JAX-RS

JAX-RS: Java API for RESTful Web Services ( JAX-RS ) on Java - ohjelmointikielen API -spesifikaatio , joka tukee verkkopalvelujen rakentamista REST (Representation State Transfer ) -arkkitehtuurimallin mukaisesti. JAX-RS käyttää Java SE 5:ssä käyttöön otettuja huomautuksia yksinkertaistaakseen verkkopalveluasiakkaiden ja päätepisteiden kehittämistä ja käyttöönottoa.

Versiosta 1.1 lähtien JAX-RS on virallinen osa Java EE 6:ta. Merkittävä piirre tässä on se, että JAX-RS:n käytön aloittaminen ei vaadi konfigurointia. Jos Java EE 6:ta ei käytetä, käyttöönottokuvaajaan tarvitaan pieni merkintä web.xml.

Tekniset tiedot

JAX-RS tarjoaa joitakin huomautuksia, jotka auttavat kartoittamaan POJO-resurssiluokan (Plain Old Java Object ) verkkoresurssiksi . Huomautukset ovat Java - paketissa . Nämä sisältävät: javax.ws.rs

@Pathmäärittää suhteellisen polun resurssiluokalle tai -menetelmälle.
@GET, @PUT, @POST, @DELETEja @HEADmääritä HTTP-pyyntömenetelmä.
@Producesmäärittää vastaus-MIME-tyypit (käytetään sisällön neuvotteluun).
@Consumesmäärittää pyynnössä hyväksytyt MIME-tyypit.

Lisäksi JAX-RS tarjoaa lisämerkintöjä menetelmäparametreille tiedon poimimiseksi pyynnöstä. Kaikki @*Parammerkinnät hyväksyvät jonkin muodon avaimen, jota käytetään etsimään haluttu arvo.

@PathParamsitoo menetelmäparametrin polun segmenttiin.
@QueryParamsitoo menetelmäparametrin HTTP-pyyntöparametrin arvoon.
@MatrixParamsitoo menetelmäparametrin HTTP-matriisiparametrin arvoon.
@HeaderParamsitoo menetelmäparametrin HTTP-otsikon arvoon.
@CookieParamsitoo menetelmäparametrin evästeen arvoon .
@FormParamsitoo menetelmäparametrin lomakearvoon.
@DefaultValuemäärittää oletusarvon yllä oleville sidoksille, kun avainta ei löydy.
@Contextpalauttaa koko objektikontekstin ( esimerkiksi @Context HttpServletRequest request).