com.ibm.mq
类 MQDestination
- java.lang.Object
- com.ibm.mq.jmqi.JmqiObject
- com.ibm.mq.MQManagedObject
- com.ibm.mq.MQDestination
-
公共抽象类 MQDestination 扩展 MQManagedObject
-
字段摘要
-
从类 com.ibm.mq继承的字段。MQManagedObject
alternateUserId, closeOptions, connectionReference, isOpen, name, openOptions
-
-
方法概要
所有方法 实例方法 具体方法 修饰符和类型 方法和描述 voidget(MQMessage message)从队列或主题中检索消息。voidget(MQMessage message, MQGetMessageOptions getMessageOptions)从队列或主题中检索消息。voidget(MQMessage message, MQGetMessageOptions getMessageOptions, int maxMsgSize)从队列或主题检索消息,直至达到指定的最大消息大小。java.util.GregorianCalendargetCreationDateTime()获取创建此目标的日期和时间。intgetDestinationType()获取此对象所表示的目标类型。intgetQueueManagerCmdLevel()voidput(MQMessage message)将消息放入队列或将消息发布到主题。voidput(MQMessage message, MQPutMessageOptions putMessageOptions)将消息放入队列或将消息发布到主题。voidsetQueueManagerCmdLevel(int queueManagerCmdLevel)
-
-
方法详细信息
get
public void get (MQMessage 消息) 抛出 MQException
从队列或主题中检索消息。 此方法将MQMessage对象作为参数。 它使用对象中的某些字段作为输入参数,特别是messageId和correlationId,因此确保根据需要设置这些字段很重要。 如果 get 失败,那么 MQMessage 对象保持不变。 如果成功,那么 MQMessage 的消息描述符 (成员变量) 和消息数据部分将完全替换为来自入局消息的消息描述符和消息数据。 此方法使用MQGetMessageOptions的缺省实例来执行 get。 使用的消息选项为CMQC.MQGMO_NO_WAIT。- 参数:
message-包含消息描述符信息和返回的消息数据的输入/输出参数。- 抛出:
MQException-如果调用失败。
get
public void get (MQMessage 消息, MQGetMessage选项 getMessage选项) 抛出 MQException
从队列或主题中检索消息。 此方法将MQMessage对象作为参数。 它使用对象中的某些字段作为输入参数,特别是messageId和correlationId,因此确保根据需要设置这些字段很重要。 如果 get 失败,那么 MQMessage 对象保持不变。 如果成功,那么 MQMessage 的消息描述符 (成员变量) 和消息数据部分将完全替换为来自入局消息的消息描述符和消息数据。- 参数:
message-包含消息描述符信息和返回的消息数据的输入/输出参数。getMessageOptions-用于控制获取操作的选项。- 抛出:
MQException-如果调用失败。
get
public void get (MQMessage 消息, MQGetMessage选项 getMessage选项, int maxMsg大小) 抛出 MQException
从队列或主题检索消息,直至达到指定的最大消息大小。 此方法将MQMessage对象作为参数。 它使用对象中的某些字段作为输入参数,特别是messageId和correlationId,因此确保根据需要设置这些字段很重要。 如果 get 失败,那么 MQMessage 对象保持不变。 如果成功,那么 MQMessage 的消息描述符 (成员变量) 和消息数据部分将完全替换为来自入局消息的消息描述符和消息数据。- 参数:
message-包含消息描述符信息和返回的消息数据的输入/输出参数。getMessageOptions-用于控制获取操作的选项。maxMsgSize-此方法可接收的最大消息。 如果队列上的消息大于此大小,那么一旦发生两件事;- 如果在
MQGetMessageOptions对象中设置了 {link CMQC#MQGMO_ACCEPT_TRUNCATED_MSG} 标志,那么将使用尽可能多的消息数据来填充消息。 抛出异常时带有CMQC.MQCC_WARNING完成代码。 - 如果未设置
CMQC.MQGMO_ACCEPT_TRUNCATED_MSG标志,那么会将消息保留在队列或主题上,并抛出异常,其中包含CMQC.MQCC_WARNING完成代码和CMQC.MQRC_TRUNCATED_MSG_FAILED原因码。
- 如果在
- 抛出:
MQException-如果调用失败。
put
public void put (MQMessage 消息) 抛出 MQException
将消息放入队列或将消息发布到主题。 此方法使用MQPutMessageOptions的缺省实例来执行 put 或 publish。 缺省 MQPutMessage选项实例可能因目标类型而异。- 参数:
message-包含消息描述符数据的MQMessage对象 (MQMD) 以及要发送的消息。 此对象的 "消息描述符" 属性可因此方法而改变。 它们在此方法完成后立即具有的值是已放入队列或已发布到主题的值。- 抛出:
MQException-如果调用失败。
put
public void put (MQMessage 消息, MQPutMessage选项 putMessage选项) 抛出 MQException
将消息放入队列或将消息发布到主题。在 put 完成后对
MQMessage对象的修改不会影响目标上的实际消息。如果使用同一 MQMessage 对象进行进一步调用,请执行放置更新
MQMD.messageId和MQMD.correlationId。另请注意,调用
put(MQMessage, MQPutMessageOptions)不会清除消息数据。 例如:
这导致 "ab" 被第二次调用。msg.writeString("a"); destination.put(msg, pmo); msg.writeString("b"); destination.put(msg, pmo);- 参数:
message-包含消息描述符数据 (MQMD) 和要发送的消息的 MQMessage 对象。 此对象的 "消息描述符" 属性可因此方法而改变。 它们在此方法完成后立即具有的值是已放入队列或已发布到主题的值。putMessageOptions-用于控制 put 操作的选项。- 抛出:
MQException-如果调用失败。
getDestination类型
public int getDestination类型 ()
获取此对象所表示的目标类型。 可以是CMQC.MQOT_Q或CMQC.MQOT_TOPIC。- 返回:
- 目标类型。
getCreationDateTime
public java.util.GregorianCalendar getCreationDateTime() 抛出 MQException获取创建此目标的日期和时间。- 返回:
- 日期和时间。
- 抛出:
MQException-如果在关闭目标后调用此方法,那么指示该目标不再可访问。
getQueueManagerCmd级别
public int getQueueManagerCmdLevel ()
- 返回:
- 命令级别
setQueueManagerCmd级别
public void setQueueManagerCmdLevel (int queueManagerCmdLevel)
- 参数:
queueManagerCmdLevel-
-