JAX-RS

JAX-RS: Java API for RESTful Web Services és una API del llenguage de programació Java que proporciona soport en la creació de servicis web d'acort en l'estil arquitectònic Representational State Transfer (REST). JAX-RS usa anotacions, introduïdes en Java ES 5, per a simplificar el desenroll i desplegament dels clients i punts finals dels servicis web.

A partir de la versió 1.1 en avant, JAX-RS és una part oficial de Java EE 6. Una característica notable de ser part oficial de Java EE és que no es requerix configuració per a escomençar a usar JAX-RS. Per als entorns que no són Java EE 6 es requerix una (menuda) entrada en el descriptor de desplegament web. xml.

Especificació

JAX-RS proporciona algunes anotacions per a ajudar a mapear una classe recurs (un POJO) com un recurs web. Entre estes anotacions s'inclouen:

• Path especifica la ruta d'accés relativa per a una classe recurs o método.
• GET, PUT, POST, DELETE i HEAD especifiquen el tipo de petició HTTP d'un recurs.
• Produïxes especifica els tipos de mijos MIME de resposta.
• Consumes especifica els tipos de mijos de petició acceptats.

Ademés, proporciona anotacions adicionals per als paràmetros de método per a extraure informació de la solicitut. Totes les anotacions @**Param prenen una clau d'alguna forma que s'utilisa per a buscar el valor requerit.

• PathParam enllaça el paràmetro a un segment de ruta.
• QueryParam enllaça el paràmetro al valor d'un paràmetro de consulta HTTP.
• MatrixParam enllaça el paràmetro al valor d'un paràmetro de matriu d'HTTP.
• HeaderParam enllaça el paràmetro a un valor de capçalera HTTP.
• CookieParam enllaça el paràmetro a un valor de cookie.
• FormParam enllaça el paràmetro a un valor de formulari.
• DefaultValue especifica un valor per defecte per als enllaços anteriors quan la clau no és trobada.
• Context torna tot el context de l'objecte. (Per eixemple: Context HttpServletRequest request)

JAX-RS 2.0

En giner de 2011, el PCJ va formar un grup d'experts [1] per a treballar en JAX-RS 2.0. Els objectius principals són (entre uns atres) una API de client comú i el respal a Hypermedia seguint el principi HATEOAS de REST. En maig de 2013 es va publicar la versió final.

Referències

• Hadley, Marc and Paul Sandoz, eds. (September 17, 2009). JAX-RS: Java API for RESTful WebServices (version 1.1), Java Community Process