tag:blogger.com,1999:blog-5003701650524272230.post8736264677480711296..comments2023-05-15T08:30:40.114-05:00Comments on Programming fun at startup: Jersey Rest API html documentationKalpesh Patelhttp://www.blogger.com/profile/05753943463214172718noreply@blogger.comBlogger8125tag:blogger.com,1999:blog-5003701650524272230.post-44483334318989930522014-07-07T10:26:25.163-05:002014-07-07T10:26:25.163-05:00bottom line: generating REST API documentation is ...bottom line: generating REST API documentation is a major PITA.Anonymousnoreply@blogger.comtag:blogger.com,1999:blog-5003701650524272230.post-57019511207057822112014-05-14T04:55:04.553-05:002014-05-14T04:55:04.553-05:00Hi,
I am using jackson-jaxrs-1.5.7.jar for my re...Hi,<br /> I am using jackson-jaxrs-1.5.7.jar for my rest web service. I am using custom CustomWADLGeneratorConfig to generate resource doc. The CustomWADLGeneratorConfig has the code as follows,<br /><br />public List configure()<br />Unknown macro: { List ax = generator(WadlGeneratorResourceDocSupport.class).prop("resourceDocStream", "resourcedoc.xml").descriptions(); return ax; }<br /><br />}<br /><br />Wadl file has been generated successfully. But the resource class name is missing.<br />After a long search in google I found that path id attribute describes the resource class name.<br />But in generated application.wadl file path has been found but id attribute (class name) is missing.<br />How to get id attribute??<br /><br />Additional Information :<br />Through resource-doclet.jar I made ant build to produce resourcedoc.xml.<br />In web.xml I have configure to load on startup for the class CustomWADLGeneratorConfig by extending WadlGeneratorConfig.<br />So when the application is up it shows application.wadl file while hitting the corresponding URL.<br />Resource path is available but id (Resource class name) is missing. I didn't used any grammar or xsd.Anonymoushttps://www.blogger.com/profile/14900074899746370831noreply@blogger.comtag:blogger.com,1999:blog-5003701650524272230.post-72408164433028037382013-03-26T10:59:27.939-05:002013-03-26T10:59:27.939-05:00oops sorry - missed that point indeed. Thank you a...oops sorry - missed that point indeed. Thank you anyway for your post, didn't know how to set this up on Jersey.Anonymoushttps://www.blogger.com/profile/01986419260894800153noreply@blogger.comtag:blogger.com,1999:blog-5003701650524272230.post-51244973047934064522013-01-07T12:47:07.536-06:002013-01-07T12:47:07.536-06:00Mathieu you are missing the point. Even Jersey has...Mathieu you are missing the point. Even Jersey has a built in support for WADL documentation or you can add your customized WadlResource class.<br /><br />The intent here was to generate html documentation for REST apis that can be consumed by people who dont want to deal with wadl internals. Kalpesh Patelhttps://www.blogger.com/profile/05753943463214172718noreply@blogger.comtag:blogger.com,1999:blog-5003701650524272230.post-50685784901146035932013-01-07T08:03:50.899-06:002013-01-07T08:03:50.899-06:00CXF has built-in support for generating WADL. You ...CXF has built-in support for generating WADL. You have to use some cxf-specific annotations to document parameters.<br />http://cxf.apache.org/docs/jaxrs-services-description.html#JAXRSServicesDescription-WADLAutoGeneration<br /><br />Mathieu<br />http://mathieuhicauber-java.blogspot.com<br /><br /><br />Anonymoushttps://www.blogger.com/profile/01986419260894800153noreply@blogger.comtag:blogger.com,1999:blog-5003701650524272230.post-87673285302025760792012-09-25T17:28:30.210-05:002012-09-25T17:28:30.210-05:00Unfortunately I havent worked on cxf.Unfortunately I havent worked on cxf.Kalpesh Patelhttps://www.blogger.com/profile/05753943463214172718noreply@blogger.comtag:blogger.com,1999:blog-5003701650524272230.post-71738741101808174412012-09-25T17:12:10.126-05:002012-09-25T17:12:10.126-05:00Hi,
Nice tutorial. Is there anything like this ava...Hi,<br />Nice tutorial. Is there anything like this available in cxf ? Anonymoushttps://www.blogger.com/profile/00514611836054569399noreply@blogger.comtag:blogger.com,1999:blog-5003701650524272230.post-21384726169112779232012-02-16T00:38:59.247-06:002012-02-16T00:38:59.247-06:00Hi,
This is so wonderful. I am having hard time ...Hi, <br /><br />This is so wonderful. I am having hard time adding this to my project. Can you help with some more details or working code?<br /><br />-Animesh<br />www.animesh.orgAnimeshhttp://www.animesh.orgnoreply@blogger.com