apidiscovery-1.0 on Liberty Beta

Question

Bir süredir çalışmakta olan bir uygulamam var. Swagger'ı araştırmaya karar verdim ve Liberty beta'nın Swagger'ın entegre olduğunu mutlu bir şekilde öğrendim.

ben bunu denemeye karar verdi .. ama .. ... şey keşfetti olsun

Benim özellikleri gibi olamaz

<featureManager> 
    <feature>webProfile-7.0</feature> 
    <feature>adminCenter-1.0</feature> 

    <!-- The following features are in beta! --> 
    <feature>bluemixUtility-1.0</feature> 
    <feature>cloudant-1.0</feature> 
    <feature>logstashCollector-1.0</feature> 
    <feature>logmetCollector-1.0</feature> 
    <feature>osgiAppConsole-1.0</feature> 
    <feature>osgiBundle-1.0</feature> 
    <feature>passwordUtilities-1.0</feature> 
    <feature>wsAtomicTransaction-1.2</feature> 
    <feature>apiDiscovery-1.0</feature> 
    <feature>jaxrs-2.0</feature> 
    <feature>jdbc-4.1</feature> 
    <feature>localConnector-1.0</feature> 
</featureManager> 

Benim apiDiscovery tanımı

<apiDiscovery> 

    <webModuleDoc contextRoot="/MYCONTEXTROOT" docURL="/swagger.json" enabled="true"/> 

</apiDiscovery> 

Ama hiçbir şey. Ben Uygulamam vb @ yol vardır ve

https://localhost:9443/ibm/api/explorer

ziyaret .. ve bana yetiyor this göre IBM API'leri bulunan doğruladıktan. O siteden

..

ürün @ yol, @Api ve @SwaggerDefinition ek açıklamaları ile sınıflar ararken, JAX-RS ve Swagger ek açıklamaları için web uygulaması tüm sınıfları tarar . Ürün ayrıca otomatik olarak web uygulaması dağıtım veya devreye alma sırasında karşılık gelen bir Swagger belgesi üretir.

Bir şey mi eksik?

Şerefe!

James

Answer 1

Sorun çözüldü ...

ben bunu yapıyordum ben 2 sorunları olduğunu görünüyor ..

@POST @Path("/widget/{name}") 
@Consumes(MediaType.APPLICATION_JSON) 
@Produces(MediaType.APPLICATION_JSON) 
public Response createWidget( @Context HttpServletRequest request, String bodyText) 

{name} PathParam olarak kullanılmamıştır. Sanırım bir kere oldu :-) 2 yerde vardı. Kayıtta görünür .. sadece hemen değil. Sabit ve mükemmel çalıştı.

James

Answer 2

Eğer server.xml "webModuleDoc" özelliğini kullanmaya gerek yoktur JAX-RS ek notunuz varsa. Bu özellik, önceden oluşturulmuş swagger.json veya swagger.yaml dosyanızın, uygulamanızın içinde (/swagger.json gibi) başka bir konumda veya belge deposu gibi uzak bir URL'de bulunduğu durumlar içindir.

Yani ek açıklamalarınız varsa, webModuleDoc'a gerek kalmadan otomatik olarak tamamlanır.

aşağıdaki günlük spec biz mühendislik uygulamalarında her biri için oluşturulan havalı belge ortaya çıkaracaktır:

yaygın bir kullanım hata aynı jaxrs uygulama içinde aynı isimde 2 yöntem sahip

<logging traceSpecification="RESTAPIDiscovery=finest"/> 

. Swagger modeline göre, Liberty yöntem isimlerini operasyon kimlikleri olarak kullanır, bu yüzden benzersiz olmaları gerekir.