3.10　glassfish-resources.xml

説明

リソースに関する、Java EE RI固有の設定をするためのDDです。

glassfish-resources.xmlのルート要素はresourcesです。resources要素は、「要素の階層」で示すように、子要素と属性を含みます（それらの子要素と属性の配下にも、さらに、子要素と属性を含むことがあります）。

JDBCコネクションプールを作成する場合、接続するデータベースに応じて次の属性を指定します。

• HiRDBに接続する場合に指定する属性

  属性		値	備考
  /resources/jdbc-connection-pool要素のdatasource-classname属性		JP.co.Hitachi.soft.HiRDB.JDBC.PrdbDataSource	※1
  		JP.co.Hitachi.soft.HiRDB.JDBC.PrdbXADataSource	※2
  /resources/jdbc-connection-pool要素のres-type属性		javax.sql.DataSource	※1
  		javax.sql.XADataSource	※2
  /resources/jdbc-connection-pool要素のconnection-validation-method属性		custom-validation	※3
  /resources/jdbc-connection-pool要素のvalidation-classname属性		com.hitachi.software.javaee.jca.connectionvalidation.HiRDBConnectionValidation	※3
  /resources/jdbc-connection-pool/property要素	name属性の値がdescriptionのvalue属性	ポート番号	※1
  		環境変数グループ識別子	※2
  	name属性の値がDBHostNameのvalue属性	HiRDBのホスト名	−
  	name属性の値がXALocalCommitModeのvalue属性	true	※2、※4
  	name属性の値がXAOpenStringのvalue属性	環境変数グループ識別子+HiRDB.iniファイルのパス	※2
  	name属性の値がuserのvalue属性	ユーザー名	−
  	name属性の値がpasswordのvalue属性	パスワード	−

• Oracleに接続する場合に指定する属性

  属性		値	備考
  /resources/jdbc-connection-pool要素のdatasource-classname属性		oracle.jdbc.pool.OracleDataSource	※1
  		oracle.jdbc.xa.client.OracleXADataSource	※2
  /resources/jdbc-connection-pool要素のres-type属性		javax.sql.DataSource	※1
  		javax.sql.XADataSource	※2
  /resources/jdbc-connection-pool要素のconnection-validation-method属性		custom-validation	※3
  /resources/jdbc-connection-pool要素のvalidation-classname属性		org.glassfish.api.jdbc.validation.OracleConnectionValidation	※3
  /resources/jdbc-connection-pool/property要素	name属性の値がdatabaseNameのvalue属性	Oracle SID	※5
  	name属性の値がserverNameのvalue属性	Oracleのホスト名称、またはIPアドレス	※5
  	name属性の値がportNumberのvalue属性	ポート番号	※5
  	name属性の値がuserのvalue属性	ユーザー名	−
  	name属性の値がpasswordのvalue属性	パスワード	−
  	name属性の値がdriverTypeのvalue属性	thin	※5
  	name属性の値がurlのvalue属性	jdbc:oracle:thin:@Oracleのホスト名称、またはIPアドレス:ポート番号:Oracle SID	※5

注※1

XAトランザクションを使用しない場合に指定します。

注※2

XAトランザクションを使用する場合に指定します。

注※3

コネクション障害検知を行う場合だけ指定します。

注※4

このオプションは、トランザクションがグローバルトランザクションでないときに、オートコミット機能を有効にするかどうかを設定します。この設定がtrueでない場合、コネクション障害検知機能が正常に動作しません。コネクション障害検知機能を使用する場合、trueを指定します。

注※5

databaseName、serverName、portNumber、driverTypeの4つのプロパティーか、urlのどちらかを指定します。両方を指定した場合、urlが有効になり、それ以外の4つのプロパティーは無視されます。

スキーマ

<!DOCTYPE resources PUBLIC 
"-//GlassFish.org//DTD GlassFish Application Server 3.1 Resource Definitions
//EN" "http://glassfish.org/dtds/glassfish- resources_1_5.dtd">

格納先

DDファイルは次の場所に格納されます。

• application_ear_name/META-INF ディレクトリー

  application_ear_name：アプリケーションのアーカイブ名を表します。

• war_name/WEB-INF ディレクトリー

  war_name：Web アプリケーションのアーカイブ名を表します。

• ejb_jar_name/META-INF ディレクトリー

  ejb_jar_name：EJB アプリケーションのアーカイブ名を表します。

• client_jar_name/META-INF ディレクトリー

  client_jar_name：クライアントアプリケーションのアーカイブ名を表します。

• connector_rar_name/META-INF ディレクトリー

  connector_rar_name：リソースアダプターアーカイブのアーカイブ名を表します。

要素の階層

resources
. custom-resource
. . description
. . property
. external-jndi-resource
. . description
. . property
. . . description
. jdbc-resource
. . description
. . property
. . . description
. mail-resource
. . description
. . property
. . . description
. admin-object-resource
. . description
. . property
. . . description
. connector-resource
. . description
. . property
. . . description
. resource-adapter-config
. . property
. . . description
. jdbc-connection-pool
. . description
. . property
. . . description
. connector-connection-pool
. . description
. . security-map
. . . principal
. . . . name
. . . user-group
. . . backend-principal
. . property
. . . description
. work-security-map
. . description
. . principal-map
. . group-map

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE resources PUBLIC 
"-//GlassFish.org//DTD GlassFish Application Server 3.1 Resource Definitions
//EN" "http://glassfish.org/dtds/glassfish- resources_1_5.dtd">
<resources>
       <jdbc-connection-pool>
        <property name="serverName" value="localhost"/>
        <property name="portNumber" value="1527"/>
        <property name="databaseName" value="forest"/>
        <property name="User" value="forest"/>
        <property name="Password" value="forest"/>
        <property name="URL" value="jdbc:oracle://localhost:1527/forest"/>
    </jdbc-connection-pool>
    <jdbc-resource enabled="true" jndi-name="jdbc/forest" 
pool-name="oracle_net_forest_forestPool"/>
    <connector-connection-pool associate-with-thread="false" 
connection-creation-retry-attempts="0" />
</resources>