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 從訊息串流中讀取 Boolean 值。
ReadByte 從訊息串流中讀取一個帶正負號的 8 位元整數。
ReadBytes 從訊息串流中讀取位元組陣列。
ReadChar 從訊息串流中讀取一個二位元組字元。
ReadDouble 從訊息串流中讀取一個 8 位元組的倍精準度浮點數。
ReadFloat 從訊息串流中讀取一個 4 位元組的浮點數。
ReadInt 從訊息串流中讀取一個帶正負號的 32 位元整數。
ReadLong 從訊息串流中讀取一個帶正負號的 64 位元整數。
ReadObject 從訊息串流中讀取一值,並傳回其資料類型。
ReadShort 從訊息串流中讀取一個帶正負號的 16 位元整數。
ReadString 從訊息串流中讀取一個字串。
Reset 將訊息主體變成唯讀模式, 並將游標重新定位在訊息串流開頭。
WriteBoolean 將 Boolean 值寫入訊息串流中。
WriteByte 將位元組寫入訊息串流中。
WriteBytes 將位元組陣列寫入訊息串流中。
WriteChar 將字元當成 2 位元組寫入訊息串流中, 並從次序高的位元組開始。
WriteDouble 將倍精準度浮點數轉換成長整數, 並將長整數當成 8 位元組寫入訊息串流中,且從次序高的位元組開始。
WriteFloat 將浮點數轉換成整數, 並將整數當成 4 位元組寫入訊息串流中,且從次序高的位元組開始。
WriteInt 將整數當成 4 位元組寫入訊息串流中, 並從次序高的位元組開始。
WriteLong 將長整數當成 8 位元組寫入訊息串流中, 並從次序高的位元組開始。
WriteObject 使用指定的資料類型,將值寫入訊息串流中。
WriteShort 將短整數當成 2 位元組寫入訊息串流中, 並從次序高的位元組開始。
WriteString 將字串寫入訊息串流中。

ReadBoolean – 讀取 Boolean 值

介面:
Boolean ReadBoolean();

從訊息串流中讀取 Boolean 值。

參數:
傳回:
所讀取的 Boolean 值。
異常狀況:
  • 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();

從訊息串流中讀取一個二位元組字元。

參數:
傳回:
所讀取的字元。
異常狀況:
  • 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 – 讀取長整數

介面:
Int64   ReadLong();

從訊息串流中讀取一個帶正負號的 64 位元整數。

參數:
傳回:
所讀取的長整數。
異常狀況:
  • XMSException
  • MessageNotReadableException
  • MessageEOFException

ReadObject – 讀取物件

介面:
Object  ReadObject();

從訊息串流中讀取一值,並傳回其資料類型。

參數:
傳回:
值,可為下列一種物件類型:
  • Boolean
  • Byte
  • Byte[]
  • Char
  • Double
  • Single
  • Int32
  • Int64
  • Int16
  • String
異常狀況:
XMSException

ReadShort – 讀取短整數

介面:
Int16   ReadShort();

從訊息串流中讀取一個帶正負號的 16 位元整數。

參數:
傳回:
所讀取的短整數。
異常狀況:
  • XMSException
  • MessageNotReadableException
  • MessageEOFException

ReadString – 讀取字串

介面:
String  ReadString();

從訊息串流中讀取一個字串。必要時, XMS 會將字串中的字元轉換成區域字碼頁。

參數:
傳回:
封裝所讀取之字串的 String 物件。如果需要轉換資料, 則此為轉換後的字串。
異常狀況:
  • XMSException
  • MessageNotReadableException
  • MessageEOFException

Reset – 重設

介面:
void Reset();

將訊息主體變成唯讀模式, 並將游標重新定位在訊息串流開頭。

參數:
傳回:
Void
異常狀況:
  • XMSException
  • MessageNotReadableException
  • MessageEOFException

WriteBoolean – 寫入 Boolean 值

介面:
void  WriteBoolean(Boolean value);

將 Boolean 值寫入訊息串流中。

參數:
value(輸入)
要寫入的 Boolean 值。
傳回:
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);

將倍精準度浮點數轉換成長整數, 並將長整數當成 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 – 寫入長整數

介面:
void  WriteLong(Int64 value);

將長整數當成 8 位元組寫入訊息串流中, 並從次序高的位元組開始。

參數:
value(輸入)
要寫入的長整數。
傳回:
Void
異常狀況:
  • XMSException
  • MessageNotWritableException

WriteObject – 寫入物件

介面:
void  WriteObject(Object value);

使用指定的資料類型,將值寫入訊息串流中。

參數:
objectType(輸入)
值,必須是下列一種物件類型:
  • Boolean
  • Byte
  • Byte[]
  • Char
  • Double
  • Single
  • Int32
  • Int64
  • Int16
  • String
value(輸入)
內含所要寫入之值的位元組陣列。
length(輸入)
陣列中的位元組數。
傳回:
Void
異常狀況:
  • XMSException

WriteShort – 寫入短整數

介面:
void  WriteShort(Int16 value);

將短整數當成 2 位元組寫入訊息串流中, 並從次序高的位元組開始。

參數:
value(輸入)
要寫入的短整數。
傳回:
Void
異常狀況:
  • XMSException
  • MessageNotWritableException

WriteString – 寫入字串

介面:
void  WriteString(String value);

將字串寫入訊息串流中。

參數:
value(輸入)
封裝所要寫入之字串的 String 物件。
傳回:
Void
異常狀況:
  • XMSException
  • MessageNotWritableException

繼承的內容和方法


Reference topic

使用條款 | 評比此網頁

時間戳記前次更新: 25 Apr 2006
(C) Copyright IBM Corporation 2005. All Rights Reserved.
本資訊中心採用 Eclipse 技術。(http://www.eclipse.org)