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_specとMaven 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>"; } }
<?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アノテーション付けられたクラスをスキャンしてくれる、とかなんとか書いてある。