WebSphere Message Service Clients for C/C++ and .NET, Version 1.2 운영 체제: Linux, Windows

IStreamMessage

스트림 메시지는 본문이 각 값에 연관된 데이터 유형이 있는 값 스트림으로 구성된 메시지입니다. 본문의 컨텐츠는 순차적으로 쓰여지고 읽혀집니다.

상속 계층 구조:
IBM.XMS.IPropertyContext
   |
   +----IBM.XMS.IMessage
           |
           +----IBM.XMS.IStreamMessage

응용프로그램이 메시지 스트림에서 값을 읽을 때 값은 XMS에 의해 다른 데이터 유형으로 변환될 수 있습니다. 이 형식의 암시적 변환에 대한 자세한 정보는 스트림 메시지를 참조하십시오.

관련 참조
스트림 메시지

메소드

메소드 요약:
메소드 설명
ReadBoolean 메시지 스트림에서 부울 값을 읽습니다.
ReadByte 메시지 스트림에서 부호가 있는 8비트 정수를 읽습니다.
ReadBytes 메시지 스트림에서 바이트 배열을 읽습니다.
ReadChar 메시지 스트림에서 2바이트 문자를 읽습니다.
ReadDouble 메시지 스트림에서 8바이트 배정밀도 부동 소수점 수를 읽습니다.
ReadFloat 메시지 스트림에서 4바이트 부동 소수점 수를 읽습니다.
ReadInt 메시지 스트림에서 부호가 있는 32비트 정수를 읽습니다.
ReadLong 메시지 스트림에서 부호가 있는 64비트 정수를 읽습니다.
ReadObject 메시지 스트림에서 값을 읽은 후 해당 값의 데이터 유형을 리턴합니다.
ReadShort 메시지 스트림에서 부호가 있는 16비트 정수를 읽습니다.
ReadString 메시지 스트림에서 문자열을 읽습니다.
Reset 메시지 본문을 읽기 전용 모드로 전환하고 커서를 메시지 스트림의 시작 부분으로 옮깁니다.
WriteBoolean 부울 값을 메시지 스트림에 기록합니다.
WriteByte 바이트를 메시지 스트림에 기록합니다.
WriteBytes 바이트 배열을 메시지 스트림에 기록합니다.
WriteChar 메시지 스트림에 문자를 2바이트로 기록하되, 순위가 높은 바이트를 먼저 기록합니다.
WriteDouble 배정밀도 부동 소수점 수를 Long 정수로 변환한 후 Long 정수를 메시지 스트림에 8바이트로 기록합니다. 단, 순위가 높은 바이트를 먼저 기록합니다.
WriteFloat 부동 소수점 수를 정수로 변환한 후 정수를 메시지 스트림에 4바이트로 기록합니다. 단, 순위가 높은 바이트를 먼저 기록합니다.
WriteInt 메시지 스트림에 정수를 4바이트로 기록하되, 순위가 높은 바이트를 먼저 기록합니다.
WriteLong 메시지 스트림에 Long 정수를 8바이트로 기록하되, 순위가 높은 바이트를 먼저 기록합니다.
WriteObject 지정된 데이터 유형의 값을 메시지 스트림에 기록합니다.
WriteShort 메시지 스트림에 Short 정수를 2바이트로 기록하되, 순위가 높은 바이트를 먼저 기록합니다.
WriteString 문자열을 메시지 스트림에 기록합니다.

ReadBoolean – 부울 값 읽기

인터페이스:
Boolean ReadBoolean();

메시지 스트림에서 부울 값을 읽습니다.

매개변수:
없음
리턴값:
읽은 부울 값입니다.
예외:
  • XMSException
  • MessageNotReadableException
  • MessageEOFException

ReadByte – 바이트 읽기

인터페이스:
Int16   ReadSignedByte();    Byte    ReadByte();

메시지 스트림에서 부호가 있는 8비트 정수를 읽습니다.

매개변수:
없음
리턴값:
읽은 바이트입니다.
예외:
  • XMSException
  • MessageNotReadableException
  • MessageEOFException

ReadBytes – 바이트 읽기

인터페이스:
Int32   ReadBytes(Byte[] array);

메시지 스트림에서 바이트 배열을 읽습니다.

매개변수:
array(입력)
바이트 배열을 포함하는 읽은 버퍼를 나타내며 바이트 단위의 버퍼 길이입니다.

