2013-03-15 5 views
5

Biorąc abstrakcyjną, rodzajową klasę zasobów i konkretną realizację:Czy Enunciate może generować dokumenty dla interfejsu API obsługującego typy ogólne?

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> { } 

Wydaje się, że podczas generowania docs dla PersonResource, ogłosić nie podnosząc fakt, że get() zwraca Person.

  1. Osoba nie jest wymieniona w sekcji Model danych> Typy danych.

  2. W sekcji GET, ciało odpowiedzi pokazuje typ elementu jako "(niestandardowy)".

Czy są to problemy spowodowane użyciem typów generycznych jako typów jednostek? Czy istnieje sposób na podpowiedź, aby powiedzieć, jakie są prawdziwe typy, aby można było poprawnie wygenerować dokumentację?

enter image description here

Odpowiedz

0

Czy Person odnotowany jako @XmlRootElement? Jeśli tak, czy jest on zawarty w tym samym projekcie, co PersonResource? Jeśli nie, to czy importujesz klasę Person zgodnie z opisem w Enunciate: Multi-Module Projects?

Powiązane problemy