Servizi Web RESTful - Java (JAX-RS)
JAX-RSè l'acronimo di JAVA API per RESTful Web Services. JAX-RS è un'API e una specifica del linguaggio di programmazione basato su JAVA per fornire supporto per i servizi Web RESTful creati. La sua versione 2.0 è stata rilasciata il 24 maggio 2013. JAX-RS utilizza le annotazioni disponibili da Java SE 5 per semplificare lo sviluppo della creazione e della distribuzione di servizi Web basati su JAVA. Fornisce inoltre i supporti per la creazione di client per i servizi Web RESTful.
Specifiche
Di seguito sono riportate le annotazioni più comunemente utilizzate per mappare una risorsa come risorsa del servizio Web.
| Sr.No. | Annotazione e descrizione |
|---|---|
1 |
@Path Percorso relativo della classe / metodo della risorsa. |
2 |
@GET Richiesta HTTP Get, utilizzata per recuperare la risorsa. |
3 |
@PUT Richiesta HTTP PUT, utilizzata per aggiornare la risorsa. |
4 |
@POST Richiesta HTTP POST, utilizzata per creare una nuova risorsa. |
5 |
@DELETE Richiesta HTTP DELETE, utilizzata per eliminare la risorsa. |
6 |
@HEAD Richiesta HTTP HEAD, utilizzata per ottenere lo stato della disponibilità del metodo. |
7 |
@Produces Indica la risposta HTTP generata dal servizio web. Ad esempio, APPLICATION / XML, TEXT / HTML, APPLICATION / JSON ecc. |
8 |
@Consumes Indica il tipo di richiesta HTTP. Ad esempio, application / x-www-formurlencoded per accettare i dati del modulo nel corpo HTTP durante la richiesta POST. |
9 |
@PathParam Associa il parametro passato al metodo a un valore in path. |
10 |
@QueryParam Associa il parametro passato al metodo a un parametro di query nel percorso. |
11 |
@MatrixParam Associa il parametro passato al metodo a un parametro della matrice HTTP in path. |
12 |
@HeaderParam Associa il parametro passato al metodo a un'intestazione HTTP. |
13 |
@CookieParam Associa il parametro passato al metodo a un cookie. |
14 |
@FormParam Associa il parametro passato al metodo a un valore del modulo. |
15 |
@DefaultValue Assegna un valore predefinito a un parametro passato al metodo. |
16 |
@Context Contesto della risorsa. Ad esempio, HTTPRequest come contesto. |
Note- Abbiamo utilizzato Jersey, un'implementazione di riferimento di JAX-RS 2.0 di Oracle, nei capitoli RESTful Web Services - First Application e RESTful Web Services - Methods .