Sun Java System Message Queue 3.7 UR1 技术概述

前言

本书（即《Sun Java System Message Queue 3.7 UR1 技术概述》）对 Message Queue 消息传送服务的技术、概念、体系结构和功能进行了介绍。

因此，本书为 Message Queue 文档集中的其他书籍提供了基础，应先阅读本书。

目标读者

本书是专为应用程序开发者、管理员及其他计划使用 Message Queue 产品或有意了解该产品的技术、概念、体系结构和功能的人员编写的。

应用程序开发者负责编写使用 Message Queue 服务与其他客户端应用程序交换消息的 Message Queue 客户端应用程序。
管理员负责设置和管理 Message Queue 消息传送服务。本书并不要求读者掌握消息传送系统的任何知识或对其有一定了解。

本书并未假定读者了解有关通过 Message Queue 服务实现的 Java 消息服务 (Java Message Service, JMS) 规范的任何知识。

阅读本书之前

阅读本书没有任何前提条件。应当先阅读本书，对 Message Queue 的基本概念有一定了解后，再阅读 Message Queue 开发者指南以及管理指南。

本书的结构

请从头到尾阅读本书，因为每一章的内容都是以前面章节中所包含的信息为基础。下表简要介绍了各章的内容。

表 P–1 本书的内容和结构


章节	描述
第 1 章，消息传送系统：简介	介绍消息传送中间件技术，讨论 JMS 标准并介绍该标准的 Message Queue 服务实现方案。
第 2 章，客户端编程模型	介绍 JMS 编程模型以及如何使用 Message Queue 客户端运行时环境创建 JMS 客户端。介绍 C++ 客户端和 SOAP 消息传输的运行时环境支持。
第 3 章，Message Queue 服务	讨论管理任务和工具，并介绍用于配置连接、路由、持久性、安全性及监视的代理服务。
第 4 章，代理群集	讨论 Message Queue 代理群集的体系结构和使用。
第 5 章，Message Queue 和 J2EE	探讨有关在 J2EE 平台环境中实现 JMS 支持的其他信息。
附录 A，可选 JMS 功能的 Message Queue 实现	介绍 Message Queue 产品如何处理 JMS 可选项。
附录 B，Message Queue 功能	列出 Message Queue 功能，概述实现这些功能所需的步骤并提供有关进一步信息的参考。
词汇表	提供使用 Message Queue 时可能遇到的术语和概念的相关信息。

相关文档

下表按照通常的使用顺序列出了 Message Queue 文档集中的文档。

表 P–2 Message Queue 文档集


文档	读者	描述
《Sun Java System Message Queue 3.7 UR1 Installation Guide》	开发者和管理员	介绍如何在 Solaris、Linux 和 Windows 平台上安装 Message Queue 软件。
《Sun Java System Message Queue 3.7 UR1 发行说明》	开发者和管理员	包含新功能、局限性、已知错误以及技术说明的介绍。
《Sun Java System Message Queue 3.7 UR1 技术概述》	开发者和管理员	介绍了 Message Queue 的概念、功能和组件。
《Sun Java System Message Queue 3.7 UR1 Developer’s Guide for Java Clients》	开发者	为使用 JMS 或 SOAP/JAXM API 的 Message Queue 实现方案开发 Java 客户端程序的人员提供快速入门教程和编程信息。
《Sun Java System Message Queue 3.7 UR1 管理指南》	管理员，也推荐开发者阅读	提供使用 Message Queue 管理工具执行管理任务所需的背景和信息。
《Sun Java System Message Queue 3.7 UR1 Developer’s Guide for C Clients》	开发者	为使用 JMS API (C-API) 的 Message Queue C 实现方案开发 C 客户端程序的人员提供编程和参考文档。

联机帮助

Message Queue 3.7 UR1 包含用于执行 Message Queue 消息服务管理任务的命令行实用程序。

还包含图形用户界面 (Graphical User Interface, GUI) 管理工具，即管理控制台 (imqadmin)。管理控制台中包含上下文有关的帮助，请参见《Sun Java System Message Queue 3.7 UR1 管理指南》中的“管理控制台联机帮助”。

