ジャージー
、http://jsr311.java.net/nonav/releases/1.1/index.html[JAX-RS(JSR 311)に基づいてRESTful Webサービスを開発するリファレンス実装)]を指定します。
このチュートリアルでは、
Jersey
を使用して単純な世界のREST Webアプリケーションを開発する方法を紹介します。
この記事で使用する技術とツール:
-
ジャージー1.8
-
JDK 1.6
-
Tomcat 6.0
-
Maven 3.0.3
-
Eclipse 3.6
1.ディレクトリ構造
これはこのチュートリアルの最終的なWebプロジェクト構造です。
2.標準Webプロジェクト
標準のMaven Webプロジェクト構造を作成します。
mvn archetype:generate -DgroupId=com.mkyong.rest -DartifactId=RESTfulExample -DarchetypeArtifactId=maven-archetype-webapp -DinteractiveMode=false
-
注意** Eclipseをサポートするには、Mavenコマンドを使用します:
mvn eclipse:eclipse -Dwtpversion=2.0
3.プロジェクトの依存関係
JerseyはJava.net Mavenリポジトリに公開されています。 Jersey RESTアプリケーションを開発するには、Maven `pom.xm`lに”
jersey-server
“と宣言してください。
File: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サービス
Jerseyとの簡単なRESTサービス。
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
web.xml`に" com.sun.jersey.spi.container.servlet.ServletContainer
“を登録し、あなたのJerseyサービスフォルダを”
init-param
“、” com.sun.jersey.config “の下に置きます.property.packages` “となります。
File: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.デモ
この例では、 ”
projectURL/rest/hello/
“からのWebリクエストは `@Path(”/hello “)を介して”
HelloWorldService
“と一致します。
”
projectURL/rest/hello/\ {any values}
“の ”
\ {any values}
“は、 `@PathParam`で注釈が付けられたパラメータと一致します。
URL:http://localhost:8080/RESTfulExample/rest/hello/mkyong
ソースコードをダウンロードする
ダウンロードする –
JAX-RS-Hello-World-Jersey-Example.zip
(6 KB)
参考文献
-
リンク://webservices/jax-rs/resteasy-hello-world-example/[RESTEasy hello
世界の例]。
http://www.vogella.de/articles/REST/article.html
[REST with Java
(JAX-RS)Jerseyを使用して – チュートリアル]。
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
ウェブサービス]