下表列出在建立資源配接卡時會用到的特性。
特性名稱 |
有效值 |
預設值 |
說明 |
---|---|---|---|
ProviderIntegrationMode |
javabean/jndi |
javabean |
決定資源配接卡和 JMS 用戶端之間的整合模式。 |
ConnectionFactoryClassName |
Application Server 類別路徑中可供使用的類別名稱,例如: com.sun.messaging.ConnectionFactory |
無 |
JMS 用戶端的 javax.jms.ConnectionFactory 實作的類別名稱。只有當 ProviderIntegrationMode 為 javabean 時才使用。 |
QueueConnectionFactoryClassName |
Application Server 類別路徑中可供使用的類別名稱,例如: com.sun.messaging.QueueConnectionFactory |
無 |
JMS 用戶端的 javax.jms.QueueConnectionFactory 實作的類別名稱。只有當 ProviderIntegrationMode 為 javabean 時才使用。 |
TopicConnectionFactoryClassName |
Application Server 類別路徑中可供使用的類別名稱,例如: com.sun.messaging.TopicConnectionFactory |
無 |
JMS 用戶端的 javax.jms.TopicConnectionFactory 實作的類別名稱。只有將 ProviderIntegrationMode 指定為 javabean 時才使用。 |
XAConnectionFactoryClassName |
Application Server 類別路徑中可供使用的類別名稱,例如: com.sun.messaging.XAConnectionFactory |
無 |
JMS 用戶端的 javax.jms.ConnectionFactory 實作的類別名稱。只有將 ProviderIntegrationMode 指定為 javabean 時才使用。 |
XAQueueConnectionFactoryClassName |
Application Server 類別路徑中可供使用的類別名稱,例如: com.sun.messaging.XAQueueConnectionFactory |
無 |
JMS 用戶端的 javax.jms.XAQueueConnectionFactory 實作的類別名稱。只有將 ProviderIntegrationMode 指定為 javabean 時才使用。 |
XATopicConnectionFactoryClassName |
Application Server 類別路徑中可供使用的類別名稱,例如: com.sun.messaging.XATopicConnectionFactory |
無 |
JMS 用戶端的 javax.jms.XATopicConnectionFactory 實作的類別名稱。只有當 ProviderIntegrationMode 為 javabean 時才使用。 |
TopicClassName |
Application Server 類別路徑中可供使用的類別名稱,例如: com.sun.messaging.Topic |
無 |
JMS 用戶端的 javax.jms.Topic 實作的類別名稱。只有當 ProviderIntegrationMode 為 javabean 時才使用。 |
QueueClassName |
應用程式伺服器類別路徑中可供使用的類別名稱,例如: com.sun.messaging.Queue |
無 |
JMS 用戶端的 javax.jms.Queue 實作的類別名稱。只有將 ProviderIntegrationMode 指定為 javabean 時才使用。 |
SupportsXA |
True/false |
FALSE |
指定 JMS 用戶端是否支援 XA。 |
ConnectionFactoryProperties |
以逗號分隔的「名稱-值」對 |
無 |
指定 JMS 用戶端的 javabean 特性名稱以及 ConnectionFactory 的值。只有當 ProviderIntegrationMode 為 javabean 時才需要。 |
JndiProperties |
以逗號分隔的「名稱-值」對 |
無 |
指定用來連線至 JMS 提供者之 JNDI 的 JNDI 提供者特性。只有當 ProviderIntegrationMode 為 jndi 時才使用。 |
CommonSetterMethodName |
方法名稱 |
無 |
指定某些 JMS 供應商在設定其受管理物件的特性時,所使用的一般 setter 方法名稱。只有當 ProviderIntegrationMode 為 javabean 時才使用。如果是 Sun Java System Message Queue,則此特性稱為 setProperty。 |
UserName |
JMS 使用者名稱 |
無 |
與 JMS 提供者連線時採用的使用者名稱。 |
Password |
JMS 使用者的密碼 |
無 |
與 JMS 提供者連線時採用的密碼。 |
RMPolicy |
ProviderManaged 或 OnePerPhysicalConnection |
ProviderManaged |
作業事件管理員使用 XAResource 上的 isSameRM 方法,判斷由兩個 XAResources 所呈現的資源管理員實例是否相同。當 RMPolicy 設定為 ProviderManaged (預設值) 時,由 JMS 提供者負責決定 RMPolicy,通用資源配接卡中的 XAResource 包裝程式僅將 isSameRM 呼叫委託給訊息佇列提供者的 XA 資源實作。這應該非常適用於大部份的訊息佇列產品。 一些 XAResource 實作 (例如 IBM MQ 系列) 的每個實體連線都必須有一個資源管理員,因此在單一作業事件中,如果由相同的佇列管理員進行內送和外送通訊時,則可能會發生問題。當 RMPolicy 設定為 OnePerPhysicalConnection 時,通用資源配接卡中 XAResource 包裝程式實作的 isSameRM 會在委託至包裝物件前,檢查這兩個 XAResource 是否使用相同的實體連線。 |