Думаю многие Java-разработчики которые хоть раз сталкивались с Web-сервисами
, использовали генерацию Java
DTO
классов по описанию XML Schema
(XSD
). Jaxb с этим справляется на ура, не важно как его использовать, через xjc
или wsimport
вызов из командной строки, maven или gradle плагины.
Так быстро и просто сгенерировать классы из XSD
схемы. Но вот одна проблема — практически полностью пропадают описания, имевшиеся в исходной схеме!
Практически, потому что Javadoc
описание будет только у самого класса, в фиксированном формате (где не разделить описание и фрагмент XML
без регулярок скажем), описание полей (филдов) отсутствуют полностью. А если вам они, как мне, нужны ещё и во время выполнения (runtime
) — тут совсем беда.
Именно с этим, пришлось побороться, как ни странно, задача заняла много времени, и в результате я написал плагин, который и хотел бы представить в надежде что он может кому-то сэкономить несколько часов в будущем.