以下に、J2EEアプリケーションクライアントのdeployment descriptorファイルの記述形式を説明します。
deployment descriptorのファイル名は任意で拡張子を.xmlとします。
deployment descriptorファイルは、任意のディレクトリに配置し、環境プロパティでファイル名をフルパスで指定します。
記述形式
deployment descriptorの記述形式はXML形式です。deployment descriptorの記述例を以下に示します。
J2EE1.4のdeployment descriptor
<?xml version="1.0" encoding="UTF-8"?> <application-client version="1.4"
xmlns="http://java.sun.com/xml/ns/j2ee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee
http://java.sun.com/xml/ns/j2ee/application-client_1_4.xsd">
<icon> <small-icon>small_icon</small-icon> <large-icon>large_icon</large-icon> </icon> <display-name>display_name</display-name> <description>description</description> <env-entry> <description>description</description> <env-entry-name>name</env-entry-name> <env-entry-type>type</env-entry-type> <env-entry-value>value</env-entry-value> </env-entry> <ejb-ref> <description>description</description> <ejb-ref-name>name</ejb-ref-name> <ejb-ref-type>type</ejb-ref-type> <home>home</home> <remote>remote</remote> <ejb-link>link</ejb-link> </ejb-ref> <resource-ref> <description>description</description> <res-ref-name>name<res-ref-name> <res-type>type</res-type> <res-auth>auth</res-auth> </resource-ref> <resource-env-ref> <description>description</description> <resource-env-ref-name>name</resource-env-ref-name> <resource-env-ref-type>type</resource-env-ref-type> </resource-env-ref> </application-client>
J2EE1.3のdeployment descriptor
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE application-client PUBLIC
"-//Sun Microsystems, Inc.//DTD J2EE Application Client 1.3//EN"
"http://java.sun.com/dtd/application-client_1_3.dtd"> <application-client> <icon> <small-icon>small_icon</small-icon> <large-icon>large_icon</large-icon> </icon> <display-name>display_name</display-name> <description>description</description> <env-entry> <description>description</description> <env-entry-name>name</env-entry-name> <env-entry-type>type</env-entry-type> <env-entry-value>value</env-entry-value> </env-entry> <ejb-ref> <description>description</description> <ejb-ref-name>name</ejb-ref-name> <ejb-ref-type>type</ejb-ref-type> <home>home</home> <remote>remote</remote> <ejb-link>link</ejb-link> </ejb-ref> <resource-ref> <description>description</description> <res-ref-name>name<res-ref-name> <res-type>type</res-type> <res-auth>auth</res-auth> </resource-ref> <resource-env-ref> <description>description</description> <resource-env-ref-name>name</resource-env-ref-name> <resource-env-ref-type>type</resource-env-ref-type> </resource-env-ref> </application-client>
J2EE1.4のdeployment descriptorでは、先頭の<?xml...>は、XML宣言を記述しているため、deployment descriptorファイルの先頭で必ず記述してください。
J2EE1.3のdeployment descriptorでは、先頭の<?xml...>と<!DOCTYPE application-client...>は、XML宣言、およびDTD(文書型定義)を記述しているため、deployment descriptorファイルの先頭で必ず記述してください。
また、値の文字列に日本語を使用する場合は、エンコード形式(「encoding=」部分)に、“Shift_JIS”等の適切な値を指定してください。
<application-client>、</application-client>は、XMLファイルの開始と終了を示すルートタグです。必ず指定してください。
各タグの記載順序は、上記の記載順序に従ってください。
タグの文字列は、大文字小文字が区別されます。
斜体文字の部分は任意の文字列を指定します。空白、タブ、改行などの制御文字は使用できません。なお、斜体文字部分は、大文字小文字が区別されます。
名前空間プレフィックスつきのタグは指定しないでください。
指定した場合、名前変換機能が使用できなくなることがあります。
例:<pfx:ejb-ref>
タグの説明
タグ | 説明 | |
---|---|---|
icon |
| |
| small-icon | GUI上でJ2EEアプリケーションクライアントを表現する、小さい(16×16)アイコン(GIF/JPEG形式)へのURIを指定します。URIは、パッケージのルートからの相対で設定します。省略可能です。 |
large-icon | GUI上でJ2EEアプリケーションクライアントを表現する、大きい(32×32)アイコン(GIF/JPEG形式)へのURIを指定します。URIは、パッケージのルートからの相対で設定します。省略可能です。 | |
display-name | J2EEアプリケーションクライアント表示名を指定します。J2EEアプリケーションクライアント表示名は、GUIなどで表示されます。省略不可です。 | |
description | J2EEアプリケーションクライアントの詳細情報を指定します。詳細情報には、利用者に伝えたい任意の情報を指定します。省略可能です。 |
オブジェクトの参照に関する以下のタグについては、“4.9 deployment descriptorファイルへの記述”を参照してください。
env-entry
ejb-ref
resource-ref
resource-env-ref
service-ref
message-destination-ref
message-destination