1 '\" t 2 .\" Copyright 2006 Sun Microsystems, Inc. All Rights Reserved. 3 .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. 4 .\" 5 .\" This code is free software; you can redistribute it and/or modify it 6 .\" under the terms of the GNU General Public License version 2 only, as 7 .\" published by the Free Software Foundation. 8 .\" 9 .\" This code is distributed in the hope that it will be useful, but WITHOUT 10 .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or 11 .\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License 12 .\" version 2 for more details (a copy is included in the LICENSE file that 13 .\" accompanied this code). 14 .\" 15 .\" You should have received a copy of the GNU General Public License version 16 .\" 2 along with this work; if not, write to the Free Software Foundation, 17 .\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. 18 .\" 19 .\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA 20 .\" or visit www.oracle.com if you need additional information or have any 21 .\" questions. 22 .\" ` 23 .TH apt 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド" 24 .SH "名前" 25 apt \- 注釈処理ツール 26 .\" 27 .SH "形式" 28 .B apt 29 .BI [\-classpath " classpath"] 30 .BI [\-sourcepath " sourcepath"] 31 .BI [\-d " directory"] 32 .BI [\-s " directory"] 33 .BI [\-factorypath " path"] 34 .BI [\-factory " class"] 35 .B [\-print] 36 .B [\-nocompile] 37 .B [\-Akey[=val] ...] 38 .BI [javac option] 39 .BI sourcefiles 40 .BI [@files] 41 .SH "パラメータ" 42 オプションは任意の順序で使用できます。特定のオプションに適用される 43 パラメータについては、後述の「オプション」を参照してください。 44 .if t .TP 20 45 .if n .TP 15 46 .I sourcefiles 47 処理される 0 個以上のソースファイル。 48 .if t .TP 20 49 .if n .TP 15 50 .I @files 51 ソースファイルまたはその他のオプションをリストする 1 個以上のファイル。 52 .SH "機能説明" 53 注釈処理ツール 54 .B apt 55 には、プログラム注釈を処理するための一連の 56 新しいリフレクション API とインフラストラクチャサポートが含まれています。 57 .B apt 58 のリフレクション API では、プログラム構造のビューが、 59 ビルド時のソースベースの読み取り専用として用意されています。 60 これらのリフレクション API は、総称型の追加後に、 61 Java(TM) プログラミング言語の型システムを 62 わかりやすくモデル化できるように設計されました。 63 はじめに、 64 .B apt 65 は注釈プロセッサを実行します。この注釈プロセッサでは、 66 新規のソースコードおよびその他のファイルを生成します。 67 次に、オリジナルのソースファイルと生成したソースファイルの両方をコンパイルし、 68 開発を容易にします。ツールと対話するためのリフレクション API と 69 その他の API は、 70 .B com.sun.mirror 71 のサブパッケージです。 72 .LP 73 .B apt 74 によるツールの操作方法と開発手順についての詳細は、 75 http://java.sun.com/javase/6/docs/technotes/guides/apt/GettingStarted.html 76 の「Getting Started with apt」を参照してください。 77 .LP 78 .TP 3 79 注: 80 \f2apt\fP\f2 の機能\fPは標準の注釈処理インフラストラクチャに組み込まれました。この標準のインフラストラクチャは、今では \f2javac\fP ツール [ 81 .na 82 \f2Solaris と Linux\fP の場合: 83 .fi 84 http://java.sun.com/javase/6/docs/technotes/tools/solaris/javac.html] [ 85 .na 86 \f2Windows\fP の場合: 87 .fi 88 http://java.sun.com/javase/6/docs/technotes/tools/windows/javac.html] の一部となり、すべての Java コンパイラで使用できるように標準化されています。この新しいインフラストラクチャは、Java プラットフォームの一部となった言語モデルと注釈処理 API に依存しています。新しい注釈プロセッサの開発は、この新しい API と \f2javac\fP ツールに基づいて行うことをお勧めします。 89 .LP 90 .SH "オプション" 91 .SS apt 固有のオプション 92 .if t .TP 20 93 .if n .TP 15 94 .BI \-s " dir" 95 プロセッサが生成するソースファイルが配置されるディレクトリルートを 96 指定します。ファイルはパッケージのネームスペースに従って、 97 サブディレクトリに配置されます。 98 .if t .TP 20 99 .if n .TP 15 100 .BI \-nocompile 101 ソースファイルをクラスファイルにコンパイルしません。 102 .if t .TP 20 103 .if n .TP 15 104 .BI \-print 105 指定した型のテキスト表現を出力します。 106 注釈処理やコンパイルは実行しません。 107 .if t .TP 20 108 .if n .TP 15 109 .BI \-A[key[=val]] 110 注釈プロセッサに渡されるオプション。 111 .B apt 112 は、これらのオプションを直接解釈しませんが、個別のプロセッサ 113 によって使用可能になります。 114 .if t .TP 20 115 .if n .TP 15 116 .BI \-factorypath " path" 117 注釈プロセッサファクトリを検索する場所を指定します。 118 このオプションを使用する場合、ファクトリの検索に 119 クラスパスは使用されません。 120 .if t .TP 20 121 .if n .TP 15 122 .BI \-factory " classname" 123 使用する注釈プロセッサファクトリの名前。 124 デフォルトの検出処理はバイパスされます。 125 .SS javac と共有されるオプション 126 .if t .TP 20 127 .if n .TP 15 128 .BI \-d " dir" 129 プロセッサおよび 130 .B javac 131 が生成したクラスファイルを配置する場所を指定します。 132 .if t .TP 20 133 .if n .TP 15 134 .BI \-cp " path " \fLまたは\fP \fL\-classpath " path" 135 ユーザクラスファイルおよび注釈プロセッサファクトリを検索する場所を 136 指定します。 137 .B \-factorypath 138 を指定した場合、ファクトリの検索にクラスパスは使用されません。 139 .LP 140 javac のオプションについては、 141 .BR javac(1) 142 のマニュアルページを参照してください。 143 .SH 注意事項 144 .LP 145 \f2apt\fP の機能は、\f2javac\fP が提供するようになった標準の注釈処理インフラストラクチャに組み込まれました。\f2apt\fP とその関連 API のサポートは、JDK の将来のリリースで打ち切られる可能性があります。 146 .LP 147 .SH "関連項目" 148 .LP 149 .RS 3 150 .TP 2 151 * 152 javac: [ 153 .na 154 \f2Solaris と Linux\fP の場合: 155 .fi 156 http://java.sun.com/javase/6/docs/technotes/tools/solaris/javac.html] 157 [ \f2Windows\fP の場合: 158 .fi 159 http://java.sun.com/javase/6/docs/technotes/tools/windows/javac.html] 160 .TP 2 161 * 162 java: [ 163 .na 164 \f2Solaris\fP の場合: 165 .fi 166 http://java.sun.com/javase/6/docs/technotes/tools/solaris/java.html] [ 167 .na 168 \f2Linux\fP の場合: 169 .fi 170 http://java.sun.com/javase/6/docs/technotes/tools/linux/java.html] 171 [ \f2Windows\fP の場合: 172 .fi 173 http://java.sun.com/javase/6/docs/technotes/tools/windows/java.html] 174 .RE 175 176 .LP 177