|
5865
|
1 |
." Copyright (c) 2004, 2010, Oracle and/or its affiliates. All rights reserved.
|
|
2692
|
2 |
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
|
|
|
3 |
."
|
|
|
4 |
." This code is free software; you can redistribute it and/or modify it
|
|
|
5 |
." under the terms of the GNU General Public License version 2 only, as
|
|
|
6 |
." published by the Free Software Foundation.
|
|
|
7 |
."
|
|
|
8 |
." This code is distributed in the hope that it will be useful, but WITHOUT
|
|
|
9 |
." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
|
|
|
10 |
." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
|
|
|
11 |
." version 2 for more details (a copy is included in the LICENSE file that
|
|
|
12 |
." accompanied this code).
|
|
|
13 |
."
|
|
|
14 |
." You should have received a copy of the GNU General Public License version
|
|
|
15 |
." 2 along with this work; if not, write to the Free Software Foundation,
|
|
|
16 |
." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
|
|
|
17 |
."
|
|
5506
|
18 |
." Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
|
|
|
19 |
." or visit www.oracle.com if you need additional information or have any
|
|
|
20 |
." questions.
|
|
2692
|
21 |
."
|
|
9352
|
22 |
.TH apt 1 "14 Apr 2011"
|
|
2692
|
23 |
|
|
|
24 |
.LP
|
|
|
25 |
.SH "NAME"
|
|
|
26 |
.LP
|
|
|
27 |
.LP
|
|
9352
|
28 |
\f2apt\fP \- 注釈処理ツール
|
|
2692
|
29 |
.LP
|
|
9352
|
30 |
.SH "形式"
|
|
2692
|
31 |
.LP
|
|
|
32 |
.LP
|
|
9352
|
33 |
\f2apt [\-classpath \fP\f2classpath\fP] [\-sourcepath \f2sourcepath\fP] [\-d \f2directory\fP] [\-s \f2directory\fP] [\-factorypath \f2path\fP] [\-factory \f2class\fP] [\-print] [\-nocompile] [\-A\f2key\fP[\f2=val\fP] ...] [\f2javac option\fP] sourcefiles [@files]
|
|
2692
|
34 |
.LP
|
|
9352
|
35 |
.SH "パラメータ"
|
|
2692
|
36 |
.LP
|
|
|
37 |
.LP
|
|
9352
|
38 |
オプションの指定順序に決まりはありません。特定のオプションに適用されるパラメータについては、下記の「オプション」を参照してください。
|
|
2692
|
39 |
.LP
|
|
|
40 |
.RS 3
|
|
|
41 |
.TP 3
|
|
|
42 |
sourcefiles
|
|
9352
|
43 |
ゼロ、1 つ、または複数の処理対象のソースファイル
|
|
2692
|
44 |
.TP 3
|
|
|
45 |
@files
|
|
9352
|
46 |
ソースファイルまたは他のオプションを一覧表示する 1 つまたは複数のファイル
|
|
2692
|
47 |
.RE
|
|
|
48 |
|
|
|
49 |
.LP
|
|
9352
|
50 |
.SH "説明"
|
|
2692
|
51 |
.LP
|
|
|
52 |
.LP
|
|
9352
|
53 |
注釈処理ツール \f2apt\fP は、新しいリフレクト API とサポートインフラストラクチャーから構成され、プログラム注釈を処理します。\f2apt\fP リフレクト API は、 構築時のソースベースで、プログラム構造に関する読み取り専用ビューを提供します。これらのリフレクト API は、総称を追加した後に、Java(TM) プログラミング言語の型システムを正しくモデル化するように設計されています。最初に、\f2apt\fP は、新しいソースコードと他のファイルを作成する注釈プロセッサを実行します。次に、\f2apt\fP は、元のソースファイルと生成したソースファイルの両方をコンパイルするため、開発が楽になります。ツールとのインタフェースに使用されるリフレクト API などの API は、\f2com.sun.mirror\fP のサブパッケージです。
|
|
2692
|
54 |
.LP
|
|
2
|
55 |
.LP
|
|
9352
|
56 |
ツールの機能に関する詳細と、\f2apt\fP を使用した開発方法については、
|
|
2692
|
57 |
.na
|
|
9352
|
58 |
\f4「apt 入門」\fP @
|
|
2692
|
59 |
.fi
|
|
9352
|
60 |
http://java.sun.com/javase/6/docs/technotes/guides/apt/GettingStarted.htmlを参照してください。
|
|
2
|
61 |
.LP
|
|
2692
|
62 |
.RS 3
|
|
2
|
63 |
.TP 3
|
|
9352
|
64 |
注:
|
|
|
65 |
\f2apt\fP の機能は、\f2javac(1)\fP ツールの一部となった注釈処理インフラストラクチャーに組み込まれ、すべての Java コンパイラで使用できるように標準化されました。この新しいインフラストラクチャーは、言語モデルおよび Java プラットフォームの一部となった注釈処理 API に依存します。注釈プロセッサの開発は、新しい API および \f2javac\fP ツールに基づいて行うようお勧めします。
|
|
2692
|
66 |
.RE
|
|
|
67 |
|
|
|
68 |
.LP
|
|
9352
|
69 |
.SH "オプション"
|
|
2692
|
70 |
.LP
|
|
|
71 |
.SS
|
|
9352
|
72 |
apt 固有のオプション
|
|
2
|
73 |
.LP
|
|
2692
|
74 |
.RS 3
|
|
|
75 |
.TP 3
|
|
|
76 |
\-s dir
|
|
9352
|
77 |
プロセッサの生成するソースファイルを置くディレクトリルートを指定します。 ファイルは、パッケージの名前空間に基づいてサブディレクトリに置かれます。
|
|
2692
|
78 |
.TP 3
|
|
|
79 |
\-nocompile
|
|
9352
|
80 |
ソースファイルをクラスファイルにコンパイルしません。
|
|
2692
|
81 |
.TP 3
|
|
|
82 |
\-print
|
|
9352
|
83 |
指定したタイプのテキスト表現を出力します。 注釈処理またはコンパイルは行いません。
|
|
2692
|
84 |
.TP 3
|
|
|
85 |
\-A[key[=val]]
|
|
9352
|
86 |
注釈プロセッサへ渡すオプションです。 このオプションは、\f2apt\fP が直接解釈するのではなく、それぞれのプロセッサによって使用できるように変えられます。
|
|
2692
|
87 |
.TP 3
|
|
|
88 |
\-factorypath path
|
|
9352
|
89 |
注釈プロセッサファクトリを検索する場所を指定します。 このオプションを使用する場合、クラスパスのファクトリは検索されません。
|
|
2692
|
90 |
.TP 3
|
|
|
91 |
\-factory classname
|
|
9352
|
92 |
使用する注釈プロセッサファクトリの名前です。 デフォルトの検出プロセスを省略します。
|
|
|
93 |
.TP 3
|
|
|
94 |
\-version
|
|
|
95 |
バージョン情報を出力します。
|
|
|
96 |
.TP 3
|
|
|
97 |
\-X
|
|
|
98 |
非標準オプションに関する情報を表示します。
|
|
2692
|
99 |
.RE
|
|
|
100 |
|
|
2
|
101 |
.LP
|
|
2692
|
102 |
.SS
|
|
9352
|
103 |
javac と共用するオプション
|
|
2
|
104 |
.LP
|
|
2692
|
105 |
.RS 3
|
|
|
106 |
.TP 3
|
|
|
107 |
\-d dir
|
|
9352
|
108 |
プロセッサと javac 生成のクラスファイルを置く場所を指定します。
|
|
2692
|
109 |
.TP 3
|
|
9352
|
110 |
\-cp path または \-classpath path
|
|
|
111 |
ユーザークラスファイルと注釈プロセッサファクトリを検索する場所を指定します。\f2\-factorypath\fP が指定されている場合、クラスパスのファクトリは検索されません。
|
|
2692
|
112 |
.RE
|
|
|
113 |
|
|
2
|
114 |
.LP
|
|
2692
|
115 |
.LP
|
|
9352
|
116 |
\f2javac\fP オプションの詳細については、javac(1) のマニュアルページを参照してください。
|
|
|
117 |
.LP
|
|
|
118 |
.SS
|
|
|
119 |
非標準オプション
|
|
2692
|
120 |
.LP
|
|
9352
|
121 |
.RS 3
|
|
|
122 |
.TP 3
|
|
|
123 |
\-XListAnnotationTypes
|
|
|
124 |
注釈の型に検出されるリスト.
|
|
|
125 |
.TP 3
|
|
|
126 |
\-XListDeclarations
|
|
|
127 |
指定および宣言がインクルードされるリスト.
|
|
|
128 |
.TP 3
|
|
|
129 |
\-XPrintAptRounds
|
|
|
130 |
初期および再帰的な \f2apt\fP ラウンドに関する情報を出力する.
|
|
|
131 |
.TP 3
|
|
|
132 |
\-XPrintFactoryInfo
|
|
|
133 |
処理を要求するファクトリの注釈に関する情報を出力する.
|
|
|
134 |
.TP 3
|
|
|
135 |
\-XclassesAsDecls
|
|
|
136 |
クラスファイルとソースファイルの両方を、処理対象の宣言として処理します。
|
|
|
137 |
.RE
|
|
|
138 |
|
|
2692
|
139 |
.LP
|
|
|
140 |
.LP
|
|
9352
|
141 |
\f3注\fP: これらは非標準オプションなので、予告なく変更される可能性があります。
|
|
|
142 |
.LP
|
|
|
143 |
.SH "注"
|
|
2692
|
144 |
.LP
|
|
9352
|
145 |
.LP
|
|
|
146 |
\f2apt\fP の機能は、\f2javac\fP により提供される標準注釈処理インフラストラクチャーに組み込まれました。今後の JDK リリースでは、\f2apt\fP および関連する API のサポートが中止する可能性があります。
|
|
|
147 |
.LP
|
|
|
148 |
.SH "関連項目"
|
|
2
|
149 |
.LP
|
|
|
150 |
.RS 3
|
|
|
151 |
.TP 2
|
|
2692
|
152 |
o
|
|
|
153 |
javac(1), java(1)
|
|
2
|
154 |
.RE
|
|
|
155 |
|
|
|
156 |
.LP
|
|
|
157 |
|