JavaDoc

以下位置提供了 JavaDoc 格式的 JMS 和 Message Queue 文档：

平台	位置
Solaris	`/usr/share/javadoc/imq/index.html`
Linux	`/opt/sun/mq/javadoc/index.html`
Windows	`IMQ_HOME/javadoc/index.html`

可以在任何 HTML 浏览器中查看此文档。它包括标准 JMS API 文档以及 Message Queue 受管理对象的 Message Queue 特定 API，这些对消息传送应用程序的开发者很有帮助。

示例客户端应用程序

Message Queue 提供了很多示例客户端应用程序，这些应用程序对开发者有所帮助。

示例 Java 客户端应用程序

示例 Java 客户端应用程序位于以下目录（取决于所在的平台）。请参见位于这些目录及其每个子目录中的自述文件。

平台	位置
Solaris	`/usr/demo/imq/`
Linux	`/opt/sun/mq/examples`
Windows	`IMQ_HOME/demo/`

示例 C 客户端程序

示例 C 客户端应用程序位于以下目录（取决于所在的平台）。请参见位于这些目录中的自述文件。

平台	位置
Solaris	`/opt/SUNWimq/demo/C/`
Linux	`/opt/sun/mq/examples/C/`
Windows	`IMQ_HOME/demo/C/`

Java 消息服务 (Java Message Service, JMS) 规范

可以在以下位置找到 JMS 规范：

规范包括样例客户端代码。

目录变量约定

Message Queue 使用三个目录变量，它们的设置方法因平台而异。表 P–3 介绍了这些变量以及如何在 Solaris、Linux 和 Windows 平台上使用这些变量。

注 –

表 P–3 中的信息仅适用于 Message Queue 的单机安装。如果 Message Queue 作为应用服务器安装的一部分进行安装和运行，则目录变量值的设置会有所不同：IMQ_HOME 设置为 appServer_install_dir/imq（其中 appServer_install_dir 是应用服务器安装目录），而 IMQ_VARHOME 设置为 appServer_domainName_dir /imq（其中 appServer_domainName_dir 是启动 Message Queue 代理的域的域目录）。

表 P–3 目录变量约定


变量	描述
`IMQ_HOME`	在 Message Queue 文档中，用于表示 Message Queue 基目录（根安装目录）：在 Solaris 和 Linux 上，不存在 Message Queue 根安装目录。因此，Message Queue 文档中不使用 `IMQ_HOME` 来表示 Solaris 和 Linux 上的文件位置。在 Windows 上，Message Queue 根安装目录设置为 Message Queue 包的解压缩目录。
`IMQ_VARHOME`	`/var` 目录，其中存储了 Message Queue 临时或动态创建的配置和数据文件。可设置为指向任何目录的环境变量。在 Solaris 上，`IMQ_VARHOME` 默认为 `/var/imq` 目录。在 Solaris 上，对于 Sun Java System Application Server 测试版，`IMQ_VARHOME` 默认为 `IMQ_HOME/var` 目录。在 Linux 上，`IMQ_VARHOME` 默认为 `/var/opt/sun/mq` 目录。在 Windows 上，`IMQ_VARHOME` 默认为 `IMQ_HOME/var` 目录。
`IMQ_JAVAHOME`	环境变量，指向 Message Queue 可执行文件所需的 Java 运行时环境 (JRE) 的位置：在 Solaris 上，`IMQ_JAVAHOME` 查找最新的 JDK，但用户可以选择性地将该值设置为所需 JRE 所在的位置。在 Linux 上，Message Queue 首先查找最新的 JDK，但用户可以选择性地将 `IMQ_JAVAHOME` 的值设置为所需 JRE 所在的位置。在 Windows 上，`IMQ_JAVAHOME` 将设置为指向现有 Java 运行时环境（如果系统中存在支持的版本）。如果不存在支持的版本，将安装所支持的版本。

在本书中，显示 IMQ_HOME、IMQ_VARHOME 和 IMQ_JAVAHOME 时，不使用特定于平台的环境变量表示法或语法（例如，在 UNIX 上为 $IMQ_HOME）。路径名通常采用 UNIX 目录分隔符表示法 (/)。

