記述形式
名前変換ファイルの記述形式はXML形式です。名前変換ファイルの記述形式を以下に示します。
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE fujitsu-ebe-definition SYSTEM 'fujitsu-ebe-definition.dtd'> <fujitsu-ebe-definition> <client> <app-name>app-name</app-name> <ejb-ref-entry> <ejb-ref-name>ejb-ref-name</ejb-ref-name> <jndi-name>jndi-name</jndi-name> </ejb-ref-entry> <res-entry> <res-ref-name>res-ref-name</res-ref-name> <datasource-name>datasource-name</datasource-name> </res-entry> <res-env-entry> <res-env-ref-name>res-env-ref-name</res-env-ref-name> <environment-name>environment-name</environment-name> </res-env-entry> <message-destination-entry> <message-destination-name>message-destination-name</message-destination-name> <jndi-name>jndi-name</jndi-name> </message-destination-entry> </client> </fujitsu-ebe-definition>
1行目、2行目は、XML宣言、およびDTD(文書型定義)を記述しているため、名前変換ファイルの先頭で必ず記述してください。
J2EEアプリケーションクライアント用の定義で、値の文字列に日本語を使用する場合は、エンコード形式(「encoding=」部分)に、“Shift_JIS”等の適切な値を指定してください。
3行目、最終行の<fujitsu-ebe-definition>、</fujitsu-ebe-definition>は、XMLファイルの開始と終了を示すルートタグです。必ず指定してください。
各タグの記載順序は、上記の記載順序に従ってください。
太字部分は、必ず指定する必要があります。<app-name>は必須です。
斜体文字の部分は任意の文字列を指定します。空白、タブ、改行などの制御文字は使用できません。なお、斜体文字部分は、大文字小文字が区別されます。
XMLファイルで、特別な意味をもつ文字(<、>、&)を使用する場合は、変換定義に従って、以下のように記述してください。
使用したい文字 | 名前変換ファイルでの記述 |
---|---|
< | < |
> | > |
& | & |
値の文字列に"'"、および"""を記述した場合は、それぞれシングルクォーテーション(')、ダブルクォーテーション(")と解釈されます。
タグの説明
タグ | 説明 | |
---|---|---|
<client> | J2EEアプリケーションクライアントの場合に指定します。複数回指定可能です。 | |
<app-name> | 名前変換を行うアプリケーション名を指定します。 | |
<ejb-ref-entry> | EJBオブジェクトの名前変換を定義します。複数回指定可能です。 | |
| <ejb-ref-name> | deployment descriptorの参照名を指定します。 |
<jndi-name> | <ejb-ref-name>に対応するEJBアプリケーション名(運用環境の実名)を指定します。 | |
<res-entry> | JDBCデータソース、JMS(QueueConnectionFactory,TopicConnectionFactory)、JavaMail、connector、URLの名前変換を定義します。複数回指定可能です。 | |
| <res-ref-name> | deployment descriptorの参照名を指定します。 |
<datasource-name> | <res-ref-name>に対応するリソースアクセス定義名(運用環境の実名)を指定します。 | |
<res-env-entry> | JMS Destination(Queue,Topic)の名前変換を定義します。複数回指定可能です。 | |
| <res-env-ref-name> | deployment descriptorの参照名を指定します。 |
<environment-name> | <res-env-ref-name>に対応するリソースアクセス定義名(運用環境の実名)を指定します。 | |
<message-destination-entry> | JMS Destinationの名前変換を定義します。複数回指定可能です。 | |
| <message-destination-name> | deployment descriptorの参照名を指定します。 |
<jndi-name> | <message-destination-name>に対応するJMS Destination定義名(運用環境の実名)を指定します。 |
注) 参照名を重複して定義した場合は、最後の定義が有効になります。
記述例(J2EEアプリケーションクライアント)
deployment descriptorの参照名と運用環境の実名が以下の場合について、名前変換ファイルの記述例を示します。
| deployment descriptorの参照名 | 運用環境の実名 |
---|---|---|
EJB | ejb/EntBean | EB1 |
リソース参照(JDBC) | jdbc/DataSource | DS1 |
リソース参照(JMS) | jms/TopicCF | CF1 |
リソース環境参照 | jms/Topic | DN1 |
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE fujitsu-ebe-definition SYSTEM 'fujitsu-ebe-definition.dtd'> <fujitsu-ebe-definition> <client> <app-name>GetBeans</app-name> <ejb-ref-entry> <ejb-ref-name>ejb/EntBean</ejb-ref-name> <jndi-name>EB1</jndi-name> </ejb-ref-entry> <res-entry> <res-ref-name>jdbc/DataSource</res-ref-name> <datasource-name>DS1</datasource-name> </res-entry> <res-entry> <res-ref-name>jms/TopicCF</res-ref-name> <datasource-name>CF1</datasource-name> </res-entry> <res-env-entry> <res-env-ref-name>jms/Topic</res-env-ref-name> <environment-name>DN1</environment-name> </res-env-entry> </client> </fujitsu-ebe-definition>