2013-03-15 1 views
5

は抽象的、一般的なリソースクラスと具体的な実装を考える:Canジェネリック型を扱うAPI用のドキュメントを生成することができますか?

public abstract class AbstractResource<T> { 

    @Autowired 
    private SomeService<T> service; 

    @Path("/{id}") 
    @GET 
    public T get(@PathParam("id") String id) { 
     return service.get(id); 
    } 
} 

@Path("/people") 
public class PersonResource extends AbstractResource<Person> { } 

PersonResourceのためのドキュメントを生成するときに、発音するがget()Personを返すという事実を拾っていないことが表示されます。

  1. [データモデル]セクションの[データ型]セクションに人物が表示されません。

  2. GETセクションでは、レスポンスボディに要素タイプが「(カスタム)」として表示されます。

エンティティタイプとしてジェネリックを使用しているため、これらの問題はありますか?実際の種類が何であるかを明示するためのヒントがありますので、ドキュメントを正しく生成することができますか?

enter image description here

答えて

0

@XmlRootElementとして注釈Personですか?もしそうなら、それはPersonResourceと同じプロジェクトに含まれていますか?そうでない場合は、Enunciate: Multi-Module Projectsに記載されているPersonクラスをインポートしていますか?

関連する問題