An extension of the Jar task with special treatment for files that should end up in an Enterprise Application archive.

結果としてエンタープライズアプリケーションアーカイブ(EAR)となるファイルのための、特別な処理を持ったJar タスクの拡張です。

(The Ear task is a shortcut for specifying the particular layout of a EAR file. The same thing can be accomplished by using the prefix and fullpath attributes of zipfilesets in a Zip or Jar task.)

(ear タスクは、EAR ファイルの固有な配置を与えるためのショートカットです。 zip あるいは jar タスクの zipfileset の prefix 及び fullpath 属性を使えば、 同じことができます。)

The extended zipfileset element from the zip task (with attributes prefix, fullpath, and src) is available in the Ear task.

ear タスクでは、zip タスクより(prefixfullpath及びsrc属性を持たせた)拡張された zipfileset 要素が利用可能です。



Attribute Description Required
destfile the EAR file to create. Yes
appxml The deployment descriptor to use (META-INF/application.xml). Yes, unless update is set to true
basedir the directory from which to jar the files. No
compress Not only store data but also compress them, defaults to true No
encoding The character encoding to use for filenames inside the archive. Defaults to UTF8. It is not recommended to change this value as the created archive will most likely be unreadable for Java otherwise. No
filesonly Store only file entries, defaults to false No
includes comma- or space-separated list of patterns of files that must be included. All files are included when omitted. No
includesfile the name of a file. Each line of this file is taken to be an include pattern No
excludes comma- or space-separated list of patterns of files that must be excluded. No files (except default excludes) are excluded when omitted. No
excludesfile the name of a file. Each line of this file is taken to be an exclude pattern No
defaultexcludes indicates whether default excludes should be used or not ("yes"/"no"). Default excludes are used when omitted. No
manifest the manifest file to use. No
update indicates whether to update or overwrite the destination file if it already exists. No
属性 説明 必須
destfile 生成する ear ファイル Yes
appxml (META-INF/application.xml)で使うための配布記述 Yes、updateがtrueに設定されない限り
basedir jarファイルがあるディレクトリ No
compress データを保存するだけでなく、圧縮します。デフォルトでは true No
encoding アーカイブ中のファイル名で使われる文字エンコーディング。 デフォルトはUTF8。 生成されたアーカイブが、Java 以外ではほとんど読めなくなるかもしれないので、この値を変更することは勧めない No
filesonly ファイルエントリのみを保存する。デフォルトは false No
includes 入れられるファイルのパターンのカンマまたは空白文字で区切られたリスト。 省略された場合、全ファイルが入れられます。 No
includesfile ファイルの名前。 このファイルの各行は入れるファイルのパターンとして扱われます。 No
excludes 除外されるファイルのパターンのカンマあるいは空白文字で区切られたリスト。 省略された場合、(デフォルト除外ファイルを除いて)全ファイルが除外されます。 No
excludesfile ファイルの名前。 このファイルの各行は除外するファイルのパターンとして扱われます。 No
defaultexcludes デフォルト除外ファイルを使うか、使わないか指定します。 ("yes"/"no"). 省略された場合、デフォルト除外ファイルが使用されます。 No
manifest 使われるマニフェストファイル No
update 行き先のファイルがすでに存在する場合、 更新するか、上書きするかを示す。 No

Nested elements



The nested metainf element specifies a FileSet. All files included in this fileset will end up in the META-INF directory of the ear file. If this fileset includes a file named MANIFEST.MF, the file is ignored and you will get a warning.

ネストされた metainf 要素は、 ファイルセットを指定します。 このファイルセットに含まれる全てのファイルは、 ear ファイルの META-INF ディレクトリに置かれます。 このファイルセットが MANIFEST.MF という名前のファイルを含んだ場合、 ファイルは無視され、警告が表示されます。


    <ear destfile="${build.dir}/myapp.ear" appxml="${src.dir}/metadata/application.xml">
      <fileset dir="${build.dir}" includes="*.jar,*.war"/>

Copyright © 2001-2002 Apache Software Foundation. All rights Reserved.

[訳注:これは漆島賢二が翻訳しました。日本語訳に対するコメントがあれば report@jajakarta.orgに送ってください]