使用 XMS 样本应用程序

XMS .NET 样本应用程序提供了每个 API 的公共功能的概述。 使用这些样本应用程序，可以验证安装和消息传递服务器设置，并帮助您构建自己的应用程序。

关于本任务

如果您在创建自己的应用程序时需要帮助，那么可以使用这些样本应用程序作为起点。 已提供了每个样本应用程序的源代码和已编译的版本。 请查看样本源代码，并确定关键步骤，以便为应用程序创建所有必需对象（ConnectionFactory、Connection、Session、Destination 以及 Producer 和/或 Consumer）并根据需要设置任何特定属性以指定应用程序的工作方式。 有关更多信息，请参阅 编写 XMS 应用程序。 这些样本可能会在 XMS的未来发行版中发生更改。

下表显示了随 XMS提供的样本应用程序集 (每个 API 一个)。

表 1. XMS .NET 的样本应用程序
样本名称 描述

SampleConsumerCS

 从队列中获取消息或预订主题的消息使用者应用程序。

SampleProducerCS

 将消息生成到队列中或针对主题生成消息的消息生产者应用程序。

SampleConfigCS

 可用于创建基于文件的受管对象存储库的配置应用程序。 该应用程序包含适用于特殊连接设置的连接工厂和目标。 然后，可以将此受管对象存储库与各个样本使用者应用程序和生成者应用程序一起使用。

支持各种 API 中相同功能的样本存在一些语法差异。

  • 样本消息使用者和生产者应用程序都支持以下功能：
    • 与 IBM® MQ， IBM Integration Bus (通过使用与代理的实时连接) 和 WebSphere® Application Server service integration bus 的连接
    • 使用初始上下文接口执行受管对象存储库查找
    • 与队列 (IBM MQ 和 WebSphere Application Server service integration bus) 和主题 (IBM MQ，与代理的实时连接和 WebSphere Application Server service integration bus) 的连接
    • 基本、字节、映射、对象、流和文本消息
  • 样本消息使用者应用程序支持同步和异步接收方式以及 SQL 选择器语句。
  • 样本消息生产者应用程序支持持久性和非持久性传递方式。

这些样本可以在以下两种方式下运行：

简单方式
您可以使用最少的用户输入来运行样本。
高级方式
您可以更细微地定制样本的运行方式。

所有样本都兼容，因此可以跨语言运行。

[Windows]从 IBM MQ 9.1.1开始， IBM MQ 在 Windows 环境中支持 .NET Core for XMS .NET 应用程序。 IBM MQ classes for .NET 缺省情况下，标准 (包括样本) 作为标准 IBM MQ 安装的一部分进行安装。

[MQ 9.2.0 2020 年 7 月][Linux]从 IBM MQ 9.1.2开始， IBM MQ 还支持 .NET Core for applications in Linux® 环境。

XMS .NET 的样本应用程序安装在 &MQINSTALL_PATH&/samp/dotnet/samples/cs/core/xms 中。

有关更多信息，请参阅 安装 IBM MQ classes for XMS .NET Standard。