Sun Java System Application Server 9.1 管理指南

資源配接卡特性

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

特性名稱

有效值

預設值

說明

ProviderIntegrationMode

javabean/jndi

javabean

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

ConnectionFactoryClassName

Application Server 類別路徑中可供使用的類別名稱,例如: 

com.sun.messaging.ConnectionFactory

無 

JMS 用戶端的 javax.jms.ConnectionFactory 實作的類別名稱。只有當 ProviderIntegrationModejavabean 時才使用。

QueueConnectionFactoryClassName

Application Server 類別路徑中可供使用的類別名稱,例如: 

com.sun.messaging.QueueConnectionFactory

無 

JMS 用戶端的 javax.jms.QueueConnectionFactory 實作的類別名稱。只有當 ProviderIntegrationModejavabean 時才使用。

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 實作的類別名稱。只有當 ProviderIntegrationModejavabean 時才使用。

TopicClassName

Application Server 類別路徑中可供使用的類別名稱,例如: 

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 提供者負責決定 RMPolicy,通用資源配接卡中的 XAResource 包裝程式僅將 isSameRM 呼叫委託給訊息佇列提供者的 XA 資源實作。這應該非常適用於大部份的訊息佇列產品。

一些 XAResource 實作 (例如 IBM MQ 系列) 的每個實體連線都必須有一個資源管理員,因此在單一作業事件中,如果由相同的佇列管理員進行內送和外送通訊時,則可能會發生問題。當 RMPolicy 設定為 OnePerPhysicalConnection 時,通用資源配接卡中 XAResource 包裝程式實作的 isSameRM 會在委託至包裝物件前,檢查這兩個 XAResource 是否使用相同的實體連線。