Scritto da
  • email
  • twitter
  • linkedin
  • linkedin

There are lots of ways of documenting RESTful APIs in Java: just google a bit and you will find the nice Enunciate and Swagger, for example. Such approachs, however, are often quite invasive and hardly customizable. Many providers - like as Apache CXF - are able to dynamically generate a WADL representation out of JAX-RS annotated classes: such XML representation can be easily put into an XSLT transformation in order to obtain some end-user REST documentation.

There are lots of ways of documenting RESTful APIs in Java: just google a bit and you will find the nice Enunciate and Swagger, for example. Such approachs, however, are often quite invasive and hardly customizable.

Many providers - like as Apache CXF - are able to dynamically generate a WADL representation out of JAX-RS annotated classes: such XML representation can be easily put into an XSLT transformation in order to obtain some end-user REST documentation.

I have developed a sample Servlet project for this purpose, featuring some cool technologies like as Apache Cocoon 3, jQuery and highligh.js.

You can take a look at the final result, applied to Apache Syncope.

0 VOTINot rated yetNot rated yet
Ti è stato utile questo articolo?
Dal Blog di Tirasa
Quello che facciamo, studiamo e pensiamo tutti i giorni lo condividiamo qui.
Vai al blog >