NetRexxC

説明

実行中の (Apache Ant) JVM 内で NetRexx ソースツリーをコンパイルします。

ソースディレクトリとデスティネーションディレクトリは、コンパイル対象の NetRexx ソースファイルを再帰的にスキャンされます。対応するクラスファイルがない NetRexx ファイル、またはクラスファイルが Java ファイルよりも古い NetRexx ファイルのみがコンパイルされます。

ソースツリー内のファイルはデスティネーションディレクトリにコピーされ、サポートファイルをクラスパスで適切に配置できるようにします。NetRexx コンパイラはパラメータを介して特定のディレクトリにクラスファイルを作成できないため、ソースファイルがコピーされます。

ソースツリーのディレクトリ構造は、パッケージ階層に従う必要があります。

コンパイル/コピーされるファイルセットを絞り込むことができます。これは、includes、includesfile、excludes、excludesfile、および defaultexcludes 属性を使用して行うことができます。includes または includesfile 属性を使用して、パターンを使用して含めるファイルを指定します。exclude または excludesfile 属性は、除外するファイルを指定するために使用されます。これもパターンを使用して行われます。最後に、defaultexcludes 属性を使用して、デフォルトの除外を使用するかどうかを指定できます。ファイルの包含/除外の仕組み、およびパターンの記述方法については、ディレクトリベースのタスクのセクションを参照してください。

このタスクは暗黙的な FileSet を形成し、<fileset> のほとんどの属性（dir は srcdir になります）と、ネストされた <include>、<exclude>、および <patternset> 要素をサポートします。

classpath、srcdir、destDir を除くすべての属性は、ant.netrexxc.属性名 の形式でプロパティとしても使用できます。例：
<property name="ant.netrexxc.verbose" value="noverbose"/>
または、コマンドラインから次のように使用できます。
ant -Dant.netrexxc.verbose=noverbose ...

注：このタスクは、Apache Ant ディストリビューションに含まれていない外部ライブラリに依存しています。詳細については、ライブラリの依存関係を参照してください。

パラメータ

属性 説明 必須
binary リテラルを NetRexx 型ではなく Java バイナリ型として扱うかどうか いいえ
classpath コンパイル中に使用するクラスパス いいえ
comments コメントを生成された Java ソースファイルに渡すかどうか いいえ
compact エラーメッセージをコンパクトな形式で出力するか、詳細な形式で出力するか。 いいえ; デフォルトは true
compile NetRexx コンパイラが生成された Java コードをコンパイルするかどうか いいえ
console メッセージを「コンソール」に表示するかどうか。このタスクは、コンパイルメッセージのフィルタリングにデフォルト値を使用することに注意してください。 いいえ
crossref 変数相互参照を生成するかどうか いいえ
decimal NetRexx コードに10進演算を使用するかどうか。これを off に設定すると、パフォーマンスが重要なアプリケーションの場合、10進演算はエラーとして報告されます。 いいえ
defaultexcludes デフォルトの除外を使用するかどうか (yes|no)。 いいえ; デフォルトは yes
destDir NetRexx ソースファイルをコピーしてコンパイルするデスティネーションディレクトリ はい
diag コンパイルに関する診断情報を生成するかどうか いいえ
excludes 除外する必要があるファイルのパターンのカンマまたはスペース区切りリスト。 いいえ; デフォルトはデフォルトの除外、または defaultexcludes が no の場合はなし
excludesfile ファイルの名前。このファイルの各行は除外パターンと見なされます いいえ
explicit 変数を使用する前に明示的に宣言する必要があるかどうか いいえ
format 生成された Java コードを適切にフォーマットするか、コールスタックデバッグのために NetRexx 行番号と一致させるか いいえ
includes 含める必要があるファイルのパターンのカンマまたはスペース区切りリスト。 いいえ; デフォルトはすべて (**)
includesfile ファイルの名前。このファイルの各行は包含パターンと見なされます いいえ
java 生成された Java コードを作成するかどうか いいえ
keep コンパイル後に生成された Java ソースファイルを保持するかどうかを設定します。生成されたファイルの拡張子は .java.keep になり、.java では**ありません**。removeKeepExtension を使用して変更します。 いいえ
logo コンパイル時にコンパイラのテキストロゴを表示するかどうか いいえ
removeKeepExtension compile=false モードの末尾の .keep を削除して、結果の Java ソースファイルが実際に .java で終わるようにするかどうかを指定します。これにより、後で javadoc ツールを kolayca 使用できます。 いいえ
replace コンパイル時に生成された .java ファイルを置き換えるかどうか いいえ
savelog コンパイラメッセージをコンソールだけでなく NetRexxC.log にも書き込むかどうか いいえ
sourcedir NetRexx コンパイラに、クラスファイルをソースファイルと同じディレクトリに保存するように指示します。別の方法は作業ディレクトリです いいえ
srcDir ソース NetRexx ファイルを見つけるディレクトリを設定します はい
strictargs 引数が必要ない場合でも、メソッド呼び出しには常に括弧が必要であることを NetRexx コンパイラに指示します。例：aStringVar.getBytes 対 aStringVar.getBytes() いいえ
strictassign 割り当ては型と完全に一致する必要があることを NetRexx コンパイルに指示します いいえ
strictcase NetRexx コンパイラで大文字と小文字を区別するかどうかを指定します いいえ
strictimport import 文を使用してクラスを明示的にインポートする必要があるかどうか いいえ; デフォルトでは、NetRexx コンパイラは特定のパッケージを自動的にインポートします
strictprops ローカルプロパティを this を使用して明示的に修飾する必要があるかどうか いいえ
strictsignal コンパイラが明示的に名前が付けられた型によって例外のキャッチを強制するかどうか いいえ
symbols デバッグシンボルをクラスファイルに生成するかどうか いいえ
time NetRexx コンパイラにコンパイル時間をコンソールに出力するように要求します いいえ
trace トレースをオンまたはオフにし、結果のトレース出力を指示します いいえ
utf8 ソースが UTF8 であることを NetRexx コンパイラに指示します いいえ
verbose 多くの警告とエラーメッセージを生成するかどうかを指示します いいえ
suppressMethodArgumentNotUsed strictargs モードで メソッドの引数が使用されていません メッセージを除外するかどうかを指示します。 いいえ
suppressPrivatePropertyNotUsed strictargs モードで プライベートプロパティが定義されていますが、使用されていません メッセージを除外するかどうかを指示します。 いいえ
suppressVariableNotUsed strictargs モードで 変数が設定されていますが、使用されていません メッセージを除外するかどうかを指示します。エラーが隠される可能性があるため、この点に注意してください。 いいえ
suppressExceptionNotSignalled strictsignal モードで 例外が宣言されていますが、メソッド内で通知されていません メッセージを除外するかどうかを指示します。 いいえ
suppressDeprecation コンパイラ出力の非推奨メッセージを除外するかどうかを指示します いいえ

例

<netrexxc srcDir="/source/project"
          includes="vnr/util/*"
          destDir="/source/project/build"
          classpath="/source/project2/proj.jar"
          comments="true"
          crossref="false" replace="true"
          keep="true"/>