배열의 바이트 수가 버퍼 길이보다 작거나 같을 경우 전체 배열이 버퍼로 읽혀집니다. 배열의 바이트 수가 버퍼 길이보다 클 경우 버퍼가 배열의 일부로 채워지고 내부 커서가 다음으로 읽을 바이트의 위치를 표시합니다. readBytes()에 대한 이후 호출은 바이트의 현재 커서 위치에서부터 바이트를 읽습니다.

입력 시 널 포인터를 지정하면 해당 호출이 바이트 배열을 읽지 않고 건너 뜁니다.

리턴값:
버퍼로 읽어 들인 바이트 수입니다. 버퍼의 일부만 채워진 경우 값이 버퍼 길이보다 작은데, 이는 배열에 더 이상 읽을 바이트가 남아 있지 않음을 나타냅니다. 호출하기 전에 배열에서 읽을 나머지 바이트가 없을 경우 값은 XMSC_END_OF_BYTEARRAY입니다.

입력 시 널 포인터를 지정하면 이 메소드가 값을 리턴하지 않습니다.

예외:
  • XMSException
  • MessageNotReadableException
  • MessageEOFException

ReadChar – 문자 읽기

인터페이스:
Char    ReadChar();

메시지 스트림에서 2바이트 문자를 읽습니다.

매개변수:
없음
리턴값:
읽은 문자입니다.
예외:
  • XMSException
  • MessageNotReadableException
  • MessageEOFException

ReadDouble – 배정밀도 부동 소수점 수 읽기

인터페이스:
Double  ReadDouble();

메시지 스트림에서 8바이트 배정밀도 부동 소수점 수를 읽습니다.

매개변수:
없음
리턴값:
읽은 배정밀도 부동 소수점 수입니다.
예외:
  • XMSException
  • MessageNotReadableException
  • MessageEOFException

ReadFloat – 부동 소수점 수 읽기

인터페이스:
Single  ReadFloat();

메시지 스트림에서 4바이트 부동 소수점 수를 읽습니다.

매개변수:
없음
리턴값:
읽은 부동 소수점 수입니다.
예외:
  • XMSException
  • MessageNotReadableException
  • MessageEOFException

ReadInt – 정수 읽기

인터페이스:
Int32   ReadInt();

메시지 스트림에서 부호가 있는 32비트 정수를 읽습니다.

매개변수:
없음
리턴값:
읽은 정수입니다.
예외:
  • XMSException
  • MessageNotReadableException
  • MessageEOFException

ReadLong – Long 정수 읽기

인터페이스:
Int64   ReadLong();

메시지 스트림에서 부호가 있는 64비트 정수를 읽습니다.

매개변수:
없음
리턴값:
읽은 Long 정수입니다.
예외:
  • XMSException
  • MessageNotReadableException
  • MessageEOFException

ReadObject – 오브젝트 읽기

인터페이스:
Object  ReadObject();

메시지 스트림에서 값을 읽은 후 해당 값의 데이터 유형을 리턴합니다.

매개변수:
없음
리턴값:
다음 오브젝트 유형 중 하나를 값으로 사용할 수 있습니다.
  • Boolean
  • Byte
  • Byte[]
  • Char
  • Double
  • Single
  • Int32
  • Int64
  • Int16
  • String
예외:
XMSException

ReadShort – Short 정수 읽기

인터페이스:
Int16   ReadShort();

메시지 스트림에서 부호가 있는 16비트 정수를 읽습니다.

매개변수:
없음
리턴값:
읽은 Short 정수입니다.
예외:
  • XMSException
  • MessageNotReadableException
  • MessageEOFException

ReadString – 문자열 읽기

인터페이스:
String  ReadString();

메시지 스트림에서 문자열을 읽습니다. 필요한 경우 XMS에서 문자열의 문자를 로컬 코드 페이지로 변환합니다.

매개변수:
없음
리턴값:
읽은 문자열을 캡슐화하는 String 오브젝트입니다. 데이터 변환이 필수인 경우 이 매개변수는 변환 후 문자열입니다.
예외:
  • XMSException
  • MessageNotReadableException
  • MessageEOFException

Reset – 재설정

인터페이스:
void Reset();

메시지 본문을 읽기 전용 모드로 전환하고 커서를 메시지 스트림의 시작 부분으로 옮깁니다.

매개변수:
없음
리턴값:
Void
예외:
  • XMSException
  • MessageNotReadableException
  • MessageEOFException

WriteBoolean – 부울 값 쓰기

인터페이스:
void  WriteBoolean(Boolean value);

부울 값을 메시지 스트림에 기록합니다.