印刷约定

下表描述了本书中使用的印刷约定。

表 P–4 印刷约定


字体或符号	含义	示例
`AaBbCc123`	命令、文件和目录的名称；计算机屏幕输出	编辑 `.login` 文件。使用 `ls -a` 列出所有文件。 `machine_name% you have mail.`
`AaBbCc123`	用户键入的内容，与计算机屏幕输出的显示不同	`machine_name%` `su` `Password:`
`aabbcc123`	要使用实名或值替换的占位符	用于删除文件的命令为 `rm` `filename`。
AaBbCc123	保留未译的新词或术语以及要强调的词（注意：某些强调的词在联机状态下以粗体显示）	这些称为 Class 选项。
新词术语强调	新词或术语以及要强调的词	缓存是存储在本地的副本。不要保存文件。
《书名》	书名	阅读《用户指南》的第 6 章。

命令示例中的 Shell 提示符

下表显示了默认 UNIX® 系统提示符和 C shell、Bourne shell、Korn shell 及 Windows 操作系统的超级用户提示符。

表 P–5 Shell 提示符


Shell	提示符
C shell	`machine_name%`
超级用户的 C shell	`machine_name#`
Bourne shell 和 Korn shell	`$`
超级用户的 Bourne shell 和 Korn shell	`#`
Windows	C:\

符号约定

下表对本书中可能使用的符号进行了解释。

表 P–6 符号约定


符号	描述	示例	含义
`[ ]`	包含可选的参数和命令选项。	`ls [-l]`	`-l` 不是必需选项。
`{ \| }`	包含必需命令选项的选项集。	`-d {y\|n}`	`-d` 选项要求您使用参数 `y` 或参数 `n`。
`${ }`	表示变量引用。	`${com.sun.javaRoot}`	引用 `com.sun.javaRoot` 变量的值。
-	连接需要同时按下的多个键。	Ctrl-A	在按 A 键的同时按 Ctrl 键。
+	连接需要连续按下的多个键。	Ctrl+A+N	按 Ctrl 键，再将其释放，然后按后续键。
->	表示图形用户界面中的菜单项选择。	“文件”->“新建”->“模板”	从“文件”菜单中选择“新建”。从“新建”子菜单中选择“模板”。

文档、支持和培训

Sun 的 Web 站点提供了有关其他资源的信息，如下所示：

文档 (http://www.sun.com/documentation/)
支持 (http://www.sun.com/support/)
培训 (http://www.sun.com/training/)

搜索 Sun 产品文档

除了从 docs.sun.com Web 站点搜索 Sun 产品文档之外，还可以通过在搜索字段中键入以下语法来使用搜索引擎进行搜索：

search-term site:docs.sun.com

例如，要搜索 "broker"，请键入以下内容：

broker site:docs.sun.com

要将其他 Sun Web 站点（如 java.sun.com、www.sun.com 和 developers.sun.com）包含在搜索中，请在搜索字段中使用 "sun.com" 代替 "docs.sun.com"。

第三方 Web 站点引用

本文档引用了第三方 URL，并提供了其他相关信息。

注 –

Sun 对本文档中提到的第三方 Web 站点的可用性不承担任何责任。对于此类站点或资源中的（或通过它们获得的）任何内容、广告、产品或其他材料，Sun 并不表示认可，也不承担任何责任。对于因使用或依靠此类站点或资源中的（或通过它们获得的）任何内容、产品或服务而造成的或连带产生的实际或名义损坏或损失，Sun 概不负责，也不承担任何责任。

Sun 欢迎您提出意见

Sun 致力于提高其文档的质量，并十分乐意收到您的意见和建议。要共享您的意见，请访问 http://docs.sun.com，然后单击“发送意见”(Send Comments)。在联机表单中提供完整的文档标题和文件号码。文件号码包含 7 位或 9 位数字，可在书的标题页或在文档的 URL 中找到该号码。例如，本书的文件号码是 820-0533。