Jersey , Referenzimplementierung zur Entwicklung eines RESTful-Webdienstes auf der Grundlage des JAX-RS (JSR 311) ) Spezifikation.
In diesem Tutorial zeigen wir Ihnen, wie Sie mit Jersey eine einfache Hallo-Welt-REST-Webanwendung entwickeln.
In diesem Artikel verwendete Technologien und Tools:
-
Jersey 1,8
-
JDK 1.6
-
Tomcat 6.0
-
Maven 3.0.3
-
Eclipse 3.6
1. Verzeichnisstruktur
Dies ist die endgültige Webprojektstruktur dieses Lernprogramms.
2. Standard-Webprojekt
Erstellen Sie eine Standard-Maven-Webprojektstruktur.
mvn archetype:generate -DgroupId=com.mkyong.rest -DartifactId=RESTfulExample
-DarchetypeArtifactId=maven-archetype-webapp -DinteractiveMode=false
-
Hinweis ** Um Eclipse zu unterstützen, verwenden Sie den Befehl Maven:
mvn eclipse:eclipse -Dwtpversion=2.0
3. Projektabhängigkeiten
Jersey wird in Java.net Maven Repository veröffentlicht. Um die Jersey-REST-Anwendung zu entwickeln, wird in Maven `pom.xm`l einfach" Jersey-Server "angegeben.
Datei: pom.xml
<project ...>
<repositories>
<repository>
<id>maven2-repository.java.net</id>
<name>Java.net Repository for Maven</name>
<url>http://download.java.net/maven/2/</url>
<layout>default</layout>
</repository>
</repositories>
<dependencies>
<dependency>
<groupId>com.sun.jersey</groupId>
<artifactId>jersey-server</artifactId>
<version>1.8</version>
</dependency>
</dependencies>
</project>
4. REST-Service
Einfacher REST-Service mit Jersey.
package com.mkyong.rest;
import javax.ws.rs.GET;
import javax.ws.rs.Path;
import javax.ws.rs.PathParam;
import javax.ws.rs.core.Response;
@Path("/hello")
public class HelloWorldService {
@GET
@Path("/{param}")
public Response getMsg(@PathParam("param") String msg) {
String output = "Jersey say : " + msg;
return Response.status(200).entity(output).build();
}
}
5. web.xml
Registrieren Sie in "web.xml" "com.sun.jersey.spi.container.servlet.ServletContainer" und legen Sie Ihren Jersey-Serviceordner unter " init-param ", "com.sun.jersey.config" ab .eigenschaftspakete` “.
Datei: web.xml
<web-app id="WebApp__ID" version="2.4"
xmlns="http://java.sun.com/xml/ns/j2ee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee
http://java.sun.com/xml/ns/j2ee/web-app__2__4.xsd">
<display-name>Restful Web Application</display-name>
<servlet>
<servlet-name>jersey-serlvet</servlet-name>
<servlet-class>
com.sun.jersey.spi.container.servlet.ServletContainer
</servlet-class>
<init-param>
<param-name>com.sun.jersey.config.property.packages</param-name>
<param-value>com.mkyong.rest</param-value>
</init-param>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>jersey-serlvet</servlet-name>
<url-pattern>/rest/** </url-pattern>
</servlet-mapping>
</web-app>
6. Demo
In diesem Beispiel stimmt die Webanforderung von " projectURL/rest/hello/ " mit " HelloWorldService " über @Path ("/hello") `überein.
Das " \ {any values} " von " projectURL/rest/hello/\ {any values} " stimmt mit dem Parameter überein, der mit @ pathParam kommentiert wurde.
URL: http://localhost : 8080/RESTfulExample/rest/hello/mkyong
Quellcode herunterladen
Download es - JAX-RS-Hello-World-Jersey-Example.zip (6 KB)
Referenzen
-
link://webservices/jax-rs/resteasy-hallo-welt-beispiel/[RESTEasy hallo
Weltbeispiel]. http://www.vogella.de/articles/REST/article.html
(JAX-RS) mit Jersey - Tutorial]. http://www.ibm.com/developerworks/webservices/library/ws-restful/ [IBM
: RESTful Web services: The basics]. http://www.oracle.com/technetwork/articles/javase/index-137171.html [RESTful
Internetdienste]
Link://Tag/Hallo-Welt/[Hallo Welt]Link://Tag/Jax-RS/[Jax-RS] jersey