매개변수:
value(입력)
기록할 부울 값입니다.
리턴값:
Void
예외:
  • XMSException
  • MessageNotWritableException

WriteByte – 바이트 쓰기

인터페이스:
void  WriteByte(Byte value);
void  WriteSignedByte(Int16 value);

바이트를 메시지 스트림에 기록합니다.

매개변수:
value(입력)
기록할 바이트입니다.
리턴값:
Void
예외:
  • XMSException
  • MessageNotWritableException

WriteBytes – 바이트 쓰기

인터페이스:
void  WriteBytes(Byte[] value);

바이트 배열을 메시지 스트림에 기록합니다.

매개변수:
value(입력)
기록할 바이트 배열입니다.
length(입력)
배열의 바이트 수입니다.
리턴값:
Void
예외:
  • XMSException
  • MessageNotWritableException

WriteChar – 문자 쓰기

인터페이스:
void  WriteChar(Char value);

메시지 스트림에 문자를 2바이트로 기록하되, 순위가 높은 바이트를 먼저 기록합니다.

매개변수:
value(입력)
기록할 문자입니다.
리턴값:
Void
예외:
  • XMSException
  • MessageNotWritableException

WriteDouble – 배정밀도 부동 소수점 수 쓰기

인터페이스:
void  WriteDouble(Double value);

배정밀도 부동 소수점 수를 Long 정수로 변환한 후 Long 정수를 메시지 스트림에 8바이트로 기록합니다. 단, 순위가 높은 바이트를 먼저 기록합니다.

매개변수:
value(입력)
기록할 배정밀도 부동 소수점 수입니다.
리턴값:
Void
예외:
  • XMSException
  • MessageNotWritableException

WriteFloat – 부동 소수점 수 쓰기

인터페이스:
void  WriteFloat(Single value);

부동 소수점 수를 정수로 변환한 후 정수를 메시지 스트림에 4바이트로 기록합니다. 단, 순위가 높은 바이트를 먼저 기록합니다.

매개변수:
value(입력)
기록할 부동 소수점 수입니다.
리턴값:
Void
예외:
  • XMSException
  • MessageNotWritableException

WriteInt – 정수 쓰기

인터페이스:
void  WriteInt(Int32 value);

메시지 스트림에 정수를 4바이트로 기록하되, 순위가 높은 바이트를 먼저 기록합니다.

매개변수:
value(입력)
기록할 정수입니다.
리턴값:
Void
예외:
  • XMSException
  • MessageNotWritableException

WriteLong – Long 정수 쓰기

인터페이스:
void  WriteLong(Int64 value);

메시지 스트림에 Long 정수를 8바이트로 기록하되, 순위가 높은 바이트를 먼저 기록합니다.

매개변수:
value(입력)
기록할 Long 정수입니다.
리턴값:
Void
예외:
  • XMSException
  • MessageNotWritableException

WriteObject – 오브젝트 쓰기

인터페이스:
void  WriteObject(Object value);

지정된 데이터 유형의 값을 메시지 스트림에 기록합니다.

매개변수:
objectType(입력)
다음 오브젝트 유형 중 하나를 값으로 사용해야 합니다.
  • Boolean
  • Byte
  • Byte[]
  • Char
  • Double
  • Single
  • Int32
  • Int64
  • Int16
  • String
value(입력)
기록할 값을 포함하는 바이트 배열입니다.
length(입력)
배열의 바이트 수입니다.
리턴값:
Void
예외:
  • XMSException

WriteShort – Short 정수 쓰기

인터페이스:
void  WriteShort(Int16 value);

메시지 스트림에 Short 정수를 2바이트로 기록하되, 순위가 높은 바이트를 먼저 기록합니다.

매개변수:
value(입력)
기록할 Short 정수입니다.
리턴값:
Void
예외:
  • XMSException
  • MessageNotWritableException

WriteString – 문자열 쓰기

인터페이스:
void  WriteString(String value);

문자열을 메시지 스트림에 기록합니다.

매개변수:
value(입력)
기록할 문자열을 캡슐화하는 String 오브젝트입니다.
리턴값:
Void
예외:
  • XMSException
  • MessageNotWritableException

상속된 등록 정보 및 메소드


Reference topic

이용약관 | 피드백

Timestamp icon마지막 갱신 날짜: 3 Mar 2006
(C) Copyright IBM Corporation 2005. All Rights Reserved.
이 Information Center는 Eclipse 기술 기반입니다. (http://www.eclipse.org 웹 사이트 참조)