Serviciile de odihnă cu Java utilizând Jax-RS și Jersey

în

Exemplu de a crea un API Java (Jax-RS) cu servicii de odihnă utilizând Jersey cu Eclipse într-un proiect Maven.

Cerințe preliminare

Pentru a finaliza acest tutorial de succes, este necesar să aveți Eclipse instalat, serverul TOMCAT și să aveți noțiuni de bază Java.

Ce este este un serviciu de odihnă.

Restul sunt transferul de stat de reprezentare de acronim. Este o arhitectură software pentru a dezvolta servicii web. Colocvial, un serviciu web servește pentru a efectua un apel către o adresă URL (de obicei http) și obține date de răspuns la server (în principal în format JSON sau XML).

În ultimii ani, serviciile web de odihnă au fost stabilite ca fiind Modelul predominant pe web, deplasând alte arhitecturi ca săpun.

Jax-RS și Jersey

Jax-RS este un API Java pentru serviciile de web de odihnă care face parte din Java Ee.

Jersey este un cadru care simplifică în continuare utilizarea Jax-R-urilor prin răspândirea și furnizarea mai multor funcționalități pentru dezvoltatori.

Crearea proiectului în Eclipse

Primul Pasul va fi de a crea o aplicație numită cea mai aprofundată. În Eclipse mergem la meniul Fișier > nou > dinamic web proiect web. Apoi am scris doar numele proiectului ca în imagine și ajungem la finisare.

Schimbați tipul de proiect la Maven

Maven servește la gestionarea dependențelor de proiect. Acesta va servi în principal la înregistrarea bibliotecilor externe utilizate de proiect cu versiunile respective. Pentru ca Eclipse proiectul ca proiect Maven, îl vom converti. Pentru că vom merge la fereastra Proiectului Explorer (dacă nu îl avem deschis în meniul ferestrei > Afișare vizualizare > Project Explorer), În dosarul principal al proiectului, faceți clic pe butonul Drept > Configurarea > conversie la proiectul Maven. Lăsăm așa cum este în imagine și apăsați pe Finish.

este automat creat un fișier Pom.xml în rădăcina proiectului care este locul în care noi se va ocupa de bibliotecile. Pentru acest exemplu, vom folosi bibliotecile ASM.JAR, JERSEY-BUNDLE.JAR, JSON.JAR și JERSEY-SERVER.JAR. Pentru a edita Pom.xml putem face clic pe partea de sus a acestuia cu butonul drept > deschis cu > editor de text și lipiți acest XML:

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657
<?xml version="1.0" encoding="UTF-8"?><project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>ApiRest</groupId> <artifactId>ApiRest</artifactId> <version>0.0.1-SNAPSHOT</version> <packaging>war</packaging> <build> <sourceDirectory>src</sourceDirectory> <plugins> <plugin> <artifactId>maven-compiler-plugin</artifactId> <version>3.5.1</version> <configuration> <source>1.8</source> <target>1.8</target> </configuration> </plugin> <plugin> <artifactId>maven-war-plugin</artifactId> <version>3.0.0</version> <configuration> <warSourceDirectory>WebContent</warSourceDirectory> </configuration> </plugin> </plugins> </build> <dependencies> <dependency> <groupId>asm</groupId> <artifactId>asm</artifactId> <version>3.3.1</version> </dependency> <dependency> <groupId>com.sun.jersey</groupId> <artifactId>jersey-bundle</artifactId> <version>1.19</version> </dependency> <dependency> <groupId>org.json</groupId> <artifactId>json</artifactId> <version>20140107</version> </dependency> <dependency> <groupId>com.sun.jersey</groupId> <artifactId>jersey-server</artifactId> <version>1.19</version> </dependency> <dependency> <groupId>com.sun.jersey</groupId> <artifactId>jersey-core</artifactId> <version>1.19</version> </dependency> </dependencies></project>

