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

StreamMessage

스트림 메시지는 본문이 각 값에 연관된 데이터 유형이 있는 값 스트림으로 구성된 메시지입니다.

상속 계층 구조:
xms::PropertyContext
   |
   +----xms::Message
           |
           +----xms::StreamMessage

본문의 컨텐츠는 순차적으로 쓰여지고 읽혀집니다.

응용프로그램이 메시지 스트림에서 값을 읽을 때 값은 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 – 부울 값 읽기

인터페이스:
xmsBOOL readBoolean() const;

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

매개변수:
없음
리턴값:
읽은 부울 값입니다.
예외:
  • XMS_X_GENERAL_EXCEPTION
  • XMS_X_MESSAGE_NOT_READABLE_EXCEPTION
  • XMS_X_MESSAGE_EOF_EXCEPTION

readByte – 바이트 읽기

인터페이스:
xmsSBYTE readByte() const;

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

매개변수:
없음
리턴값:
읽은 바이트입니다.
예외:
  • XMS_X_GENERAL_EXCEPTION
  • XMS_X_MESSAGE_NOT_READABLE_EXCEPTION
  • XMS_X_MESSAGE_EOF_EXCEPTION

readBytes – 바이트 읽기

인터페이스:
xmsINT readBytes(xmsSBYTE *buffer,
                 const xmsINT bufferLength,
                 xmsINT *returnedLength) const;

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

매개변수:
buffer(출력)
읽은 바이트 배열을 포함하는 버퍼입니다.

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

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

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

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

리턴값:
returnedLength 매개변수에 대한 설명을 참조하십시오.
예외:
  • XMS_X_GENERAL_EXCEPTION
  • XMS_X_MESSAGE_NOT_READABLE_EXCEPTION
  • XMS_X_MESSAGE_EOF_EXCEPTION

readChar – 문자 읽기

인터페이스:
xmsCHAR16 readChar() const;

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

매개변수:
없음
리턴값:
읽은 문자입니다.
예외:
  • XMS_X_GENERAL_EXCEPTION
  • XMS_X_MESSAGE_NOT_READABLE_EXCEPTION
  • XMS_X_MESSAGE_EOF_EXCEPTION

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

인터페이스:
xmsDOUBLE readDouble() const;

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

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

readFloat – 부동 소수점 수 읽기

인터페이스:
xmsFLOAT readFloat() const;

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

매개변수:
없음
리턴값:
읽은 부동 소수점 수입니다.
예외:
  • XMS_X_GENERAL_EXCEPTION
  • XMS_X_MESSAGE_NOT_READABLE_EXCEPTION
  • XMS_X_MESSAGE_EOF_EXCEPTION

readInt – 정수 읽기

인터페이스:
xmsINT readInt() const;

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

매개변수:
없음
리턴값:
읽은 정수입니다.
예외:
  • XMS_X_GENERAL_EXCEPTION
  • XMS_X_MESSAGE_NOT_READABLE_EXCEPTION
  • XMS_X_MESSAGE_EOF_EXCEPTION

readLong – Long 정수 읽기

인터페이스:
xmsLONG readLong() const;

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

매개변수:
없음
리턴값:
읽은 Long 정수입니다.
예외:
  • XMS_X_GENERAL_EXCEPTION
  • XMS_X_MESSAGE_NOT_READABLE_EXCEPTION
  • XMS_X_MESSAGE_EOF_EXCEPTION

readObject – 오브젝트 읽기

인터페이스:
xmsOBJECT_TYPE readObject(xmsSBYTE *buffer,
                          const xmsINT bufferLength,
                          xmsINT *actualLength) const;

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

이 메소드의 사용 방법에 대한 자세한 정보는 바이트 배열을 리턴하는 C++ 메소드를 참조하십시오.

매개변수:
buffer(출력)
바이트 배열로 리턴되는 값을 포함하는 버퍼입니다. 값이 문자열이고 데이터 변환이 필수인 경우 이 매개변수는 변환 후 값입니다.

입력에서 널 포인트를 지정한 경우 해당 호출이 읽지 않고 값을 건너뜁니다.

