4.12 J2EEアプリケーションクライアントのdeployment descriptorファイルの詳細設定

Interstage Application Server J2EE ユーザーズガイド

目次索引

4.12 J2EEアプリケーションクライアントのdeployment descriptorファイルの詳細設定

　以下に、J2EEアプリケーションクライアントのdeployment descriptorファイルの記述形式を説明します。
　deployment descriptorのファイル名は任意で拡張子を.xmlとします。
　deployment descriptorファイルは、任意のディレクトリに配置し、環境プロパティでファイル名をフルパスで指定します。

■記述形式

　deployment descriptorの記述形式はXML形式です。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>
------------------------------------------------------------------------------------

先頭の<?xml．．．>と<!DOCTYPE application-client...>は、XML宣言、およびDTD(文書型定義)を記述しているため、deployment descriptorファイルの先頭で必ず記述してください。また、値の文字列に日本語を使用する場合は、エンコード形式(「encoding=」部分)に、“Shift_JIS”等の適切な値を指定してください。
<application-client>、</application-client>は、XMLファイルの開始と終了を示すルートタグです。必ず指定してください。
各タグの記載順序は、上記の記載順序に従ってください。
タグの文字列は、大文字小文字が区別されます。
斜体文字の部分は任意の文字列を指定します。空白、タブ、改行などの制御文字は使用できません。なお、斜体文字部分は、大文字小文字が区別されます。

■タグの説明

タグ		説明
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アプリケーションクライアントの詳細情報を指定します。詳細情報には、利用者に伝えたい任意の情報を指定します。省略可能です。

　オブジェクトの参照に関する以下のタグについては、“deployment descriptorファイルへの記述”を参照してください。

env-entry
ejb-ref
resource-ref
resource-env-ref

目次索引