配置數(shù)據(jù)庫(kù)資源

大多數(shù)企業(yè)應(yīng)用程序使用關(guān)系數(shù)據(jù)庫(kù)。Community Edition 使用開(kāi)放源代碼的 TranQL 項(xiàng)目作為其數(shù)據(jù)庫(kù)持久性引擎。Community Edition 提供一般資源適配器來(lái)使 JDBC 驅(qū)動(dòng)程序可以作為 J2EE Connection Architecture (J2CA) 資源使用，并提供特定于 IBM Cloudscape 供應(yīng)商的資源適配器來(lái)使 Cloudscape 可以作為 Tranql 的 J2CA 資源使用。作為一種增值，Community Edition 還提供一個(gè) WebSphere 嵌入式資源適配器來(lái)使 Microsoft SQL 2000 服務(wù)器可以作為 J2CA 資源使用。了解 Community Edition 存儲(chǔ)庫(kù)中的下列文件將有助于您為數(shù)據(jù)源選擇正確的資源適配器以及制定數(shù)據(jù)庫(kù)部署計(jì)劃：

repository\tranql\rars\tranql-connector-1.0.rar：這是 TranQL Generic JDBC Resource Adapter，使用該資源適配器，可以通過(guò)一般 JDBC 連接來(lái)訪問(wèn) SQL 數(shù)據(jù)庫(kù)。連接是使用配置的 JDBC URL、用戶名和密碼從 java.sql.Driver 獲得的。因?yàn)榇私涌诓惶峁?duì) XAResource 的訪問(wèn)，所以只支持 Local 事務(wù)。
tranql-connector-derby-client-local-1.0.rar：這是用于 IBM Cloudscape 的 TranQL Client Local Transaction Resource Adapter。該資源適配器提供對(duì)具有本地事務(wù)支持的遠(yuǎn)程 IBM Cloudscape 數(shù)據(jù)庫(kù)的訪問(wèn)。
tranql-connector-derby-client-xa-1.0.rar：這是用于 IBM Cloudscape 的 TranQL Client XA Transaction Resource Adapter。該資源適配器提供對(duì)具有 XA 事務(wù)支持的遠(yuǎn)程 IBM Cloudscape 數(shù)據(jù)庫(kù)的訪問(wèn)。
tranql-connector-derby-embed-local-1.0.rar：這是用于 IBM Cloudscape 的 TranQL Embedded Local Resource Adapter。該資源適配器提供對(duì)具有本地事務(wù)支持的嵌入式 IBM Cloudscape 數(shù)據(jù)庫(kù)的訪問(wèn)。
tranql-connector-derby-embed-xa-1.0.rar：這是用于 IBM Cloudscape 的 TranQL Embedded XA Resource Adapter。該資源適配器提供對(duì)具有 XA 事務(wù)支持的嵌入式 IBM Cloudscape 數(shù)據(jù)庫(kù)的訪問(wèn)。
tranql-connector-websphere-embed-local-1.0.rar：這是用于 Microsoft SQL 2000 服務(wù)器的 TranQL IBM WebSphere Connect JDBC Driver Embedded Local Resource Adapter。該資源適配器提供對(duì)具有本地事務(wù)支持的 Microsoft SQL 2000 服務(wù)器數(shù)據(jù)庫(kù)的訪問(wèn)。
tranql-connector-websphere-embed-xa-1.0.rar：這是用于 Microsoft SQL 2000 服務(wù)器的 TranQL IBM WebSphere Connect JDBC Driver Embedded XA Resource Adapter。該資源適配器提供對(duì)具有 XA 事務(wù)支持的 Microsoft SQL 2000 服務(wù)器數(shù)據(jù)庫(kù)的訪問(wèn)。
上面提到的所有 TranQL rar 文件都包含在 tranql-1.1.ibm.jar 文件中，該文件是數(shù)據(jù)庫(kù)持久性引擎。
repository\org.apache.derby\jars：這個(gè)目錄包含 IBM Cloudscape 數(shù)據(jù)庫(kù)服務(wù)器 jar 文件。
repository\websphere\jars：這個(gè)目錄包含用于 Microsoft SQL 2000 數(shù)據(jù)庫(kù)服務(wù)器的 WebSphere 嵌入式 JDBC 驅(qū)動(dòng)程序。

