Если у вас есть объект, у которого есть список подобъектов, и ваши критерии объединяют две таблицы вместе, вы можете получить дубликаты основного объекта.
Один из способов избежать дубликатов - использовать DistinctRootEntityResultTransformer. Основным недостатком этого является использование буферизации набора результатов / подсчета строк. Они не работают вместе.
http://jautodoc.sourceforge.net/ - Может быть, это вас удовлетворит.
Если вы находитесь в объявлении метода с курсором и нажмите ALT + SHIFT + J (или щелкните правой кнопкой мыши метод, который вы хотите задокументировать в схеме, затем выберите Source -> Generate Element Comment) Eclipse вставит все теги @param и @return соответственно и установит курсор на комментарий.
Еще одна приятная особенность - вы можете нажать CTRL + Пробел в комментарии JavaDoc для создания ссылок на другие классы.