ジャージー

、http://jsr311.java.net/nonav/releases/1.1/index.html[JAX-RS(JSR 311)に基づいてRESTful Webサービスを開発するリファレンス実装)]を指定します。

このチュートリアルでは、

Jersey

を使用して単純な世界のREST Webアプリケーションを開発する方法を紹介します。

この記事で使用する技術とツール:

  1. ジャージー1.8

  2. JDK 1.6

  3. Tomcat 6.0

  4. Maven 3.0.3

  5. Eclipse 3.6

1.ディレクトリ構造

これはこのチュートリアルの最終的なWebプロジェクト構造です。


フォルダディレクトリ、タイトル= "ジャージーフォルダ"、幅= 471、高さ= 322

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


demo、title = "jersey-hello-world"、width = 567、height = 272

ソースコードをダウンロードする

ダウンロードする –

JAX-RS-Hello-World-Jersey-Example.zip

(6 KB)

参考文献


  1. ジャージー公式サイト

  2. リンク://webservices/jax-rs/resteasy-hello-world-example/[RESTEasy hello

(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

ウェブサービス]

リンク://タグ/hello-world/[hello world]

jax-rs


jersey