2013-03-15 3 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

Person@XmlRootElement로 주석이? 그렇다면 PersonResource과 같은 프로젝트에 포함되어 있습니까? 그렇지 않은 경우 Enunciate: Multi-Module Projects에 설명 된대로 Person 클래스를 가져 오시겠습니까?