您可能想知道為什么盡管 Community Edition 支持前面提到的 Oracle、DB2 或 MySQL 數(shù)據(jù)庫(kù)，但是卻沒(méi)有看到特定于這些數(shù)據(jù)庫(kù)的任何資源適配器。這是因?yàn)橛糜?Oracle、DB2 和 MySQL 數(shù)據(jù)庫(kù)服務(wù)器的 JDBC 驅(qū)動(dòng)程序并沒(méi)有包含在 Community Edition 安裝鏡像中。相反，將使用一般資源適配器 (tranql-connector-1.0.rar) 來(lái)部署用于 Oracle、DB2 和 MySQL 數(shù)據(jù)庫(kù)服務(wù)器的數(shù)據(jù)源，并將必需的特定于數(shù)據(jù)庫(kù)的類復(fù)制到 Community Edition 存儲(chǔ)庫(kù)中。與此有關(guān)的更多信息將在本文后面介紹。

數(shù)據(jù)庫(kù)配置池類型

Community Edition 支持下列三種數(shù)據(jù)庫(kù)配置池類型。您可以確定您的 J2EE 應(yīng)用程序需要哪種數(shù)據(jù)庫(kù)配置池類型。

服務(wù)器范圍的數(shù)據(jù)源：它用于在服務(wù)器上運(yùn)行的所有應(yīng)用程序。Community Edition 提供的 EMPdemo 示例使用該服務(wù)器范圍的數(shù)據(jù)源。
應(yīng)用程序范圍的數(shù)據(jù)源：它用于同一個(gè)應(yīng)用程序的一個(gè)或多個(gè)模塊。
模塊范圍的數(shù)據(jù)源：它只用于應(yīng)用程序中的某個(gè)特定模塊。Community Edition 提供的 daytrader 示例使用該模塊范圍的數(shù)據(jù)源。

配置數(shù)據(jù)庫(kù)池

不管您決定使用哪種數(shù)據(jù)庫(kù)配置池類型，您都需要制定一個(gè)數(shù)據(jù)庫(kù)池部署計(jì)劃。在數(shù)據(jù)庫(kù)池部署計(jì)劃中，您可以指定數(shù)據(jù)源配置 ID、其父 ID、依賴項(xiàng)和資源適配器配置信息，例如數(shù)據(jù)源名稱、池大小的最小值和最大值。通過(guò)使用 EMPdemo 示例提供的數(shù)據(jù)庫(kù)池部署計(jì)劃，我們將向您介紹如何理解和修改此計(jì)劃以制定自己的數(shù)據(jù)庫(kù)部署計(jì)劃。

定義數(shù)據(jù)源配置 ID 和父 ID：數(shù)據(jù)庫(kù)部署計(jì)劃的下列部分指定 configId，對(duì)于 Community Edition 服務(wù)器實(shí)例，它必須是唯一的。如果在部署數(shù)據(jù)源時(shí)父 ID（parentId 的值）沒(méi)有運(yùn)行，則部署工具會(huì)首先啟動(dòng)該父 ID 以確保其可用。在 EMPdemo 示例中，數(shù)據(jù)庫(kù)部署計(jì)劃的這一部分對(duì)不同的數(shù)據(jù)庫(kù)服務(wù)器來(lái)說(shuō)是一樣的（清單 1）。?
清單 1：EMPdemo Cloudscape 數(shù)據(jù)庫(kù)池部署計(jì)劃（第 I 部分）

<?xml version="1.0"?> <connector xmlns="http://geronimo.apache.org/xml/ns/j2ee/connector-1.0" configId="EmployeeDatasource" parentId="org/apache/geronimo/Server">

