Sun Java System Message Queue 3.7 UR1 管理指南

附录 B Message QueueTM 接口的稳定性

Sun Java SystemTM Message Queue 使用的许多接口可以帮助管理员自动完成任务。 本附录根据这些接口的稳定性对其进行分类。接口越稳定,在本产品的后续版本中对其进行更改的可能性就越小。

本附录中未列出的接口都是专用的,而非供用户使用的接口。

分类方案

附录 B,Message QueueTM 接口的稳定性说明了稳定性分类方案。

表 B–1 接口稳定性分类方案

分类 

描述 

专用 

用户无法直接使用。在任何发行版中都可能对其进行改进或将其删除。 

开发中 

可供用户使用。可能会在主要发行版(如 3.0 和 4.0)或次要发行版(如 3.1 和 3.2)中做不兼容更改。所有更改都将慎重缓慢地进行。虽然我们会尽量保证所有更改都是兼容的,但不能保证做到这一点。 

稳定 

可供用户使用。只在主要发行版(如 3.0 和 4.0)中做不兼容更改。 

标准 

可供用户使用。这些接口根据官方认可的标准进行定义,由标准组织控制。 很少对这些接口做不兼容更改。 

不稳定 

可供用户使用。可能会在主要发行版(如 3.0 和 4.0)或次要发行版(如 3.1 和 3.2)中做不兼容更改。用户需注意,在以后的发行版中可能会删除这些接口,也可能以一种不兼容的方式大幅度更改这些接口。建议用户不要在不稳定的接口上创建显式相关性。 

接口稳定性

附录 B,Message QueueTM 接口的稳定性列出了这些接口及其分类。

表 B–2 Message Queue 接口的稳定性

接口 

分类 

命令行接口

 

imqbrokerd 命令行接口

开发中 

imqadmin 命令行接口

不稳定 

imqcmd 命令行接口

开发中 

imqdbmgr 命令行接口

不稳定 

imqkeytool 命令行接口

开发中 

imqobjmgr 命令行接口

开发中 

imqusermgr 命令行接口

不稳定 

imqbrokerdimqadmin imqcmdimqdbmgrimqkeytool imqobjmgrimqusermgr 的输出

不稳定 

命令

 

imqobjmgr 命令文件

开发中 

imqbrokerd 命令

稳定 

imqadmin 命令

不稳定 

imqcmd 命令

稳定 

imqdbmgr 命令

不稳定 

imqkeytool 命令

稳定 

imqobjmgr 命令

稳定 

imqusermgr 命令

不稳定 

API

 

JMS API (javax.jms)

标准 

JAXM API (javax.xml)

标准 

C-API 

开发中 

C-API 环境变量 

不稳定 

基于消息的监视 API 

开发中 

受管理对象 API (com.sun.messaging)

开发中 

.jar 和 .war 文件

 

imq.jar 位置和名称

稳定 

jms.jar 位置和名称

开发中 

imqbroker.jar 位置和名称

专用 

imqutil.jar 位置和名称

专用 

imqadmin.jar 位置和名称

专用 

imqservlet.jar 位置和名称

开发中 

imqhttp.war 位置和名称

开发中 

imqhttps.war 位置和名称

开发中 

imqjmsra.rar 位置和名称

开发中 

imqxm.jar 位置和名称

开发中 

jaxm-api.jar 位置和名称

开发中 

saaj-api.jar 位置和名称

开发中 

saaj-impl.jar 位置和名称

开发中 

activation.jar 位置和名称

开发中 

mail.jar 位置和名称

开发中 

dom4j.jar 位置和名称

专用 

fscontext.jar 位置和名称

不稳定 

文件

 

代理日志文件的位置和内容格式 

不稳定 

密码文件 

不稳定 

accesscontrol.properties 文件

不稳定 

系统目的地

 

mq.sys.dmq 目的地

稳定 

mq.metrics.* 目的地

开发中 

配置属性

 

Message Queue JMS 资源适配器配置属性 

开发中 

Message Queue JMS 资源适配器 JavaBean 和 ActivationSpec 配置属性  

开发中 

消息属性和格式

 

停用消息队列消息属性 JMSXDeliveryCount

标准 

停用消息队列消息属性 JMS_SUN_*

开发中 

Message Queue 客户端消息属性: JMS_SUN_*

开发中 

度量或监视消息的 JMS 消息格式 

开发中 

杂项

 

Message Queue JMS 资源适配器软件包 com.sun.messaging.jms.ra

开发中 

用于存储持久性消息的 JDBC 模式 

开发中