附录 E   MQ 接口的稳定性

Sun™ ONE Message Queue (MQ) 使用的许多接口可能对管理员自动化管理任务很有帮助。表 E-1 按照稳定性（即本产品的后续版本中对其进行更改的可能性）列出了这些接口。表 E-2 介绍了分类方案。

表 E-1    MQ 3.0.1 接口的稳定性 

接口	分类
imqbrokerd 命令行接口	开发中
imqadmin 命令行接口	不稳定
imqcmd 命令行接口	开发中
imqdbmgr 命令行接口	不稳定
imqkeytool 命令行接口	开发中
imqobjmgr 命令行接口	开发中
imqusermgr 命令行接口	不稳定
imqobjmgr 命令文件	开发中
imqbrokerd 命令	稳定
imqadmin 命令	不稳定
imqcmd 命令	稳定
imqdbmgr 命令	不稳定
imqkeytool 命令	稳定
imqobjmgr 命令	稳定
imqusermgr 命令	不稳定
JMS API (javax.jms)	标准
JAXM API (javax.xml)	标准
被管理对象 API (com.sun.messaging)	开发中
imq.jar 位置和名称	稳定
jms.jar 位置和名称	开发中
imqbroker.jar 位置和名称	专用
imqutil.jar 位置和名称	专用
imqadmin.jar 位置和名称	专用
imqservlet.jar 位置和名称	开发中
imqhttp.war 位置和名称	开发中
imqhttps.war 位置和名称	开发中
imqxm.jar 位置和名称	开发中
jaxm-api.jar 位置和名称	开发中
saaj-api.jar 位置和名称	开发中
saaj-impl.jar 位置和名称	开发中
activation.jar 位置和名称	开发中
mail.jar 位置和名称	开发中
dom4j.jar 位置和名称	专用
fscontext.jar 位置和名称	不稳定
imqbrokerd、imqadmin、imqcmd、imqdbmgr、imqkeytool、imqobjmgr 和 imqusermgr 的输出	不稳定
代理日志文件的位置和内容格式	不稳定
密码文件	不稳定
accesscontrol.properties	不稳定

表 E-2    接口稳定性分类方案 

分类	说明
专用	用户无法直接使用。在任何发行版中都可能对其进行改进或将其删除。
开发中	可供用户使用。可能会在主版本（例如 3.0 和 4.0）或次版本（例如 3.1 和 3.2）中做不兼容更改。所有更改都将慎重逐步地进行。虽然我们会尽量保证所有更改都是兼容的，但不能保证做到这一点。
稳定	可供用户使用。只在主版本（例如 3.0 和 4.0）中做不兼容更改。
标准	可供用户使用。这些接口根据官方认可的标准进行定义，由标准组织控制。很少对这些接口做不兼容更改。
不稳定	可供用户使用。可能会在主版本（例如 3.0 和 4.0）或次要版本（例如 3.1 和 3.2）中做不兼容更改。用户需注意，在以后的发行版中可能会删除这些接口，也可能以一种不兼容的方式更改这些接口。建议用户不要在不稳定的接口上创建显式相关性。