• 定義依賴元素：dependency 元素定義所有數(shù)據(jù)源依賴項(xiàng)及其相對(duì)于 Community Edition 存儲(chǔ)庫(kù)的相對(duì)路徑（清單 2）。IBM Cloudscape 數(shù)據(jù)庫(kù)服務(wù)器及其特定于供應(yīng)商的 tranql 資源適配器是隨 Community Edition 一起提供的，所以您不必?fù)?dān)心要將 jar 文件復(fù)制到存儲(chǔ)庫(kù)中。通過(guò)將它們指定為依賴項(xiàng)，您可以免于將它們包含在自己的應(yīng)用程序中。?
  

清單 2：EMPdemo Cloudscape 數(shù)據(jù)庫(kù)池部署計(jì)劃（第 II 部分）

<dependency> <uri>org.apache.derby/jars/derby-10.1.ibm.jar</uri> </dependency> <dependency>s <uri>org.apache.derby/jars/derbynet-10.1.ibm.jar</uri> </dependency>

正如前面提到的，Community Edition 也包含用于 Microsoft SQL 2000 服務(wù)器的 WebSphere 嵌入式 Tranql 資源適配器和 WebSphere 嵌入式類型 4 JDBC 驅(qū)動(dòng)程序（jar 文件在 repository\websphere\jars 目錄中）。根據(jù)這一事實(shí)，您可以提供以下訪問(wèn) Microsoft SQL 2000 服務(wù)器的數(shù)據(jù)源的依賴元素（清單 3）。
清單 3：EMPdemo Microsoft SQL 數(shù)據(jù)庫(kù)池部署計(jì)劃（第 II 部分）

<dependency> <uri>websphere/jars/base-3.5.11.jar</uri> </dependency> <dependency> <uri>websphere/jars/util-3.5.11.jar</uri> </dependency> <dependency> <uri>websphere/jars/sqlserver-3.5.11.jar</uri> </dependency>

如果您要為 Oracle、DB2 或 MySQL 服務(wù)器構(gòu)建 dependency 元素，則可以遵循相同的模式。但是，您需要在 Community Edition 存儲(chǔ)庫(kù)中創(chuàng)建目錄和子目錄，將 JDBC 驅(qū)動(dòng)程序 jar 文件從數(shù)據(jù)庫(kù)服務(wù)器復(fù)制到新建的目錄中，并在嘗試部署數(shù)據(jù)庫(kù)部署計(jì)劃之前在 uri 依賴元素中指定該 jar 文件及其路徑。

• 配置資源適配器
  
• IBM Cloudscape 數(shù)據(jù)庫(kù)：配置用于 IBM Cloudscape 的資源適配器非常簡(jiǎn)單，因?yàn)?Community Edition 已經(jīng)提供了特定于 Cloudscape 的資源適配器。您不需要輸入 JDBC 驅(qū)動(dòng)程序信息。如果您將 CreateDatabase 屬性設(shè)置為 True，則也不需要事先創(chuàng)建數(shù)據(jù)庫(kù)。如果您利用下面的示例，則只需要修改 name、UserName、Password、DatabaseName 和 CreateDatabase 元素并配置數(shù)據(jù)庫(kù)池，這樣就可以構(gòu)建自己的用于 Cloudscape 的資源適配器配置（清單 4）。name 元素定義其他模塊將用于引用此連接池的名稱。它在您定義的數(shù)據(jù)庫(kù)池范圍內(nèi)必須是唯一的。例如，jdbc/EmployeeDatasource 在服務(wù)器范圍內(nèi)必須是唯一的，因?yàn)樵撆渲糜糜诜?wù)器范圍的數(shù)據(jù)源。您還需要指定 name、UserName、Password、DatabaseName 和 CreateDatabase 元素。?
  

