Spec-Zone .ru
спецификации, руководства, описания, API
Содержание документации

ИМЯ

apt - инструмент обработки аннотации

РЕЗЮМЕ

apt [-classpath classpath] [-sourcepath sourcepath] [-d directory] [-s directory] [-factorypath path] [-factory class] [-print] [-nocompile] [-Akey[=val] ...] [javac option] sourcefiles [@files]

ПАРАМЕТРЫ

Опции могут быть в любом порядке. Для обсуждения параметров, которые применяются к определенной опции, см. ОПЦИИ ниже.

исходные файлы
Нуль или больше исходных файлов, которое будет обработано.
@files
Один или более файлов, которые перечисляют исходные файлы или другие опции

ОПИСАНИЕ

Отметьте: инструмент apt и его связанный API, содержавшийся в пакете, com.sun.mirror был осужден начиная с JDK 7 и планируется, чтобы быть удаленным в следующем главном выпуске JDK. Используйте опции, доступные в инструменте javac и API, содержавшихся в пакетах javax.annotation.processing и javax.lang.model обработать аннотации.

Инструмент apt, инструмент обработки аннотации, включает отражающие API и инфраструктуру поддержки, чтобы обработать аннотации программы. apt отражающие API обеспечивает разовое сборкой, основанное на источнике, представление только для чтения структуры программы. Эти отражающие API разрабатываются, чтобы чисто смоделировать систему типов языка программирования Java™ после добавления обобщений. Во-первых, apt выполняет процессоры аннотации, которые могут произвести новый исходный код и другие файлы. Затем, apt может вызвать компиляцию и исходных и сгенерированных исходных файлов, ослабляя разработку. Отражающие API и другие API, используемые, чтобы взаимодействовать с инструментом, являются подпакетами com.sun.mirror.

Более полное обсуждение того, как инструмент работает так же как инструкции для того, чтобы разработать с apt, находится в Начинании с apt.

ОПЦИИ

apt определенные опции

dir -s
Определите корень каталога, под которым будут помещены сгенерированные процессором исходные файлы; файлы помещаются в подкаталоги, основанные на пространстве имен пакета.
-nocompile
Не компилируйте исходные файлы, чтобы классифицировать файлы.
-print
Распечатайте текстовое представление указанных типов; не выполните обработку аннотации или компиляцию.
-A [ключ [= val]]
Опции, чтобы передать к процессорам аннотации - они не интерпретируются apt непосредственно, но делаются доступными для использования отдельными процессорами
Путь -factorypath
Определите, где найти фабрики процессора аннотации; если эта опция используется, путь к классу не ищется фабрики.
Имя класса -factory
Имя фабрики процессора аннотации, чтобы использовать; процесс открытия значения по умолчанию обходов
-version
Информация о печатной версии.
-X
Информация о дисплее о нестандартных опциях.

Опции совместно используются с javac

dir -d
Определите, куда поместить процессор и javac сгенерированные файлы класса
Путь -cp или путь -classpath
Определите, где найти пользовательские файлы класса и фабрики процессора аннотации. Если -factorypath дается, путь к классу не ищется фабрики.

Консультируйтесь с javac (1) страница справочника для информации об опциях javac.

Нестандартные Опции

-XListAnnotationTypes
Перечислите найденные типы аннотации.
-XListDeclarations
Перечислите определенные и включенные объявления.
-XPrintAptRounds
Информация о печати о начальных и рекурсивных раундах apt.
-XPrintFactoryInfo
Информация о печати, о которой аннотациях фабрику просят обработать.
-XclassesAsDecls
Обработайте и класс и исходные файлы как объявления, чтобы обработать.

Отметьте: Поскольку эти опции нестандартны, они подлежат изменению без уведомления.

ПРИМЕЧАНИЯ

Инструмент apt и его связанный API, содержавшийся в пакете, com.sun.mirror был осужден начиная с JDK 7 и планируется, чтобы быть удаленным в следующем главном выпуске JDK. Используйте опции, доступные в инструменте javac и API, содержавшихся в пакетах javax.annotation.processing и javax.lang.model обработать аннотации.

СМ. ТАКЖЕ


Oracle и/или его филиалы Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.
Свяжитесь с Нами