Message 属性

JMS_IBM_MQMD* 属性

IBM® Message Service Client for .NET 支持客户机应用程序使用 API 读取/写入 MQMD 字段。 它也允许访问 MQ 消息数据。 缺省情况下，已禁用对 MQMD 的访问，必须由应用程序使用 Destination 属性 XMSC_WMQ_MQMD_WRITE_ENABLED 和 XMSC_WMQ_MQMD_READ_ENABLED 来明确进行启用。 这两个属性相互独立。

除 StrucId 和 Version 以外的所有其他 MQMD 字段都作为额外的 Message 对象属性公开，并添加了前缀 JMS_IBM_MQMD。

JMS_IBM_MQMD* 属性的优先级高于其他属性（如上表中所述的 JMS_IBM*）。

发送消息

表示除 StrucId 和 Version 之外的所有 MQMD 字段。 这些属性仅仅是指 MQMD 字段；属性同时出现在 MQMD 和 MQRFH2 头中，不会设置或抽取 MQRFH2 中的版本。 除了 JMS_IBM_MQMD_BackoutCount 之外，以上任意属性都可以设置。 将忽略对 JMS_IBM_MQMD_BackoutCount 设置的任何值。

如果属性具有最大长度限制，而您提供的值过长，则该值会被截断。

对于某些属性，还必须在 Destination 对象上设置 XMSC_WMQ_MQMD_MESSAGE_CONTEXT 属性。 应用程序必须以相应的上下文权限运行才能使属性生效。 如果未将 XMSC_WMQ_MQMD_MESSAGE_CONTEXT 设置为相应的值，那么将忽略此属性值。 如果将 XMSC_WMQ_MQMD_MESSAGE_CONTEXT 设置为相应的值，但您对于队列管理器没有足够的上下文权限，那么将发出异常。 下面是一些要求 XMSC_WMQ_MQMD_MESSAGE_CONTEXT 具有特定值的属性。

接收消息

请参阅 MQMD 以获取更多详细信息。

示例

以下示例生成的消息将放入 MQMD.UserIdentifier 设置为“JoeBloggs”的队列或主题中。

  // Create a ConnectionFactory, connection, session, producer, message
  // ...

  // Create a destination
  // ...

  // Enable MQMD write
  dest.setBooleanProperty(XMSC_WMQ_MQMD_WRITE_ENABLED, 
		XMSC_WMQ_MQMD_WRITE_ENABLED_YES);
  
  // Optionally, set a message context if applicable for this MD field
  dest.setIntProperty(XMSC_WMQ_MQMD_MESSAGE_CONTEXT, 
    XMSC_WMQ_MDCTX_SET_IDENTITY_CONTEXT);

  // On the message, set property to provide custom UserId
  msg.setStringProperty(JMS_IBM_MQMD_USERIDENTIFIER, "JoeBloggs");

  // Send the message
  // ...

在设置 JMS_IBM_MQMD_USERIDENTIFIER 之前，需要先设置 XMSC_WMQ_MQMD_MESSAGE_CONTEXT。 有关使用 XMSC_WMQ_MQMD_MESSAGE_CONTEXT 的更多信息，请参阅 Message 对象属性。

同样，可通过在收到消息前将 XMSC_WMQ_MQMD_READ_ENABLED 设置为 true，然后使用消息获取方法（如 getStringProperty）来抽取 MQMD 字段内容。 收到的任何属性均为只读。

此示例将从队列或主题中获取用于保存消息 MQMD.ApplIdentityData 字段值的值字段。

  // Create a ConnectionFactory, connection, session, consumer
  // ...

  // Create a destination
  // ...

  // Enable MQMD read
  dest.setBooleanProperty(XMSC_WMQ_MQMD_READ_ENABLED, XMSC_WMQ_MQMD_READ_ENABLED_YES);

  // Receive a message
  // ...

  // Get required MQMD field value using a property
  System.String value = rcvMsg.getStringProperty(JMS_IBM_MQMD_APPLIDENTITYDATA);