max-size 元素定義允許的最大并發(fā)連接數(shù)。min-size 元素定義允許的最小并發(fā)連接數(shù)。blocking-timeout-milliseconds 元素定義在從池中獲取連接時(shí)等待的毫秒數(shù)，此后將放棄連接。idle-timeout-minutes 元素定義在連接關(guān)閉并從池中刪除之前可以保持空閑狀態(tài)的分鐘數(shù)。
您可能還想知道為什么將 global-jndi-name 元素注釋掉了。這是因?yàn)樵趪L試從 J2EE 應(yīng)用程序客戶端連接到數(shù)據(jù)源時(shí)才使用該元素。EMPdemo 示例中沒(méi)有 J2EE 應(yīng)用程序客戶端。有關(guān) Cloudscape 資源適配器的詳細(xì)信息，請(qǐng)參見(jiàn) tranql-connector-derby-client-local-1.0.rar、tranql-connector-derby-client-xa-1.0.rar、tranql-connector-derby-embed-local-1.0.rar 和 tranql-connector-derby-embed-xa-1.0.rar 文件中的 ra.xml 文件。
清單 4：EMPdemo Cloudscape 數(shù)據(jù)庫(kù)池部署計(jì)劃（第 III 部分）

<resourceadapter> <outbound-resourceadapter> <connection-definition> <connectionfactory-interface>javax.sql.DataSource </connectionfactory-interface> <connectiondefinition-instance> <name>jdbc/EmployeeDatasource</name> <config-property-setting name="UserName"> </config-property-setting> <config-property-setting name="Password"> </config-property-setting> <config-property-setting name="DatabaseName">Employee </config-property-setting> <config-property-setting name="CreateDatabase">true </config-property-setting> <connectionmanager> <xa-transaction> <transaction-caching/> </xa-transaction> <single-pool> <max-size>5</max-size> <min-size>0</min-size> <blocking-timeout-milliseconds>5000 </blocking-timeout-milliseconds> <idle-timeout-minutes>15</idle-timeout-minutes> <match-one/> </single-pool> </connectionmanager> <!--global-jndi-name>EmployeeDatasource</global-jndi-name--> </connectiondefinition-instance> </connection-definition> </outbound-resourceadapter> </resourceadapter> </connector>

• Oracle 數(shù)據(jù)庫(kù)：正如前面提到的，Community Edition 提供了特定于 IBM Cloudscape 和 Microsoft SQL Server 2000 的資源適配器。對(duì)于 Oracle、DB2或 MySQL 數(shù)據(jù)庫(kù)，您需要使用一般資源適配器，它允許您為 JDBC 驅(qū)動(dòng)程序指定 Driver 和 ConnectionURL（清單 5）。有關(guān)一般資源適配器的詳細(xì)信息，請(qǐng)參見(jiàn) tranql-connector-1.0.rar 文件中的 ra.xml 文件。?
  

清單 5：EMPdemo Oracle 數(shù)據(jù)庫(kù)資源適配器配置

... <config-property-setting name="UserName">wasce</config-property-setting> <config-property-setting name="Password">password</config-property-setting> <config-property-setting name="Driver">oracle.jdbc.driver.OracleDriver</ config-property-setting> <config-property-setting name="ConnectionURL">jdbc:oracle:thin: @oracleServer.ibm.com:1521:orcl</config-property-setting> ...

• IBM DB2 數(shù)據(jù)庫(kù)：IBM DB2 數(shù)據(jù)庫(kù)資源適配器配置與 Oracle 相同，唯一不同之處在于需要指定特定于 DB2 的 UserName、Password、Driver 和 ConnectionURL 元素（清單 6）。?
  

清單 6：Daytrader DB2 數(shù)據(jù)庫(kù)資源適配器配置

... <config-property-setting name="UserName">db2inst1</config-property-setting> <config-property-setting name="Password">password</config-property-setting> <config-property-setting name="Driver">com.ibm.db2.jcc.DB2Driver</config-property-setting> <config-property-setting name="ConnectionURL">jdbc:db2://db2.raleigh.ibm.com:50001/tradedb </config-property-setting> ...

