Hi Sergey, Thanks for your reply.
I did consider switching to Swagger but I thought I would like to know the fundamentals and features of the libraries (e.g. xslt and javadoc). Will test with 3.1.8 and get back to you. Thanks and cheers. Regards, Allan C. On Thu, Dec 8, 2016 at 8:30 PM, Sergey Beryozkin <[email protected]> wrote: > Hi > On 08/12/16 00:46, Allan C. wrote: > >> Hi all, >> >> I would like to delve deeper into CXF cxf-rt-rs-service-description and >> java2wadl-plugin (upgraded from some-version-I-cant-remember to 3.1.7), >> and >> have a few questions: >> >> 1. I noticed that if my service does not have any SOAP APIs, the SOAP >> section is not generated. Just wondering if the SOAP section will be >> generated if one of my services is a SOAP. >> >> Yes > >> 2. The service endpoint address is not a link anymore, so I wouldn't able >> to navigate to the WADL unless I manually change the URL address to >> include >> _wadl parameter. Would there be an option anywhere to get the link to >> appear? >> >> Can you try CXF 3.1.8 please ? > > 3. My REST API resources are consuming and producing application/json. When >> I compare the wadl type=json and type=xml, the json wadl describes the >> representation by class name (e.g. >> {"representation":{"@element":"ThirdPartyElement","@mediaTyp >> e":"application/json"}), >> while the xml wadl describes the element <representation >> mediaType="application/json">. >> > WADL in JSON format is an experiment - WADL XML is converted into JSON and > that is all about WADL in JSON, as opposed to it having some specific > treatment of the JSON representations. > > WADLGenerator has a property, 'linkAnyMediaTypeToXmlSchema' - if you > configure the generator as a jaxrs:provider with this property set to true > then an application/json when possible > > >> Correct me if I am wrong, I understand that if the resource parameter is >> annotated with JAXB, the fragments will be generated. But if it is a third >> party class that I have no control of, is there a way to generate the >> fragments too? >> > No, if a given class has no JAXB annotations then no XML schema fragments > will be generated - but one can configure the generator to refer to the > external schemas. > > Have you considered using Swagger2 for describing JSON services ? > > >> 4. I would also like to delve into Support for Javadoc >> <http://cxf.apache.org/docs/jaxrs-services-description.html# >> JAXRSServicesDescription-SupportforJavadoc>. >> I experimented with it by writing a javadoc for a resource method but >> there's no visible changes in the wadl / services list page. >> > WADLGenerator needs to be configured with a doc provider which will load > the generated javadocs. java2wadl can collect them at the build time... > > Thanks, Sergey > > >> I appreciate your time and many thanks in advance. Cheers. >> >> Regards, >> Allan C. >> >> > > -- > Sergey Beryozkin > > Talend Community Coders > http://coders.talend.com/ >
