Usługi sieciowe RESTful - Java (JAX-RS)
JAX-RSto skrót od JAVA API for RESTful Web Services. JAX-RS to interfejs API języka programowania oparty na JAVA i specyfikacja zapewniająca obsługę utworzonych usług WWW zgodnych z REST. Jego wersja 2.0 została wydana 24 maja 2013 roku. JAX-RS wykorzystuje adnotacje dostępne w Javie SE 5, aby uprościć tworzenie i wdrażanie usług internetowych opartych na JAVA. Zapewnia również obsługę tworzenia klientów dla usług sieci Web zgodnych z REST.
Specyfikacje
Poniżej przedstawiono najczęściej używane adnotacje do mapowania zasobu jako zasobu usługi internetowej.
| Sr.No. | Adnotacja i opis |
|---|---|
1 |
@Path Względna ścieżka klasy / metody zasobu. |
2 |
@GET Żądanie HTTP Get, używane do pobierania zasobów. |
3 |
@PUT Żądanie HTTP PUT, używane do aktualizacji zasobu. |
4 |
@POST Żądanie HTTP POST, używane do tworzenia nowego zasobu. |
5 |
@DELETE Żądanie HTTP DELETE, używane do usuwania zasobu. |
6 |
@HEAD Żądanie HTTP HEAD, używane do uzyskania stanu dostępności metody. |
7 |
@Produces Wskazuje odpowiedź HTTP wygenerowaną przez usługę sieci Web. Na przykład APPLICATION / XML, TEXT / HTML, APPLICATION / JSON itp. |
8 |
@Consumes Określa typ żądania HTTP. Na przykład application / x-www-formurlencoded do akceptowania danych formularza w treści HTTP podczas żądania POST. |
9 |
@PathParam Wiąże parametr przekazany do metody z wartością w path. |
10 |
@QueryParam Wiąże parametr przekazany do metody z parametrem zapytania w ścieżce. |
11 |
@MatrixParam Wiąże parametr przekazany do metody z parametrem macierzy HTTP w path. |
12 |
@HeaderParam Wiąże parametr przekazany do metody z nagłówkiem HTTP. |
13 |
@CookieParam Wiąże parametr przekazany do metody do pliku Cookie. |
14 |
@FormParam Wiąże parametr przekazany do metody z wartością formularza. |
15 |
@DefaultValue Przypisuje wartość domyślną do parametru przekazanego do metody. |
16 |
@Context Kontekst zasobu. Na przykład HTTPRequest jako kontekst. |
Note- Użyliśmy Jersey, referencyjnej implementacji JAX-RS 2.0 firmy Oracle, w rozdziałach RESTful Web Services - First Application i RESTful Web Services - Methods .