Одним из часто упоминаемых преимуществ аннотаций является возможность генерировать документацию, XML, файлы конфигурации и многое другое с помощью обработчиков аннотаций во время компиляции/развертывания. Я видел несколько примеров обработчиков аннотаций, но не об автоматической генерации документов или XML-файлов с их помощью. Я понимаю, почему это было бы полезно, например. добавление ценной информации в документацию проекта из аннотаций.
Один из способов включить их в документацию — использовать мета-аннотацию @Documented
для типов аннотаций, чтобы включить их в JavaDoc, но это просто копирует аннотацию со своими значениями как есть, ничего не меняя, не форматируя и не создавая.
Итак, мой вопрос: как можно использовать процессоры для создания документации, конфигурации, XML-файлов для проекта и каковы некоторые практические примеры этого?
@Documented
— это просто подсказка для любых инструментов документирования. Некоторые аннотации важны для API, некоторые нет, поэтому вы можете включить аннотацию annotated в документы. На самом деле не имеет значения, какой инструмент или использует ли инструмент процессор или нет. - person kapex   schedule 04.03.2015