• Microsoft SQL 2000 服務(wù)器：作為 Apache Geronimo 的一種增值，Community Edition 提供了用于 Microsoft SQL 2000 服務(wù)器的 WebSphere 嵌入式 Tranql 資源適配器，它為您處理 Driver 和 ConnectionURL 信息，所以您只需要指定 ServerName 和 DatabaseName（清單 7）。如果您的 SQL Server 在不同于缺省端口 (1433) 的其他端口上運(yùn)行，則可以在 DatabaseName 元素之后指定 PortNumber 屬性。有關(guān)資源適配器的詳細(xì)信息，請(qǐng)參見(jiàn) tranql-connector-websphere-embed-local-1.0.rar 和 tranql-connector-websphere-embed-xa-1.0.rar 文件中的 ra.xml 文件。?
  

清單 7：EMPdemo Microsoft SQL 數(shù)據(jù)庫(kù)資源適配器配置

... <config-property-setting name="UserName">wasce</config-property-setting> <config-property-setting name="Password">password</config-property-setting> <config-property-setting name="ServerName">servername.ibm.com</config-property-setting> <config-property-setting name="DatabaseName">wascedb</config-property-setting> ...

部署和修改數(shù)據(jù)庫(kù)池

部署數(shù)據(jù)庫(kù)池：您已經(jīng)了解了如何制定數(shù)據(jù)庫(kù)部署計(jì)劃，以及對(duì)于不同的數(shù)據(jù)庫(kù)服務(wù)器應(yīng)該使用什么資源適配器。現(xiàn)在，我們來(lái)演練如何在 Community Edition 服務(wù)器上使用 bin 目錄中的部署工具來(lái)部署數(shù)據(jù)庫(kù)池（清單 8）。
清單 8：部署 EMPdemo Cloudscape 數(shù)據(jù)源

deploy.[bat|sh] --user system --password manager deploy ..\repository\tranql\rars\ tranql-connector-derby-embed-xa-1.0.rar Cloudscape-db-plan.xml

在運(yùn)行部署命令的命令窗口中，您將看到一個(gè)指示數(shù)據(jù)庫(kù)池是否已經(jīng)部署成功的輸出。必要時(shí)替換管理員用戶名和密碼。如果您想要使用其他資源適配器，則可以用您選擇的資源適配器來(lái)替換上面的 rar 文件。例如，如果您部署 EMPdemo Oracle 數(shù)據(jù)庫(kù)，則將 tranql-connector-derby-embed-xa-1.0.rar 替換為 tranql-connector-1.0.rar，將 Cloudscape-db-plan 替換為 EMPdemo Oracle 數(shù)據(jù)庫(kù)部署計(jì)劃 (oracle-db-plan.xml)。

修改數(shù)據(jù)庫(kù)池：該部署工具并沒(méi)有提供修改命令。要修改數(shù)據(jù)庫(kù)池，您需要取消部署該數(shù)據(jù)庫(kù)池然后再部署它。

使用數(shù)據(jù)庫(kù)池

要使用您剛部署的數(shù)據(jù)庫(kù)池，請(qǐng)定義 Apache Geronimo 部署計(jì)劃中的特定資源引用來(lái)引用它（清單 9）。您還需要在 web.xml 中聲明該資源引用，并在應(yīng)用程序代碼中通過(guò) JNDI 查找數(shù)據(jù)庫(kù)池。有關(guān)詳細(xì)信息，可以查看 EMPdemo home 目錄中的 src\webapp\WEB-INF\web.xml 和 src\webapp\jsp\EMPdemo.jsp 文件。
清單 9：EMPdemo 部署計(jì)劃中的 resource-ref 元素

<resource-ref> <ref-name>jdbc/DataSource</ref-name> <resource-link>jdbc/EmployeeDatasource</resource-link> </resource-ref>

配置 Java Message Service

Java Message Service (JMS) 支持在不同的應(yīng)用程序組件之間發(fā)送消息，即使在分發(fā)時(shí)也如此。消息驅(qū)動(dòng) Bean 使用 JMS 來(lái)接收消息，然后可能根據(jù)這些消息來(lái)采取某種操作。

ActiveMQ

