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

IBytesMessage

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

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

관련 참조
바이트 메시지

.NET 등록 정보

.NET 등록 정보 요약:
.NET 등록 정보 설명
BodyLength 메시지 본문이 읽기 전용일 경우 메시지 본문의 길이를 바이트 단위로 가져옵니다.

BodyLength – 본문 길이 가져오기Get Body Length

인터페이스:
Int64 BodyLength
    {
      get;
    }

메시지 본문이 읽기 전용일 경우 메시지 본문의 길이를 바이트 단위로 가져옵니다.

메시지 읽기 커서의 현재 위치에 상관없이 리턴값은 전체 본문의 길이입니다.

예외:
  • XMSException
  • MessageNotReadableException

메소드

메소드 요약:
메소드 설명
ReadBoolean 바이트 메시지 스트림에서 부울 값을 읽습니다.
ReadSignedByte 바이트 메시지 스트림의 다음 바이트를 부호가 있는 8비트 정수로 읽습니다.
ReadBytes 현재 커서 위치에서 시작되는 바이트 메시지 스트림에서 바이트 배열을 읽습니다.
ReadChar 바이트 메시지 스트림의 다음 2바이트를 문자로 읽습니다.
ReadDouble 바이트 메시지 스트림의 다음 8바이트를 배정밀도 부동 소수점 수로 읽습니다.
ReadFloat 바이트 메시지 스트림의 다음 4바이트를 부동 소수점 수로 읽습니다.
ReadInt 바이트 메시지 스트림의 다음 4바이트를 부호가 있는 32비트 정수로 읽습니다.
ReadLong 바이트 메시지 스트림의 다음 8바이트를 부호가 있는 64비트 정수로 읽습니다.
ReadShort 바이트 메시지 스트림의 다음 2바이트를 부호가 있는 16비트 정수로 읽습니다.
ReadByte 바이트 메시지 스트림의 다음 바이트를 부호 없는 8비트 정수로 읽습니다.
ReadUnsignedShort 바이트 메시지 스트림의 다음 2바이트를 부호 없는 16비트 정수로 읽습니다.
ReadUTF 바이트 메시지 스트림에서 UTF-8로 인코딩된 문자열을 읽습니다.
Reset 메시지 본문을 읽기 전용 모드로 전환하고 커서를 바이트 메시지 스트림의 시작 부분으로 옮깁니다.
WriteBoolean 부울 값을 바이트 메시지 스트림에 기록합니다.
WriteByte 바이트를 바이트 메시지 스트림에 기록합니다.
WriteBytes 바이트 배열을 바이트 메시지 스트림에 기록합니다.
WriteBytes 지정된 길이로 정의된 부분 바이트 배열을 바이트 메시지 스트림에 기록합니다.
WriteChar 바이트 메시지 스트림에 문자를 2바이트로 기록하되, 순위가 높은 바이트를 먼저 기록합니다.
WriteDouble 배정밀도 부동 소수점 수를 Long 정수로 변환한 후 Long 정수를 바이트 메시지 스트림에 8바이트로 기록합니다. 단, 순위가 높은 바이트를 먼저 기록합니다.
WriteFloat 부동 소수점 수를 정수로 변환한 후 정수를 바이트 메시지 스트림에 4바이트로 기록합니다. 단, 순위가 높은 바이트를 먼저 기록합니다.
WriteInt 바이트 메시지 스트림에 정수를 4바이트로 기록하되, 순위가 높은 바이트를 먼저 기록합니다.
WriteLong 바이트 메시지 스트림에 Long 정수를 8바이트로 기록하되, 순위가 높은 바이트를 먼저 기록합니다.
WriteObject 지정된 오브젝트를 바이트 메시지 스트림에 기록합니다.
WriteShort 바이트 메시지 스트림에 Short 정수를 2바이트로 기록하되, 순위가 높은 바이트를 먼저 기록합니다.
WriteUTF 바이트 메시지 스트림에 UTF-8로 인코딩된 문자열을 기록합니다.

ReadBoolean – 부울 값 읽기

인터페이스:
Boolean ReadBoolean();

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

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

ReadSignedByte – 바이트 읽기

인터페이스:
Int16   ReadSignedByte();

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

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

ReadBytes – 바이트 읽기

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

현재 커서 위치에서 시작되는 바이트 메시지 스트림에서 바이트 배열을 읽습니다.

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

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

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

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

예외:
  • 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();

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

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

ReadLong – Long 정수 읽기

인터페이스:
Int64   ReadLong();

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

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

ReadShort – Short 정수 읽기

인터페이스:
Int16   ReadShort();

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

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

ReadByte – 부호 없는 바이트 읽기

인터페이스:
Byte    ReadByte();

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

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

ReadUnsignedShort – 부호 없는 Short 정수 읽기

인터페이스:
Int32   ReadUnsignedShort();

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

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

ReadUTF – UTF 문자열 읽기

인터페이스:
String  ReadUTF();

바이트 메시지 스트림에서 UTF-8로 인코딩된 문자열을 읽습니다.

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

Reset – 재설정

인터페이스:
void Reset();

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

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

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(입력)
기록할 바이트 배열입니다.
리턴값:
Void
예외:
  • XMSException
  • MessageNotWritableException

WriteBytes – 부분 바이트 배열 쓰기

인터페이스:
void  WriteBytes(Byte[] value, int offset, int length);

지정된 길이로 정의된 부분 바이트 배열을 바이트 메시지 스트림에 기록합니다.

매개변수:
value(입력)
기록할 바이트 배열입니다.
offset(입력)
기록할 바이트 배열의 시작 지점입니다.
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);

지정된 오브젝트를 바이트 메시지 스트림에 기록합니다.

매개변수:
value(입력)
기록할 오브젝트로서 원시 유형에 대한 참조여야 합니다.
리턴값:
Void
예외:
  • XMSException
  • MessageNotWritableException

WriteShort – Short 정수 쓰기

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

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

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

WriteUTF – UTF 문자열 쓰기

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

바이트 메시지 스트림에 UTF-8로 인코딩된 문자열을 기록합니다.

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