24.4.2 javax.ws.rs.core.HttpHeaders
javax.ws.rs.core.HttpHeadersは,HTTPリクエストのHTTPヘッダを保持するコンテキストです。
ルートリソースクラスのフィールドにインジェクトされるjavax.ws.rs.core.HttpHeadersの使用例を次に示します。
package com.sample.resources; import javax.ws.rs.GET; import javax.ws.rs.Path; import javax.ws.rs.core.Context; import javax.ws.rs.core.HttpHeaders; //ルートリソースクラス @Path("/root") public class Resource { //Contextアノテーションを使用してHttpHeadersをインジェクトするフィールド private @Context HttpHeaders httpHeaders; //リソースメソッド @GET public String getValue () { String value = this.httpHeaders.getRequestHeader("Accept").get(0); return value; } }
ルートリソースクラスcom.sample.resources.Resourceを含むWebアプリケーション(WARファイル)のコンテキストルートが"example"で,Webアプリケーションが"sample.com"というホストで公開されているとします。この例で,Accept HTTPヘッダに"application/xml"を指定したURL"http://sample.com/example/root"に対するHTTP GETリクエストでは,まずhttpHeadersフィールドにjavax.ws.rs.core.HttpHeadersコンテキストがインジェクトされ,その後HTTP GETリクエストを処理できるgetValue()メソッドが呼び出されます。このため,getValue()メソッドでhttpHeadersフィールドからAccept HTTPヘッダの値を取得すると"application/xml"という値が取得されます。