2013-03-15 25 views
5

soyut, genel Kaynak sınıf ve somut bir uygulama Verilen:Genel türleri ele alan bir API için dokümanlar oluşturulabilir mi?

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

O PersonResource Dokümanları oluştururken, enunciate get() bir Person döndüren gerçeğini toplayıp olmadığını belirledik.

  1. Kişi, Veri Modeli> Veri Türleri bölümünde listelenmiyor. GET bölümü altında, Yanıt Gövdesi öğe türünü "(özel)" olarak gösterir.

Bu sorunlar, varlık türleri olarak jeneriklerin kullanımı nedeniyle mi? Gerçek türlerin neler olduğunu belirtmek için ipucu vermenin bir yolu var mı, bu yüzden dokümantasyon doğru bir şekilde üretilebilir mi?

enter image description here

cevap

0

Person@XmlRootElement olarak açıklamalı mı? Öyleyse, PersonResource ile aynı projeye dahil mi? Değilse Person sınıfını Enunciate: Multi-Module Projects'da açıklandığı gibi mi ithal ediyorsunuz?

İlgili konular