com.ibm.mq

类 MQMessage

  • java.lang.Object
  • 所有已实现的接口：
    java.io.DataInput, java.io.DataOutput

    公共类 MQMessage
扩展 MQMD
实现 java.io.DataInput, java.io.DataOutput
    MQMessage 表示 IBM MQ 消息的消息描述符和数据。 它具有一组用于从消息中读取数据的方法和一组用于将数据写入消息的方法。 这些读写方法所使用的数字和字符串的格式由 encoding和 characterSet 字段控制。 其余字段包含在消息在发送和接收应用程序之间传递时伴随应用程序消息数据的控制信息。

    • 构造函数详细信息

      • MQMessage

        public MQMessage ()
        缺省构造函数。 这将创建具有缺省消息描述符信息和空消息缓冲区的消息。

    • 方法详细信息

      • getTotalMessageLength

        公共 int getTotalMessageLength()
        获取消息中存储在保存此消息的消息队列上的总字节数。 当 MQQueue.get()方法失败并带有指示消息已截断的错误代码时，此方法将报告队列中消息的总大小。
        返回：
        消息中的总字节数

      • getMessageLength

        公共 int getMessageLength()
                     抛出 java.io.IOException
        获取此消息中消息数据的字节数。
        返回：
        字节数。
        抛出：
        java.io.IOException -如果 IO 存在问题。

      • getDataLength

        公共 int getDataLength()
                  抛出 java.io.IOException
        获取要读取的剩余消息数据的字节数。
        返回：
        int 剩余字节数
        抛出：
        java.io.IOException -如果 IO 存在问题。

      • 搜索

        public void seek (int seekOffset)
          抛出 java.io.EOFException
        将光标移至消息缓冲区中的新绝对位置。 后续读和写将从缓冲区中的此位置开始。
        参数：
        seekOffset -光标位置的新值。
        抛出：
        java.io.EOFException -如果偏移量将光标置于消息数据之外。

      • setDataOffset

        public void setDataOffset(int offset)
                   抛出 java.io.EOFException
        将光标移至消息缓冲区中的新绝对位置。 此方法与 seek()相同，提供此方法是为了实现与其他 WMQ API 的跨语言兼容性。
        参数：
        offset -光标位置的新值。
        抛出：
        java.io.EOFException -如果偏移量将光标置于消息数据之外。

      • getDataOffset

        public int getDataOffset()
                  抛出 java.io.IOException
        返回消息数据中的当前光标位置 (读写操作生效的点)。
        返回：
        光标位置。
        抛出：
        java.io.IOException -如果 IO 存在问题。

      • clearMessage

        public void clearMessage()
                  抛出 java.io.IOException
        废弃消息缓冲区中的任何数据并将光标位置设置为零。
        抛出：
        java.io.IOException -如果 IO 存在问题。

      • resizeBuffer

        public void resizeBuffer(int size)
                  抛出 java.io.IOException
        向 MQMessage 类指示可能需要的缓冲区大小。 如果消息当前包含消息数据，并且新大小小于当前大小，那么将截断消息数据。 如果此消息随后与 MQQueue.get(MQMessage, MQGetMessageOptions) 配合使用，那么这是为获取请求分配的缓冲区大小。
        参数：
        size -缓冲区的新大小
        抛出：
        java.io.IOException -如果 IO 存在问题。

      • readBoolean

        public boolean readBoolean()
                    抛出 java.io.IOException
                           java.io.EOFException
        从消息缓冲区中的当前位置读取布尔值。
        指定者：
        readBoolean在接口中java.io.DataInput
        返回：
        布尔值。
        抛出：
        java.io.IOException -如果 IO 存在问题。
        java.io.EOFException -如果读取超出文件末尾。

      • readByte

        public byte readByte()
              抛出 java.io.IOException
                     java.io.EOFException
        从消息缓冲区中的当前位置读取字节。
        指定者：
        readByte在接口中java.io.DataInput
        返回：
        (已签名) 字节。
        抛出：
        java.io.IOException -如果 IO 存在问题。
        java.io.EOFException -如果读取超出文件末尾。

      • readChar

        public char readChar()
              抛出 java.io.IOException
                     java.io.EOFException
        从消息缓冲区中的当前位置读取字符。
        指定者：
        readChar在接口中java.io.DataInput
        返回：
        Unicode 字符。
        抛出：
        java.io.IOException -如果 IO 存在问题。
        java.io.EOFException -如果读取超出文件末尾。

      • readDouble

        public double readDouble()
                  抛出 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()
                抛出 java.io.IOException
                       java.io.EOFException
        从消息缓冲区中的当前位置读取浮点数。
        指定者：
        readFloat在接口中java.io.DataInput
        返回：
        大尾数法浮点型 (如果 encoding等于 MQConstants.MQENC_INTEGER_NORMAL) ，小尾数法浮点型 (如果它等于 MQConstants.MQENC_INTEGER_REVERSED) 或小尾数法浮点型 (如果它等于 MQConstants.MQENC_INTEGER_REVERSED)zSeries格式化浮点数 (如果它等于 MQConstants.MQENC_FLOAT_S390)。
        抛出：
        java.io.IOException -如果编码都不是这些编码。
        java.io.EOFException -如果读取超出文件末尾。

      • readFully

        public void readFully(byte[] b)
               抛出 java.io.IOException
        使用来自消息缓冲区的数据填充字节数组。
        指定者：
        readFully在接口中java.io.DataInput
        参数：
        b -字节数组。
        抛出：
        java.io.IOException -如果 IO 存在问题。

      • readFully

        public void readFully(byte[])b、
                      英特关，
                      整数)
               抛出 java.io.IOException
        部分使用消息缓冲区中的数据填充字节数组。
        指定者：
        readFully在接口中java.io.DataInput
        参数：
        b -字节数组。
        off -读取开始的消息缓冲区的偏移量。
        len -要读取的字节数。
        抛出：
        java.io.IOException -如果 IO 存在问题。

      • readStringOfByteLength

        public java.lang.String readStringOfByteLength(int numberOfBytes)
                                        抛出 java.io.IOException
                                               java.io.EOFException
        读取指定数量的字节，并使用它们通过 characterSet指定的字符集来构造新字符串。 当给定的字节在给定的字符集中无效时，此方法的行为取决于 JRE 的实现。

        在已知字符串的字节长度的情况下，应该在此方法的单次调用中读取整个字符串，从而避免出现字节和字符边界不一致的问题。

        参数：
        numberOfBytes -要读取的字节数。
        返回：
        字符串。
        抛出：
        java.io.IOException -如果 IO 存在问题。
        java.io.EOFException -如果读取超出文件末尾。

      • readStringOfCharLength

        public java.lang.String readStringOfCharLength(int numberOfChars)
                                        抛出 java.io.IOException
                                               java.io.EOFException
        读取 characterSet标识的代码集中的字符串，并将其转换为 Unicode。
        参数：
        numberOfChars -要读取的字符数 (根据代码集可能与字节数不同，因为某些代码集每个字符使用多个字节)。
        返回：
        字符串。
        抛出：
        java.io.IOException -如果 IO 存在问题。
        java.io.EOFException -如果读取超出文件末尾。

      • readInt

        公共 int readInt()
            抛出 java.io.IOException
        从消息缓冲区中的当前位置读取整数。
        指定者：
        readInt在接口中java.io.DataInput
        返回：
        大尾数法整数 (如果 encoding等于 MQConstants.MQENC_INTEGER_NORMAL) 或小尾数法整数 (如果它等于 MQConstants.MQENC_INTEGER_REVERSED)。
        抛出：
        java.io.IOException -如果 IO 存在问题。

      • readInt4

        public int readInt4()
             抛出 java.io.IOException
        readInt()的同义词，提供此同义词是为了实现跨语言 WMQ API 兼容性。
        返回：
        int 读取的整数
        抛出：
        java.io.IOException -如果 IO 存在问题。

      • readLine

        public java.lang.String readLine()
                          抛出 java.io.IOException
        从消息中读取文本行。 从 characterSet中标识的代码集转换，然后在已终止的行中读取 \n ， \r ， \r \n EOF 或 UTF 字符串的结尾。
        指定者：
        readLine在接口中java.io.DataInput
        返回：
        返回的字符串 (Unicode)。
        抛出：
        java.io.IOException -如果 IO 存在问题。

      • readLong

        public long readLong()
              抛出 java.io.IOException
        从消息缓冲区中的当前位置读取整数。
        指定者：
        readLong在接口中java.io.DataInput
        返回：
        大尾数法 (如果 encoding等于 MQConstants.MQENC_INTEGER_NORMAL) 或小尾数法 (如果它等于 MQConstants.MQENC_INTEGER_REVERSED)。
        抛出：
        java.io.IOException -如果编码不等于其中任何一个值。

      • readInt8

        public long readInt8()
              抛出 java.io.IOException
        与 readLong()相同。 为实现跨语言 WMQ API 兼容性而提供。
        返回：
        大尾数法 (如果 encoding等于 MQConstants.MQENC_INTEGER_NORMAL) 或小尾数法 (如果它等于 MQConstants.MQENC_INTEGER_REVERSED)。
        抛出：
        java.io.IOException -如果编码不等于其中任何一个值。

      • readShort

        public short readShort()
                抛出 java.io.IOException
        从消息缓冲区中的当前位置读取短信息。
        指定者：
        readShort在接口中java.io.DataInput
        返回：
        大尾数法短 (如果 encoding等于 MQConstants.MQENC_INTEGER_NORMAL) 或小尾数法短 (如果它等于 MQConstants.MQENC_INTEGER_REVERSED)。
        抛出：
        java.io.IOException -如果编码不等于其中任何一个值。

      • readInt2

        公用短 readInt2()
               抛出 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()
                         抛出 java.io.IOException
        从消息缓冲区中的当前位置读取 UTF 格式字符串。
        指定者：
        readUTF在接口中java.io.DataInput
        返回：
        字符串。
        抛出：
        java.io.IOException -如果 IO 存在问题。

      • readUnsignedByte

        公共 int readUnsignedByte()
                     抛出 java.io.IOException
        从消息缓冲区中的当前位置读取无符号字节。
        指定者：
        readUnsignedByte在接口中java.io.DataInput
        返回：
        包含值的整数。
        抛出：
        java.io.IOException -如果 IO 存在问题。

      • readUnsignedShort

        公共 int readUnsignedShort()
                      抛出 java.io.IOException
        从消息缓冲区中的当前位置读取无符号短信息。
        指定者：
        readUnsignedShort在接口中java.io.DataInput
        返回：
        包含大尾数法短整型 (如果 encoding等于 MQConstants.MQENC_INTEGER_NORMAL) 或小尾数法短整型 (如果它等于 MQConstants.MQENC_INTEGER_REVERSED)。
        抛出：
        java.io.IOException -如果编码不等于其中任何一个值。

      • readUInt2

        public int readUInt2()
              抛出 java.io.IOException
        与为实现跨语言 WMQ API 兼容性而提供的 readUnsignedShort()相同。
        返回：
        包含大尾数法短整型 (如果 encoding等于 MQConstants.MQENC_INTEGER_NORMAL) 或小尾数法短整型 (如果它等于 MQConstants.MQENC_INTEGER_REVERSED)。
        抛出：
        java.io.IOException -如果 IO 存在问题。

      • readString

        public java.lang.String readString(int length)
                            抛出 java.io.IOException
        不推荐使用。 请改为使用 readStringOfCharLength(int)方法。
        读取 characterSet标识的代码集中的字符串，并将其转换为 Unicode。
        参数：
        length -要读取的字符数 (根据代码集，这可能与字节数不同，因为某些代码集每个字符使用多个字节)。
        返回：
        相应代码集中的字符串
        抛出：
        java.io.IOException

      • readDecimal2

        public short readDecimal2()
                   抛出 java.io.IOException
        读取范围在 -999 到 999 之间的 2 字节压缩十进制数。
        返回：
        大尾数法短整型 (如果 encoding等于 MQConstants.MQENC_DECIMAL_NORMAL ) 或小尾数法短整型 (如果它等于 MQConstants.MQENC_DECIMAL_REVERSED)。
        抛出：
        java.io.IOException -如果 IO 存在问题。

      • readDecimal4

        public int readDecimal4()
                 抛出 java.io.IOException
        读取 -9,999,999 至 9,999,999 范围内的 4 字节打包十进制数。
        返回：
        大尾数法 int (如果 encoding等于 MQConstants.MQENC_DECIMAL_NORMAL ) 或小尾数法 int (如果它等于 MQConstants.MQENC_DECIMAL_REVERSED)。
        抛出：
        java.io.IOException -如果 IO 存在问题。

      • readDecimal8

        public long readDecimal8()
                  抛出 java.io.IOException
        读取范围在 -999,999,999,999,999,999 到 999,999,999,999,999 之间的 8 字节压缩十进制数。
        返回：
        大尾数法 (如果 encoding等于 MQConstants.MQENC_DECIMAL_NORMAL ) 或小尾数法 (如果它等于 MQConstants.MQENC_DECIMAL_REVERSED)。
        抛出：
        java.io.IOException -如果 IO 存在问题。

      • readObject

        public java.lang.Object readObject()
                            抛出 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)
              抛出 java.io.IOException
                     java.io.EOFException
        在消息缓冲区中向前移动光标。
        指定者：
        skipBytes在接口中java.io.DataInput
        参数：
        n -要移动的字节数。
        返回：
        实际移动的字节数。
        抛出：
        java.io.IOException -如果 IO 存在问题。
        java.io.EOFException -如果跳过超出文件末尾。

      • 写入

        public void write (int b)
           抛出 java.io.IOException
        在当前位置将字节写入消息缓冲区。
        指定者：
        write在接口中java.io.DataOutput
        参数：
        b -要写入的字节
        抛出：
        java.io.IOException -如果 IO 存在问题。

      • 写入

        public void write (byte [] b)
           抛出 java.io.IOException
        在当前位置将字节数组写入消息缓冲区。
        指定者：
        write在接口中java.io.DataOutput
        参数：
        b -要写入的数组。
        抛出：
        java.io.IOException -如果 IO 存在问题。

      • 写入

        public void write (byte [] b ，
                  英特关，
                  整数)
           抛出 java.io.IOException
        在当前位置将一系列字节写入消息缓冲区。
        指定者：
        write在接口中java.io.DataOutput
        参数：
        b -从中写入字节的数组。
        off -要写入的数组中第一个字节的偏移量。
        len -要写入的字节数。
        抛出：
        java.io.IOException -如果 IO 存在问题。

      • writeBoolean

        public void writeBoolean(boolean v)
                  抛出 java.io.IOException
        将布尔值写入当前位置的消息缓冲区。
        指定者：
        writeBoolean在接口中java.io.DataOutput
        参数：
        v -要写入的布尔值。
        抛出：
        java.io.IOException -如果 IO 存在问题。

      • writeByte

        public void writeByte(int v)
               抛出 java.io.IOException
        在当前位置将字节写入消息缓冲区。
        指定者：
        writeByte在接口中java.io.DataOutput
        参数：
        v -要写入的字节。
        抛出：
        java.io.IOException -如果 IO 存在问题。

      • writeBytes

        public void writeBytes(java.lang.String s)
                抛出 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)
               抛出 java.io.IOException
        在当前位置将 Unicode 字符写入消息缓冲区。
        指定者：
        writeChar在接口中java.io.DataOutput
        参数：
        v -要写入的字符，以 int 表示。
        抛出：
        java.io.IOException -如果 IO 存在问题。

      • writeChars

        public void writeChars(java.lang.String s)
                抛出 java.io.IOException
        将字符串作为 Unicode 字符序列写入当前位置的消息缓冲区。
        指定者：
        writeChars在接口中java.io.DataOutput
        参数：
        s -要写入的字符串。
        抛出：
        java.io.IOException -如果 IO 存在问题。

      • writeDouble

        public void writeDouble(double v)
                 抛出 java.io.IOException
        在当前位置将双精度值写入消息缓冲区。 此方法的行为由 encoding确定。

        MQConstants.MQENC_FLOAT_IEEE_NORMAL 和MQENC_IEEE_FLOAT_逆向分别以大尾数法和小尾数法格式写入 IEEE 标准浮点数的值。

        值 MQConstants.MQENC_FLOAT_S390 将写入zSeries格式浮点数。 请注意， IEEE 双打的范围大于zSeries双精度浮点数，并且该非常大的数字无法转换。

        指定者：
        writeDouble在接口中java.io.DataOutput
        参数：
        v -要写入的双精度值。
        抛出：
        java.io.IOException -如果 IO 存在问题。

      • writeFloat

        public void writeFloat(float v)
                抛出 java.io.IOException
        在当前位置将浮点写入消息缓冲区。 此方法的行为由 encoding确定。

        MQConstants.MQENC_FLOAT_IEEE_NORMAL 和MQENC_IEEE_FLOAT_逆向分别以大尾数法和小尾数法格式写入 IEEE 标准浮点数的值。

        值 MQConstants.MQENC_FLOAT_S390 将写入zSeries格式浮点数。 请注意， IEEE 双打的范围大于zSeries双精度浮点数，并且该非常大的数字无法转换。

        指定者：
        writeFloat在接口中java.io.DataOutput
        参数：
        v -要写入的浮点数。
        抛出：
        java.io.IOException -如果 IO 存在问题。

      • writeInt

        public void writeInt(int v)
              抛出 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)
               抛出 java.io.IOException
        writeInt()的同义词，提供此同义词是为了实现跨语言 WMQ API 兼容性。
        参数：
        v -要写入的整数
        抛出：
        java.io.IOException -如果 IO 存在问题。

      • writeLong

        public void writeLong(long v)
               抛出 java.io.IOException
        在当前位置将长整型写入消息缓冲区。 此方法的行为由 encoding确定。

        MQConstants.MQENC_INTEGER_NORMAL 和 MQConstants.MQENC_INTEGER_REVERSED 的值分别以大尾数法和小尾数法格式写入长整型。

        指定者：
        writeLong在接口中java.io.DataOutput
        参数：
        v -要写入的长整型。
        抛出：
        java.io.IOException -如果 IO 存在问题。

      • writeInt8

        public void writeInt8(long v)
               抛出 java.io.IOException
        writeLong()的同义词，提供此同义词是为了实现跨语言 WMQ API 兼容性。
        参数：
        v -要写入的长整型
        抛出：
        java.io.IOException -如果 IO 存在问题。

      • writeShort

        public void writeShort(int v)
                抛出 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)
               抛出 java.io.IOException
        与为实现跨语言 WMQ API 兼容性而提供的 writeShort()相同。
        参数：
        v -要写入的长整型。
        抛出：
        java.io.IOException -如果 IO 存在问题。

      • writeDecimal2

        public void writeDecimal2(short v)
                   抛出 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)
                   抛出 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)
                   抛出 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)
              抛出 java.io.IOException
        将 UTF 格式的字符串写入当前位置的消息缓冲区。
        指定者：
        writeUTF在接口中java.io.DataOutput
        参数：
        str -要写入的字符串。
        抛出：
        java.io.IOException -如果 IO 存在问题。

      • writeString

        public void writeString(java.lang.String s)
                 抛出 java.io.IOException
        将 java.lang.String 写入当前位置的消息缓冲区，并使用 characterSet标识的编码字符集对其进行编码。

        如果 characterSet 设置为缺省值 MQCCSI_Q_MGR ，那么用于对 java.lang.String 进行编码的编码字符集取决于运行应用程序的平台:

        • 如果应用程序正在 z/OS上运行，那么将使用编码字符集标识 500 对 java.lang.String 进行编码。
        • 对于所有其他平台，将使用编码字符集标识 819 对 java.lang.String 进行编码。
        参数：
        s -要编写的 java.lang.String 。
        抛出：
        java.io.IOException -如果 IO 存在问题。

      • writeObject

        public void writeObject(java.lang.Object obj)
                 抛出 java.io.IOException
        将对象写入消息。
        参数：
        obj -要写入的对象。
        抛出：
        java.io.IOException -如果 IO 存在问题。

      • getPropertyValidation

        public int getPropertyValidation()
        指定在设置消息的属性时是否应进行属性验证。 可能的值为：
        • MQCMHO_DEFAULT_VALIDATION ，缺省值
        • MQCMHO_VALIDATE
        • MQCMHO_NO_VALIDATION
        返回：
        true (如果将进行属性验证)

      • setPropertyValidation

        public void setPropertyValidation(int propertyValidation)
        指定在设置消息的属性时是否应进行属性验证。 可能的值为：
        • MQCMHO_DEFAULT_VALIDATION ，缺省值
        • MQCMHO_VALIDATE
        • MQCMHO_NO_VALIDATION
        参数：
        propertyValidation -如果应该进行属性验证，请设置为 true

      • setBooleanProperty

        public void setBooleanProperty(java.lang.String name、
                               布尔值)
                        抛出 MQException
        使用缺省属性描述符将具有指定名称的布尔属性值设置到消息中。
        参数：
        name -布尔属性的名称。
        value -要设置的布尔属性值。
        抛出：
        MQException -如果属性名称无效。

      • setBooleanProperty

        public void setBooleanProperty(java.lang.String name、
                               MQPropertyDescriptor 描述符，
                               布尔值)
                        抛出 MQException
        使用指定的属性描述符将具有指定名称的布尔属性值设置到消息中。
        参数：
        name -布尔属性的名称。
        descriptor -属性本身的属性。
        value -要设置的布尔属性值。
        抛出：
        MQException -如果属性名称无效。

      • setBytesProperty

        public void setBytesProperty(java.lang.String名称、
                             byte [] 值)
                      抛出 MQException
        使用缺省属性描述符将具有指定名称的字节数组属性值设置到消息中。
        参数：
        name -字节数组属性的名称。
        value -要设置的字节数组属性值。
        抛出：
        MQException -如果属性名称无效。

      • setBytesProperty

        public void setBytesProperty(java.lang.String名称、
                             MQPropertyDescriptor 描述符，
                             byte [] 值)
                      抛出 MQException
        使用指定的属性描述符将具有指定名称的字节数组属性值设置到消息中。
        参数：
        name -字节数组属性的名称。
        descriptor -属性本身的属性。
        value -要设置的字节数组属性值。
        抛出：
        MQException -如果属性名称无效。

      • setByteProperty

        public void setByteProperty(java.lang.String name、
                            字节值)
                     抛出 MQException
        使用缺省属性描述符将具有指定名称的字节属性值设置到消息中。
        参数：
        name -字节属性的名称。
        value -要设置的字节属性值。
        抛出：
        MQException -如果属性名称无效。

      • setByteProperty

        public void setByteProperty(java.lang.String name、
                            MQPropertyDescriptor 描述符，
                            字节值)
                     抛出 MQException
        使用指定的属性描述符将具有指定名称的字节属性值设置到消息中。
        参数：
        name -字节属性的名称。
        descriptor -属性本身的属性。
        value -要设置的字节属性值。
        抛出：
        MQException -如果属性名称无效。

      • setShortProperty

                                     短值)
                      抛出 MQException
        使用缺省属性描述符将具有指定名称的简短属性值设置到消息中。
        参数：
        name -短属性的名称。
        value -要设置的简短属性值。
        抛出：
        MQException -如果属性名称无效。

      • setShortProperty

                                     MQPropertyDescriptor 描述符，
                             短值)
                      抛出 MQException
        使用指定的属性描述符将具有指定名称的简短属性值设置到消息中。
        参数：
        name -短属性的名称。
        descriptor -属性本身的属性。
        value -要设置的简短属性值。
        抛出：
        MQException -如果属性名称无效。

      • setInt2Property

        public void setInt2Property(java.lang.String name ，
                            短值)
                     抛出 MQException
        setShortProperty(String, short)的同义词，为跨语言 IBM MQ API 兼容性提供。
        参数：
        name -短属性的名称。
        value -要设置的简短属性值。
        抛出：
        MQException -如果属性名称无效。

      • setIntProperty

        public void setIntProperty(java.lang.String名称、
                           int 值)
                    抛出 MQException
        使用缺省属性描述符将具有指定名称的 int 属性值设置到消息中。
        参数：
        name -int 属性的名称。
        value -要设置的 int 属性值。
        抛出：
        MQException -如果属性名称无效。

      • setIntProperty

        public void setIntProperty(java.lang.String名称、
                           MQPropertyDescriptor 描述符，
                           int 值)
                    抛出 MQException
        使用指定的属性描述符将具有指定名称的 int 属性值设置到消息中。
        参数：
        name -int 属性的名称。
        descriptor -属性本身的属性。
        value -要设置的 int 属性值。
        抛出：
        MQException -如果属性名称无效。

      • setInt4Property

        public void setInt4Property(java.lang.String name ，
                            int 值)
                     抛出 MQException
        setIntProperty(String, int)的同义词，为跨语言 IBM MQ API 兼容性提供。
        参数：
        name -int 属性的名称。
        value -要设置的 int 属性值。
        抛出：
        MQException -如果属性名称无效。

      • setLongProperty

        public void setLongProperty(java.lang.Stringname.LongProperty)、
                            long 值)
                     抛出 MQException
        使用缺省属性描述符将具有指定名称的长属性值设置到消息中。
        参数：
        name -长属性的名称。
        value -要设置的长属性值。
        抛出：
        MQException -如果属性名称无效。

      • setLongProperty

        public void setLongProperty(java.lang.Stringname.LongProperty)、
                            MQPropertyDescriptor 描述符，
                            long 值)
                     抛出 MQException
        使用指定的属性描述符将具有指定名称的长属性值设置到消息中。
        参数：
        name -长属性的名称。
        descriptor -属性本身的属性。
        value -要设置的长属性值。
        抛出：
        MQException -如果属性名称无效。

      • setInt8Property

        public void setInt8Property(java.lang.String name ，
                            long 值)
                     抛出 MQException
        setLongProperty(String, long)的同义词，为跨语言 IBM MQ API 兼容性提供。
        参数：
        name -长属性的名称。
        value -要设置的长属性值。
        抛出：
        MQException -如果属性名称无效。

      • setFloatProperty

                                     浮点值)
                      抛出 MQException
        使用缺省属性描述符将具有指定名称的浮点属性值设置到消息中。
        参数：
        name -浮点属性的名称。
        value -要设置的浮点属性值。
        抛出：
        MQException -如果属性名称无效。

      • setFloatProperty

                                     MQPropertyDescriptor 描述符，
                             浮点值)
                      抛出 MQException
        使用指定的属性描述符将具有指定名称的浮点属性值设置到消息中。
        参数：
        name -浮点属性的名称。
        descriptor -属性本身的属性。
        value -要设置的浮点属性值。
        抛出：
        MQException -如果属性名称无效。

      • setDoubleProperty

        public void setDoubleProperty(java.lang.String名称、
                              双精度值)
                       抛出 MQException
        使用缺省属性描述符将具有指定名称的双精度属性值设置到消息中。
        参数：
        name -double 属性的名称。
        value -要设置的双精度值。
        抛出：
        MQException -如果属性名称无效。

      • setDoubleProperty

        public void setDoubleProperty(java.lang.String名称、
                              MQPropertyDescriptor 描述符，
                              双精度值)
                       抛出 MQException
        使用指定的属性描述符将具有指定名称的双精度属性值设置到消息中。
        参数：
        name -double 属性的名称。
        descriptor -属性本身的属性。
        value -要设置的双精度值。
        抛出：
        MQException -如果属性名称无效。

      • setStringProperty

        public void setStringProperty(java.lang.String名称、
                              java.lang.String 值)
                       抛出 MQException
        使用缺省属性描述符将具有指定名称的字符串属性值设置到消息中。
        参数：
        name -字符串属性的名称。
        value -要设置的字符串属性值。
        抛出：
        MQException -如果属性名称无效。

      • setStringProperty

        public void setStringProperty(java.lang.String名称、
                              MQPropertyDescriptor 描述符，
                              java.lang.String 值)
                       抛出 MQException
        使用指定的属性描述符将具有指定名称的字符串属性值设置到消息中。
        参数：
        name -字符串属性的名称。
        descriptor -属性本身的属性。
        value -要设置的字符串属性值。
        抛出：
        MQException -如果属性名称无效。

      • setObjectProperty

        public void setObjectProperty(java.lang.String name、
                              java.lang.Object 值)
                       抛出 MQException
        使用缺省属性描述符将具有指定名称的 Java 对象属性值设置到消息中。 请注意，此方法仅适用于对象化的基本对象类型 (Integer ， Double ， Long ...) 和字符串对象。 设置属性就像直接调用了 set * Property 方法一样，例如整数导致设置 int 属性值， Long 导致设置 long 属性值等。
        参数：
        name -Java 对象属性的名称。
        value -要设置的 Java 对象属性值。
        抛出：
        MQException -如果属性名称无效。

      • setObjectProperty

        public void setObjectProperty(java.lang.String name、
                              MQPropertyDescriptor 描述符，
                              java.lang.Object 值)
                       抛出 MQException
        使用指定的属性描述符将具有指定名称的 Java 对象属性值设置到消息中。 请注意，此方法仅适用于对象化的基本对象类型 (Integer ， Double ， Long ...) 和字符串对象。 设置属性就像直接调用了 set * Property 方法一样，例如整数导致设置 int 属性值， Long 导致设置 long 属性值等。
        参数：
        name -Java 对象属性的名称。
        descriptor -属性本身的属性。
        value -要设置的 Java 对象属性值。
        抛出：
        MQException -如果属性名称无效。

      • getBooleanProperty

        public boolean getBooleanProperty(java.lang.String name)
                           抛出 MQException
        返回具有指定名称的布尔属性的值。
        参数：
        name -布尔属性的名称。
        返回：
        指定名称的布尔属性值; 如果没有此名称的属性，那么将抛出 MQException。
        抛出：
        MQException -如果属性不存在或类型转换无效。

      • getBooleanProperty

        public boolean getBooleanProperty(java.lang.String name、
                                  MQPropertyDescriptor 描述符)
                           抛出 MQException
        返回具有指定名称的布尔属性的值，并填充指定的属性描述符。
        参数：
        name -布尔属性的名称。
        descriptor -属性本身的属性。
        返回：
        指定名称的布尔属性值; 如果没有此名称的属性，那么将抛出 MQException。
        抛出：
        MQException -如果属性不存在或类型转换无效。

      • getBytesProperty

        public byte[] getBytesProperty(java.lang.String name)
                        抛出 MQException
        返回具有指定名称的字节数组属性的值。
        参数：
        name -字节数组属性的名称。
        返回：
        指定名称的字节数组属性值; 如果没有此名称的属性，那么将抛出 MQException。
        抛出：
        MQException -如果属性不存在或类型转换无效。

      • getBytesProperty

        public byte[] getBytesProperty(java.lang.String name、
                               MQPropertyDescriptor 描述符)
                        抛出 MQException
        返回具有指定名称的字节数组属性的值，并填充指定的属性描述符。
        参数：
        name -字节数组属性的名称。
        descriptor -属性本身的属性。
        返回：
        指定名称的字节数组属性值; 如果没有此名称的属性，那么将抛出 MQException。
        抛出：
        MQException -如果属性不存在或类型转换无效。

      • getByteProperty

        public byte getByteProperty(java.lang.String name)
                     抛出 MQException
        返回具有指定名称的字节属性的值。
        参数：
        name -字节属性的名称。
        返回：
        指定名称的字节属性值; 如果没有此名称的属性，那么将抛出 MQException。
        抛出：
        MQException -如果属性不存在或类型转换无效。

      • getByteProperty

        public byte getByteProperty(java.lang.String name、
                            MQPropertyDescriptor 描述符)
                     抛出 MQException
        返回具有指定名称的字节属性的值，填充指定的属性描述符。
        参数：
        name -字节属性的名称。
        descriptor -属性本身的属性。
        返回：
        指定名称的字节属性值; 如果没有此名称的属性，那么将抛出 MQException。
        抛出：
        MQException -如果属性不存在或类型转换无效。

      • getShortProperty

        public short getShortProperty(java.lang.String name)
                       抛出 MQException
        返回具有指定名称的短属性的值。
        参数：
        name -短属性的名称。
        返回：
        指定名称的简短属性值; 如果没有此名称的属性，那么将抛出 MQException。
        抛出：
        MQException -如果属性不存在或类型转换无效。

      • getShortProperty

        public short getShortProperty(java.lang.String名称、
                              MQPropertyDescriptor 描述符)
                       抛出 MQException
        返回具有指定名称的短属性的值，并填充指定的属性描述符。
        参数：
        name -短属性的名称。
        descriptor -属性本身的属性。
        返回：
        指定名称的简短属性值; 如果没有此名称的属性，那么将抛出 MQException。
        抛出：
        MQException -如果属性不存在或类型转换无效。

      • getInt2Property

        public short getInt2Property(java.lang.String name)
                      抛出 MQException
        getShortProperty(String)的同义词，为跨语言 IBM MQ API 兼容性提供。
        参数：
        name -短属性的名称。
        返回：
        指定名称的简短属性值; 如果没有此名称的属性，那么将抛出 MQException。
        抛出：
        MQException -如果属性不存在或类型转换无效。

      • getInt2Property

        public short getInt2Property(java.lang.String name ，
                             MQPropertyDescriptor 描述符)
                      抛出 MQException
        getShortProperty(String, MQPropertyDescriptor)的同义词，为跨语言 IBM MQ API 兼容性提供。
        参数：
        name -短属性的名称。
        descriptor -属性本身的属性。
        返回：
        指定名称的简短属性值; 如果没有此名称的属性，那么将抛出 MQException。
        抛出：
        MQException -如果属性不存在或类型转换无效。

      • getIntProperty

        public int getIntProperty(java.lang.String name)
                   抛出 MQException
        返回具有指定名称的 int 属性的值。
        参数：
        name -int 属性的名称。
        返回：
        指定名称的 int 属性值; 如果没有此名称的属性，那么将抛出 MQException。
        抛出：
        MQException -如果属性不存在或类型转换无效。

      • getIntProperty

        public int getIntProperty(java.lang.String name、
                          MQPropertyDescriptor 描述符)
                   抛出 MQException
        返回具有指定名称的 int 属性的值，填充指定的属性描述符。
        参数：
        name -int 属性的名称。
        descriptor -属性本身的属性。
        返回：
        指定名称的 int 属性值; 如果没有此名称的属性，那么将抛出 MQException。
        抛出：
        MQException -如果属性不存在或类型转换无效。

      • getInt4Property

        public int getInt4Property(java.lang.String name)
                    抛出 MQException
        getIntProperty(String)的同义词，为跨语言 IBM MQ API 兼容性提供。
        参数：
        name -int 属性的名称。
        返回：
        指定名称的 int 属性值; 如果没有此名称的属性，那么将抛出 MQException。
        抛出：
        MQException -如果属性不存在或类型转换无效。

      • getInt4Property

        public int getInt4Property(java.lang.String name ，
                           MQPropertyDescriptor 描述符)
                    抛出 MQException
        getIntProperty(String, MQPropertyDescriptor)的同义词，为跨语言 IBM MQ API 兼容性提供。
        参数：
        name -int 属性的名称。
        descriptor -属性本身的属性。
        返回：
        指定名称的 int 属性值; 如果没有此名称的属性，那么将抛出 MQException。
        抛出：
        MQException -如果属性不存在或类型转换无效。

      • getLongProperty

        public long getLongProperty(java.lang.String name)
                     抛出 MQException
        返回具有指定名称的长属性的值。
        参数：
        name -长属性的名称。
        返回：
        指定名称的长属性值; 如果没有此名称的属性，那么将抛出 MQException。
        抛出：
        MQException -如果属性不存在或类型转换无效。

      • getLongProperty

        public long getLongProperty(java.lang.String名称、
                            MQPropertyDescriptor 描述符)
                     抛出 MQException
        返回具有指定名称的长属性的值，并填充指定的属性描述符。
        参数：
        name -长属性的名称。
        descriptor -属性本身的属性。
        返回：
        指定名称的长属性值; 如果没有此名称的属性，那么将抛出 MQException。
        抛出：
        MQException -如果属性不存在或类型转换无效。

      • getInt8Property

        public long getInt8Property(java.lang.String name)
                     抛出 MQException
        getLongProperty(String)的同义词，为跨语言 IBM MQ API 兼容性提供。
        参数：
        name -长属性的名称。
        返回：
        指定名称的长属性值; 如果没有此名称的属性，那么将抛出 MQException。
        抛出：
        MQException -如果属性不存在或类型转换无效。

      • getInt8Property

        public long getInt8Property(java.lang.String name ，
                            MQPropertyDescriptor 描述符)
                     抛出 MQException
        getLongProperty(String, MQPropertyDescriptor)的同义词，为跨语言 IBM MQ API 兼容性提供。
        参数：
        name -长属性的名称。
        descriptor -属性本身的属性。
        返回：
        指定名称的长属性值; 如果没有此名称的属性，那么将抛出 MQException。
        抛出：
        MQException -如果属性不存在或类型转换无效。

      • getFloatProperty

        public float getFloatProperty(java.lang.String name)
                       抛出 MQException
        返回具有指定名称的浮点属性的值。
        参数：
        name -浮点属性的名称。
        返回：
        指定名称的浮点属性值; 如果没有此名称的属性，那么将抛出 MQException。
        抛出：
        MQException -如果属性不存在或类型转换无效。

      • getFloatProperty

                                      MQPropertyDescriptor 描述符)
                       抛出 MQException
        返回具有指定名称的浮点属性的值，并填充指定的属性描述符。
        参数：
        name -浮点属性的名称。
        descriptor -属性本身的属性。
        返回：
        指定名称的浮点属性值; 如果没有此名称的属性，那么将抛出 MQException。
        抛出：
        MQException -如果属性不存在或类型转换无效。

      • getDoubleProperty

        public double getDoubleProperty(java.lang.String name)
                         抛出 MQException
        返回具有指定名称的 double 属性的值。
        参数：
        name -double 属性的名称。
        返回：
        指定名称的双精度属性值; 如果没有此名称的属性，那么将抛出 MQException。
        抛出：
        MQException -如果属性不存在或类型转换无效。

      • getDoubleProperty

        public double getDoubleProperty(java.lang.String name、
                                MQPropertyDescriptor 描述符)
                         抛出 MQException
        返回具有指定名称的 double 属性的值，并填充指定的属性描述符。
        参数：
        name -double 属性的名称。
        descriptor -属性本身的属性。
        返回：
        指定名称的双精度属性值; 如果没有此名称的属性，那么将抛出 MQException。
        抛出：
        MQException -如果属性不存在或类型转换无效。

      • getStringProperty

        public java.lang.String getStringProperty(java.lang.String name)
                                   抛出 MQException
        返回具有指定名称的 String 属性的值。
        参数：
        name -字符串属性的名称。
        返回：
        指定名称的字符串属性值; 如果没有此名称的属性，那么将抛出 MQException。
        抛出：
        MQException -如果属性不存在或类型转换无效。

      • getStringProperty

        public java.lang.String getStringProperty(java.lang.String name、
                                          MQPropertyDescriptor 描述符)
                                   抛出 MQException
        返回具有指定名称的 String 属性的值，并填充指定的属性描述符。
        参数：
        name -字符串属性的名称。
        descriptor -属性本身的属性。
        返回：
        指定名称的字符串属性值; 如果没有此名称的属性，那么将抛出 MQException。
        抛出：
        MQException -如果属性不存在或类型转换无效。

      • getObjectProperty

        public java.lang.Object getObjectProperty(java.lang.String name)
                                   抛出 MQException
        返回具有指定名称的 Java 对象属性的值。 此方法可用于返回对象化格式的对象，该对象已通过等效 setObjectProperty(String, Object) 方法调用或其等效原语 #set*Property 方法作为属性存储在消息中。
        参数：
        name -Java 对象属性的名称。
        返回：
        指定名称的 Java 对象属性值，采用对象化格式 (例如，如果将该属性设置为 int ，那么将返回整数); 如果没有此名称的属性，那么将抛出 MQException。
        抛出：
        MQException -如果属性不存在

      • getObjectProperty

        public java.lang.Object getObjectProperty(java.lang.String name、
                                          MQPropertyDescriptor 描述符)
                                   抛出 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)
                                                         抛出 MQException
        返回与指定名称匹配的所有属性名的枚举。 可以在名称末尾使用通配符 "%" 来过滤消息的属性，在零个或多个字符 (包括 ".") 上进行匹配。 字符。
        参数：
        nameP -要匹配的属性的名称。
        返回：
        属性名称与指定名称匹配的属性值的所有名称的枚举。
        抛出：
        MQException -如果属性名称无效。

      • deleteProperty

        public void deleteProperty(java.lang.String nameP)
                    抛出 MQException
        从消息中删除具有指定名称的属性。
        参数：
        nameP -要删除的属性的名称。
        抛出：
        MQException -如果属性名称无效或不存在。
跳过导航链接
© Copyright IBM Corp. 2008 ， 2016. All Rights Reserved.