Hi all,
last week at ApacheCon: Core EU 2015 I attended Andrei Shakirin's talk
[1] and he briefly mentioned the new Swagger feature [2].
It looked great, so I wanted to add such feature as an optional Syncope
extension [3] and I've started playing with it.
I noticed that Swagger's SwaggerSerializers (used by Swagger2Feature)
was doing a great job in generating endpoint and schema information from
our (not Swagger-annotated) JAX-RS interface, but I was somehow
unsatisfied of the final result - as seen through Swagger UI - for a
couple of reasons:
1. all endpoints were falling under a single "default" dropdown, despite
of being defined in 25+ different @Path-annotated classes
2. being such services and methods documented exclusively via Javadoc, I
was hoping to get it as it can happen with WADL
For this reason I've developed an extension to original
SwaggerSerializers [4] (I also had to extend Swagger2Feature naturally [5]).
I am quite satisfied of the final result, which solves both issues
reported above; as you can see the code is in Syncope repository but it
is not related to anything specific about Syncope, so I was thinking if
it makes sense to refactor [4] and [5] as a patch for CXF.
WDYT?
[1]
http://apacheconcore2015.sched.org/event/1b440fe7cfe61985dc5aacf6f8487ba3#.VheMR5cj1hE
[2] https://cxf.apache.org/docs/swagger2feature.html
[3] https://issues.apache.org/jira/browse/SYNCOPE-704
[4]
https://github.com/apache/syncope/blob/master/core/rest-cxf/src/main/java/org/apache/syncope/core/rest/cxf/SyncopeSwaggerSerializers.java
[5]
https://github.com/apache/syncope/blob/master/core/rest-cxf/src/main/java/org/apache/syncope/core/rest/cxf/SyncopeSwagger2Feature.java
--
Francesco Chicchiriccò
Tirasa - Open Source Excellence
http://www.tirasa.net/
Involved at The Apache Software Foundation:
member, Syncope PMC chair, Cocoon PMC, Olingo PMC
http://people.apache.org/~ilgrosso/