Community Edition 中的 JMS 支持是由 ActiveMQ 提供的。ActiveMQ 是一個(gè) JMS 1.1 提供程序，它完全支持遵循 J2EE 1.4 的服務(wù)器，包括 Community Edition。它還包含一個(gè) Java Connector Architecture (JCA) 1.5 資源適配器，該資源適配器允許應(yīng)用服務(wù)器連接到池、管理事務(wù)和控制連接器安全性。對(duì) JMS 資源的訪問(wèn)是由遵循 ActiveMQ JCA 的資源適配器提供的。目前，ActiveMQ 是唯一已知可以用于 Community Edition 的 JMS 提供程序。

JMS 消息代理

ActiveMQ 服務(wù)器（或消息代理）在缺省情況下是在 Community Edition 服務(wù)器啟動(dòng)時(shí)啟動(dòng)的。其配置 (org/apache/geronimo/ActiveMQServer) 是在 system-activemq-plan.xml（可以在 wasce_install_root/doc/plan 目錄中找到）中定義的。此配置包括兩個(gè)傳輸：一個(gè)在端口 61616 上運(yùn)行的 TCP 傳輸和一個(gè)在相同 JVM 上運(yùn)行的客戶端的直接傳輸（清單 10）。ActiveMQ 支持的其他傳輸包括 SSL、NIO、UDP、多播、JGroup 和 JXTA 傳輸。
清單 10：在 system-activemq-plan.xml 中定義的傳輸

<gbean gbeanName="geronimo.server:J2EEApplication=null, J2EEModule=org/apache/geronimo/ActiveMQServer,J2EEServer=geronimo, j2eeType=JMSConnector,broker=ActiveMQ,name=ActiveMQ.tcp.default" class="org.activemq.gbean.ActiveMQConnectorGBean"> <attribute name="protocol">tcp</attribute> <attribute name="host">0.0.0.0</attribute> <attribute name="port">61616</attribute> <reference name="activeMQContainer"> <gbean-name>geronimo.server:j2eeType=JMSServer,name=ActiveMQ,* </gbean-name></reference> </gbean> <gbean gbeanName="geronimo.server:J2EEApplication=null, J2EEModule=org/apache/geronimo/ActiveMQServer,J2EEServer=geronimo,j2eeType=JMSConnector, broker=ActiveMQ,name=ActiveMQ.vm.localhost" class="org.activemq.gbean.ActiveMQConnectorGBean"> <attribute name="protocol">vm</attribute> <attribute name="host">localhost</attribute> <attribute name="port">-1</attribute> <reference name="activeMQContainer"> <gbean-name>geronimo.server:j2eeType=JMSServer,name=ActiveMQ,* </gbean-name></reference> </gbean>

消息代理配置的建議更改方式是使用 config.xml 來(lái)配置正確的屬性。有關(guān)使用 config.xml 來(lái)配置服務(wù)器屬性的更多信息，請(qǐng)參見(jiàn)第 1 部分。問(wèn)題在于，在實(shí)際操作中很難確定哪些是正確的 gbean 屬性以及它們是否是可管理的。另外，建議不要重新部署 system-activemq-plan.xml，因?yàn)檫@種方式以后會(huì)導(dǎo)致問(wèn)題的出現(xiàn)。如果您知道屬性名稱（以及它們是否可管理），則可以通過(guò)編輯 config.xml 來(lái)更改這些計(jì)劃，然后重新部署它們。

配置 JMS 資源

消息代理僅在有配置目標(biāo)時(shí)才有用。在 Community Edition 中創(chuàng)建和配置這些資源意味著部署一個(gè)帶有如何與消息代理通信的信息的資源適配器實(shí)例。要獲得示例，請(qǐng)查看 system-jms-plan.xml（可以在 wasce_install_root/doc/plan 目錄中找到）。此計(jì)劃將創(chuàng)建一個(gè)資源適配器實(shí)例和一個(gè)連接工廠，后者是創(chuàng)建供內(nèi)部使用的兩個(gè)隊(duì)列（MDBTransferBeanOutQueue 和 SendReceiveQueue）所需要的（清單 11）。
清單 11：system-jms-plan.xml 中定義的連接器

