Cosminexus V9 アプリケーションサーバ Webサービス開発ガイド
ここでは,JAX-RSエンジンがサポートする要求メソッド識別子について説明します。
javax.ws.rs.DELETEアノテーションは,アノテートされたメソッドがHTTP DELETEリクエストを処理することを指定します。javax.ws.rs.DELETEアノテーションが使用できる対象を次に示します。
javax.ws.rs.GETアノテーションは,アノテートされたメソッドがHTTP GETリクエストを処理することを示します。javax.ws.rs.GETアノテーションが使用できる対象を次に示します。
javax.ws.rs.HEADアノテーションは,アノテートされたメソッドがHTTP HEADリクエストを処理することを示します。javax.ws.rs.HEADアノテーションが使用できる対象を次に示します。
HTTP HEADリクエストを受けた場合,JAX-RSエンジンは次の優先順位で動作します。
HTTP HEADリクエストを処理するルートリソースクラスの例を次に示します。
package com.sample.resources;
import javax.ws.rs.HEAD;
import javax.ws.rs.Path;
import javax.ws.rs.core.Response;
//ルートリソースクラス
@Path("/root")
public class Resource {
//リソースメソッド
@HEAD
public Response getValue() {
String customHeader = "foo";
String customHeaderValue = "bar";
int httpStatus = 200;
//ResponseBuilderを使用してResponseオブジェクトを構築する
return Response.status(httpStatus).header(customHeader,
customHeaderValue).build();
}
}
|
ルートリソースクラスcom.sample.resources.Resourceを含むWebアプリケーション(WARファイル)のコンテキストルートが"example"で,Webアプリケーションが"sample.com"というホストで公開されているとします。この例では,URL"http://sample.com/example/root"に対するHTTP HEADリクエストは,getValue()メソッドにディスパッチされます。getValue()メソッドが返すResponseオブジェクトがエンティティボディを含んでいても無視されます。
javax.ws.rs.OPTIONSアノテーションは,アノテートされたメソッドがHTTP OPTIONSリクエストを処理することを示します。javax.ws.rs.OPTIONSアノテーションが使用できる対象を次に示します。
HTTP OPTIONSリクエストのためのJAX-RSエンジンの動作を次に示します。
HTTP OPTIONSリクエストを処理するルートリソースクラスの例を次に示します。
package com.sample.resources;
import javax.ws.rs.OPTIONS;
import javax.ws.rs.Path;
import javax.ws.rs.core.Response;
//ルートリソースクラス
@Path("/root")
public class Resource {
//リソースメソッド
@OPTIONS
public Response getValue() {
String entity = "Some Contents";
String customHeader = "foo";
String customHeaderValue = "bar";
int httpStatus = 200;
//ResponseBuilderを使用してResponseオブジェクトを構築する
return Response.status(httpStatus).header(customHeader,
customHeaderValue).entity(entity).build();
}
}
|
ルートリソースクラスcom.sample.resources.Resourceを含むWebアプリケーション(WARファイル)のコンテキストルートが"example"で,Webアプリケーションが"sample.com"というホストで公開されているとします。この例では,URL"http://sample.com/example/root"に対するHTTP OPTIONSリクエストは,getValue()メソッドにディスパッチされます。
javax.ws.rs.POSTアノテーションは,アノテートされたメソッドがHTTP POSTリクエストを処理することを示します。javax.ws.rs.POSTアノテーションが使用できる対象を次に示します。
javax.ws.rs.PUTアノテーションは,アノテートされたメソッドがHTTP PUTリクエストを処理することを示します。javax.ws.rs.PUTアノテーションが使用できる対象を次に示します。
All Rights Reserved. Copyright (C) 2012, 2015, Hitachi, Ltd.