AntCall

Description

説明

Call another target within the same build-file optionally specifying some properties (param's in this context)

いくつかのプロパティ(パラメータはこのコンテキストにあります)を自由に指定して、同じビルドファイル内の別のターゲットをコールします。

By default, all of the properties of the current project will be available in the new project. Alternatively, you can set the inheritAll attribute to false and only "user" properties (i.e., those passed on the command-line) will be passed to the new project. In either case, the set of properties passed to the new project will override the properties that are set in the new project (See also the property task).

デフォルトでは、現在のプロジェクトの全てのプロパティは新しいプロジェクトにおいても利用可能です。 しかし、 inheritAll 属性を false にセットして、 "ユーザの" プロパティだけ(つまり、それらはコマンドライン上で渡される)を、新しいプロジェクトに渡すこともできます。 いずれの場合も、新しいプロジェクトに渡されたプロパティのセットは、新しいプロジェクトでセットされているプロパティを上書きします(property task も参照して下さい)。

You can also set properties in the new project from the old project by using nested param tags. These properties are always passed regardless of the setting of inheritAll. This allows you to parameterize your subprojects.

さらに、ネストされた param タグを使って古いプロジェクトから新しいプロジェクトへプロパティをセットすることもできます。 これらのプロパティは、 inheritAll の設定にかかわらず常に渡されます。 これは、サブプロジェクトをパラメータ化することを可能にします。

Nested <reference> elements can be used to copy references from the calling project to the new project, optionally under a different id. References taken from nested elements will override existing references in the new project.

ネストされた <reference> 要素は異なる id の下で自由に、コール中のプロジェクトから新しいプロジェクトに reference をコピーするために使用することができます。 ネストされた要素から得られた reference は、新しいプロジェクトでの既存の reference を上書きします。

When a target is invoked by antcall, all of its dependent targets will also be called within the context of any new parameters. For example. if the target "doSomethingElse" depended on the target "init", then the antcall of "doSomethingElse" will call "init" during the call. Of course, any properties defined in the antcall task or inherited from the calling target will be fixed and not overridable in the init task -or indeed in the "doSomethingElse" task.

ターゲットが antcall によって起動された時、そのターゲットに依存するすべてのターゲットは任意の新しいパラメータのコンテキスト内に呼ばれます。 例えば、ターゲット "doSomethingElse" がターゲット "init"に依存している場合、 "doSomethingElse" の antcall は "init" をコールします。 もちろん、 antcall タスクの中で定義されたプロパティ、又は呼び出しのターゲットから継承したプロパティはinit タスク内、さらに "doSomethingElse" タスクにおいても固定され、上書きされません。

Parameters

パラメータ

Attribute Description Required
target The target to execute. Yes
inheritAll If true, pass all properties to the new Ant project. Defaults to true. No
inheritRefs If true, pass all references to the new Ant project. Defaults to false. No
属性 説明 必須
target 実行するターゲットです。 Yes
inheritAll true の場合は、プロパティをすべて新しい Ant プロジェクトへ渡します。 デフォルトは trueです。 No
inheritRefs true の場合は、 reference をすべて新しい Ant プロジェクトへ渡します。 デフォルトは falseです。 No

Parameters specified as nested elements

ネストされた要素として指定されるパラメータ

param

Specifies the properties to set before running the specified target. See property for usage guidelines.

指定されたターゲットを実行する前にセットするべきプロパティを指定します。 使用ガイドラインの property を参照してください。

reference

Used to chose references that shall be copied into the new project, optionally changing their id.

自由に id を変更して、新しいプロジェクトにコピーされる reference を選ぶために使用されます。

Attribute Description Required
refid The id of the reference in the calling project. Yes
torefid The id of the reference in the new project. No, defaults to the value of refid.
属性 説明 必須
refid コールしているプロジェクトでの reference の id。 Yes
torefid 新しいプロジェクトでの reference の id。 No, デフォルトは refid の値。

Examples

  <target name="default">
    <antcall target="doSomethingElse">
      <param name="param1" value="value"/>
    </antcall>
  </target>

  <target name="doSomethingElse">
    <echo message="param1=${param1}"/>
  </target>

Will run the target 'doSomethingElse' and echo 'param1=value'.

ターゲット 'doSomethingElse' を実行し、 'param1=value' を出力します。

  <antcall ... >
    <reference refid="path1" torefid="path2" />
  </antcall>

will copy the parent's definition of path1 into the new project using the id path2.

id path2 を使用して、新しいプロジェクトに親の path1 の定義をコピーします。


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

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