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

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

目次索引

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

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

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

env-entry
ejb-ref
resource-ref
resource-env-ref
service-ref
message-destination-ref
message-destination

目次索引