On 21/01/2016 13:13, Sergey Beryozkin wrote:
Hi

wadl-to-java generates a Java code and optionally converts WADL docs into JavaDocs too - and with the latest improvements to the feature done by Francesco the source (+ docs) will be converted into Swagger JSON, without necessarily adding Swagger annotations...

As a side note, if the only reason you'd like to do Swagger is to get some UI then note WADLGenerator can be configured with and XSLT source reference, an XSLT conversion (like the one done in Syncope :-)) can make a great difference :-)

FYI, this is the result of such XSLT transformation, starting from the CXF-generated, Javadocs-enabled, WADL

http://syncope.apache.org/rest/2.0/index.html

and this is the Swagger obtained from the same source, generated by Swagger2Feature:

http://syncopecore2-tirasa.rhcloud.com/swagger/

(deployed on OpenShift with free gears and not always available...)

Regards.

On 21/01/16 12:05, Francesco Chicchiriccò wrote:
On 21/01/2016 11:34, Gary Gregory wrote:
Hi All:

I see that CXF includes supports for both WADL [1] and Swagger [2]. Is to
possible to programatically use CXF to convert a WADL file to a Swagger
file? Perhaps by first parsing WADL to some CXF internal format and then
back out to Swagger?

Hi Gary,
don't know about WADL -> internal (maybe Sergey), but the internal ->
Swagger part is what actually performed by [3] as triggered by [4]
(references shown for 3.1.X).

Regards.

[1] https://cxf.apache.org/docs/jaxrs-services-description.html#JAXRSServicesDescription-WADLfirstDevelopment

[2] https://cxf.apache.org/docs/swagger2feature.html
[3] https://github.com/apache/cxf/blob/3.1.x-fixes/rt/rs/description/src/main/java/org/apache/cxf/jaxrs/swagger/Swagger2Serializers.java

[4] https://github.com/apache/cxf/blob/3.1.x-fixes/rt/rs/description/src/main/java/org/apache/cxf/jaxrs/swagger/Swagger2Feature.java#L92

--
Francesco Chicchiriccò

Tirasa - Open Source Excellence
http://www.tirasa.net/

Involved at The Apache Software Foundation:
member, Syncope PMC chair, Cocoon PMC, Olingo PMC, CXF committer
http://home.apache.org/~ilgrosso/

Reply via email to