| Oracle® Fusion Middleware Oracle Infrastructure Webサービスの開発 12c (12.2.1.1) E77386-01 |
|
 前 |
 次 |
Fast Infosetは、テキストベースのXML形式よりも効率的にシリアライズできる、圧縮バイナリ・エンコーディング形式です。Fast Infosetは、ドキュメント・サイズと処理パフォーマンスの両方を最適化します。
有効にすると、Fast Infosetでは、データの送信前に、SOAPエンベロープのXML情報セットが圧縮バイナリ形式に変換されます。Fast Infosetは、暗号化メッセージ、署名付きメッセージ、MTOM対応メッセージおよびSOAPアタッチメントを最適化します。また、HTTPトランスポートとJMSトランスポートの両方をサポートします。
Fast Infoset機能は、すべてのWebサービスにおいて、デフォルトで有効です。Webサービス・クライアントの場合、Fast Infosetは、Webサービスで有効化されWSDLで通知されている場合にのみ有効となります。
Fast Infosetは、Webサービスまたはクライアントで、明示的に有効化および構成できます。これについて、次の項で説明します。
Fast Infoset機能は、デフォルトで、Webサービスで有効化され、WSDLに通知されています。次のいずれかの方法を使用することにより、WebサービスでFast Infosetを明示的に有効にできます。
設計時に、com.oracle.webservices.api.FastInfosetService注釈を使用します。たとえば、次に示すコードの抜粋は、com.oracle.webservices.api.FastInfosetService注釈を使用して、設計時にWebサービスでFast Infosetを有効化し構成する例を示しています。
package examples.webservices.fastinfoset; import com.oracle.webservcies.api.FastInfosetService; import oracle.webservices.annotations.PortableWebService; import javax.jws.WebMethod; @PortableWebService @FastInfosetService(enabled = true) public class HelloImplFastInfosetEnabled { @WebMethod public String hello(String name) { return "Hello, " + name + "! (from FI Enabled Service)"; } }
この注釈の詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』の@FastInfosetServiceに関する説明を参照してください。
@PortableWebService注釈の詳細は、Oracle Infrastructure WebサービスJava APIリファレンスを参照してください。
デプロイ後は、oracle/fast_infoset_service_policyをWebサービスにアタッチします。
詳細は、次の項を参照してください。
『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のFusion Middleware Controlを使用したWebサービスおよびクライアントへのポリシーのアタッチに関する説明
『Webサービスの管理』のWLSTを使用したFast Infosetの構成に関する項
次のいずれかの方法を使用することにより、Webサービス・クライアントでFast Infosetを明示的に有効化および構成できます。
設計時には、「設計時のFastInfosetClientFeature機能クラスの使用」に示すように、com.oracle.webservices.api.FastInfosetClientFeature機能を使用します。
デプロイメント後にoracle/fast_infoset_client_policyをWebサービスにアタッチする。
詳細は、次の項を参照してください。
『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のFusion Middleware Controlを使用したWebサービスおよびクライアントへのポリシーのアタッチに関する説明
『Webサービスの管理』のWLSTを使用したFast Infosetの構成に関する項
設計時にクライアントおよびWebサービスでFast Infosetを有効化および構成するには、次の項を参照してください。
クライアントでFast Infosetを有効化する際に、コンテンツ・ネゴシエーション・ポリシーを構成できます。
表7-1は、com.oracle.webservices.api.FastInfosetContentNegotiationTypeで定義する、有効なコンテンツ・ネゴシエーション方針をまとめたものです。
表7-1 コンテンツ・ネゴシエーション方針
| 値 | 説明 |
|---|---|
|
Fast Infosetがサービスで有効と見なします。すべてのリクエストが、Fast Infosetを使用して送信されます。 |
|
クライアントからの最初のリクエストは、Fast Infosetを有効にするのではなく、クライアントでFast Infoset機能がサポートされていることを示すHTTP受入れヘッダーを使用して送信されます。サービス・レスポンスがFast Infoset形式の場合、サービスでFast Infosetが有効になっていることが確認された後、クライアントからの後続リクエストはFast Infoset形式で送信されます。 |
|
クライアント・リクエストではFast Infosetは使用されません。 |
次のことに注意してください。
コンテンツ・ネゴシエーション戦略がクライアントで明示的に構成されている場合:
WSDLで通知されているネゴシエーション戦略より優先されます。
構成されているコンテンツ・ネゴシエーション戦略が、サービスにより通知されている機能と競合する場合(クライアントでOPTIMISTICが構成され、サービスでFast Infosetが無効にされている場合など)は、例外が生成されます。
コンテンツ・ネゴシエーション戦略がクライアントで明示的に構成されていない場合:
Fast Infosetがサービスで有効化および通知されている場合、OPTIMISTICコンテンツ・ネゴシエーション戦略が使用されます。
Fast Infosetがサービスで無効化され、通知されていない場合、NONEコンテンツ・ネゴシエーション戦略が使用されます。
次のコードの抜粋は、com.oracle.webservices.api.FastInfosetClientFeature機能クラスを使用して、設計時にWebサービスでFast Infosetを有効化および構成する例です。
package examples.webservices.fastinfoset; import com.oracle.webservices.api.FastInfosetClientFeature; import com.oracle.webservices.api.FastInfosetContentNegotiationType; ... public class HelloServicePortClient { private static HelloServiceService helloServiceService; public static void main(String [] args) { FastInfosetContentNegotiationType clientNeg = FastInfosetContentNegotiationType.PESSIMISTIC; FastInfosetClientFeature feature = FastInfosetClientFeature.builder().fastInfosetContentNegotiation(clientNeg).enabled(true).build(); helloServiceService = new HelloServiceService(); HelloService helloService = helloServiceService.getHelloServicePort(feature); ... }
設計時にFast Infosetを明示的に無効にするには次のようにします。
「WebサービスでのFast Infosetの有効化」の説明に従って、Webサービスで注釈のenabledフラグをfalseに設定します
Webサービス・クライアントの場合、アノテーションまたは機能クラスでenabledフラグをfalseに設定するか、コンテンツ・ネゴシエーション方針をNONEに設定します(「Webサービス・クライアントでのFast Infosetの有効化と構成について」を参照)
次のコードの抜粋は、com.oracle.webservices.api.FastInfosetServiceアノテーションを使用して、設計時にWebサービスでFast Infosetを無効化する例です。
package examples.webservices.fastinfoset; import com.oracle.webservices.api.FastInfosetService; ... @PortableWebService @FastInfosetService(enabled = false) public class HelloImplFastInfosetDisabled{ @WebMethod public String hello(String name) { return "Hello, " + name + "! (from FI Disabled Service)"; } }
デプロイメント後にFast Infosetを無効にするには次のようにします。
Webサービスまたはクライアントから、それぞれoracle/fast_infoset_service_policyポリシー、oracle/fast_infoset_client_policyポリシーをデタッチする。
詳細は、次の項を参照してください。
『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のFusion Middleware Controlを使用したWebサービスおよびクライアントへのポリシーのアタッチに関する説明
『Webサービスの管理』のWLSTを使用したFast Infosetの構成に関する項
グローバルにFast Infosetを無効にする場合は、Webサービスまたはクライアントの上位スコープで、それぞれoracle/no_fast_infoset_service_policyポリシー、oracle/no_fast_infoset_client_policyポリシーを含むポリシー・セットを定義する。
詳細は、次の項を参照してください。
『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のポリシー・セットを使用したポリシーのグローバルなアタッチに関する説明
『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のWLSTによるポリシー・セットを使用したグローバルなポリシーのアタッチに関する項
