下表列出在建立資源配接卡時會用到的特性。
特性名稱 |
有效值 |
預設值 |
說明 |
---|---|---|---|
ProviderIntegrationMode |
javabean/jndi |
javabean |
決定資源配接卡和 JMS 用戶端之間的整合模式。 |
ConnectionFactoryClassName |
應用程式伺服器類別路徑中可供使用的類別名稱,例如: com.sun.messaging.ConnectionFactory |
無 |
JMS 用戶端的 javax.jms.ConnectionFactory 實作的類別名稱。會在 ProviderIntegrationMode 為 javabean 時加以使用。 |
QueueConnectionFactoryClassName |
應用程式伺服器類別路徑中可供使用的類別名稱,例如: com.sun.messaging.QueueConnectionFactory |
無 |
JMS 用戶端的 javax.jms.QueueConnectionFactory 實作的類別名稱。會在 ProviderIntegrationMode 為 javabean 時加以使用。 |
TopicConnectionFactoryClassName |
應用程式伺服器類別路徑中可供使用的類別名稱,例如: com.sun.messaging.TopicConnectionFactory |
無 |
JMS 用戶端的 javax.jms.TopicConnectionFactory 實作的類別名稱。會在 ProviderIntegrationMode 指定為 javabean 時加以使用。 |
XAConnectionFactoryClassName |
應用程式伺服器類別路徑中可供使用的類別名稱,例如: com.sun.messaging.XAConnectionFactory |
無 |
JMS 用戶端的 javax.jms.ConnectionFactory 實作的類別名稱。會在 ProviderIntegrationMode 指定為 javabean 時加以使用。 |
XAQueueConnectionFactoryClassName |
應用程式伺服器類別路徑中可供使用的類別名稱,例如: com.sun.messaging.XAQueueConnectionFactory |
無 |
JMS 用戶端的 javax.jms.XAQueueConnectionFactory 實作的類別名稱。會在 ProviderIntegrationMode 指定為 javabean 時加以使用。 |
XATopicConnectionFactoryClassName |
應用程式伺服器類別路徑中可供使用的類別名稱,例如: com.sun.messaging.XATopicConnectionFactory |
無 |
JMS 用戶端的 javax.jms.XATopicConnectionFactory 實作的類別名稱。會在 ProviderIntegrationMode 是 javabean 時加以使用。 |
TopicClassName |
應用程式伺服器類別路徑中可供使用的類別名稱,例如: 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 Series) 在進行每個實體連線時,都要仰賴資源管理員。單一作業事件中同一個佇列管理員進行內送和外送通訊時,會造成問題 (例如,當 MBD 傳送回應至目標時)。 當 RMPolicy 設定為 OnePerPhysicalConnection 時,通用資源配接卡中 XAResource 包裝程式實作的 isSameRM 會在委託至包裝物件前,檢查這兩個 XAResource 是否使用相同的實體連線。如需有關此特性的其他資訊,請參閱 Issue Tracker 資料庫中的問題 #5 (位於 Glassfish 網站)。 |