JavaEE 環境で JAX-RS の Hello World を実装する方法のメモ。

#環境
##OS
Windows7 64bit

##AP サーバ
GlassFish 4.0 OpenSource Edition

#実装
##Application クラスを継承したクラスを作成する

MyApplication

package jaxrs;

import javax.ws.rs.ApplicationPath;
import javax.ws.rs.core.Application;

@ApplicationPath("rest")
public class MyApplication extends Application {
}

##JAX-RS のサービスクラスを作成する

HelloWorldResource

package jaxrs;

import javax.ws.rs.GET;
import javax.ws.rs.Path;

@Path("hello-world")
public class HelloWorldResource {
    
    @GET
    public String helloWorld() {
        return "Hello World!!";
    }
}

#動作確認
ブラウザで以下の URL にアクセス。

※ホスト名（localhost）、ポート（8080）、コンテキストパス（jaxrs）は適宜読み替え。

#説明

MyApplication

@ApplicationPath("rest")
public class MyApplication extends Application {

まず javax.ws.rs.core.Application を継承したクラスを作成し、 javax.ws.rs.ApplicationPath アノテーションを付与する。このアノテーションの value に指定した値が、 JAX-RS で処理する URL のベースになる。

HelloWorldResource

@Path("hello-world")
public class HelloWorldResource {
    
    @GET
    public String helloWorld() {

ApplicationPath アノテーションで URL のベースを rest と指定しているので、 http://host-name/context-name/rest/hello-world に GET でアクセスすれば、上記の helloWorld() メソッドを実行することができる。

メソッドの戻り値が String 型の場合は、 return した値がそのまま HTTP のレスポンスとなる。

#参考

web applications - Jersey JAX-RS on Glassfish 3.0.1: Can I have an empty webapp element in my web.xml? - Stack Overflow