<connector xmlns="http://geronimo.apache.org/xml/ns/j2ee/connector-1.0" configId="org/apache/geronimo/SystemJMS" parentId="org/apache/geronimo/ActiveMQServer"> <resourceadapter> <resourceadapter-instance> <resourceadapter-name>ActiveMQ RA</resourceadapter-name> <config-property-setting name="ServerUrl" >tcp://0.0.0.0:61616</config-property-setting> ... </resourceadapter-instance> ... </resourceadapter> ... <adminobject> <adminobject-interface>javax.jms.Queue</adminobject-interface> <adminobject-class>org.codehaus.activemq.message.ActiveMQQueue </adminobject-class> <adminobject-instance> <message-destination-name>SendReceiveQueue</message-destination-name> <config-property-setting name="PhysicalName" >SendReceiveQueue</config-property-setting> </adminobject-instance> </adminobject> </connector>

要?jiǎng)?chuàng)建自己的資源適配器實(shí)例，您可以從 system-jms-plan.xml 計(jì)劃復(fù)制連接器元素，為其提供自己的 configId，并用自己的隊(duì)列和主題來(lái)替換其隊(duì)列。將連接器元素復(fù)制到哪里取決于您想讓連接器實(shí)例擁有的作用域。您可以將資源適配器定義和部署為對(duì)所有其他模塊可見(jiàn)的獨(dú)立連接器，方法是將其放在自己的計(jì)劃中并用對(duì) activemq rar 文件的引用來(lái)部署它：

deploy.[bat|sh] deploy my-jms-plan.xml ..\repository\activemq\rars\activemq-ra-3.2-M1.ibm.rar

另一種選擇是在應(yīng)用程序或模塊范圍內(nèi)創(chuàng)建資源適配器實(shí)例。

dayTrader 示例應(yīng)用程序是一個(gè)擁有自己的資源適配器實(shí)例的應(yīng)用程序示例。它引用一個(gè)隊(duì)列 (TradeBrokerQueue) 和一個(gè)主題 (TradeStreamerTopic)。這些資源的定義可以在 daytrader-plan.xml 中的一個(gè) ext-module 元素內(nèi)找到（清單 12）。通過(guò) ext-module 元素 dayTrader，您可以使用現(xiàn)有的 Active MQ 連接器副本，而不必將其包含在應(yīng)用程序中。
清單 12：dayTrader 的 JMS 資源使用現(xiàn)有的 Active MQ 連接器副本

<ext-module> <connector>TradeJMS</connector> <external-path>activemq/rars/activemq-ra-3.2-M1.ibm.rar</external-path> <connector xmlns="http://geronimo.apache.org/xml/ns/j2ee/connector" xmlns:naming="http://geronimo.apache.org/xml/ns/naming" configId="TradeJMS" parentId="TradeDataSource"> ... </connector> </ext-module>

system-jms-plan.xml 中的資源適配器實(shí)例和 daytrader-plan.xml 中的資源適配器實(shí)例都是使用相同的信息配置的：如何連接到 JMS 服務(wù)器、在創(chuàng)建新的資源時(shí)隊(duì)列和主題連接工廠應(yīng)該使用什么設(shè)置，以及對(duì)隊(duì)列和主題的引用。這些與您在配置自己的資源適配器實(shí)例時(shí)需要提供的信息是相同的。

該連接器中的 adminobject 元素的作用在于將應(yīng)用程序的 J2EE 描述符中聲明的消息目的地引用與真正的物理目的地連接起來(lái)。例如，在 daytrader 的 ejb-jar.xml 文件中聲明了用于 TradeBrokerQueue 和 TradeStreamerStopic 的 message-destination-ref 元素（清單 13）。
清單 13：ejb-jar.xml 中 dayTrader 的消息目的地引用

<message-destination-ref> <message-destination-ref-name>jms/TradeBrokerQueue</message-destination-ref-name> <message-destination-type>javax.jms.Queue</message-destination-type> <message-destination-usage>Produces</message-destination-usage> <message-destination-link>TradeBrokerQueue</message-destination-link> </message-destination-ref> <message-destination-ref> <message-destination-ref-name>jms/TradeStreamerTopic</message-destination-ref-name> <message-destination-type>javax.jms.Topic</message-destination-type> <message-destination-usage>Produces</message-destination-usage> <message-destination-link>TradeStreamerTopic</message-destination-link> </message-destination-ref>

