com.ibm.mq

类 MQDistributionList

java.lang.Object

com.ibm.mq.jmqi.JmqiObject

com.ibm.mq.MQManagedObject

com.ibm.mq.MQDistributionList

公共类 MQDistributionList
扩展 MQManagedObject

使用 MQDistributionList 构造函数或 MQQueueManager.accessDistributionList() 方法创建分发列表。 分发列表表示一组开放式队列，可以使用对 put 方法的单个调用将消息发送到这些队列。

字段摘要

从类 com.ibm.mq继承的字段。MQManagedObject

alternateUserId, closeOptions, connectionReference, isOpen, name, openOptions

从类 com.ibm.mq.jmqi.JmqiObject 继承的字段

COMP_JM, COMP_JN, COMP_JO

构造函数摘要

构造函数

构造函数和描述
MQDistributionList(MQQueueManager qMgr, MQDistributionListItem[] litems, int openOptions, java.lang.String alternateUserId) 创建新的分发列表并打开队列。

方法概要

修饰符和类型	方法和描述
void	close() 关闭分发列表。
MQDistributionListItem	getFirstDistributionListItem() 获取分发列表中的第一项，如果该列表为空，那么为空。
int	getInvalidDestinationCount() 获取分发列表中未能成功打开的项数。
int	getValidDestinationCount() 获取分发列表中已成功打开的项数。
void	put(MQMessage message, MQPutMessageOptions putMessageOptions) 将消息放入分发列表中的队列。

从类 com.ibm.mq继承的方法。MQManagedObject

getAlternateUserId, getAttributeString, getCloseOptions, getConnectionReference, getDescription, getName, getOpenOptions, getResolvedObjectString, getResolvedQName, getResolvedType, inquire, inquire, isOpen, set, setAttributeString, setCloseOptions

从类 com.ibm.mq.jmqi.JmqiObject 继承的方法

getJmqiEnvironment

从类 java.lang.Object 继承的方法

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造函数详细信息

MQDistributionList

public MQDistributionList(MQQueueManager qMgr，
                          MQDistributionListItem[] litems ，
                          int openOptions，
                          java.lang.String alternateUser标识)
                   抛出 MQException

创建新的分发列表并打开队列。

参数：

qMgr -要在其中打开列表的队列管理器。

litems -要包含在分发列表中的项。

openOptions -用于控制分发列表打开的选项。

alternateUserId -用于在 openOptions中指定 MQOO_ALTERNATE_USER_AUTHORITY 时检查打开队列的授权的备用用户标识。 否则，此参数可以留空 (或空)。

抛出：

MQException -仅当调用完全失败时才会抛出。 如果至少有一个队列成功打开，那么构造函数将完成。

方法详细信息

put

public void put (MQMessage 消息，
                MQPutMessage选项 putMessage选项)
         抛出 MQException

将消息放入分发列表中的队列。

参数：

message -消息描述符信息和返回的消息数据。

putMessageOptions -控制 MQPUT 的操作。

抛出：

MQException -如果 put 失败。

关闭

public void close()
           抛出 MQException

关闭分发列表。

覆盖：

close的实例MQManagedObject

抛出：

MQException -如果关闭失败。

getValidDestinationCount

public int getValidDestinationCount()

获取分发列表中已成功打开的项数。

返回：

项目数。

getInvalidDestinationCount

public int getInvalidDestinationCount()

获取分发列表中未能成功打开的项数。

返回：

项目数。

getFirstDistributionList项

public MQDistributionListItem getFirstDistributionListItem ()

获取分发列表中的第一项，如果该列表为空，那么为空。

返回：

第一项。