bufferLength(입력)
버퍼 길이(바이트)입니다. XMSC_QUERY_SIZE를 지정한 경우 값은 리턴되지 않고 actualLength 매개변수로 길이가 리턴됩니다.
actualLength(출력)
값의 길이(바이트)입니다. 값이 문자열이고 데이터 변환이 필수인 경우 이 매개변수는 변환 후 길이입니다. 입력에서 널 포인트를 지정한 경우 길이가 리턴되지 않습니다.
리턴값:
다음 오브젝트 유형 중 하나를 값의 데이터 유형으로 사용할 수 있습니다.
  • XMS_OBJECT_TYPE_BOOL
  • XMS_OBJECT_TYPE_BYTE
  • XMS_OBJECT_TYPE_BYTEARRAY
  • XMS_OBJECT_TYPE_CHAR
  • XMS_OBJECT_TYPE_DOUBLE
  • XMS_OBJECT_TYPE_FLOAT
  • XMS_OBJECT_TYPE_INT
  • XMS_OBJECT_TYPE_LONG
  • XMS_OBJECT_TYPE_SHORT
  • XMS_OBJECT_TYPE_STRING
예외:
XMS_X_GENERAL_EXCEPTION

readShort – Short 정수 읽기

인터페이스:
xmsSHORT readShort() const;

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

매개변수:
없음
리턴값:
읽은 Short 정수입니다.
예외:
  • XMS_X_GENERAL_EXCEPTION
  • XMS_X_MESSAGE_NOT_READABLE_EXCEPTION
  • XMS_X_MESSAGE_EOF_EXCEPTION

readString – 문자열 읽기

인터페이스:
String readString() const;

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

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

reset – 재설정

인터페이스:
xmsVOID reset() const;

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

매개변수:
없음
리턴값:
Void
예외:
  • XMS_X_GENERAL_EXCEPTION
  • XMS_X_MESSAGE_NOT_READABLE_EXCEPTION
  • XMS_X_MESSAGE_EOF_EXCEPTION

writeBoolean – 부울 값 쓰기

인터페이스:
xmsVOID writeBoolean(const xmsBOOL value);

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

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

writeByte – 바이트 쓰기

인터페이스:
xmsVOID writeByte(const xmsSBYTE value);

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

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

writeBytes – 바이트 쓰기

인터페이스:
xmsVOID writeBytes(const xmsSBYTE *value,
                   const xmsINT length);

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

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

writeChar – 문자 쓰기

인터페이스:
xmsVOID writeChar(const xmsCHAR16 value);

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

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

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

인터페이스:
xmsVOID writeDouble(const xmsDOUBLE value);

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

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

writeFloat – 부동 소수점 수 쓰기

인터페이스:
xmsVOID writeFloat(const xmsFLOAT value);

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

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

writeInt – 정수 쓰기

인터페이스:
xmsVOID writeInt(const xmsINT value);

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

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

writeLong – Long 정수 쓰기

인터페이스:
xmsVOID writeLong(const xmsLONG value);

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

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

writeObject – 오브젝트 쓰기

인터페이스:
xmsVOID writeObject(const xmsOBJECT_TYPE objectType,
                    const xmsSBYTE *value,
                    const xmsINT length);

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

매개변수:
objectType(입력)
다음 오브젝트 유형 중 하나를 값의 데이터 유형으로 사용해야 합니다.
  • XMS_OBJECT_TYPE_BOOL
  • XMS_OBJECT_TYPE_BYTE
  • XMS_OBJECT_TYPE_BYTEARRAY
  • XMS_OBJECT_TYPE_CHAR
  • XMS_OBJECT_TYPE_DOUBLE
  • XMS_OBJECT_TYPE_FLOAT
  • XMS_OBJECT_TYPE_INT
  • XMS_OBJECT_TYPE_LONG
  • XMS_OBJECT_TYPE_SHORT
  • XMS_OBJECT_TYPE_STRING
value(입력)
기록할 값을 포함하는 바이트 배열입니다.
length(입력)
배열의 바이트 수입니다.
리턴값:
Void
예외:
  • XMS_X_GENERAL_EXCEPTION

writeShort – Short 정수 쓰기

인터페이스:
xmsVOID writeShort(const xmsSHORT value);

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

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

writeString – 문자열 쓰기

인터페이스:
xmsVOID writeString(const String & value);

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

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

상속된 메소드


Reference topic

이용약관 | 피드백

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