kagamihogeの日記

kagamihogeの日記です。

JAX-RSさわる

Web ServiceさわったらRESTもね、ということで。Hello Worldレベルのことをやる。環境は引き続きWildFly使う。

やったこと

Dynamic Web Project作る。
プロジェクト右クリック -> Configure -> Convert to Maven Projectする。
pom.xmlに依存性追加する。

<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>jboss8-rs</groupId>
    <artifactId>jboss8-rs</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <packaging>war</packaging>
    <dependencies>
        <dependency>
            <groupId>org.jboss.spec.javax.ws.rs</groupId>
            <artifactId>jboss-jaxrs-api_2.0_spec</artifactId>
            <version>1.0.0.Alpha1</version>
            <scope>provided</scope>
        </dependency>
    </dependencies>
    <build>
        <sourceDirectory>src</sourceDirectory>
        <plugins>
            <plugin>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.1</version>
                <configuration>
                    <source>1.7</source>
                    <target>1.7</target>
                </configuration>
            </plugin>
            <plugin>
                <artifactId>maven-war-plugin</artifactId>
                <version>2.3</version>
                <configuration>
                    <warSourceDirectory>WebContent</warSourceDirectory>
                    <failOnMissingWebXml>false</failOnMissingWebXml>
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>

Maven Repository: org.jboss.spec.javax.ws.rsを見るとMaven Repository: org.jboss.spec.javax.ws.rs » jboss-jaxrs-api_1.1_specMaven Repository: org.jboss.spec.javax.ws.rs » jboss-jaxrs-api_2.0_specてのがある。タブンjboss的にはコレを使えばいいんだろうな〜とういい加減な推測の元、コレを使うことにする。折角なので2.0を選ぶ。

HelloWorld的なことをやるコードを書く。ぶっちゃけJBoss Centralから作れるJAX-RSのサンプルプロジェクトhelloworld-rsのぱくり。

package kagamihoge.rs;

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

@Path("/")
public class HelloWorld {

    @GET
    @Path("/json")
    @Produces({ "application/json" })
    public String getHelloWorldJSON() {
        return "{\"result\":\"World\"}";
    }

    @GET
    @Path("/xml")
    @Produces({ "application/xml" })
    public String getHelloWorldXML() {
        return "<xml><result>World</result></xml>";
    }
}

web.xmlサーブレットのマッピング情報書く。

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns="http://xmlns.jcp.org/xml/ns/javaee"
    xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd"
    id="WebApp_ID" version="3.1">
    <display-name>jboss8-rs1</display-name>
    <servlet-mapping>
        <servlet-name>javax.ws.rs.core.Application</servlet-name>
        <url-pattern>/rest/*</url-pattern>
    </servlet-mapping>
</web-app>

http://localhost:8080/jboss8-rs/rest/json とか http://localhost:8080/jboss8-rs/rest/xml でレスポンスが返ってくる。

RESTEasy JAX-RS - 3.4. Configuring in JBoss AS 7, EAP, and Wildfly だと、web.xmlサーブレットマッピング使わないやり方が書いてある。
まず空のweb.xmlを用意する。

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://xmlns.jcp.org/xml/ns/javaee" xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd" id="WebApp_ID" version="3.1">
  <display-name>jboss8-rs</display-name>
</web-app>

こんな感じのクラスを作っておく。

package kagamihoge.rs;

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

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

}

ドキュメントには、このクラスがWARにあるとJAX-RSアノテーション付けられたクラスをスキャンしてくれる、とかなんとか書いてある。