![]() | |
Sun Java System Message Queue 3 2005Q4 管理指南 |
第 17 章
JMS 資源介面特性參照Message Queue JMS 資源介面 (JMS RA) 可讓您使用標準 J2EE Connector Architecture (JCA),為 Sun Java System Message Queue 整合任何 J2EE 1.4 應用程式伺服器。Message Queue JMS 資源介面外掛應用程式伺服器後,此應用程式伺服器部署的應用程式,即可使用 Message Queue 來傳送及接收 JMS 訊息。
Message Queue JMS 資源介面透過三個 JavaBean 元件,展現其配置特性:
若要設定這些實體的特性值,您可以使用應用程式伺服器在配置及部署資源介面及部署 MDB 時提供的工具。
本章列出並描述 Message Queue JMS 資源介面的配置特性。它包含下面各節:
ResourceAdapter JavaBeanResourceAdapter 配置可以配置預設的 JMS 資源介面運作方式。表 17-1 列出並描述您可以用以配置此 JavaBean 的特性。註腳會標示出每個必要的特性。
表 17-1 資源介面特性
特性
預設
說明
addressList1
mq://localhost:7676
/jms資源介面與 Message Queue 服務的連線,使用訊息服務位址格式來指定。
資源介面提供預設值。
addressList 是 Sun Java System Message Queue 特有的特性名稱,但是意義與標準特性 connectionURL 相同。Sun Java System Message Queue 提供這兩種特性名稱。您必須設定 connectionURL 或 ddressList,兩者是相等的。
addressListBehavior
PRIORITY
此字串指定資源介面如何連線至 Message Queue 服務。此值是 PRIORITY 或 RANDOM。
PRIORITY 連線選取位址清單 (addressList) 中指定的第一個 Message Queue 代理程式。
RANDOM 連線隨機選取位址清單中的 Message Queue 代理程式。
連線失敗後的重新連線方式對於 PRIORITY 和 RANDOM 是相同的。代理程式連線失敗時,會嘗試重新連線。如果嘗試後仍然失敗,資源介面會繼續對使用中位址清單執行連線。
addressListIterations
1
在位址清單中重複連線的次數。此值套用初始連線和繼續嘗試重新連線。
connectionURL
mq://localhost:7676
/jms
資源介面與 Message Queue 服務的連線,使用訊息服務位址格式來指定。
等同於 addressList 特性;如需詳細資訊,請參閱前述說明。
userName1
guest
資源介面連線至 Message Queue 服務時,所使用的預設使用者名稱。
資源介面提供預設值。
password1
guest
資源介面連線至 Message Queue 服務時,所使用的預設密碼。
資源介面提供預設值。
reconnectAttempts
6
在位址清單中嘗試重新連線單一項目的次數。reconnectEnabled 設定為 true 時,即可使用此特性。
reconnectEnabled
false
此布林值指定連線失敗後是否嘗試重新連線。
嘗試重新連線的運作方式,是由 reconnectInterval 和 reconnectAttempts 值來控制。
reconnectInterval
30000
嘗試重新連線的間隔 (以毫秒為單位)。reconnectEnabled 設定為 true 時,即可使用此特性。
1 這是必要的特性。
ManagedConnectionFactory JavaBean管理式連線工廠提供並定義資源介面提供給訊息驅動 Bean 的連線。如果您設定的屬性 ResourceAdapter JavaBean 也有類似的特性,此設定會抑制 ResourceAdapter Bean 的類似指定值。
表 17-2 會列出並描述 Message Queue 資源介面提供的管理式連線工廠之可配置屬性。
表 17-2 管理式連線工廠屬性
屬性
預設
說明
addressList
無
衍生自此管理式連線工廠的連線清單。
此屬性的格式如表 17-1 中所描述,符合訊息服務 addressList。如果未設定此值,則連線如該表中所描述,使用 ResourceAdapter JavaBean 的 addressList 指定值。
addressListBehavior
PRIORITY
此字串指定資源介面如何連線至 Message Queue 服務。此值是 PRIORITY 或 RANDOM。
PRIORITY 連線選取位址清單 (addressList) 中指定的第一個 Message Queue 代理程式。
RANDOM 連線隨機選取位址清單中的 Message Queue 代理程式。
連線失敗後的重新連線方式對於 PRIORITY 和 RANDOM 是相同的。代理程式連線失敗時,會嘗試重新連線。如果嘗試後仍然失敗,資源介面會繼續對使用中位址清單執行連線。
addressListIterations
1
在位址清單中重複連線的次數。此值套用初始連線和繼續嘗試重新連線。
clientID
無
衍生自此管理式連線工廠的連線所使用的用戶端識別碼。
password
guest
(可選擇) 連線的密碼。
如果未設定此值,則連線如表 17-1 中所描述,使用 ResourceAdapter JavaBean 的指定密碼。
reconnectAttempts
6
在位址清單中嘗試重新連線單一項目的次數。
reconnectEnabled
false
此布林值指定連線失敗後是嘗試重新連線或嘗試新的連線。
嘗試重新連線,由 reconnectInterval 和 reconnectAttempts 屬性所控制。
reconnectInterval
30000
嘗試重新連線至 Message Queue 服務的最小間隔毫秒數。
userName
guest
(可選擇) 連線的使用者名稱。
如果未設定此值,則連線如表 17-1 中所描述,使用 ResourceAdapter JavaBean 的指定使用者名稱。
ActivationSpec JavaBean應用程式伺服器指示資源介面啟動訊息端點,並且讓訊息端點與訊息驅動 Bean 產生關聯時,會使用 ActivationSpec JavaBean 特性。
表 17-3 會列出並描述訊息端點啟動規格的可配置特性。此表指出 Message Queue 資源介面的特有特性,以及 Enterprise JavaBean 2.1 標準或 J2EE Connector Architecture (J2EE CA) 1.5 標準的特有特性。