Sun Java System Application Server Enterprise Edition 8.2 管理指南

資源配接卡特性

下表列出在建立資源配接卡時會用到的特性。

特性名稱

有效值

預設值

說明

ProviderIntegrationMode

javabean/jndi

javabean

決定資源配接卡和 JMS 用戶端之間的整合模式。 

ConnectionFactoryClassName

應用程式伺服器類別路徑中可供使用的類別名稱,例如: 

com.sun.messaging.ConnectionFactory

無 

JMS 用戶端的 javax.jms.ConnectionFactory 實作的類別名稱。會在 ProviderIntegrationModejavabean 時加以使用。

QueueConnectionFactoryClassName

應用程式伺服器類別路徑中可供使用的類別名稱,例如: 

com.sun.messaging.QueueConnectionFactory

無 

JMS 用戶端的 javax.jms.QueueConnectionFactory 實作的類別名稱。會在 ProviderIntegrationModejavabean 時加以使用。

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 實作的類別名稱。會在 ProviderIntegrationModejavabean 時加以使用。

TopicClassName

應用程式伺服器類別路徑中可供使用的類別名稱,例如: 

com.sun.messaging.Topic

無 

JMS 用戶端的 javax.jms.Topic 實作的類別名稱。會在 ProviderIntegrationModejavabean 時加以使用。

QueueClassName

應用程式伺服器類別路徑中可供使用的類別名稱,例如: 

 

com.sun.messaging.Queue

無 

JMS 用戶端的 javax.jms.Queue 實作的類別名稱。會在 ProviderIntegrationMode 指定為 javabean 時加以使用。

SupportsXA

True/false

FALSE

指定 JMS 用戶端是否支援 XA。 

ConnectionFactoryProperties

以逗號分隔的「名稱-值」對。 

無 

這指定 JMS 用戶端的 javabean 特性名稱以及 ConnectionFactory 的值。只有當 ProviderIntegrationModejavabean 時才會需要。

JndiProperties

以逗號分隔的「名稱-值」對。 

無 

這指定用來連線至 JMS 提供者之 JNDI 的 JNDI 提供者特性。只有當 ProviderIntegrationModejndi 時才會用到。

CommonSetterMethodName

方法名稱 

無 

這指定某些 JMS 供應商在設定其受管理物件的特性時,所使用的一般 setter 方法名稱。只有當 ProviderIntegrationModejavabean 時,才會用到這個特性。如果是 Sun Java System Message Queue,則此特性稱為 setProperty

UserName

JMS 使用者名稱 

無 

與 JMS 提供者連線時採用的使用者名稱。 

Password

JMS 使用者的密碼。 

無 

與 JMS 提供者連線時採用的密碼。 

RMPolicy

ProviderManagedOnePerPhysicalConnection

ProviderManaged

作業事件管理員使用 XAResource 上的 isSameRM 方法,來判斷由兩個 XAResources 所呈現的資源管理員實例是否相同。

RMPolicy 設定為 ProviderManaged (預設值) 時,由 JMS 提供者負責決定通用資源配接卡中的 RMPolicyXAResource 包裝程式,是否僅將 isSameRM 呼叫委託給訊息佇列提供者的 XA 資源實作。這應該非常適用於大部份的訊息佇列產品。

有些 XAResource 實作 (如 IBM MQ Series) 在進行每個實體連線時,都要仰賴資源管理員。單一作業事件中同一個佇列管理員進行內送和外送通訊時,會造成問題 (例如,當 MBD 傳送回應至目標時)。

RMPolicy 設定為 OnePerPhysicalConnection 時,通用資源配接卡中 XAResource 包裝程式實作的 isSameRM 會在委託至包裝物件前,檢查這兩個 XAResource 是否使用相同的實體連線。如需有關此特性的其他資訊,請參閱 Issue Tracker 資料庫中的問題 #5 (位於 Glassfish 網站)。