|
| |
| Sun Java System Message Queue 3 2005Q1 管理指南 | |
第 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
資源介面與 Message Queue 服務的連線，使用訊息服務位址格式來指定。
資源介面提供預設值。
addressList 是 Sun Java System Message Queue 特有的屬性名稱，但是意義與標準屬性 connectionURL 相同。Sun Java System Message Queue 提供這兩種屬性名稱。您必須設定 connectionURL 或 ddressList，二者是相等的。
mq://localhost:7676
/jmsaddressListBehavior
這個字串指定資源介面如何連線至 Message Queue 服務。此值是 PRIORITY 或 RANDOM。
PRIORITY 連線選取位址清單 (addressList) 中指定的第一個 Message Queue 代理程式。
RANDOM 連線隨機選取位址清單中的 Message Queue 代理程式。
連線失敗後的重新連線方式，同 PRIORITY 和 RANDOM。代理程式連線失敗時，會嘗試重新連線。如果嘗試後仍然失敗，資源介面會繼續對使用中位址清單執行連線。
PRIORITY
addressListIterations
在位址清單中重複連線的次數。此值套用初始連線和繼續嘗試重新連線。
1
connectionURL
資源介面與 Message Queue 服務的連線，使用訊息服務位址格式來指定。
等同於 addressList 屬性；如需詳細資訊，請參閱前述說明。
mq://localhost:7676
/jms
userName1
資源介面連線至 Message Queue 服務時使用的預設使用者名稱。
資源介面提供預設值。
guest
password1
資源介面連線至 Message Queue 服務時使用的預設密碼。
資源介面提供預設值。
guest
reconnectAttempts
在位址清單中嘗試重新連線單一項目的次數。reconnectEnabled 設定為 true 時，即可使用此屬性。
6
reconnectEnabled
這個布林值指定連線失敗後是否嘗試重新連線。
嘗試重新連線的運作方式，是由 reconnectInterval 和 reconnectAttempts 值來控制。
false
reconnectInterval
嘗試重新連線的間隔 (以毫秒為單位)。reconnectEnabled 設定為 true 時，即可使用此屬性。
30000
1這是必要的特性。
ManagedConnectionFactory JavaBean受管理連線工廠提供並定義資源介面提供給訊息驅動 Bean 的連線。如果您設定的屬性 ResourceAdapter JavaBean 也有類似的屬性，此設定會抑制 ResourceAdapter Bean 的類似指定值。
表 17-2 列出並描述 Message Queue 資源介面提供的受管理連線工廠的可配置屬性。
表 17-2 受管理連線工廠屬性
名稱
說明
預設
addressList
衍生自此受管理連線工廠的連線清單。
這個特性的格式如表 17-1 中所描述，符合訊息服務 addressList。如果未設定此值，則連線如該表中所描述，使用 ResourceAdapter JavaBean 的 addressList 指定值。
無
addressListBehavior
這個字串指定資源介面如何連線至 Message Queue 服務。此值是 PRIORITY 或 RANDOM。
PRIORITY 連線選取位址清單 (addressList) 中指定的第一個 Message Queue 代理程式。
RANDOM 連線隨機選取位址清單中的 Message Queue 代理程式。
連線失敗後的重新連線方式，同 PRIORITY 和 RANDOM。代理程式連線失敗時，會嘗試重新連線。如果嘗試後仍然失敗，資源介面會繼續對使用中位址清單執行連線。
PRIORITY
addressListIterations
在位址清單中重複連線的次數。此值套用初始連線和繼續嘗試重新連線。
1
clientID
衍生自此受管理連線工廠的連線所使用的用戶端識別碼。
無
password
(選用) 連線密碼。
如果未設定此值，則連線如表 17-1 中所描述，使用 ResourceAdapter JavaBean 的指定密碼。
guest
reconnectAttempts
在位址清單中嘗試重新連線單一項目的次數。
6
reconnectEnabled
這個布林值指定連線失敗後是嘗試重新連線或嘗試新的連線。
嘗試重新連線，是由 reconnectInterval 和 reconnectAttempts 特性來控制。
false
reconnectInterval
嘗試重新連線至 Message Queue 服務的最小間隔毫秒數。
30000
userName
(選用) 連線的使用者名稱。
如果未設定此值，則連線如表 17-1 中所描述，使用 ResourceAdapter JavaBean 的指定使用者名稱。
guest
ActivationSpec JavaBean應用程式伺服器指示資源介面啟動訊息端點並且讓訊息端點與訊息驅動 Bean 產生關聯時，會使用 ActivationSpec JavaBean 特性。
表 17-3 列出並描述訊息端點啟動規格的可配置屬性。此表指出 Message Queue 資源介面的特有特性，以及 Enterprise JavaBean 2.1 標準或 J2EE Connector Architecture (J2EE CA) 1.5 標準的特有特性。