până în prezent tot ceea ce am făcut a fost de a crea și configura proiect. Acum creăm un serviciu de odihnă care returnează, de exemplu, o listă de utilizatori. Dar înainte de a crea un pachet în care vă place codul nostru. Prin convenție, unul numit COM este de obicei creat. În dosarul aprest / Java Resources / SRC Buton Drept > pachet. Acum în interiorul acestui pachet butonul Dreapta > nou > Clasa. O fereastră va fi deschisă și am pus ca nume al clasei de utilizatori. Inside UserService.java Vom copia acest cod:

div id = „2def51dee”>

Vom crea un obiect Java vechi Ploin), o clasă la Definiți utilizatorul:

123456789101112131415161718192021
package com;import java.util.ArrayList;import java.util.List;import javax.ws.rs.GET;import javax.ws.rs.Path;import javax.ws.rs.Produces;import javax.ws.rs.core.Response;import org.json.JSONException;@Path("/users")public class UsersService { private static final long serialVersionUID = 1L; @GET @Produces("application/json") public Response getUsers() throws JSONException { List<User> users = new ArrayList<>(); users.add(new User("admin")); users.add(new User("john")); users.add(new User("usuario2")); return Response.status(200).entity(users.toString()).build(); }}

DIV ID =” 2DEF51DEE „> Compilați Proiectul

Faceți clic pe butonul Dreapta din proiect și noi Selectați Maven > actualizare. Și le dăm bine. Apoi, din nou butonul din dreapta din dosarul proiectului și dați-l să ruleze ca > maven construit (opțiunea numărul 5). În pop-up care este deschis în fila principală și câmpul de țintă am scris instalarea curată și apoi faceți clic pe Run.

Dacă totul a mers bine, ar trebui să vedeți un mesaj de succes similar cu acesta:

1234567891011121314151617181920212223
package com;import javax.xml.bind.annotation.XmlElement;import javax.xml.bind.annotation.XmlRootElement;import org.json.JSONException;import org.json.JSONObject;@XmlRootElementpublic class User { @XmlElement(name = "username") String username; public User() { } public User(String username) { this.username = username; } @Override public String toString() { try { return new JSONObject().put("username", username).toString(); } catch (JSONException e) { return null; } }}

Proiectul

Dacă am instalat deja și configurat serverul Tomcat pentru Eclipse, putem merge la fila de servere și în instanța Serverului Tomcat la localhost, faceți clic pe butonul din dreapta și selectați „Adăugare și eliminare …”

în fereastră este deschisă deplasarea aplicării noastre cele mai aprofundate de la dispoziție și oferim să terminăm.

Acum trebuie să configurați un web.xml pentru serverul Tomcat. Vom crea un fișier web.XML în dosarul WebContent / Web-Inf și vom copia următorul cod XML:

1234567
 ------------------------------------------------------------------------ BUILD SUCCESS ------------------------------------------------------------------------ Total time: 10.046 s Finished at: 2016-12-28T17:35:36+01:00 Final Memory: 17M/132M ------------------------------------------------------------------------

div id =” 2DEF51DEE „>

Pentru a rula instanța de server, Faceți clic pe butonul din dreapta al Tomcat și oferim Start. După câteva momente, putem deschide browserul și vom vizita adresa URL http://localhost:8080/ApiRest/users/. Dacă totul a mers bine, ar trebui să vedem un JSON cu următorul conținut:

ca rezumat Structura directorului ar trebui să fie Aceasta:

12345678910111213141516171819202122232425
iv id = ”
1234567891011

a interzis redarea totală sau parțială a acestui articol fără consimțământul prealabil al WebToutoriales.com

123456789
ApiRest/---- src/-------- com/------------ User.java------------ UsersService.java---- WebContent/--------WEB-INF/------------web.xml---- pom.xml

Lasă un răspuns

Adresa ta de email nu va fi publicată. Câmpurile obligatorii sunt marcate cu *