Interstage Application Server/Interstage Web Server J2EE ユーザーズガイド
目次 索引 前ページ次ページ

第1部 J2EE共通編> 第3章 J2EEアプリケーションの運用> 3.3 J2EEアプリケーションの配備と設定

3.3.2 J2EEアプリケーション(EARファイル)のdeployment descriptor

 J2EEアプリケーション(EARファイル)のdeployment descriptor(application.xml)は、J2EEアプリケーションの動作環境を設定します。
 ここでは、application.xmlの記述方法について説明します。

■application.xmlの記述形式

 application.xmlは、J2EEアプリケーション(EARファイル)についてのdeployment descriptorです。
 J2EEアプリケーションの構成物のパスや、セキュリティロールを記述します。パスは、EARファイルにパッケージングした時のモジュール内のパスを記述します。
 deployment descriptorの記述形式はXML形式です。deployment descriptorの記述形式を以下に示します。

-------------------------------------------------------------------------------
<?xml version="1.0" encoding="UTF-8"?>
<application 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_1_4.xsd"
  version="1.4">
  <display-name>display_name</display-name>
  <module>
    <connector>uri</connector>
    <alt-dd>uri</alt-dd>
  </module>
  <module>
    <ejb>uri</ejb>
    <alt-dd>uri</alt-dd>
  </module>
  <module>
    <java>uri</java>
    <alt-dd>uri</alt-dd>
  </module>
  <module>
    <web>
      <web-uri>uri</web-uri>
      <context-root>context-root</context-root>
    </web>
    <alt-dd>uri</alt-dd>
  </module>
  <security-role>
    <role-name>role-name</role-name>
  </security-role>
</application>
-------------------------------------------------------------------------------

◆記述にあたっての注意事項

■application.xmlのタグ

 J2EEアプリケーション(EARファイル)のdeployment descriptor(application.xml)には、以下のタグを指定できます。

◆定義する内容

タグ名

説明

タグの省略

複数の指定

application

J2EEアプリケーション(EARファイル)のdeployment descriptorの開始と終了を定義します。

×

×

display-name

J2EEアプリケーション(EARファイル)の名前を定義します。

×

module

一つのモジュールに関する定義を記述します。
注) connector、ejb、java、webのいずれかを必ず定義する必要があります。

×

connector

connector(RARファイル)のパスを定義します。

×

×

ejb

EJBモジュール(ejb-jarファイル)のパスを定義します。

×

×

java

J2EEアプリケーションクライアント(client-jarファイル)のパスを定義します。

×

×

web

Webモジュールに関する定義を記述します。

×

×

web-uri

Webモジュール(WARファイル)のパスを定義します。

×

×

context-root

Webアプリケーション名を定義します。
注) EARファイル内で一意な値でなければなりません

×

×

alt-dd

モジュールのdeployment descriptorのパスを定義します。省略した場合は、モジュールに含まれるdeployment descriptorが使用されます。

×

security-role

アクセス制限で使用するセキュリティロールを定義します。

role-name

セキュリティロール名を定義します。ロール名には、セキュリティ機能の運用設定(Interstage ディレクトリサービス)で定義したセキュリティロール名を指定してください。
注) EARファイル内で一意な値でなければなりません

×

×

◆例

 モジュール構成が、以下の場合のdeployment descriptorの例です。

EARファイルが以下を含む
-------------------------------------------------------------------------------
<?xml version="1.0" encoding="UTF-8"?>
<application 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_1_4.xsd"
  version="1.4">
  <display-name>J2EEApplication</display-name>
  <module>
    <connector>connector.rar</connector>
    <alt-dd>connector.xml</alt-dd>
  </module>
  <module>
    <ejb>ejb.jar</ejb>
    <alt-dd>ejb.xml</alt-dd>
  </module>
  <module>
    <java>client.jar</java>
    <alt-dd>client.xml</alt-dd>
  </module>
  <module>
    <web>
      <web-uri>web.war</web-uri >
      <context-root>WebApplication</context-root>
    </web>
    <alt-dd>web.xml</alt-dd>
  </module>
  <security-role>
    <role-name>Administrator</role-name>
  </security-role>
  <security-role>
    <role-name>Operator</role-name>
  </security-role></application>
-------------------------------------------------------------------------------

目次 索引 前ページ次ページ

Copyright 2008 FUJITSU LIMITED