WebLogic Webサービスでサポートされる機能および基準

2 WebLogic Webサービスでサポートされる機能および基準

Oracle WebLogic ServerのWebLogic Webサービスでは、様々な機能および標準がサポートされています。Webサービスの標準を定義する仕様の多くは、業界全体で幅広く使用できるように記述されています。そのため、Oracleによる特定の仕様の実装では、その仕様で定義されているすべての使い方がサポートされていない場合もあります。

ノート:

Oracle WebLogic ServerのJAX-WS実装は、JAX-WS参照実装(RI)から拡張されて、Glassfish Communityによって開発されます(https://github.com/javaee/metro-jax-wsを参照してください)。JAX-WS仕様(JSR-224)で定義されたすべての機能は、Oracle WebLogic Serverによって完全にサポートされます。

また、JAX-WS RIにはGlassfishコントリビュータによって提供された様々な拡張があります。特に記載しないかぎり、JAX-WS RI拡張はOracle WebLogic Serverでの使用についてはサポートされません。

Oracleでは、Webサービス仕様の考え得るあらゆる使用事例をサポートするよりも、Webサービス・プラットフォームの相互運用性の方をより重要視しています。Web Services Interoperability Organizationの次の仕様に準拠し、それをWebサービス相互運用性の基準とみなしています。

Basic Profile 2.0 (JAX-WSのみ): http://www.ws-i.org/Profiles/BasicProfile-2_0(WGD).html
Basic Profile 1.2 (JAX-WSのみ): http://www.ws-i.org/Profiles/BasicProfile-1_2(WGAD).html
Basic Profile 1.1 (JAX-WSおよびJAX-RPC):http://www.ws-i.org/Profiles/BasicProfile-1.1-2004-08-24.html
Basic Security Profile 1.1 (JAX-WSおよびJAX-RPC):http://www.ws-i.org/Profiles/BasicSecurityProfile-1.1.html
Reliable Secure Profile 1.0 (JAX-WSのみ):http://www.ws-i.org/Profiles/ReliableSecureProfile-1.0.html

WebLogic Webサービスのドキュメント・セットでは、すべての仕様の要件が説明されているわけではありません。ただし、これらの仕様の要件に含まれていない機能については説明しています。

次の表に、WebLogic Webサービスでサポートされる機能および仕様をまとめます。

表2-1 WebLogic Webサービスでサポートされる機能および基準

機能	説明	JAX-WS	JAX-RS	JAX-RPC
メタデータ・アノテーションに基づくプログラミング・モデルとランタイム・アーキテクチャ	JSR 109: Implementing Enterprise Web Services: WebLogic ServerなどのJava EEアプリケーション・サーバーで実行するWebサービスをJavaで実装するためのプログラミング・モデルおよびランタイム・アーキテクチャ。「JSR 109: Implementing Enterprise Web Services 1.3」を参照してください	バージョン1.3	なし	バージョン1.3
メタデータ・アノテーションに基づくプログラミング・モデルとランタイム・アーキテクチャ	Web Services Metadata for the Java Platform 2.0 (JSR-181)—Webサービスのプログラミングを容易にするためにJava Webサービス(JWS)ファイルで使用できる標準アノテーション。「Web Services Metadata for the Java Platform 2.0 (JSR-181)」を参照してください。	サポート対象	なし	サポート対象
プログラミングAPI	Java API for XML-based Web Services (JAX-WS)—Java Webサービスのコーディング、構築、デプロイメントに使用する標準ベースのAPI。統合されたスタックには、JAX-WS 2.1、JAXB 2.1、およびSAAJ 1.3が含まれます。「Java API for XML-based Web Services (JAX-WS) 2.2」を参照してください『Oracle WebLogic Server JAX-WS Webサービスの開発』も参照してください。	バージョン2.2	なし	なし
プログラミングAPI	Java API for RESTful Web Services (JAX-RS)—Representational State Transfer (REST)アーキテクチャ・スタイルに基づいてWebサービスを開発するための標準JAVA API。「Java API for RESTful Web Services (JAX-RS)」を参照してください。『Oracle WebLogic Server RESTful Webサービスの開発と保護』も参照してください。	なし	2.0	なし
プログラミングAPI	Java API for XML-based RPC (JAX-RPC)—XMLベースのリモート・プロシージャ・コール(RPC)に使用するJava API。「Java API for XML-based RPC (JAX-RPC) 1.1」を参照してください『Oracle WebLogic Server JAX-RPC Webサービスの開発』も参照してください。	なし	なし	バージョン1.1
データ・バインディング	Java Architecture for XML Binding (JAXB)—XMLスキーマをJavaコード内の表現にバインドするために使用する実装。JAXBは、JAX-WS Webサービスでのみサポートされます。「Java Architecture for XML Binding (JAXB) 2.2」を参照してください Oracle WebLogic Server JAX-WS Webサービスの開発のJAXBデータ・バインディングの使用も参照してください。	バージョン2.2	バージョン2.2	なし
データ・バインディング	Apache XMLBeans—XMLスキーマをJava型にバインドし、様々な方法でXMLデータにアクセスするための技術。XMLBeansは、JAX-RPC Webサービス用のデフォルトのバインディング技術です。「Apache XMLBeans 2.0」を参照してください。 Oracle WebLogic Server JAX-RPC Webサービスの開発のデータ・バインディングの理解も参照してください。	なし	なし	2.0
Webサービスの記述	Web Services Description Language (WSDL)—Webサービスを記述するためのXMLベースの仕様。「Web Services Description Language (WSDL) 1.1」を参照してください関連項目: JAX-WS: Oracle WebLogic Server JAX-WS Webサービスの開発のWSDLファイルから開始するWebLogic Webサービスの開発: 主なステップ JAX-RPC: Oracle WebLogic Server JAX-RPC Webサービスの開発のWSDLファイルから開始するWebLogic Webサービスの開発: 主なステップ	バージョン1.1	なし	バージョン1.1
Webサービスの記述	Web Application Description Language (WADL)—XMLベースの仕様で、マシンが読み取ることができるHTTPベースのWebアプリケーションの記述を提供します。「Web Application Description Language (WADL) 2009 Membership Submission」を参照してください	なし	2009 Member Submission	なし
Webサービスの記述	Web Services Policy Framework (WS-Policy)—Webサービスのポリシーを記述して通信するための、汎用的なモデルおよび対応する構文。「Web Services Policy Framework (WS-Policy) 1.5および1.2」を参照してください	バージョン1.5および1.2	なし	バージョン1.5および1.2
Webサービスの記述	Web Services Policy Attachment (WS-PolicyAttachment)—ポリシーに使用する抽象モデルとXMLベースの式の構文。「Web Services Policy Attachment (WS-Policy Attachment) 1.5および1.2」を参照してください	バージョン1.5および1.2	なし	バージョン1.5および1.2
Webサービスとリクエストを行ったクライアントの間のデータ交換	Simple Object Access Protocol (SOAP)—分散型環境で情報を交換するために使用する軽量XMLベースのプロトコル。「Simple Object Access Protocol (SOAP) 1.1および1.2」を参照してください	バージョン1.2および1.1	なし	バージョン1.2および1.1
Webサービスとリクエストを行ったクライアントの間のデータ交換	SOAP with Attachments API for Java (SAAJ) 1.3 - SOAP 1.1仕様およびSOAP with Attachmentsノートに準拠するメッセージの生成と消費を行うために開発者が使用できる実装。「SOAP with Attachments API for Java (SAAJ) 1.3」を参照してください	バージョン1.3	なし	バージョン1.3
セキュリティ	Web Services Security (WS-Security)—メッセージの内容の整合性と機密性を確保するセキュアなt5rrr6sを構築する際に使用できるSOAP (SOAP11、SOAP12)の拡張機能の標準セット。「Web Services Security (WS-Security) 1.1および1.0」を参照してください『Oracle WebLogic Server WebLogic Webサービスの保護』も参照してください。	バージョン1.1および1.0	なし	バージョン1.1および1.0
セキュリティ	Web Services Security Policy (WS-SecurityPolicy)—WS-Policyフレームワークで使用するセキュリティ・ポリシー・アサーションのセット。「Web Services Security Policy (WS-SecurityPolicy) 1.3」を参照してください『Oracle WebLogic Server WebLogic Webサービスの保護』も参照してください。	バージョン1.3	なし	バージョン1.3
セキュリティ	Security Assertion Markup Language (SAML)—セキュリティ・ドメイン間で認証および認可データを交換するためのXML標準。「Security Assertion Markup Language (SAML) 2.0および1.1」を参照してください『Oracle WebLogic Server WebLogic Webサービスの保護』も参照してください。	バージョン2.0および1.1	なし	バージョン2.0および1.1
セキュリティ	Security Assertion Markup Language (SAML) Token Profile—SOAPメッセージの認証と暗号化を実装するWS-Security SOAP拡張セット。「Security Assertion Markup Language (SAML) Token Profile 1.1および1.0」を参照してください『Oracle WebLogic Server WebLogic Webサービスの保護』も参照してください。	バージョン1.1および1.0	なし	バージョン1.1および1.0
信頼性のある通信	Web Services Addressing (WS-Addressing)—Webサービスおよびメッセージのアドレッシングを行うための、トランスポートに依存しないメカニズム。「Web Services Addressing (WS-Addressing) 1.0および2004/08 Member Submission」を参照してください	バージョン1.0および2004/08	なし	バージョン1.0および2004/08
信頼性のある通信	Web Services Reliable Messaging (WS-ReliableMessaging)—ソフトウェア・コンポーネント、システム、またはネットワークに障害が発生した場合に、別々のWebLogic Serverインスタンス上で動作する2つのエンドポイント(Webサービスおよびクライアント)が確実に通信するため実装。「Web Services Reliable Messaging (WS-ReliableMessaging)」を参照してください関連項目: JAX-WS: Oracle WebLogic Server JAX-WS Webサービスの開発のWebサービスの信頼性のあるメッセージングの使用 JAX-RPC: Oracle WebLogic Server JAX-RPC Webサービスの高度な機能のプログラミングのWebサービスの信頼性のあるメッセージングの使用	バージョン1.2および1.1	なし	バージョン1.1および1.0
信頼性のある通信	Web Services Reliable Messaging Policy (WS-RM Policy) —WS-PolicyおよびWS-ReliableMessagingで使用する信頼性のあるメッセージングのためのドメイン固有のポリシー・アサーション。「Web Services Reliable Messaging Policy (WS-RM Policy)」を参照してください関連項目: JAX-WS: Oracle WebLogic Server JAX-WS Webサービスの開発の信頼できるメッセージングおよびMakeConnection用の事前パッケージ済のWS-Policyファイル JAX-RPC: Oracle WebLogic Server JAX-RPC Webサービスの開発の信頼できるメッセージング用の事前パッケージ済のWS-Policyファイル	バージョン1.2および1.1	なし	バージョン1.1および1.0
信頼性のある通信	Web Services Trust Language (WS-Trust)—Web Services Security (WS-Security)に基づく拡張です。これらの拡張により、非同期通信を安全に実行できます。「Web Services Trust Language (WS-Trust)」を参照してください Oracle WebLogic Server WebLogic Webサービスの保護のメッセージレベルのセキュリティの構成も参照してください。	バージョン1.4および1.3	なし	バージョン1.3
信頼性のある通信	Web Services Secure Conversation Language (WS-SecureConversation)—Web Services Security (WS-Security)およびWeb Services Trust Language (WS-Trust)に基づく拡張です。これらの拡張により、非同期通信を安全に実行できます。「Web Services Secure Conversation Language (WS-SecureConversation)」を参照してください Oracle WebLogic Server WebLogic Webサービスの保護のメッセージレベルのセキュリティの構成も参照してください。	バージョン1.4	なし	バージョン1.3
非同期通信	非同期リクエスト・レスポンス—Webサービスを同期的に呼び出す場合、呼出し側のクライアント・アプリケーションは、レスポンスが返るまで待機してから、処理を続行します。レスポンスが即座に返る場合、このWebサービス呼出しの方法が一般的です。しかし、リクエストの処理が遅延する可能性があるため、クライアント・アプリケーションによる処理を続行しレスポンスへの対処は後で行うようにします。これは、非同期Webサービスの呼出しを使用して実行できます。たとえば、次を参照してください。 JAX-WS: Oracle WebLogic Server JAX-WS Webサービスの開発の非同期クライアントの開発 JAX-RPC: Oracle WebLogic Server JAX-RPC Webサービスの開発の非同期のリクエストおよびレスポンスを使用したWebサービスの呼出し	サポート対象	サポート対象	サポート対象
非同期通信	WS-MakeConnection—送信側エンドポイントが受信側エンドポイントへの新規接続を開始できない場合に2つのエンドポイント間でメッセージを転送するメカニズムを提供します。「Web Services MakeConnection 1.1」を参照してください Oracle WebLogic Server JAX-WS Webサービスの開発の非同期クライアントの開発も参照してください。	バージョン1.1	なし	なし
原子性トランザクション	Web Services Atomic Transaction—Web Services Coordination仕様に記述される拡張可能な調整フレームワークで使用される原子性トランザクションの調整タイプを定義します。WS-AtomicTransaction仕様とWS-Coordination仕様は、参加者間で分散アクティビティを調整する拡張可能なフレームワークを定義します。「Web Services Atomic Transaction (WS-AtomicTransaction) Version 1.2、1.1、および1.0」を参照してください。 Oracle WebLogic Server JAX-WS Webサービスの開発のWebサービスの原子性トランザクションの使用も参照してください。ノート: JAX-RPCの場合、同様の機能はトランザクション内で`@WebMethod`を使用して実行されます(`@weblogic.jws.Transactional`)。『Oracle WebLogic Server WebLogic Webサービス・リファレンス』のweblogic.jws.Transactionに関する項を参照してください。	バージョン1.2、1.1および1.0	なし	該当なし(詳細は「ノート」を参照)
原子性トランザクション	Web Services Coordination—分散アプリケーションのアクションを調整するプロトコルを提供する拡張可能なフレームワークを定義します。WS-AtomicTransaction仕様とWS-Coordination仕様は、参加者間で分散アクティビティを調整する拡張可能なフレームワークを定義します。「Web Services Coordination (WS-Coordination) Version 1.2、1.1、および1.0」を参照してください。 Oracle WebLogic Server JAX-WS Webサービスの開発のWebサービスの原子性トランザクションの使用も参照してください。	バージョン1.2、1.1および1.0	なし	なし
クライアント・イベント通知	Webサービス・コールバック—コールバックは、なんらかのイベントが発生したことをWebサービスのクライアントに通知するものです。たとえば、クライアントのリクエストの結果が用意されたとき、または、クライアントのリクエストが実行できない場合に、クライアントに通知できます。詳細については、以下を参照してください。 JAX-WS: 『Oracle WebLogic Server JAX-WS Webサービスの開発』のコールバックの使用 JAX-RPC: Oracle WebLogic Server JAX-RPC Webサービスの開発のコールバックを使用したクライアントへのイベントの通知	サポート対象	サポート対象外	サポート対象
XML伝達の最適化	Fast Infoset—テキストベースのXML形式よりも効率的にシリアライズできる、圧縮バイナリ・エンコーディング形式です。Fast Infosetによって、ドキュメント・サイズと処理パフォーマンスの両方が最適化されます。「Fast Infoset」を参照してください。 Oracle WebLogic Server JAX-WS Webサービスの開発のFast Infosetを使用したXML伝達の最適化も参照してください。	サポート対象	サポート対象外	サポート対象外
XML伝達の最適化	Message Transmission Optimization Mechanism (MTOM): SOAPメッセージにおける、`xs:base64Binary`または`xs:hexBinary`に関するXMLデータの転送を最適化するためのメソッドを定義します。詳細については、以下を参照してください。 JAX-WS: Oracle WebLogic Server JAX-WS Webサービスの開発のバイナリ・データ転送の最適化 JAX-RPC: Oracle WebLogic Server JAX-RPC Webサービスの開発のMTOM/XOPを使用したバイナリ・データの送信	サポート対象	サポート対象外	サポート対象
SOAP Over JMSトランスポート	SOAP over JMSトランスポート—通常、クライアント・アプリケーションからWebLogic Webサービスを呼び出すときは、接続プロトコルとしてHTTP/Sが使用されます。しかし、クライアント・アプリケーションがトランスポートにJMSを使用するようにWebLogic Webサービスを構成することもできます。SOAP over JMS Transport 1.0を参照してください。詳細については、以下を参照してください。 Oracle WebLogic Server JAX-WS Webサービスの開発の接続プロトコルとしてのJMSトランスポートの使用 Oracle WebLogic Server JAX-RPC Webサービスの開発の接続プロトコルとしてのJMSトランスポートの使用	サポート対象	サポート対象外	サポート対象
スタンドアロンJava SEクライアント・アクセス	スタンドアロンJava SEクライアントJARファイル—使用しているコンピュータにWebLogic Serverがインストールされていない場合でも、スタンドアロンWebLogic Webサービス・クライアントJARファイルを使用してWebサービスを起動できます。次を参照してください。 Oracle WebLogic Server JAX-WS Webサービスの開発のスタンドアロンJava SEクライアントからのWebサービスの起動 Oracle WebLogic Server JAX-RPC Webサービスの開発のWebサービス起動時のスタンドアロン・クライアントJARファイルの使用	サポート対象	サポート対象	サポート対象
公開(登録と検索)	Universal Description, Discovery, and Integration (UDDI)—UDDI v2.0レジストリおよびUDDIExplorerアプリケーションは、このリリースで削除されました。	なし	なし	なし

次の項では、これらの仕様について詳しく説明します。なお、仕様はアルファベット順に並べてあります。これら以外にWebLogic Webサービスでサポートされる仕様については、「WebLogic Webサービスでサポートされるその他の仕様」を参照してください

JAX-WS 2.2 RI/JDK 8.0の拡張に関するノート

APIのサブセット(たとえば、com.sun.xml.ws.developer)は、JDK 8.0またはJAX-WS 2.2 Reference Implementation (RI)の拡張としてサポートされます。

これらのAPIはJDK 8.0やWebLogic Serverソフトウェアの一部としては提供されないため、変更される可能性があります。以下にこのようなAPIの例を示します(これらに限定されるものではありません)。

com.sun.xml.ws.api.server.AsyncProvider
com.sun.xml.ws.client.BindingProviderProperties
com.sun.xml.ws.developer.JAXWSProperties
com.sun.xml.ws.developer.SchemaValidation
com.sun.xml.ws.developer.SchemaValidationFeature
com.sun.xml.ws.developer.StreamingAttachment
com.sun.xml.ws.developer.StreamingAttachmentFeature
com.sun.xml.ws.developer.StreamingDataHandler

Apache XMLBeans 2.0

XMLBeansでは、XMLインスタンス・データにアクセスして変更するためのJavaインタフェースおよびクラスを、XML Schemaを使用してコンパイルします。XMLBeansは、JAX-RPC Webサービス用のデフォルトのバインディング技術です。

Apache XMLBeans 2.0(http://xmlbeans.apache.org)は、XMLスキーマをJava型にバインドし、様々な方法でXMLデータにアクセスするための技術を提供します。

Fast Infoset

Fast Infosetは、テキストベースのXML形式よりも効率的にシリアライズできる、圧縮バイナリ・エンコーディング形式です。Fast Infosetによって、ドキュメント・サイズと処理パフォーマンスの両方が最適化されます。

有効にすると、Fast Infosetでは、データの送信前に、SOAPエンベロープのXML情報セットが圧縮バイナリ形式に変換されます。Fast Infosetは、暗号化メッセージ、署名付きメッセージ、MTOM対応メッセージおよびSOAPアタッチメントを最適化します。また、HTTPトランスポートとJMSトランスポートの両方をサポートします。

Fast Infoset仕様ITU-T Rec.X.891およびISO/IEC 24824-1 (Fast Infoset)は、ITU-TおよびISOの両方の標準化団体によって規定されています。この仕様は、ITUのWebサイト(http://www.itu.int/rec/T-REC-X.891-200505-I/en)からダウンロードできます。

『Oracle WebLogic Server JAX-WS Webサービスの開発』の「Fast Infosetを使用したXML転送の最適化」を参照してください。

Java API for RESTful Web Services (JAX-RS)

Java API for RESTful Web Services (JAX-RS)仕様は、Representational State Transfer (REST)アーキテクチャ・スタイルに基づいてWebサービスを開発するための標準JAVA APIを提供します。https://jcp.org/en/jsr/detail?id=339を参照してください。

WebLogic Serverのこのリリースでは、デフォルトでJersey 2.x (JAX-RS 2.0 RI)がサポートされています。共有ライブラリとしてのWebLogic Serverへの登録は不要になりました。

『Oracle WebLogic Server RESTful Webサービスの開発と保護』を参照してください。

Java API for XML-based RPC (JAX-RPC) 1.1

Java API for XML-based RPC (JAX-RPC)仕様は、XMLベースのリモート・プロシージャ・コール(RPC)に使用するJava APIを定義します。特に、これらのAPIは、SOAP 1.1(分散型環境で情報を交換するためのXMLベースのプロトコル)を使用して、Webサービスを呼び出したり、Webサービスからレスポンスを取得したりするのに使用されます。

ネームスペース: http://java.sun.com/xml/ns/jax-rpc

https://github.com/javaee/jax-rpc-riを参照してください。

WebLogic Serverには、JAX-RPCバージョン1.1仕様の必要な機能がすべて実装されています。また、Oracle WebLogic Server JAX-RPC Webサービスの開発のデータ・バインディングの理解で説明されているとおり、WebLogic Server実装のオプションのデータ型もサポートされています。WebLogic Serverには、この章で説明されていないJAX-RPC仕様のオプション機能は実装されていません。

『Oracle WebLogic Server JAX-RPC Webサービスの開発』を参照してください。

ノート:

JAX-WSはJAX-RPCの後継仕様で、Java EEの新機能の多くが実装されているため、JAX-WSに準拠してWebサービスを開発することをお薦めします。JAX-RPCは、レガシーな仕様と位置づけられ、これ以上の拡張は予定されていません。

Java API for XML-Based Web Services (JAX-WS) 2.2

Java API for XML-based Web Services (JAX-WS)は、Java Webサービスのコーディング、構築、デプロイメントに使用する標準ベースのAPIです。

ネームスペース : http://java.sun.com/xml/ns/jaxws

http://jcp.org/aboutJava/communityprocess/mrel/jsr224/index2.htmlを参照してください。統合されたスタックには、JAX-WS 2.2、Java Architecture for XML Binding (JAXB) 2.2およびSOAP with Attachments API for Java (SAAJ) 1.3が含まれます。

『Oracle WebLogic Server JAX-WS Webサービスの開発』を参照してください。

Java Architecture for XML Binding (JAXB) 2.2

Java Architecture for XML Binding (JAXB)は、XMLスキーマをJavaコード内の表現にバインドする便利な方法を提供します。これにより、XML自体に関する知識がそれほどなくても、XMLデータと処理関数を、Javaテクノロジに基づくアプリケーションに、簡単に組み込むことができます。

ネームスペース : http://java.sun.com/xml/ns/jaxb

http://jcp.org/en/jsr/detail?id=222を参照してください。

『Oracle WebLogic Server JAX-WS Webサービスの開発』の「JAXBデータ・バインディングの使用」を参照してください。

ノート:

JAXBをJAX-RPCと一緒に使用することはできません。

JSR 109: Implementing Enterprise Web Services 1.3

JSR 109: Implementing Enterprise Web Servicesは、WebLogic ServerなどのJava EEアプリケーション・サーバーで実行するWebサービスをJavaで実装するためのプログラミング・モデルおよびランタイム・アーキテクチャを定義します。

JSR 109: Implementing Enterprise Web Services仕様(http://www.jcp.org/en/jsr/detail?id=109)を参照してください。特に、プログラマが次の2つのコンポーネントのいずれかを使用してJava EE Webサービスを実装することを規定しています。

Webコンテナ内で動作するJavaクラス
EJBコンテナ内で動作するステートレス・セッションEJB

また、標準Java EE Webサービスのパッケージ化形式、デプロイメント・モデル、実行時サービスについても記述されており、そのすべてをWebLogic Webサービスで実装しています。

Security Assertion Markup Language (SAML) 2.0および1.1

Security Assertion Markup Language (SAML)仕様は、セキュリティ・ドメイン間で認証および認可データを交換するためのXML標準を提供します。

ネームスペース:

urn:oasis:names:tc:SAML:2.0:assertion

urn:oasis:names:tc:SAML:2.0:protocol

次を参照してください。

「Oracle WebLogic ServerのWebLogic Webサービスの保護」を参照してください。

Security Assertion Markup Language (SAML) Token Profile 1.1および1.0

Web Services Security: SAML Token Profile 1.1仕様は、SOAPメッセージの認証および暗号化を実装するSOAP拡張機能セットを定義します。

ネームスペース: urn:oasis:names:tc:SAML:1.0:assertion

次を参照してください。

「Oracle WebLogic ServerのWebLogic Webサービスの保護」を参照してください。

Simple Object Access Protocol (SOAP) 1.1および1.2

Simple Object Access Protocol (SOAP)は、分散型環境で情報を交換するために使用する軽量XMLベースのプロトコルです。

ネームスペース : http://schemas.xmlsoap.org/wsdl/soap

http://www.w3.org/TR/SOAPのSimple Object Access Protocol (SOAP)を参照してください。WebLogic Serverには、SOAP仕様のバージョン1.1と1.2の独自の実装が含まれています。プロトコルの構成は以下のとおりです。

SOAPメッセージを記述するエンベロープ。メッセージの本文を含むエンベロープは、処理するユーザーを識別し、処理方法を記述します。
アプリケーション固有のデータ型のインスタンスを表現するためのエンコーディング・ルール・セット。
リモート・プロシージャ・コールおよびレスポンスを表す規則。

この情報は、HTTPやHTTPSなどのWebプロトコルで転送可能なMultipurpose Internet Mail Extensions (MIME)エンコード・パッケージ内に埋め込まれています。MIMEは、非ASCIIメッセージをインターネット上で送信できるようにフォーマットするための仕様です。

次の例は、HTTPリクエスト内に埋め込まれている株取引情報用のSOAP 1.1リクエストを示しています。

POST /StockQuote HTTP/1.1
Host: www.sample.com:7001
Content-Type: text/xml; charset="utf-8"
Content-Length: nnnn
SOAPAction: "Some-URI"

<SOAP-ENV:Envelope 
   xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
         SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
     <SOAP-ENV:Body>
          <m:GetLastStockQuote xmlns:m="Some-URI">
               <symbol>ORCL</symbol>
          </m:GetLastStockQuote>
     </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

WebLogic Webサービスは、デフォルトではSOAPのバージョン1.1を使用します。バージョン1.2を使用する場合は、そのWebサービスを実装するJWSファイルでバインディング・タイプを指定する必要があります。

SOAP over JMSトランスポート1.0

SOAP over Java Messaging Service (JMS)トランスポートは、JAX-WSおよびJAX-RPC WebLogic Webサービスの接続プロトコルとしてサポートされています。

JAX-WSでは、この機能は新しいW3C SOAP over Java Message Service 1.0標準(2012年2月)をサポートします。この標準は、http://www.w3.org/TR/soapjms/で入手できます。

詳細については、以下を参照してください。

Oracle WebLogic Server JAX-WS Webサービスの開発の接続プロトコルとしてのJMSトランスポートの使用
Oracle WebLogic Server JAX-RPC Webサービスの開発の接続プロトコルとしてのJMSトランスポートの使用

SOAP with Attachments API for Java (SAAJ) 1.3

SOAP with Attachments API for Java (SAAJ)は、SOAP 1.1仕様およびSOAP with Attachmentsノートに準拠するメッセージを開発者が生成および消費する方法を説明します。

https://saaj.java.netで説明しているSOAP with Attachments API for Java (SAAJ)仕様を参照してください。

APIのjavax.xml.soapというパッケージでは、MIME添付を持つSOAPメッセージの主要な抽象概念を提供しています。添付には、XMLドキュメント全体、XMLフラグメント、画像、テキスト・ドキュメント、または有効なMIMEタイプを持つその他のコンテンツを使用できます。また、このパッケージでは、Webサービスとのリクエストおよびレスポンス型の対話に関する単純なクライアント側のビューも提供しています。

Web Application Description Language (WADL) 2009 Membership Submission

Web Application Description Language (WADL)は、XMLベースの仕様で、マシンが読み取ることができるHTTPベースのWebアプリケーションの記述を提供します。WebLogic Webサービスの開発者は、WADLファイルを作成する必要はありません。これらのファイルはWebLogic Webサービス開発プロセスの一部として自動的に生成されます。

ネームスペース: http://wadl.dev.java.net/2009/02/wadl.xsd

http://www.w3.org/Submission/wadlのWeb Application Description Language (WADL)仕様を参照してください。

『Oracle WebLogic Server RESTful Webサービスの開発と保護』を参照してください。

Web Services Addressing (WS-Addressing) 1.0および2004/08 Member Submission

Web Services Addressing (WS-Addressing)コアは、Webサービスおよびメッセージのアドレッシングを行うための、トランスポートに依存しないメカニズムを提供します。

ネームスペース:

http://www.w3.org/2005/08/addressing

http://www.w3.org/2007/05/addressing/metadata

http://www.w3.org/TR/ws-addr-coreのWeb Services Addressing (WS-Addressing)コア仕様を参照してください。特に、この仕様では、Webサービスのエンドポイントを識別したり、メッセージ内のエンドポイントIDをエンド・ツー・エンドで保護したりするのに使用される多数のXML要素が定義されています。

1.0に加え、現在のリリースでは、Web Services Addressing (August 2004 Member Submission) (http://www.w3.org/Submission/2004/SUBM-ws-addressing-20040810)もサポートされます。

Web Services Addressing (WS-Addressing) Metadata仕様は、http://www.w3.org/TR/ws-addr-metadataで説明されるように、WSDLを使用してWeb Services Addressing Coreで定義される抽象プロパティを記述する方法や、WebサービスによってWS-Addressingのサポートを指定するためにWS-Policyを使用する方法を定義します。

Web Services Atomic Transaction (WS-AtomicTransaction) Version 1.2、1.1、および1.0

Web Services Atomic Transaction (WS-AtomicTransaction)は、Web Services Coordination仕様に記述される拡張可能な調整フレームワークで使用される原子性トランザクションの調整タイプを定義します。WS-AtomicTransaction仕様とWS-Coordination仕様は、参加者間で分散アクティビティを調整する拡張可能なフレームワークを定義します。

http://docs.oasis-open.org/ws-tx/wstx-wsat-1.2-spec-cs-01/wstx-wsat-1.2-spec-cs-01.htmlで説明しているWebサービスの原子性トランザクション(WS-AtomicTransaction)仕様を参照してください。

『Oracle WebLogic Server JAX-WS Webサービスの開発』の「Webサービス原子性トランザクションの使用」を参照してください。

Web Services Coordination (WS-Coordination) Version 1.2、1.1、および1.0

Web Services Coordination (WS-Coordination)は、分散アプリケーションのアクションを調整するプロトコルを提供する拡張可能なフレームワークを定義します。

http://docs.oasis-open.org/ws-tx/wstx-wscoor-1.2-spec-cs-01/wstx-wscoor-1.2-spec-cs-01.htmlで説明しているWeb Services Coordination (WS-Coordination)仕様を参照してください。WS-AtomicTransaction仕様とWS-Coordination仕様は、参加者間で分散アクティビティを調整する拡張可能なフレームワークを定義します。

Web Services Description Language (WSDL) 1.1

WSDL (Web Services Description Language)は、Webサービスの内容を説明するXMLベースの仕様です。WSDLドキュメントには、Webサービス操作、入出力パラメータ、およびクライアント・アプリケーションからWebサービスへの接続方法を記述します。

ネームスペース : http://schemas.xmlsoap.org/wsdl

http://www.w3.org/TR/wsdlのWeb Services Description Language (WSDL)仕様を参照してください。

WebLogic Webサービスの開発者は、WSDLファイルを作成する必要はありません。これらのファイルはWebLogic Webサービス開発プロセスの一部として自動的に生成されます。

次の例は参照用でGetLastStockQuoteメソッドを含む株取引WebサービスStockQuoteServiceを記述するWSDLファイルを示しています。

<?xml version="1.0"?>
  <definitions name="StockQuote"
               targetNamespace="http://sample.com/stockquote.wsdl"
               xmlns:tns="http://sample.com/stockquote.wsdl"
               xmlns:xsd="http://www.w3.org/2000/10/XMLSchema"
               xmlns:xsd1="http://sample.com/stockquote.xsd"
               xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
               xmlns="http://schemas.xmlsoap.org/wsdl/">
      <message name="GetStockPriceInput">
          <part name="symbol" element="xsd:string"/>
      </message>
      <message name="GetStockPriceOutput">
          <part name="result" type="xsd:float"/>
      </message>
      <portType name="StockQuotePortType">
          <operation name="GetLastStockQuote">
             <input message="tns:GetStockPriceInput"/>
             <output message="tns:GetStockPriceOutput"/>
          </operation>
      </portType>
      <binding name="StockQuoteSoapBinding" type="tns:StockQuotePortType">
          <soap:binding style="rpc" 
                        transport="http://schemas.xmlsoap.org/soap/http"/>
          <operation name="GetLastStockQuote">
             <soap:operation soapAction="http://sample.com/GetLastStockQuote"/>
             <input>
                 <soap:body use="encoded" namespace="http://sample.com/stockquote"
                           encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"/>
             </input>
             <output>
             <soap:body use="encoded" namespace="http://sample.com/stockquote"
                           encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"/>
             </output>
          </operation>>
      </binding>
      <service name="StockQuoteService">
          <documentation>My first service</documentation>
          <port name="StockQuotePort" binding="tns:StockQuoteSoapBinding">
             <soap:address location="http://sample.com/stockquote"/>
          </port>
      </service>
  </definitions>

WSDL仕様には、Webサービスを呼び出すときに使用できる様々なタイプのバインディングを指定するための、オプションの拡張要素があります。WebLogic Webサービス・ランタイムでは、次のとおりです。

SOAPバインディングを完全にサポートしているため、WSDLファイルにSOAPバインディングが含まれている場合、WebLogic Webサービスは、Webサービスの呼出しに使用するメッセージの形式およびプロトコルとしてSOAPを使用します。
HTTP GETおよびPOSTバインディングが無視されるため、WSDLファイルにこの拡張機能が含まれている場合、WebLogic Webサービス・ランタイムではWSDLの解析時にその要素がスキップされます。
MIMEバインディングが部分的にサポートされているため、WSDLファイルにこの拡張機能が含まれている場合、WebLogic Webサービス・ランタイムでその要素が解析されますが、Webサービス呼出しのためにメッセージを作成するときに、実際にはMIMEバインディングは作成されません。

次を参照してください。

JAX-WS: Oracle WebLogic Server JAX-WS Webサービスの開発のWSDLファイルから開始するWebLogic Webサービスの開発: 主なステップ
JAX-RPC: Oracle WebLogic Server JAX-RPC Webサービスの開発のWSDLファイルから開始するWebLogic Webサービスの開発: 主なステップ

Web Services MakeConnection 1.1

Web Services MakeConnectionでは、送信側エンドポイントが受信側エンドポイントへの新規接続を開始できない場合に2つのエンドポイント間でメッセージを転送するメカニズムを提供します。たとえば、ファイアウォールの内側から非同期Webサービスを起動するためのものです。

ネームスペース: http://docs.oasis-open.org/ws-rx/wsmc/200702

http://docs.oasis-open.org/ws-rx/wsmc/200702のWeb Services MakeConnection仕様を参照してください。

『Oracle WebLogic Server JAX-WS Webサービスの開発』の「非同期クライアントの開発」を参照してください。

Web Services Metadata for the Java Platform 2.0 (JSR-181)

メタデータ・アノテーション機能を活用して、アノテーション付きのJavaファイルを作成し、Antタスクを使用してそのファイルを標準のJavaクラスまたはEJBのJavaソース・コードに変換し、関連するアーティファクトをすべて自動的に生成するプログラミング・モデルを使用することをお薦めします。

http://download.oracle.com/javase/6/docs/technotes/guides/language/annotations.htmlを参照してください。

アノテーション付きのJava Webサービス(JWS)ファイル(簡略化してJWSファイルと呼びます)は、Webサービスの中核部分です。このファイルにはWebサービスの動作を決定するJavaコードが含まれています。JWSファイルは、JDK 5.0メタデータ・アノテーションを使用してWebサービスの形式や特性を指定した、通常のJavaクラス・ファイルです。JWSファイルで使用できるJWSアノテーションには、http://www.jcp.org/en/jsr/detail?id=181に記載のWeb Services Metadata for the Java Platform仕様(JSR-181)で定義された標準のアノテーションと、その他の標準またはWebLogic固有のアノテーションがあり、作成するWebサービスのタイプに応じて使い分けます。

ノート:

JWSアノテーション・ファイルを使用する以外の方法としては、標準のJavaクラスまたはEJBをゼロからコーディングし、それに関連するアーティファクト(デプロイメント記述子ファイル、WSDL、ユーザー定義のデータ型のデータ・バインディング・アーティファクトなど)を手動で生成することで、WebLogic Webサービスを自分でプログラミングする方法があります。ただし、この方法は、難しく時間がかかるためお薦めできません。

Web Services Policy Attachment (WS-Policy Attachment) 1.5および1.2

Web Services Policy Attachment (WS-Policy Attachment)仕様では、ポリシーの抽象モデルとXMLベースの式の文法を定義しています。この仕様では、ポリシーとポリシーの適用先のサブジェクトを関連付けるための、2つの汎用メカニズムが定義されています。また、それらの汎用メカニズムを使用して、WS-PolicyをWSDLやUDDIの記述に関連付ける方法も定義しています。

ネームスペース:

WS-Policy Attachment 1.5 : http://www.w3.org/ns/ws-policy

WS-PolicyAttachment 1.2 : http://schemas.xmlsoap.org/ws/2004/09/policy

次を参照してください。

Web Services Policy 1.5 - Attachment(推奨): http://www.w3.org/TR/ws-policy-attach/
Web Services Policy 1.2 - Attachment (WS-PolicyAttachment)(メンバーの発行): http://www.w3.org/Submission/WS-PolicyAttachment

「Oracle WebLogic ServerのWebLogic Webサービスの保護」を参照してください。

Web Services Policy Framework (WS-Policy) 1.5および1.2

WS-Policy Framework (WS-Policy)仕様では、Webサービスのポリシーを記述して通信するための、汎用的なモデルと対応する構文が提供されています。WS-Policyは、幅広いサービスの要件、プリファレンス事項、機能を記述するために、他のWebサービス仕様が使用したり拡張したりできる、構成の基本セットを定義しています。

ネームスペース:

WS-Policy Framework 1.5 : http://www.w3.org/ns/ws-policy

WS-Policy 1.2 : http://schemas.xmlsoap.org/ws/2004/09/policy

次を参照してください。

Web Services Policy 1.5 - Framework(推奨): http://www.w3.org/TR/ws-policy
Web Services Policy 1.2 - Framework (WS-Policy) (メンバーの発行): http://www.w3.org/Submission/WS-Policy

「Oracle WebLogic ServerのWebLogic Webサービスの保護」を参照してください。

Web Services Reliable Messaging (WS-ReliableMessaging)

Web Services Reliable Messaging (WS-ReliableMessaging)は、ソフトウェア・コンポーネント、システム、またはネットワークに障害が発生した場合に、別々のWebLogic Serverインスタンス上で動作する2つのWebサービスが確実に通信できるかを説明します。

ネームスペース : http://docs.oasis-open.org/ws-rx/wsrm/200702

http://docs.oasis-open.org/ws-rx/wsrm/200702のWeb Services Reliable Messaging (WS-ReliableMessaging)仕様を参照してください。特に、ソース・エンド・ポイントから宛先エンド・ポイントに送信されるメッセージの配信またはエラーの生成を保証する、相互運用性プロトコルを提供しています。

次を参照してください。

JAX-WS: Oracle WebLogic Server JAX-WS Webサービスの開発のWebサービスの信頼性のあるメッセージングの使用
JAX-RPC: Oracle WebLogic Server JAX-RPC Webサービスの高度な機能のプログラミングのWebサービスの信頼性のあるメッセージングの使用

ノート:

WebLogic Server WS-ReliableMessagingは、旧バージョンの仕様との後方互換性をサポートします。たとえば、WS-ReliableMessaging 1.2 Webサービスは、WS-ReliableMessaging 1.2または1.1の仕様に準拠するクライアントによってアクセスされます。ただし、WS-ReliableMessaging 1.2/1.1クライアントは、WS-ReliableMessaging 1.0サーバーと通信できません。WS-ReliableMessaging 1.2 (クライアントまたはサービス)は、JAX-WSでのみサポートされることに注意します。

Web Services Reliable Messaging Policy Assertion (WS-RM Policy)

Web Services Reliable Messaging Policy Assertion (WS-RM Policy)仕様では、WS-PolicyおよびWS-ReliableMessagingで使用する信頼性のあるメッセージングのためのドメイン固有のポリシー・アサーションが定義されています。この仕様では、RM宛先およびRMソースは、所定のシーケンスに対するそれぞれの要件を記述できるようになります。

ネームスペース : http://docs.oasis-open.org/ws-rx/wsrmp/200702

次を参照してください。

バージョン1.2 (JAX-WSのみ): http://docs.oasis-open.org/ws-rx/wsrmp/200702/wsrmp-1.2-spec-os.html
バージョン1.1 (JAX-WSとJAX-RPC): http://docs.oasis-open.org/ws-rx/wsrmp/200702/wsrmp-1.1-spec-os-01.html

次を参照してください。

JAX-WS: Oracle WebLogic Server JAX-WS Webサービスの開発のWebサービスの信頼性のあるメッセージングの使用
JAX-RPC: Oracle WebLogic Server JAX-RPC Webサービスの高度な機能のプログラミングのWebサービスの信頼性のあるメッセージングの使用

Web Services Secure Conversation Language (WS-SecureConversation)

Web Services Secure Conversation Language (WS-SecureConversation)仕様では、Web Services Security (WS-Security) 1.1、1.0およびWeb Services Trust Language (WS-Trust)に基づく拡張が定義されています。これらの拡張により、1つ以上のメッセージにまたがる通信を保護できます。

ネームスペース : http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512

特に、仕様はセキュリティ・コンテキストを確立および共有し、そのセキュリティ・コンテキスト(または共有秘密)からキーを派生させるためのメカニズムが定義されています。

次を参照してください。

バージョン1.4 (JAX-WS): http://docs.oasis-open.org/ws-sx/ws-secureconversation/v1.4/ws-secureconversation.html
バージョン1.3 (JAX-RPC): http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512/ws-secureconversation-1.3-os.html

「Oracle WebLogic ServerのWebLogic Webサービスの保護」を参照してください。

Web Services Security (WS-Security) 1.1および1.0

ネームスペース : http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecuritysecext-1.0.xsd、http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurityutility-1.0.xsd、http://docs.oasis-open.org/wss/oasis-wss-wssecurity-secext-1.1.xsd

Webサービス・セキュリティについての以下の説明は、2006年2月の「Web Services Security: SOAP Message Security」と題されたOASIS標準1.1仕様から直接引用したものです。

この仕様は、整合性と機密性を確保するセキュアなWebサービスを構築する際に使用できるSOAP (SOAP11、SOAP12)の拡張の標準セットを提案するものです。この拡張セットのことをWeb Services Security: SOAP Message SecurityまたはWSS: SOAP Message Securityと呼びます。

この仕様には柔軟性があり、様々なセキュリティ・モデル(PKI、Kerberos、SSLなど)でセキュアなWebサービスを実現するための土台となるように設計されています。たとえばこの仕様では、複数のセキュリティ・トークン・フォーマット、複数の信頼ドメイン、複数のシグネチャ・フォーマット、および複数の暗号化技術がサポートされています。トークン・フォーマットおよびそれらを使用するためのセマンティクスは、関連付けられたプロファイル・ドキュメントに定義されています。

この仕様は、主にセキュリティ・トークンの伝播、メッセージの整合性、およびメッセージの機密性の3つのメカニズムを提供します。これらのメカニズムは、それだけではWebサービス用の完全なセキュリティ・ソリューションとはなりません。この仕様は、他のWebサービス拡張機能やより高いレベルのアプリケーション固有プロトコルと一緒に使用して、様々なセキュリティ・モデルおよびセキュリティ技術を実現することができるビルディング・ブロックです。

前述のメカニズムは、独立して使用することも(たとえばセキュリティ・トークンを渡すため)、密接に統合して使用することもできます(たとえば、メッセージ全体やその一部に対して署名や暗号化を行い、署名や暗号化に使用するキーと関連付けられたセキュリティ・トークンまたはトークン・パスを提供するなど)。

OASIS Web Service Security Webページ(http://www.oasis-open.org/committees/tc_home.php?wg_abbrev=wss)を参照してください。

WebLogic Webサービスでは次のトークン・プロファイルも実装しています。

Webサービス・セキュリティ: SOAPメッセージ・セキュリティ
Webサービス・セキュリティ:ユーザー名トークン・プロファイル
Webサービス・セキュリティ: X.509証明書トークン・プロファイル
Webサービス・セキュリティ: SAMLトークン・プロファイル1.0および1.1

「Oracle WebLogic ServerのWebLogic Webサービスの保護」を参照してください。

Web Services Security Policy (WS-SecurityPolicy) 1.3

Web Services Security Policy (WS-SecurityPolicy)では、WS-Policyフレームワークで使用する一連のセキュリティ・ポリシー・アサーションが定義され、WS-Security、WS-TrustおよびWS-SecureConversationのコンテキストでメッセージを保護する方法が記述されています。

ネームスペース : http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702

http://docs.oasis-open.org/ws-sx/ws-securitypolicy/v1.3/cd/ws-securitypolicy-1.3-spec-cd-03.htmlのWeb Services Security Policy (WS-SecurityPolicy)仕様を参照してください。

WebLogic Webサービスのすべての非同期機能(コールバック、会話、Webサービスの信頼性のあるメッセージング)では、実装でアドレッシングを使用していますが、Webサービス・プログラマは、追加のアドレッシング機能が必要な場合に、この仕様に準拠するAPIを単独で使用することもできます。

「Oracle WebLogic ServerのWebLogic Webサービスの保護」を参照してください。

Web Services Trust Language (WS-Trust)

Web Services Trust Language (WS-Trust)には、セキュリティ・トークンのリクエストと発行や信頼関係の仲介を行うためのフレームワークとなる拡張機能が定義されています。

ネームスペース : http://schemas.xmlsoap.org/ws/2005/02/trust

Web Services Security (WS-Security) 1.1および1.0のWeb Services Trust Language (WS-Trust)仕様を参照してください。

次を参照してください。

バージョン1.4 (JAX-WS): http://docs.oasis-open.org/ws-sx/ws-trust/200802
バージョン1.3 (JAX-RPC): http://docs.oasis-open.org/ws-sx/ws-trust/200512/ws-trust-1.3-os.html

「Oracle WebLogic ServerのWebLogic Webサービスの保護」を参照してください。

WebLogic Webサービスでサポートされるその他の仕様

http://www.w3.org/TR/xmlschema-1に記述されている「XML Schema Part 1: Structures」
http://www.w3.org/TR/xmlschema-2に記述されている「XML Schema Part 2: Data Types」