メッセージキューイングアクセス機能 TP1/Message Queue - Access 使用の手引
BytesMessageインタフェース(JMS)
BytesMessageインタフェースは,解釈されていないバイトストリームを含むメッセージを送信するために使用します。
形式
public interface BytesMessage extends Message { public boolean readBoolean() throws JMSException; public byte readByte() throws JMSException; public int readUnsignedByte() throws JMSException; public short readShort() throws JMSException; public int readUnsignedShort() throws JMSException; public char readChar() throws JMSException; public int readInt() throws JMSException; public long readLong() throws JMSException; public float readFloat() throws JMSException; public double readDouble() throws JMSException; public java.lang.String readUTF() throws JMSException; public int readBytes(byte[] value) throws JMSException; public int readBytes(byte[] value, int length) throws JMSException; public void writeBoolean(boolean value) throws JMSException; public void writeByte(byte value) throws JMSException; public void writeShort(short value) throws JMSException; public void writeChar(char value) throws JMSException; public void writeInt(int value) throws JMSException; public void writeLong(long value) throws JMSException; public void writeFloat(float value) throws JMSException; public void writeDouble(double value) throws JMSException; public void writeUTF(java.lang.String value) throws JMSException; public void writeBytes(byte[] value) throws JMSException; public void writeBytes(byte[] value, int offset, int length) throws JMSException; public void writeObject(java.lang.Object value) throws JMSException; public void reset() throws JMSException; }
メソッド
● public boolean readBoolean() throws JMSException
バイトメッセージストリームからboolean型の値を取得します。
● public byte readByte() throws JMSException
バイトメッセージストリームから符号付き8ビット型の値を取得します。
● public int readUnsignedByte() throws JMSException
バイトメッセージストリームから符号なし8ビット型の値を取得します。
● public short readShort() throws JMSException
バイトメッセージストリームから符号付き16ビット型の値を取得します。
● public int readUnsignedShort() throws JMSException
バイトメッセージストリームから符号なし16ビット型の値を取得します。
● public char readChar() throws JMSException
バイトメッセージストリームからUnicode文字列を取得します。
● public int readInt() throws JMSException
バイトメッセージストリームから符号付き32ビット型の値を取得します。
● public long readLong() throws JMSException
バイトメッセージストリームから符号付き64ビット型の値を取得します。
● public float readFloat() throws JMSException
バイトメッセージストリームからfloat型の値を取得します。
● public double readDouble() throws JMSException
バイトメッセージストリームからdouble型の値を取得します。
● public java.lang.String readUTF() throws JMSException
バイトメッセージストリームから修正UTF-8フォーマットを使用してエンコードされた文字列を取得します。
● public int readBytes(byte[] value) throws JMSException
バイトメッセージストリームからbyte型配列の値を取得します。
バイトメッセージストリームから読み込まれる残りのバイトより,配列の長さが小さい場合,配列は満たされます。この場合は,あとの呼び出しで次の増分が読み込まれます。一方,バイトメッセージストリームから読み込まれる残りのバイトより,配列の長さが大きい場合,残りのバイトデータは配列に読み込まれます。
戻り値がbyte型配列の長さより小さい場合は,バイトメッセージストリームにデータが残っていないことを示します。この場合は,次の読み込みで-1が返ります。
● public int readBytes(byte[] value, int length) throws JMSException
バイトメッセージストリームからbyte型配列の値の一部を取得します。
バイトメッセージストリームから読み込まれる残りのバイトよりlengthが小さい場合,読み込まれたデータは配列にlengthの長さまで格納されます。この場合は,あとの呼び出しで次の増分が読み込まれます。一方,バイトメッセージストリームから読み込まれる残りのバイトよりlengthが大きい場合,残りのバイトデータは配列に読み込まれます。
戻り値がlengthより小さい場合は,バイトメッセージストリームにデータが残っていないことを示します。この場合は,次の読み込みで-1が返ります。
lengthの値が負の場合,または配列の長さより大きい場合は,例外JMSExceptionがスローされます。例外がスローされると,バイトメッセージストリームからデータは読み込まれません。
● public void writeBoolean(boolean value) throws JMSException
1バイトの値として,boolean型の値をバイトメッセージストリームに書き込みます。trueの場合は1の値,falseの場合は0の値を書き込みます。
● public void writeByte(byte value) throws JMSException
1バイトの値として,byte型の値をバイトメッセージストリームに書き込みます。
● public void writeShort(short value) throws JMSException
2バイトの値として,short型の値をhigh byte firstでバイトメッセージストリームに書き込みます。
● public void writeChar(char value) throws JMSException
2バイトの値として,char型の値をhigh byte firstでバイトメッセージストリームに書き込みます。
● public void writeInt(int value) throws JMSException
4バイトの値として,int型の値をhigh byte firstでバイトメッセージストリームに書き込みます。
● public void writeLong(long value) throws JMSException
8バイトの値として,long型の値をhigh byte firstでバイトメッセージストリームに書き込みます。
● public void writeFloat(float value) throws JMSException
FloatクラスのfloatToIntBitsメソッドを使用して,float型の値をint型に変換します。その後,4バイトの値として,変換したint型の値をhigh byte firstでバイトメッセージストリームに書き込みます。
● public void writeDouble(double value) throws JMSException
DoubleクラスのdoubleToLongBitsメソッドを使用して,double型の値をlong型に変換します。その後,8バイトの値として,変換したlong型の値をhigh byte firstでバイトメッセージストリームに書き込みます。
● public void writeUTF(java.lang.String value) throws JMSException
修正UTF-8フォーマットを使用してエンコードされた文字列をバイトメッセージストリームに書き込みます。
● public void writeBytes(byte[] value) throws JMSException
byte型配列をバイトメッセージストリームに書き込みます。
● public void writeBytes(byte[] value, int offset, int length) throws JMSException
byte型配列の一部をバイトメッセージストリームに書き込みます。
● public void writeObject(java.lang.Object value) throws JMSException
Javaオブジェクトをバイトメッセージストリームに書き込みます。書き込みできる値の型は,プリミティブ型をラップするクラス(Byte,Integerなど),String型,およびbyte型配列です。
● public void reset() throws JMSException
メッセージ本体を読み込み専用にして,バイトメッセージストリームを最初の位置に変更します。
All Rights Reserved. Copyright (C) 2006, 2007, Hitachi, Ltd.
(C) Copyright International Business Machines Corporation 1994, 1999. All rights reserved.