因?yàn)?adminobject 元素只在消息目的地引用與物理目的地之間映射，所以它們可以在多個(gè)位置建立映射。dayTrader 的 J2EE 應(yīng)用程序客戶端 (tradeStreamerAppclient) 也有一個(gè)資源適配器實(shí)例，它知道如何與 Community Edition 服務(wù)器進(jìn)行通信，只要該服務(wù)器可以通過(guò)指定的 serverUrl 訪問(wèn)即可。在本例中，它為 tcp://localhost:61616。此客戶端也有一個(gè) adminobject 元素，該元素將 TradeStreamerTopic 引用映射到其真正的目的地。

其他有用的資源

下一部分為您提供其他資源。

配置 SSL

Community Edition 支持使用安全套接字層 (SSL) 來(lái)保護(hù)使用 HTTPS 協(xié)議訪問(wèn)的 Web 資源。Enterprise JavaBeans 的 SSL 支持還不可用。缺省情況下，Community Edition 在端口 8443 上啟動(dòng) HTTPS 連接器來(lái)訪問(wèn) Web 應(yīng)用程序。此初始配置使用了一個(gè)密鑰存儲(chǔ)，您可以將其用于測(cè)試，但不能將其用于生產(chǎn)環(huán)境。由于 Community Edition 的每個(gè)副本都分發(fā)相同的密鑰存儲(chǔ)，因此不再認(rèn)為該密鑰是機(jī)密的。如果您需要更改初始配置、現(xiàn)有的密鑰存儲(chǔ)，或者可信的實(shí)體，則最值得參考的資料是 Community Edition 文檔。相關(guān)部分包括：

• Configuring an HTTPS connector
  
• Managing SSL certificates
  
• Managing trust
  

用 LDAP 配置 Community Edition

Community Edition 支持對(duì)目錄服務(wù)器進(jìn)行 Lightweight Directory Access Protocol (LDAP) 身份驗(yàn)證。您既可以使用 IBM LDAP 服務(wù)器，也可以使用 Apache LDAP Directory。不管您選擇哪種 LDAP 服務(wù)器，都需要首先對(duì)其進(jìn)行安裝和設(shè)置，因?yàn)?Community Edition 不提供任何 LDAP 服務(wù)器。您還需要制定一個(gè)特定于 Community Edition 的 LDAP 安全領(lǐng)域計(jì)劃，它通過(guò)將登錄模塊配置連接到該領(lǐng)域來(lái)定義 GenericSecurityRealm 的名稱及其身份驗(yàn)證策略。有關(guān)此主題的更多信息，請(qǐng)參閱 Configuring Apache LDAP Directory。

配置 CORBA over IIOP

Common Object Request Broker Architecture (CORBA) 是一個(gè)與供應(yīng)商無(wú)關(guān)的體系結(jié)構(gòu)和基礎(chǔ)設(shè)施，它允許計(jì)算機(jī)應(yīng)用程序通過(guò)網(wǎng)絡(luò)一起工作。Community Edition 同時(shí)為 Sun? 和 IBM JDK/JRE 提供 CORBA 支持。如果您的應(yīng)用程序?qū)?CORBA 用于 IBM JDK/JRE，請(qǐng)確保您有支持的 JDK/JRE ifix，它們?cè)诋a(chǎn)品文檔中有記錄。有關(guān) CORBA 配置的更多信息，請(qǐng)參閱 Forge ahead with Geronimo CORBA interoperability。

本文轉(zhuǎn)自BlogJava 新浪blog的博客，原文鏈接：WASCE （基于geronimo ） 配置，如需轉(zhuǎn)載請(qǐng)自行聯(lián)系原博主。

總結(jié)

以上是生活随笔為你收集整理的WASCE （基于geronimo ） 配置的全部?jī)?nèi)容，希望文章能夠幫你解決所遇到的問(wèn)題。

如果覺(jué)得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。