JavaDoc дает полное имя класса... как сокращать?

Question

проблема

я бегу mvn javadoc:javadoc генерировать JavaDoc, и я доволен результатами, за исключением одного: он дает полностью квалифицированные имена классов для любого класса, поступающего из сторонней библиотеки или нашей собственной базы кода. Например,

Он возвращает тип возврата com.project.beans.BeanA, com.project.beans.BeanB для методов, возвращающих один из этих классов.

Он дает тип параметра org.codehaus.jettison.json.JSONObject для метода, который принимает объект JSON. (Принимая во внимание, что он дает тип параметра Integer для метода, который принимает java.lang.Integer.)

Вопрос

Есть ли способ генерировать сокращенные имена для этих классов для удобства чтения? т.е. BeanA, BeanB, JSONObject.

И есть ли способ сделать это без какой-либо конфигурации XML?

Заранее спасибо:-)

Answer 1

Я считаю, что вы хотите, чтобы -noqualifier опция javadoc, которую можно установить прямо из maven javadoc:javadoc команда.

Обычно для передачи параметра в плагин maven, который вы просто делаете для других программ на Java, использующих -D в этом случае это будет mvn -Dnoqualifier=all javadoc:javadoc но насколько я могу судить noqualifier Похоже, он не задан как выражение в исходном коде плагина, поэтому я не знаю, можно ли передать его через командную строку.

Если это не работает, вы можете изменить pom.xml и добавить <noqualifier>all</noqualifier> в конфиге javadoc плагин. Или вы можете создать свойство в вашем pom, которое будет дано как значение для <noqualifier> тег, но на этот раз свойство может быть переопределено с помощью командной строки.