Sun Java System Message Queue 3.7 UR1 管理指南

附錄 B Message QueueTM 介面的穩定性

Sun Java SystemTM Message Queue 使用許多介面以協助管理員自動進行工作。本附錄可根據穩定性對介面進行分類。介面愈穩定,在後續版本中變更的可能性愈小。

附錄中沒有列出來的介面都是私有的介面,且不提供給客戶使用。

分類機制

附錄 BMessage QueueTM 介面的穩定性 中描述穩定性分類機制。

表 B–1 介面穩定性分類機制

分類 

說明 

私有 

不由客戶直接使用。可在任何版次中變更或移除。 

改進中 

由客戶使用。主要發行版本 (如 3.0、4.0) 或次要發行版本 (如 3.1、3.2) 可能會有不相容的變更。應謹慎而緩慢地進行變更。應進行適當的操作以確保所有的變更均相容,但是這點無法保證。 

穩定 

由客戶使用。僅主要發行版本 (如 3.0 或 4.0) 可能會有不相容的變更。 

標準 

由客戶使用。這些介面由正式標準定義,並由標準組織控制。幾乎沒有與這些介面不相容的變更。 

不穩定 

由客戶使用。主要發行版本 (如 3.0、4.0) 或次要發行版本 (如 3.1、3.2) 可能會有不相容的變更。通知客戶在未來版次中,這些介面可能會以不相容的方式進行大幅度移除或變更。建議客戶不要在不穩定的介面上建立明確的相依性。 

介面穩定性

附錄 BMessage 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 模式 

改進中