Моя цель — «прочитать» классы Java определенного пакета, а затем обработать Javadoc и аннотации (желательно одновременно) для классов в этом пакете и для методов внутри этих классов. Решение должно быть реализовано на Java 6 или 7, инструмент сборки - Maven 3. В настоящее время мы используем maven-compiler-plugin
, версию 2.5.1
, но я, вероятно, могу обновить ее, если она доступна/необходима.
Насколько я понимаю, цель классов javax.annotation.processing
состоит в том, чтобы делать такие вещи, и я считаю, что Java-код соответствует строкам этого другого SO answer должен работать для моих целей, но практические детали того, как заставить его работать, все еще немного нечеткие.
В общем, вот что мне нужно:
- Код Java для выбора нужных мне аннотаций и элементов Javadoc, а затем преобразования этих элементов в модель данных, необходимую для создания пользовательской документации.
- Java-код для записи этой модели данных в файл документации или каталог файлов.
- Maven 3 configuration to:
- Run the annotation processor once at a good time
- Включить сгенерированный каталог документов в выходной файл войны
Биты Maven сбивают меня с толку больше, чем код Java, поэтому, если вы собираетесь ответить только на половину, это половина, которая получит мою галочку. Кроме того, я бы предпочел не помещать этот процессор аннотаций в репозиторий Maven в качестве отдельного плагина, поскольку он будет очень тесно связан с некоторыми пользовательскими аннотациями, которые мы используем.
Вот краткий список вопросов, которые я нашел связанными, но я не смог синтезировать свой собственный ответ: