Java Bean検証アノテーションを使用してPOJOから文書を生成

Question

JAXBを使用してXSDから生成された既存のBeanがあります。 XSDファイルがたくさんあるので（実際には）、その部分のコンパイルには時間がかかります。 XSDを読んですべてのBeanのHTMLカタログを生成するカスタムMavenプラグインがあります。

XSDのドキュメンテーションが生成されたBeanに保持されず、XMLで表現されたいくつかの制約がJavaに適切に変換されないか、または強く強制されないため、JAXBを取り除きたいと思います。

Java Bean検証アノテーション（必要に応じてカスタムアノテーションを使用）を使用したいと考えています。

既存のJavadocコメントとJava Bean検証アノテーションから生成されたドキュメントをマージする既存のプラグイン/ライブラリ/その他について知っていますか？

import lombok.Getter; 
import lombok.Setter; 

import javax.validation.constraints.NotNull; 
import javax.validation.constraints.Size; 

/** 
* Documentation... 
*/ 
@Getter 
@Setter 
public class Bean { 

    /** 
    * Documentation with javadoc annotations 
    */ 
    @NotNull 
    @Size(min = 3, max = 20) 
    private String message; 

} 

例えば、メッセージプロパティのドキュメントは次のようになります。javadocの注釈付き

ドキュメントが
「メッセージ」nullにすべきではありません。
"message"のサイズは3〜20文字でなければなりません。

Answer 1

Javadoc（eclipse、STS、..）を生成するには、JAutoDocプラグインを試してください。それは生成のための選択肢を持っています：既存のものを置き換える、既存のものを完全にする、既存のものを保持するそれに加えて、さまざまな選択肢をカスタマイズすることができます。 リンク市場：https://marketplace.eclipse.org/content/jautodoc

Answer 2

ビーン検証制約のアノテーションは、すでに生成されたJavadoc（またはメタ注釈付き@Documentedである本当にすべての注釈）の一部です。これで十分でない場合は、その制約メタデータのテキスト表現を追加するカスタムドックレットを作成することを検討できます。