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

BytesMessage

바이트 메시지는 본문이 바이트 스트림을 구성하는 메시지입니다.

상속 계층 구조:
xms::PropertyContext
   |
   +----xms::Message
           |
           +----xms::BytesMessage
관련 참조
바이트 메시지

메소드

메소드 요약:
메소드 설명
getBodyLength 메시지의 본문이 읽기 전용일 때 메시지의 본문 길이를 가져옵니다.
readBoolean 바이트 메시지 스트림에서 부울 값을 읽습니다.
readByte 바이트 메시지 스트림의 다음 바이트를 부호가 있는 8비트 정수로 읽습니다.
readBytes 현재 커서 위치에서 시작되는 바이트 메시지 스트림에서 바이트 배열을 읽습니다.
readChar 바이트 메시지 스트림의 다음 2바이트를 문자로 읽습니다.
readDouble 바이트 메시지 스트림의 다음 8바이트를 배정밀도 부동 소수점 수로 읽습니다.
readFloat 바이트 메시지 스트림의 다음 4바이트를 부동 소수점 수로 읽습니다.
readInt 바이트 메시지 스트림의 다음 4바이트를 부호가 있는 32비트 정수로 읽습니다.
readLong 바이트 메시지 스트림의 다음 8바이트를 부호가 있는 64비트 정수로 읽습니다.
readShort 바이트 메시지 스트림의 다음 2바이트를 부호가 있는 16비트 정수로 읽습니다.
readUnsignedByte 바이트 메시지 스트림의 다음 바이트를 부호 없는 8비트 정수로 읽습니다.
readUnsignedShort 바이트 메시지 스트림의 다음 2바이트를 부호 없는 16비트 정수로 읽습니다.
readUTF 바이트 메시지 스트림에서 UTF-8로 인코딩된 문자열을 읽습니다.
reset 메시지 본문을 읽기 전용 모드로 전환하고 커서를 바이트 메시지 스트림의 시작 부분으로 옮깁니다.
writeBoolean 부울 값을 바이트 메시지 스트림에 기록합니다.
writeByte 바이트를 바이트 메시지 스트림에 기록합니다.
writeBytes 바이트 배열을 바이트 메시지 스트림에 기록합니다.
writeChar 바이트 메시지 스트림에 문자를 2바이트로 기록하되, 순위가 높은 바이트를 먼저 기록합니다.
writeDouble 배정밀도 부동 소수점 수를 Long 정수로 변환한 후 Long 정수를 바이트 메시지 스트림에 8바이트로 기록합니다. 단, 순위가 높은 바이트를 먼저 기록합니다.
writeFloat 부동 소수점 수를 정수로 변환한 후 정수를 바이트 메시지 스트림에 4바이트로 기록합니다. 단, 순위가 높은 바이트를 먼저 기록합니다.
writeInt 바이트 메시지 스트림에 정수를 4바이트로 기록하되, 순위가 높은 바이트를 먼저 기록합니다.
writeLong 바이트 메시지 스트림에 Long 정수를 8바이트로 기록하되, 순위가 높은 바이트를 먼저 기록합니다.
writeShort 바이트 메시지 스트림에 Short 정수를 2바이트로 기록하되, 순위가 높은 바이트를 먼저 기록합니다.
writeUTF 바이트 메시지 스트림에 UTF-8로 인코딩된 문자열을 기록합니다.

getBodyLength – 본문 길이 가져오기

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

메시지의 본문이 읽기 전용일 때 메시지의 본문 길이를 가져옵니다.

매개변수:
없음
리턴값:
메시지의 본문 길이(바이트)입니다. 메시지 읽기 커서의 현재 위치에 상관없이 메소드는 전체 본문의 길이를 리턴합니다.
예외:
  • XMS_X_GENERAL_EXCEPTION
  • XMS_X_MESSAGE_NOT_READABLE_EXCEPTION

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(출력)
읽은 바이트 배열을 포함하는 버퍼입니다. 호출하기 전에 스트림에서 읽을 나머지 바이트 수가 버퍼 길이보다 크거나 같을 경우 버퍼가 가득 채워집니다. 그렇지 않을 경우 버퍼가 나머지 모든 바이트로 일부만 채워집니다.

입력 시 널 포인터를 지정하면 이 메소드가 바이트를 읽지 않고 건너 뜁니다. 호출하기 전에 스트림에서 읽을 나머지 바이트 수가 버퍼 길이보다 크거나 같을 경우 건너 뛴 바이트 수는 버퍼 길이와 같습니다. 그렇지 않을 경우 나머지 모든 바이트를 건너 뜁니다.

bufferLength(입력)
버퍼 길이(바이트)입니다. 대신 XMSC_QUERY_SIZE를 지정하면 버퍼로 바이트를 읽어 들이지 않지만 커서의 현재 위치에서 시작하여 스트림에 남아있는 바이트의 수를 returnedLength 매개변수로 리턴하고 커서는 진행되지 않습니다.
returnedLength(출력)
버퍼로 읽어 들인 바이트 수입니다. 버퍼의 일부만 채워진 경우 값이 버퍼 길이보다 작은데, 이는 더 이상 읽을 바이트가 남아 있지 않음을 나타냅니다. 호출하기 전에 스트림에서 읽을 나머지 바이트가 없을 경우 값은 XMSC_END_OF_STREAM입니다.

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

리턴값:
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;

바이트 메시지 스트림의 다음 4바이트를 부호가 있는 32비트 정수로 읽습니다.

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

readLong – Long 정수 읽기

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

바이트 메시지 스트림의 다음 8바이트를 부호가 있는 64비트 정수로 읽습니다.

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

readShort – Short 정수 읽기

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

바이트 메시지 스트림의 다음 2바이트를 부호가 있는 16비트 정수로 읽습니다.

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

readUnsignedByte – 부호 없는 바이트 읽기

인터페이스:
xmsBYTE readUnsignedByte() const;

바이트 메시지 스트림의 다음 바이트를 부호 없는 8비트 정수로 읽습니다.

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

readUnsignedShort – 부호 없는 Short 정수 읽기

인터페이스:
xmsUSHORT readUnsignedShort() const;

바이트 메시지 스트림의 다음 2바이트를 부호 없는 16비트 정수로 읽습니다.

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

readUTF – UTF 문자열 읽기

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

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

매개변수:
없음
리턴값:
읽은 문자열을 캡슐화하는 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

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

writeShort – Short 정수 쓰기

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

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

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

writeUTF – UTF 문자열 쓰기

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

바이트 메시지 스트림에 UTF-8로 인코딩된 문자열을 기록합니다. 필요한 경우 XMS에서 문자열의 문자를 로컬 코드 페이지에서 UTF-8로 변환합니다.

매개변수:
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 웹 사이트 참조)