附錄 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) 的不相容變更。通知客戶在未來版次中，這些介面可能會以不相容的方式進行大幅度移除或變更。建議客戶不要在不穩定的介面上建立明確的相依性。