com.ibm.mq

類別 MQMessage

  • java.lang.Object
  • 所有實作的介面:
    java.io.DataInput、java.io.DataOutput


    public class MQMessage
    延伸 MQMD
    實作 java.io.DataInput、java.io.DataOutput
    MQMessage 代表 IBM MQ 訊息的訊息描述子及資料。 它有一組用於從訊息讀取資料的方法,以及一組用於將資料寫入訊息的方法。 這些讀寫方法所使用的數字和字串格式由 encodingcharacterSet 欄位。 其餘欄位包含當訊息在傳送與接收應用程式之間傳送時,應用程式訊息資料所隨附的控制資訊。
    • 建構子詳細資料

      • MQMessage

        public MQMessage ()
        預設建構子。 這會建立具有預設訊息描述子資訊及空訊息緩衝區的訊息。
    • 方法詳細資料

      • getTotalMessageLength

        public int getTotalMessageLength ()
        取得訊息中儲存在保留此訊息之訊息佇列上的位元組總數。 此方法會報告在下列情況下佇列上訊息的大小總計: MQQueue.get()方法失敗,錯誤碼指出訊息已截斷。
        傳回:
        訊息中的位元組總數
      • getMessageLength

        public int getMessageLength ()
                             throws java.io.IOException
        取得此訊息中訊息資料的位元組數。
        傳回:
        位元組數。
        擲出:
        java.io.IOException-如果 IO 有問題。
      • getDataLength

        public int getDataLength ()
                          throws java.io.IOException
        取得剩餘要讀取的訊息資料位元組數。
        傳回:
        int the number of bytes remaining
        擲出:
        java.io.IOException-如果 IO 有問題。
      • public void seek (int seekOffset)
                  throws java.io.EOFException
        將游標移至訊息緩衝區中的新絕對位置。 後續的讀取和寫入將從緩衝區中的這個位置開始。
        參數:
        seekOffset-游標位置的新值。
        擲出:
        java.io.EOFException-如果偏移將游標移到訊息資料之外。
      • setDataOffset

        public void setDataOffset (int offset)
                           throws java.io.EOFException
        將游標移至訊息緩衝區中的新絕對位置。 此方法與 seek(),並提供與其他 WMQ API 的跨語言相容性。
        參數:
        offset-游標位置的新值。
        擲出:
        java.io.EOFException-如果偏移將游標移到訊息資料之外。
      • getDataOffset

        public int getDataOffset ()
                          throws java.io.IOException
        傳回訊息資料內的現行游標位置 (讀取及寫入作業生效的點)。
        傳回:
        游標位置。
        擲出:
        java.io.IOException-如果 IO 有問題。
      • clearMessage

        public void clearMessage ()
                          throws java.io.IOException
        捨棄訊息緩衝區中的任何資料,並將游標位置設為零。
        擲出:
        java.io.IOException-如果 IO 有問題。
      • resizeBuffer

        public void resizeBuffer (int size)
                          throws java.io.IOException
        向 MQMessage 類別指出可能需要的緩衝區大小。 如果訊息目前包含訊息資料,且新大小小於現行大小,則會截斷訊息資料。 如果後續將此訊息與 MQQueue.get(MQMessage, MQGetMessageOptions) ,則這是配置給 get 要求的緩衝區大小。
        參數:
        size-緩衝區的新大小
        擲出:
        java.io.IOException-如果 IO 有問題。
      • readBoolean

        public boolean readBoolean ()
                            throws java.io.IOException ,
                                   java.io.EOFException
        從訊息緩衝區中的現行位置讀取布林。
        指定者:
        readBoolean 在介面中 java.io.DataInput
        傳回:
        布林。
        擲出:
        java.io.IOException-如果 IO 有問題。
        java.io.EOFException-如果讀取超出檔案結尾。
      • readByte

        public byte readByte ()
                      throws java.io.IOException ,
                             java.io.EOFException
        從訊息緩衝區中的現行位置讀取位元組。
        指定者:
        readByte 在介面中 java.io.DataInput
        傳回:
        (帶正負號) 位元組。
        擲出:
        java.io.IOException-如果 IO 有問題。
        java.io.EOFException-如果讀取超出檔案結尾。
      • readChar

        public char readChar ()
                      throws java.io.IOException ,
                             java.io.EOFException
        從訊息緩衝區中的現行位置讀取字元。
        指定者:
        readChar 在介面中 java.io.DataInput
        傳回:
        Unicode 字元。
        擲出:
        java.io.IOException-如果 IO 有問題。
        java.io.EOFException-如果讀取超出檔案結尾。
      • readDouble

        public double readDouble ()
                          throws java.io.IOException ,
                                 java.io.EOFException
        從訊息緩衝區中的現行位置讀取倍精準數。
        指定者:
        readDouble 在介面中 java.io.DataInput
        傳回:
        大序排列法倍精準數 encoding等於 MQConstants.MQENC_INTEGER_NORMAL ,如果它等於 MQConstants.MQENC_INTEGER_REVERSED ,則為小序排列法倍精準數。
        擲出:
        java.io.IOException-如果編碼不等於其中任一值。
        java.io.EOFException-如果讀取超出檔案結尾。
      • readFloat

        public float readFloat ()
                        throws java.io.IOException ,
                               java.io.EOFException
        從訊息緩衝區中的現行位置讀取浮點數。
        指定者:
        readFloat 在介面中 java.io.DataInput
        傳回:
        大序排列法浮點數 encoding等於 MQConstants.MQENC_INTEGER_NORMAL ,如果小序排列法等於 MQConstants.MQENC_INTEGER_REVERSED ,則為浮點數,或zSeries格式化浮點數字 (如果它等於 MQConstants.MQENC_FLOAT_S390)。
        擲出:
        java.io.IOException-如果編碼不是這些。
        java.io.EOFException-如果讀取超出檔案結尾。
      • readFully

        public void readFully (byte [] b)
                       throws java.io.IOException
        以訊息緩衝區中的資料填入位元組陣列。
        指定者:
        readFully 在介面中 java.io.DataInput
        參數:
        b-位元組陣列。
        擲出:
        java.io.IOException-如果 IO 有問題。
      • readFully

        public void readFully (byte [] b ,
                              int off ,
                              int len)
                       throws java.io.IOException
        將訊息緩衝區中的資料部分填入位元組陣列。
        指定者:
        readFully 在介面中 java.io.DataInput
        參數:
        b-位元組陣列。
        off-開始讀取的訊息緩衝區中的偏移。
        len-要讀取的位元組數。
        擲出:
        java.io.IOException-如果 IO 有問題。
      • readStringOfByteLength

        public java.lang.String readStringOfByteLength (int numberOfBytes)
                                                throws java.io.IOException ,
                                                       java.io.EOFException
        讀取指定的位元組數,並使用它們來使用指定的字集建構新字串 characterSet。 當給定的位元組在給定的字集中無效時,此方法的行為取決於 JRE 的實作。

        如果已知字串的位元組長度,則應該在此方法的單一呼叫中讀取整個字串,以避免位元組和字元界限不一致的問題。

        參數:
        numberOfBytes-要讀取的位元組數。
        傳回:
        字串。
        擲出:
        java.io.IOException-如果 IO 有問題。
        java.io.EOFException-如果讀取超出檔案結尾。
      • readStringOfCharLength

        public java.lang.String readStringOfCharLength (int numberOfChars)
                                                throws java.io.IOException ,
                                                       java.io.EOFException
        讀取字碼集中由所識別的字串 characterSet並將其轉換為 Unicode。
        參數:
        numberOfChars-要讀取的字元數 (根據字碼集,可能與位元組數不同,因為部分字碼集每個字元使用多個位元組)。
        傳回:
        字串。
        擲出:
        java.io.IOException-如果 IO 有問題。
        java.io.EOFException-如果讀取超出檔案結尾。
      • readInt

        public int readInt ()
                    throws java.io.IOException
        從訊息緩衝區中的現行位置讀取整數。
        指定者:
        readInt 在介面中 java.io.DataInput
        傳回:
        大序排列法整數 if encoding等於 MQConstants.MQENC_INTEGER_NORMAL ,如果它等於 MQConstants.MQENC_INTEGER_REVERSED ,則為小序排列法整數。
        擲出:
        java.io.IOException-如果 IO 有問題。
      • readInt4

        public int readInt4()
                     throws java.io.IOException
        同義字 readInt(),針對跨語言 WMQ API 相容性所提供。
        傳回:
        int 整數讀取
        擲出:
        java.io.IOException-如果 IO 有問題。
      • readLine

        public java.lang.String readLine ()
                                  throws java.io.IOException
        從訊息讀取一行文字。 從中所識別的字碼集進行轉換 characterSet,然後在已由 UTF 字串 \n、\r、\r、EOF 或 UTF 字串結尾終止的行中讀取。
        指定者:
        readLine 在介面中 java.io.DataInput
        傳回:
        the returned string , in Unicode.
        擲出:
        java.io.IOException-如果 IO 有問題。
      • readLong

        public long readLong ()
                      throws java.io.IOException
        從訊息緩衝區中的現行位置讀取整數。
        指定者:
        readLong 在介面中 java.io.DataInput
        傳回:
        大序排列法長 encoding等於 MQConstants.MQENC_INTEGER_NORMAL ,如果它等於 MQConstants.MQENC_INTEGER_REVERSED ,則為小序排列法長。
        擲出:
        java.io.IOException-如果編碼不等於其中任一值。
      • readInt8

        public long readInt8()
                      throws java.io.IOException
        與相同 readLong()。 為了跨語言 WMQ API 相容性而提供。
        傳回:
        大序排列法長 encoding等於 MQConstants.MQENC_INTEGER_NORMAL ,如果它等於 MQConstants.MQENC_INTEGER_REVERSED ,則為小序排列法長。
        擲出:
        java.io.IOException-如果編碼不等於其中任一值。
      • readShort

        public short readShort ()
                        throws java.io.IOException
        從訊息緩衝區中的現行位置讀取短訊息。
        指定者:
        readShort 在介面中 java.io.DataInput
        傳回:
        大序排列法的簡稱 encoding等於 MQConstants.MQENC_INTEGER_NORMAL ,如果它等於 MQConstants.MQENC_INTEGER_REVERSED ,則為小序排列法。
        擲出:
        java.io.IOException-如果編碼不等於其中任一值。
      • readInt2

        public short readInt2()
                       throws java.io.IOException
        與相同 readShort()。 為了跨語言 MQ API 相容性而提供。
        傳回:
        大序排列法的簡稱 encoding等於 MQConstants.MQENC_INTEGER_NORMAL ,如果它等於 MQConstants.MQENC_INTEGER_REVERSED ,則為小序排列法。
        擲出:
        java.io.IOException-如果 IO 有問題。
      • readUTF

        public java.lang.String readUTF ()
                                 throws java.io.IOException
        從訊息緩衝區中的現行位置讀取 UTF 格式字串。
        指定者:
        readUTF 在介面中 java.io.DataInput
        傳回:
        字串。
        擲出:
        java.io.IOException-如果 IO 有問題。
      • readUnsignedByte

        public int readUnsignedByte ()
                             throws java.io.IOException
        從訊息緩衝區中的現行位置讀取不帶正負號的位元組。
        指定者:
        readUnsignedByte 在介面中 java.io.DataInput
        傳回:
        包含值的整數。
        擲出:
        java.io.IOException-如果 IO 有問題。
      • readUnsignedShort

        public int readUnsignedShort ()
                              throws java.io.IOException
        從訊息緩衝區中的現行位置讀取不帶正負號的 short。
        指定者:
        readUnsignedShort 在介面中 java.io.DataInput
        傳回:
        包含大序排列法 short if encoding等於 MQConstants.MQENC_INTEGER_NORMAL ,如果它等於 MQConstants.MQENC_INTEGER_REVERSED ,則為小序排列法。
        擲出:
        java.io.IOException-如果編碼不等於其中任一值。
      • readUInt2

        public int readUInt2()
                      throws java.io.IOException
        與相同 readUnsignedShort(),針對跨語言 WMQ API 相容性所提供。
        傳回:
        包含大序排列法 short if encoding等於 MQConstants.MQENC_INTEGER_NORMAL ,如果它等於 MQConstants.MQENC_INTEGER_REVERSED ,則為小序排列法。
        擲出:
        java.io.IOException-如果 IO 有問題。
      • readString

        public java.lang.String readString (int length)
                                    throws java.io.IOException
        已淘汰。 使用 readStringOfCharLength(int)方法。
        讀取字碼集中由所識別的字串 characterSet並將其轉換為 Unicode。
        參數:
        length-要讀取的字元數 (可能與根據字碼集的位元組數不同,因為部分字碼集每個字元使用多個位元組)。
        傳回:
        a String in the appropriate codeset
        擲出:
        java.io.IOException
      • readDecimal2

        public short readDecimal2()
                           throws java.io.IOException
        讀取範圍介於 -999 到 999 之間的 2 位元組壓縮十進位數。
        傳回:
        大序排列法的簡稱 encoding等於 MQConstants.MQENC_DECIMAL_NORMAL 或小序排列法 (如果它等於 MQConstants.MQENC_DECIMAL_REVERSED)。
        擲出:
        java.io.IOException-如果 IO 有問題。
      • readDecimal4

        public int readDecimal4()
                         throws java.io.IOException
        讀取 4 位元組壓縮十進位數,範圍為 -9,999,999 至 9,999,999。
        傳回:
        大序排列法 int if encoding等於 MQConstants.MQENC_DECIMAL_NORMAL 或小序排列法 int (如果它等於 MQConstants.MQENC_DECIMAL_REVERSED)。
        擲出:
        java.io.IOException-如果 IO 有問題。
      • readDecimal8

        public long readDecimal8()
                          throws java.io.IOException
        讀取 8 位元組壓縮十進位數,範圍為 -999,999,999,999,999 至 999,999,999,999,999,999。
        傳回:
        大序排列法長 encoding等於 MQConstants.MQENC_DECIMAL_NORMAL 或小序排列法 (如果它等於 MQConstants.MQENC_DECIMAL_REVERSED)。
        擲出:
        java.io.IOException-如果 IO 有問題。
      • readObject

        public java.lang.Object readObject ()
                                    throws java.lang.ClassNotFoundException ,
                                           java.io.InvalidClassException ,
                                           java.io.StreamCorruptedException ,
                                           java.io.OptionalDataException ,
                                           java.io.IOException
        讀取訊息中所載的物件。
        傳回:
        物件。
        擲出:
        java.lang.ClassNotFoundException
        java.io.InvalidClassException
        java.io.StreamCorruptedException
        java.io.OptionalDataException
        java.io.IOException
      • skipBytes

        public int skipBytes (int n)
                      throws java.io.IOException ,
                             java.io.EOFException
        將游標在訊息緩衝區中向前移動。
        指定者:
        skipBytes 在介面中 java.io.DataInput
        參數:
        n-要移動的位元組數。
        傳回:
        實際移動的位元組數。
        擲出:
        java.io.IOException-如果 IO 有問題。
        java.io.EOFException-如果跳過超出檔案結尾。
      • 寫入

        public void write (int b)
                   throws java.io.IOException
        將位元組寫入現行位置的訊息緩衝區。
        指定者:
        write 在介面中 java.io.DataOutput
        參數:
        b-要寫入的位元組
        擲出:
        java.io.IOException-如果 IO 有問題。
      • 寫入

        public void write (byte [] b)
                   throws java.io.IOException
        將位元組陣列寫入現行位置的訊息緩衝區。
        指定者:
        write 在介面中 java.io.DataOutput
        參數:
        b-要寫入的陣列。
        擲出:
        java.io.IOException-如果 IO 有問題。
      • 寫入

        public void write (byte [] b ,
                          int off ,
                          int len)
                   throws java.io.IOException
        將一系列位元組寫入現行位置的訊息緩衝區。
        指定者:
        write 在介面中 java.io.DataOutput
        參數:
        b-從中寫入位元組的陣列。
        off-要寫入陣列中第一個位元組的偏移。
        len-要寫入的位元組數。
        擲出:
        java.io.IOException-如果 IO 有問題。
      • writeBoolean

        public void writeBoolean (boolean v)
                          throws java.io.IOException
        將布林寫入現行位置的訊息緩衝區。
        指定者:
        writeBoolean 在介面中 java.io.DataOutput
        參數:
        v-要寫入的布林。
        擲出:
        java.io.IOException-如果 IO 有問題。
      • writeByte

        public void writeByte (int v)
                       throws java.io.IOException
        將位元組寫入現行位置的訊息緩衝區。
        指定者:
        writeByte 在介面中 java.io.DataOutput
        參數:
        v-要寫入的位元組。
        擲出:
        java.io.IOException-如果 IO 有問題。
      • writeBytes

        public void writeBytes (java.lang.String s)
                        throws java.io.IOException
        已淘汰。 這會實作DataOutput.writeBytes(String)方法是 一般字串寫入常式-它會將字串中字元的低順序位元組寫入訊息,並捨棄高順序位元組。 (在 MQ中,很難看到需要的行為,但這是必要的,因為 MQMessage 會實作DataOutput介面。)
        此方法未執行任何資料轉換. 如果您想要將字串寫入訊息,並適當處理目前有效的字集,請使用 writeString(String) 而非此方法。
        以位元組序列形式將字串寫入現行位置的訊息緩衝區。

        指定者:
        writeBytes 在介面中 java.io.DataOutput
        參數:
        s-要寫入的字串。
        擲出:
        java.io.IOException-如果 IO 有問題。
      • writeChar

        public void writeChar (int v)
                       throws java.io.IOException
        在現行位置將 Unicode 字元寫入訊息緩衝區。
        指定者:
        writeChar 在介面中 java.io.DataOutput
        參數:
        v-要寫入的字元,以整數表示。
        擲出:
        java.io.IOException-如果 IO 有問題。
      • writeChars

        public void writeChars (java.lang.String s)
                        throws java.io.IOException
        將字串以 Unicode 字元序列寫入現行位置的訊息緩衝區。
        指定者:
        writeChars 在介面中 java.io.DataOutput
        參數:
        s-要寫入的字串。
        擲出:
        java.io.IOException-如果 IO 有問題。
      • writeDouble

        public void writeDouble (double v)
                         throws java.io.IOException
        將倍精準數寫入現行位置的訊息緩衝區。 此方法的行為取決於 encoding.

        MQConstants.MQENC_FLOAT_IEEE_NORMAL 及 MQENC_IEE_FLOAT_REVERSED 的值分別以大序排列法及小序排列法格式寫入 IEEE 標準浮點數。

        MQConstants.MQENC_FLOAT_S390 值會寫入zSeries格式化浮點數字。 請注意, IEEE 加倍的範圍大於zSeries倍精準度浮點數,且無法轉換非常大的數字。

        指定者:
        writeDouble 在介面中 java.io.DataOutput
        參數:
        v-要寫的雙份
        擲出:
        java.io.IOException-如果 IO 有問題。
      • writeFloat

        public void writeFloat (float v)
                        throws java.io.IOException
        將浮點數寫入現行位置的訊息緩衝區。 此方法的行為取決於 encoding.

        MQConstants.MQENC_FLOAT_IEEE_NORMAL 及 MQENC_IEE_FLOAT_REVERSED 的值分別以大序排列法及小序排列法格式寫入 IEEE 標準浮點數。

        MQConstants.MQENC_FLOAT_S390 值會寫入zSeries格式化浮點數字。 請注意, IEEE 加倍的範圍大於zSeries倍精準度浮點數,且無法轉換非常大的數字。

        指定者:
        writeFloat 在介面中 java.io.DataOutput
        參數:
        v-要寫的浮漂
        擲出:
        java.io.IOException-如果 IO 有問題。
      • writeInt

        public void writeInt (int v)
                      throws java.io.IOException
        將 int 寫入現行位置的訊息緩衝區。 此方法的行為取決於 encoding.

        MQConstants.MQENC_INTEGER_NORMAL 及 MQConstants.MQENC_INTEGER_REVERSED 的值分別以大序排列法及小序排列法格式寫入整數。

        指定者:
        writeInt 在介面中 java.io.DataOutput
        參數:
        v-要寫的整數。
        擲出:
        java.io.IOException-如果 IO 有問題。
      • writeInt4

        public void writeInt4(int v)
                       throws java.io.IOException
        同義字 writeInt(),針對跨語言 WMQ API 相容性所提供。
        參數:
        v-要寫的整數
        擲出:
        java.io.IOException-如果 IO 有問題。
      • writeLong

        public void writeLong (long v)
                       throws java.io.IOException
        在現行位置將長寫入訊息緩衝區。 此方法的行為取決於 encoding.

        MQConstants.MQENC_INTEGER_NORMAL 及 MQConstants.MQENC_INTEGER_REVERSED 分別以大序排列法及小序排列法格式撰寫 longs。

        指定者:
        writeLong 在介面中 java.io.DataOutput
        參數:
        v-要寫的長篇
        擲出:
        java.io.IOException-如果 IO 有問題。
      • writeInt8

        public void writeInt8(long v)
                       throws java.io.IOException
        同義字 writeLong(),針對跨語言 WMQ API 相容性所提供。
        參數:
        v-要寫的長篇
        擲出:
        java.io.IOException-如果 IO 有問題。
      • writeShort

        public void writeShort (int v)
                        throws java.io.IOException
        將短訊寫入現行位置的訊息緩衝區。 此方法的行為取決於 encoding.

        MQConstants.MQENC_INTEGER_NORMAL 及 MQConstants.MQENC_INTEGER_REVERSED 分別以大序排列法及小序排列法格式撰寫短褲的值。

        MQConstants.MQENC_FLOAT_S390 值會寫入zSeries格式化浮點數字。

        指定者:
        writeShort 在介面中 java.io.DataOutput
        參數:
        v-要寫的短文
        擲出:
        java.io.IOException-如果 IO 有問題。
      • writeInt2

        public void writeInt2(int v)
                       throws java.io.IOException
        與相同 writeShort(),針對跨語言 WMQ API 相容性所提供。
        參數:
        v-要寫的長篇
        擲出:
        java.io.IOException-如果 IO 有問題。
      • writeDecimal2

        public void writeDecimal2(short v)
                           throws java.io.IOException
        將 2 位元組壓縮十進位格式數字寫入現行位置的訊息緩衝區。 此方法的行為取決於 encoding。 MQConstants.MQENC_DECIMAL_NORMAL 值會寫入大序排列法聚集十進位, MQConstants.MQENC_DECIMAL_REVERSED 值會寫入小序排列法聚集十進位。
        參數:
        v-是要在範圍 -999 至 999 內寫入的數字。
        擲出:
        java.io.IOException-如果 IO 有問題。
      • writeDecimal4

        public void writeDecimal4(int v)
                           throws java.io.IOException
        將 4 位元組壓縮十進位格式數字寫入現行位置的訊息緩衝區。 此方法的行為取決於 encoding。 MQConstants.MQENC_DECIMAL_NORMAL 值會寫入大序排列法聚集十進位, MQConstants.MQENC_DECIMAL_REVERSED 值會寫入小序排列法聚集十進位。
        參數:
        v-是要寫入的數字,範圍為 -9,999,999 至 9,999,999。
        擲出:
        java.io.IOException-如果 IO 有問題。
      • writeDecimal8

        public void writeDecimal8(long v)
                           throws java.io.IOException
        將 8 位元組壓縮十進位格式數字寫入現行位置的訊息緩衝區。 此方法的行為取決於 encoding。 MQConstants.MQENC_DECIMAL_NORMAL 值會寫入大序排列法聚集十進位, MQConstants.MQENC_DECIMAL_REVERSED 值會寫入小序排列法聚集十進位。
        參數:
        v-是要寫入的整數,範圍為 -999,999,999,999,999 到 999,999,999,999,999,999。
        擲出:
        java.io.IOException-如果 IO 有問題。
      • writeUTF

        public void writeUTF (java.lang.String str)
                      throws java.io.IOException
        以 UTF 格式將字串寫入現行位置的訊息緩衝區。
        指定者:
        writeUTF 在介面中 java.io.DataOutput
        參數:
        str-要寫入的字串。
        擲出:
        java.io.IOException-如果 IO 有問題。
      • writeString

        public void writeString (java.lang.String s)
                         throws java.io.IOException
        將 java.lang.String 寫入現行位置的訊息緩衝區,並使用所識別的編碼字集來編碼它 characterSet.

        如果 characterSet 設為預設值 MQCCSI_Q_MGR ,則用來編碼 java.lang.String 的編碼字集取決於應用程式執行所在的平台:

        • 如果應用程式在 z/OS上執行,則會使用編碼字集 ID 500 來編碼 java.lang.String。
        • 對於所有其他平台, java.lang.String 將使用編碼字集 ID 819 來編碼。
        參數:
        s-要寫入的 java.lang.String。
        擲出:
        java.io.IOException-如果 IO 有問題。
      • writeObject

        public void writeObject (java.lang.Object obj)
                         throws java.io.IOException
        將物件寫入訊息。
        參數:
        obj-要寫入的物件。
        擲出:
        java.io.IOException-如果 IO 有問題。
      • getPropertyValidation

        public int getPropertyValidation ()
        指定是否應在設定訊息內容時驗證內容。 可能的值為:
        • MQCMHO_DEFAULT_VALIDATION ,預設值
        • MQ 指令 _ 驗證
        • MQCMHO_NO_VALIDATION
        傳回:
        true是否將進行內容驗證
      • setPropertyValidation

        public void setPropertyValidation (int propertyValidation)
        指定是否應在設定訊息內容時驗證內容。 可能的值為:
        • MQCMHO_DEFAULT_VALIDATION ,預設值
        • MQ 指令 _ 驗證
        • MQCMHO_NO_VALIDATION
        參數:
        propertyValidation-設為true是否應進行內容驗證
      • setBooleanProperty

        public void setBooleanProperty (java.lang.String name ,
                                       布林值)
                                throws MQException
        使用預設內容描述子,在訊息中設定具有指定名稱的布林內容值。
        參數:
        name-布林內容的名稱。
        value-要設定的布林內容值。
        擲出:
        MQException-如果內容名稱無效。
      • setBooleanProperty

        public void setBooleanProperty (java.lang.String name ,
                                       MQPropertyDescriptor 描述子,
                                       布林值)
                                throws MQException
        使用指定的內容描述子,在訊息中設定具有指定名稱的布林內容值。
        參數:
        name-布林內容的名稱。
        descriptor-內容本身的屬性。
        value-要設定的布林內容值。
        擲出:
        MQException-如果內容名稱無效。
      • setBytesProperty

        public void setBytesProperty (java.lang.String name ,
                                     byte [] value)
                              throws MQException
        使用預設內容描述子,在訊息中設定具有指定名稱的位元組陣列內容值。
        參數:
        name-位元組陣列內容的名稱。
        value-要設定的位元組陣列內容值。
        擲出:
        MQException-如果內容名稱無效。
      • setBytesProperty

        public void setBytesProperty (java.lang.String name ,
                                     MQPropertyDescriptor 描述子,
                                     byte [] value)
                              throws MQException
        使用指定的內容描述子,在訊息中設定具有指定名稱的位元組陣列內容值。
        參數:
        name-位元組陣列內容的名稱。
        descriptor-內容本身的屬性。
        value-要設定的位元組陣列內容值。
        擲出:
        MQException-如果內容名稱無效。
      • setByteProperty

        public void setByteProperty (java.lang.String name ,
                                    位元組值)
                             throws MQException
        使用預設內容描述子,在訊息中設定具有指定名稱的位元組內容值。
        參數:
        name-位元組內容的名稱。
        value-要設定的位元組內容值。
        擲出:
        MQException-如果內容名稱無效。
      • setByteProperty

        public void setByteProperty (java.lang.String name ,
                                    MQPropertyDescriptor 描述子,
                                    位元組值)
                             throws MQException
        使用指定的內容描述子,在訊息中設定具有指定名稱的位元組內容值。
        參數:
        name-位元組內容的名稱。
        descriptor-內容本身的屬性。
        value-要設定的位元組內容值。
        擲出:
        MQException-如果內容名稱無效。
      • setShortProperty

        public void setShortProperty (java.lang.String name ,
                                     短值)
                              throws MQException
        使用預設內容描述子,在訊息中設定具有指定名稱的簡短內容值。
        參數:
        name-簡短內容的名稱。
        value-要設定的簡短內容值。
        擲出:
        MQException-如果內容名稱無效。
      • setShortProperty

        public void setShortProperty (java.lang.String name ,
                                     MQPropertyDescriptor 描述子,
                                     短值)
                              throws MQException
        使用指定的內容描述子,在訊息中設定具有指定名稱的簡短內容值。
        參數:
        name-簡短內容的名稱。
        descriptor-內容本身的屬性。
        value-要設定的簡短內容值。
        擲出:
        MQException-如果內容名稱無效。
      • setInt2Property

        public void setInt2Property(java.lang.String name ,
                                    短值)
                             throws MQException
        同義字 setShortProperty(String, short),針對跨語言 IBM MQ API 相容性提供。
        參數:
        name-簡短內容的名稱。
        value-要設定的簡短內容值。
        擲出:
        MQException-如果內容名稱無效。
      • setIntProperty

        public void setIntProperty (java.lang.String name ,
                                   int value)
                            throws MQException
        使用預設內容描述子,在訊息中設定具有指定名稱的 int 內容值。
        參數:
        name-int 內容的名稱。
        value-要設定的 int 內容值。
        擲出:
        MQException-如果內容名稱無效。
      • setIntProperty

        public void setIntProperty (java.lang.String name ,
                                   MQPropertyDescriptor 描述子,
                                   int value)
                            throws MQException
        使用指定的內容描述子,在訊息中設定具有指定名稱的 int 內容值。
        參數:
        name-int 內容的名稱。
        descriptor-內容本身的屬性。
        value-要設定的 int 內容值。
        擲出:
        MQException-如果內容名稱無效。
      • setInt4Property

        public void setInt4Property(java.lang.String name ,
                                    int value)
                             throws MQException
        同義字 setIntProperty(String, int),針對跨語言 IBM MQ API 相容性提供。
        參數:
        name-int 內容的名稱。
        value-要設定的 int 內容值。
        擲出:
        MQException-如果內容名稱無效。
      • setLongProperty

        public void setLongProperty (java.lang.String name ,
                                    long 值)
                             throws MQException
        使用預設內容描述子,在訊息中設定具有指定名稱的長內容值。
        參數:
        name-長內容的名稱。
        value-要設定的 long 內容值。
        擲出:
        MQException-如果內容名稱無效。
      • setLongProperty

        public void setLongProperty (java.lang.String name ,
                                    MQPropertyDescriptor 描述子,
                                    long 值)
                             throws MQException
        使用指定的內容描述子,在訊息中設定具有指定名稱的長內容值。
        參數:
        name-長內容的名稱。
        descriptor-內容本身的屬性。
        value-要設定的 long 內容值。
        擲出:
        MQException-如果內容名稱無效。
      • setInt8Property

        public void setInt8Property(java.lang.String name ,
                                    long 值)
                             throws MQException
        同義字 setLongProperty(String, long),針對跨語言 IBM MQ API 相容性提供。
        參數:
        name-長內容的名稱。
        value-要設定的 long 內容值。
        擲出:
        MQException-如果內容名稱無效。
      • setFloatProperty

        public void setFloatProperty (java.lang.String name ,
                                     浮點值)
                              throws MQException
        使用預設內容描述子,在訊息中設定具有指定名稱的浮點內容值。
        參數:
        name-浮點內容的名稱。
        value-要設定的浮點內容值。
        擲出:
        MQException-如果內容名稱無效。
      • setFloatProperty

        public void setFloatProperty (java.lang.String name ,
                                     MQPropertyDescriptor 描述子,
                                     浮點值)
                              throws MQException
        使用指定的內容描述子,在訊息中設定具有指定名稱的浮點內容值。
        參數:
        name-浮點內容的名稱。
        descriptor-內容本身的屬性。
        value-要設定的浮點內容值。
        擲出:
        MQException-如果內容名稱無效。
      • setDoubleProperty

        public void setDoubleProperty (java.lang.String name ,
                                      倍精準數值)
                               throws MQException
        使用預設內容描述子,在訊息中設定具有指定名稱的倍精準數內容值。
        參數:
        name-double 內容的名稱。
        value-要設定的 double 內容值。
        擲出:
        MQException-如果內容名稱無效。
      • setDoubleProperty

        public void setDoubleProperty (java.lang.String name ,
                                      MQPropertyDescriptor 描述子,
                                      倍精準數值)
                               throws MQException
        使用指定的內容描述子,在訊息中設定具有指定名稱的倍精準數內容值。
        參數:
        name-double 內容的名稱。
        descriptor-內容本身的屬性。
        value-要設定的 double 內容值。
        擲出:
        MQException-如果內容名稱無效。
      • setStringProperty

        public void setStringProperty (java.lang.String name ,
                                      java.lang.String 值)
                               throws MQException
        使用預設內容描述子,在訊息中設定具有指定名稱的「字串」內容值。
        參數:
        name-String 內容的名稱。
        value-要設定的 String 內容值。
        擲出:
        MQException-如果內容名稱無效。
      • setStringProperty

        public void setStringProperty (java.lang.String name ,
                                      MQPropertyDescriptor 描述子,
                                      java.lang.String 值)
                               throws MQException
        使用指定的內容描述子,在訊息中設定具有指定名稱的「字串」內容值。
        參數:
        name-String 內容的名稱。
        descriptor-內容本身的屬性。
        value-要設定的 String 內容值。
        擲出:
        MQException-如果內容名稱無效。
      • setObjectProperty

        public void setObjectProperty (java.lang.String name ,
                                      java.lang.Object 值)
                               throws MQException
        使用預設內容描述子,在訊息中設定具有指定名稱的 Java 物件內容值。 請注意,此方法僅適用於已物件化初始物件類型 (整數、倍精準數、長整數 ...) 及 String 物件。 內容的設定如同已直接呼叫 set * Property 方法一樣,例如 Integer 會導致設定 int 內容值, Long 會導致設定 long 內容值等。
        參數:
        name-Java 物件內容的名稱。
        value-要設定的 Java 物件內容值。
        擲出:
        MQException-如果內容名稱無效。
      • setObjectProperty

        public void setObjectProperty (java.lang.String name ,
                                      MQPropertyDescriptor 描述子,
                                      java.lang.Object 值)
                               throws MQException
        使用指定的內容描述子,在訊息中設定具有指定名稱的 Java 物件內容值。 請注意,此方法僅適用於已物件化初始物件類型 (整數、倍精準數、長整數 ...) 及 String 物件。 內容的設定如同已直接呼叫 set * Property 方法一樣,例如 Integer 會導致設定 int 內容值, Long 會導致設定 long 內容值等。
        參數:
        name-Java 物件內容的名稱。
        descriptor-內容本身的屬性。
        value-要設定的 Java 物件內容值。
        擲出:
        MQException-如果內容名稱無效。
      • getBooleanProperty

        public boolean getBooleanProperty (java.lang.String name)
                                   throws MQException
        傳回具有指定名稱之布林內容的值。
        參數:
        name-布林內容的名稱。
        傳回:
        指定名稱的布林內容值; 如果沒有此名稱的內容,則會擲出 MQException。
        擲出:
        MQException-如果內容不存在或類型轉換無效。
      • getBooleanProperty

        public boolean getBooleanProperty (java.lang.String name ,
                                          MQPropertyDescriptor 描述子)
                                   throws MQException
        傳回具有指定名稱的布林內容值,並填寫指定的內容描述子。
        參數:
        name-布林內容的名稱。
        descriptor-內容本身的屬性。
        傳回:
        指定名稱的布林內容值; 如果沒有此名稱的內容,則會擲出 MQException。
        擲出:
        MQException-如果內容不存在或類型轉換無效。
      • getBytesProperty

        public byte [] getBytesProperty (java.lang.String name)
                                throws MQException
        傳回具有指定名稱之位元組陣列內容的值。
        參數:
        name-位元組陣列內容的名稱。
        傳回:
        所指定名稱的位元組陣列內容值; 如果沒有此名稱的內容,則會擲出 MQException。
        擲出:
        MQException-如果內容不存在或類型轉換無效。
      • getBytesProperty

        public byte [] getBytesProperty (java.lang.String name ,
                                       MQPropertyDescriptor 描述子)
                                throws MQException
        傳回具有指定名稱之位元組陣列內容的值,並填入指定的內容描述子。
        參數:
        name-位元組陣列內容的名稱。
        descriptor-內容本身的屬性。
        傳回:
        所指定名稱的位元組陣列內容值; 如果沒有此名稱的內容,則會擲出 MQException。
        擲出:
        MQException-如果內容不存在或類型轉換無效。
      • getByteProperty

        public byte getByteProperty (java.lang.String name)
                             throws MQException
        傳回具有指定名稱之位元組內容的值。
        參數:
        name-位元組內容的名稱。
        傳回:
        指定名稱的位元組內容值; 如果沒有此名稱的內容,則會擲出 MQException。
        擲出:
        MQException-如果內容不存在或類型轉換無效。
      • getByteProperty

        public byte getByteProperty (java.lang.String name ,
                                    MQPropertyDescriptor 描述子)
                             throws MQException
        傳回具有指定名稱之位元組內容的值,並填入指定的內容描述子。
        參數:
        name-位元組內容的名稱。
        descriptor-內容本身的屬性。
        傳回:
        指定名稱的位元組內容值; 如果沒有此名稱的內容,則會擲出 MQException。
        擲出:
        MQException-如果內容不存在或類型轉換無效。
      • getShortProperty

        public short getShortProperty (java.lang.String name)
                               throws MQException
        傳回具有指定名稱之簡短內容的值。
        參數:
        name-簡短內容的名稱。
        傳回:
        指定名稱的簡短內容值; 如果沒有此名稱的內容,則會擲出 MQException。
        擲出:
        MQException-如果內容不存在或類型轉換無效。
      • getShortProperty

        public short getShortProperty (java.lang.String name ,
                                      MQPropertyDescriptor 描述子)
                               throws MQException
        傳回具有指定名稱的簡短內容值,並填寫指定的內容描述子。
        參數:
        name-簡短內容的名稱。
        descriptor-內容本身的屬性。
        傳回:
        指定名稱的簡短內容值; 如果沒有此名稱的內容,則會擲出 MQException。
        擲出:
        MQException-如果內容不存在或類型轉換無效。
      • getInt2Property

        public short getInt2Property(java.lang.String name)
                              throws MQException
        同義字 getShortProperty(String),針對跨語言 IBM MQ API 相容性提供。
        參數:
        name-簡短內容的名稱。
        傳回:
        指定名稱的簡短內容值; 如果沒有此名稱的內容,則會擲出 MQException。
        擲出:
        MQException-如果內容不存在或類型轉換無效。
      • getInt2Property

        public short getInt2Property(java.lang.String name ,
                                     MQPropertyDescriptor 描述子)
                              throws MQException
        同義字 getShortProperty(String, MQPropertyDescriptor),針對跨語言 IBM MQ API 相容性提供。
        參數:
        name-簡短內容的名稱。
        descriptor-內容本身的屬性。
        傳回:
        指定名稱的簡短內容值; 如果沒有此名稱的內容,則會擲出 MQException。
        擲出:
        MQException-如果內容不存在或類型轉換無效。
      • getIntProperty

        public int getIntProperty (java.lang.String name)
                           throws MQException
        傳回具有指定名稱之 int 內容的值。
        參數:
        name-int 內容的名稱。
        傳回:
        指定名稱的 int 內容值; 如果沒有此名稱的內容,則會擲出 MQException。
        擲出:
        MQException-如果內容不存在或類型轉換無效。
      • getIntProperty

        public int getIntProperty (java.lang.String name ,
                                  MQPropertyDescriptor 描述子)
                           throws MQException
        傳回具有指定名稱的 int 內容值,並填入指定的內容描述子。
        參數:
        name-int 內容的名稱。
        descriptor-內容本身的屬性。
        傳回:
        指定名稱的 int 內容值; 如果沒有此名稱的內容,則會擲出 MQException。
        擲出:
        MQException-如果內容不存在或類型轉換無效。
      • getInt4Property

        public int getInt4Property(java.lang.String name)
                            throws MQException
        同義字 getIntProperty(String),針對跨語言 IBM MQ API 相容性提供。
        參數:
        name-int 內容的名稱。
        傳回:
        指定名稱的 int 內容值; 如果沒有此名稱的內容,則會擲出 MQException。
        擲出:
        MQException-如果內容不存在或類型轉換無效。
      • getInt4Property

        public int getInt4Property(java.lang.String name ,
                                   MQPropertyDescriptor 描述子)
                            throws MQException
        同義字 getIntProperty(String, MQPropertyDescriptor),針對跨語言 IBM MQ API 相容性提供。
        參數:
        name-int 內容的名稱。
        descriptor-內容本身的屬性。
        傳回:
        指定名稱的 int 內容值; 如果沒有此名稱的內容,則會擲出 MQException。
        擲出:
        MQException-如果內容不存在或類型轉換無效。
      • getLongProperty

        public long getLongProperty (java.lang.String name)
                             throws MQException
        傳回具有指定名稱之 long 內容的值。
        參數:
        name-長內容的名稱。
        傳回:
        指定名稱的長內容值; 如果沒有此名稱的內容,則會擲出 MQException。
        擲出:
        MQException-如果內容不存在或類型轉換無效。
      • getLongProperty

        public long getLongProperty (java.lang.String name ,
                                    MQPropertyDescriptor 描述子)
                             throws MQException
        傳回具有指定名稱之 long 內容的值,並填入指定的內容描述子。
        參數:
        name-長內容的名稱。
        descriptor-內容本身的屬性。
        傳回:
        指定名稱的長內容值; 如果沒有此名稱的內容,則會擲出 MQException。
        擲出:
        MQException-如果內容不存在或類型轉換無效。
      • getInt8Property

        public long getInt8Property(java.lang.String name)
                             throws MQException
        同義字 getLongProperty(String),針對跨語言 IBM MQ API 相容性提供。
        參數:
        name-長內容的名稱。
        傳回:
        指定名稱的長內容值; 如果沒有此名稱的內容,則會擲出 MQException。
        擲出:
        MQException-如果內容不存在或類型轉換無效。
      • getInt8Property

        public long getInt8Property(java.lang.String name ,
                                    MQPropertyDescriptor 描述子)
                             throws MQException
        同義字 getLongProperty(String, MQPropertyDescriptor),針對跨語言 IBM MQ API 相容性提供。
        參數:
        name-長內容的名稱。
        descriptor-內容本身的屬性。
        傳回:
        指定名稱的長內容值; 如果沒有此名稱的內容,則會擲出 MQException。
        擲出:
        MQException-如果內容不存在或類型轉換無效。
      • getFloatProperty

        public float getFloatProperty (java.lang.String name)
                               throws MQException
        傳回具有指定名稱之浮點內容的值。
        參數:
        name-浮點內容的名稱。
        傳回:
        指定名稱的浮點內容值; 如果沒有此名稱的內容,則會擲出 MQException。
        擲出:
        MQException-如果內容不存在或類型轉換無效。
      • getFloatProperty

        public float getFloatProperty (java.lang.String name ,
                                      MQPropertyDescriptor 描述子)
                               throws MQException
        傳回具有指定名稱的浮點內容值,並填入指定的內容描述子。
        參數:
        name-浮點內容的名稱。
        descriptor-內容本身的屬性。
        傳回:
        指定名稱的浮點內容值; 如果沒有此名稱的內容,則會擲出 MQException。
        擲出:
        MQException-如果內容不存在或類型轉換無效。
      • getDoubleProperty

        public double getDoubleProperty (java.lang.String name)
                                 throws MQException
        傳回具有指定名稱之 double 內容的值。
        參數:
        name-double 內容的名稱。
        傳回:
        指定名稱的 double 內容值; 如果沒有此名稱的內容,則會擲出 MQException。
        擲出:
        MQException-如果內容不存在或類型轉換無效。
      • getDoubleProperty

        public double getDoubleProperty (java.lang.String name ,
                                        MQPropertyDescriptor 描述子)
                                 throws MQException
        傳回具有指定名稱的 double 內容值,並填入指定的內容描述子。
        參數:
        name-double 內容的名稱。
        descriptor-內容本身的屬性。
        傳回:
        指定名稱的 double 內容值; 如果沒有此名稱的內容,則會擲出 MQException。
        擲出:
        MQException-如果內容不存在或類型轉換無效。
      • getStringProperty

        public java.lang.String getStringProperty (java.lang.String name)
                                           throws MQException
        傳回具有指定名稱之 String 內容的值。
        參數:
        name-String 內容的名稱。
        傳回:
        指定名稱的 String 內容值; 如果沒有此名稱的內容,則會擲出 MQException。
        擲出:
        MQException-如果內容不存在或類型轉換無效。
      • getStringProperty

        public java.lang.String getStringProperty (java.lang.String name ,
                                                  MQPropertyDescriptor 描述子)
                                           throws MQException
        傳回具有指定名稱之 String 內容的值,並填入指定的內容描述子。
        參數:
        name-String 內容的名稱。
        descriptor-內容本身的屬性。
        傳回:
        指定名稱的 String 內容值; 如果沒有此名稱的內容,則會擲出 MQException。
        擲出:
        MQException-如果內容不存在或類型轉換無效。
      • getObjectProperty

        public java.lang.Object getObjectProperty (java.lang.String name)
                                           throws MQException
        傳回具有指定名稱之 Java 物件內容的值。 此方法可用來以物件化格式傳回物件,該物件已儲存為訊息中具有對等項目的內容 setObjectProperty(String, Object) 方法呼叫,或其對等基本元素#set*Property方法。
        參數:
        name-Java 物件內容的名稱。
        傳回:
        指定名稱的 Java 物件內容值,採用物件化格式 (例如,如果內容設為 int ,則會傳回整數); 如果沒有此名稱的內容,則會擲出 MQException。
        擲出:
        MQException-如果內容不存在
      • getObjectProperty

        public java.lang.Object getObjectProperty (java.lang.String name ,
                                                  MQPropertyDescriptor 描述子)
                                           throws MQException
        傳回具有指定名稱之 Java 物件內容的值,並填入指定的內容描述子。 此方法可用來以物件化格式傳回物件,該物件已儲存為訊息中具有對等項目的內容 setObjectProperty(String, Object) 方法呼叫,或其對等基本元素#set*Property方法。
        參數:
        name-Java 物件內容的名稱。
        descriptor-內容本身的屬性。
        傳回:
        指定名稱的 Java 物件內容值,採用物件化格式 (例如,如果內容設為 int ,則會傳回整數); 如果沒有此名稱的內容,則會擲出 MQException。
        擲出:
        MQException-如果內容不存在
      • getPropertyNames

        public java.util.Enumeration<java.lang.String> getPropertyNames(java.lang.String nameP)
                                                                 throws MQException
        傳回符合指定名稱之所有內容名稱的列舉。 可以在名稱結尾使用萬用字元 "%" 來過濾訊息的內容,以符合零個以上字元 (包括 ".")。 來區隔。
        參數:
        nameP-要比對的內容名稱。
        傳回:
        內容名稱符合指定名稱之內容值的所有名稱列舉。
        擲出:
        MQException-如果內容名稱無效。
      • deleteProperty

        public void deleteProperty (java.lang.String nameP)
                            throws MQException
        從訊息中刪除具有指定名稱的內容。
        參數:
        nameP-要刪除的內容名稱。
        擲出:
        MQException-如果內容名稱無效或不存在。
© Copyright IBM Corp. 2008 , 2016. All Rights Reserved.