プライマリ・コンテンツに移動
Oracle® Fusion Middleware Oracle WebLogic Server 12.1.3 JAX-RPC Webサービスの開発
12
c
(12.1.3)
E57562-03
ライブラリ
製品
次
目次
タイトルおよび著作権情報
はじめに
ドキュメントのアクセシビリティについて
表記規則
このガイドでの新しい情報
12
c
(12.1.3)の新機能と変更された機能
12
c
(12.1.2)の新機能と変更された機能
第I部 概要
1
JAX-RPC Webサービスの概要
2
JAX-RPC Webサービス開発者向けサンプル
簡単なHelloWorld Webサービスの作成
サンプルHelloWorldImpl.java JWSファイル
HelloWorldImpl.javaのサンプルAntビルド・ファイル
ユーザー定義のデータ型を使用するWebサービスの作成
サンプルBasicStruct JavaBean
サンプルComplexImpl.java JWSファイル
ComplexImpl.java JWSファイルのサンプルAntビルド・ファイル
WSDLファイルからのWebサービスの作成
サンプルWSDLファイル
サンプルTemperaturePortType Java実装ファイル
TemperatureServiceのサンプルAntビルド・ファイル
Java SEクライアントからのWebサービスの呼出し
サンプルJavaクライアント・アプリケーション
Javaクライアント・アプリケーションをビルドするためのサンプルAntビルド・ファイル
WebLogic WebサービスからのWebサービスの呼出し
サンプルClientServiceImpl.java JWSファイル
ClientServiceをビルドするためのサンプルAntビルド・ファイル
第II部 基本的なJAX-RPC Webサービスの開発
3
JAX-RPC Webサービスの開発
WebLogic Webサービス・プログラミング・モデルの概要
Webサービス機能用のドメイン構成
Javaから開始するWebLogic Webサービスの開発: 主な手順
WSDLファイルから開始するWebLogic Webサービスの開発: 主な手順
基本的なAnt build.xmlファイルの作成
jwsc WebLogic WebサービスAntタスクの実行
Webサービスの呼出しに使用されるトランスポートの指定
WebLogic Webサービスのコンテキスト・パスの定義
jwscの使用例
wsdlc WebLogic WebサービスAntタスクの実行
wsdlcで生成される途中まで作成済みのJWS実装クラス・ファイルの更新
WebLogic Webサービスのデプロイとアンデプロイ
wldeploy Antタスクを使用したWebサービスのデプロイ
管理コンソールを使用したWebサービスのデプロイ
WebサービスのWSDLの参照
動的なWSDLで指定されたサーバー・アドレスの構成
Webサービスがコールバック・サービスでなく、HTTP/Sを使用して呼び出せる場合
Webサービスがコールバック・サービスでなく、JMSトランスポートを使用して呼び出せる場合
Webサービスがコールバック・サービスである場合
Webサービスがプロキシ・サーバーを使用して呼び出せる場合
Webサービスのテスト
WebサービスのWebLogic分割開発ディレクトリ環境への統合
4
JWSファイルのプログラミング
JWSファイルとJWSアノテーションの概要
JWSファイルのJava要件
JWSファイルのプログラミング: 一般的な手順
JWSファイルの例
JWSファイルがWebサービスを実装することの指定(@WebServiceアノテーション)
WebサービスとSOAPメッセージ・プロトコルのマッピングの指定(@SOAPBindingアノテーション)
Webサービスのコンテキスト・パスとサービスURIの指定(@WLHttpTransportアノテーション)
JWSメソッドをパブリック操作として公開することの指定(@WebMethodおよび@OneWayアノテーション)
操作のパラメータとWSDL要素のマッピングのカスタマイズ(@WebParamアノテーション)
操作の戻り値とWSDL要素のマッピングのカスタマイズ(@WebResultアノテーション)
Webサービスの実行時情報へのアクセス
JwsContextを使用した実行時情報へのアクセス
Webサービス・コンテキストへのアクセスに関するガイドライン
JwsContextのメソッド
Stubインタフェースを使用した実行時情報へのアクセス
ステートレス・セッションEJBを実装すべき場合
JWSファイルでEJBを実装する場合のプログラミングのガイドライン
EJBを実装するJWSファイルの例
ユーザー定義のJavaデータ型のプログラミング
例外のスロー
JWSファイルからの別のWebサービスの呼出し
JWSアノテーションおよびAPIによるその他の機能のプログラミング
MTOM/XOPを使用したバイナリ・データの送信
SOAP添付ファイルのストリーミング
SOAP 1.2の使用
トランザクション内で実行する操作の指定
HttpServletRequest/Responseオブジェクトの取得
JWSプログラミングのベスト・プラクティス
5
データ・バインディングの理解
データ・バインディングの概要
サポートされる組込みデータ型
組込みデータ型のXML-to-Javaマッピング
組込みデータ型のJava-to-XMLマッピング
サポートされるユーザー定義のデータ型
サポートされるユーザー定義のXMLデータ型
サポートされるユーザー定義のJavaデータ型
6
JAX-RPC Webサービス・クライアントの開発
JAX-RPC Webサービス・クライアントの概要
JAX-RPCを使用したWebサービスの呼出し
Webサービスを呼び出すクライアントの例
Java SEクライアントからのWebサービスの呼出し
クライアントのアーティファクトを生成するためのclientgen Antタスクの使用
Webサービスに関する情報の取得
Webサービスを呼び出すJavaクライアント・アプリケーション・コードの記述
クライアント・アプリケーションのコンパイルと実行
JavaクライアントのサンプルAntビルド・ファイル
別のWebサービスからのWebサービスの呼出し
Webサービス・クライアントのサンプルbuild.xmlファイル
Webサービスを呼び出すサンプルJWSファイル
Webサービス呼出し時のスタンドアロン・クライアントJARファイルの使用
Webサービス呼出し時のプロキシ・サーバーの使用
HttpTransportInfo APIを使用したプロキシ・サーバーの指定
システム・プロパティを使用したプロキシ・サーバーの指定
Webサービスを再デプロイする際にクライアント側で考慮すべき事項
WebLogic Webサービスのスタブ・プロパティ
レスポンスSOAPメッセージの文字エンコーディングの設定
第III部 JAX-RPC Webサービスの高度な機能の開発
7
非同期リクエスト-レスポンスを使用したWebサービスの呼出し
非同期リクエスト-レスポンス機能の概要
非同期リクエスト-レスポンスの使用: 主な手順
非同期WebサービスのホストWebLogic Serverインスタンスの構成
非同期のJWSファイルの記述
Webサービスの非同期な呼出しのコーディングに関するガイドライン
非同期の呼出し前および呼出し後におけるコンテキストの使用
同期呼出しのサンプル
非同期リクエスト-レスポンスを使用する場合のbuild.xmlファイルの更新
内部非同期サービスの無効化
非同期のリクエスト・レスポンスとプロキシ・サーバーの使用
8
Webサービスの信頼性のあるメッセージングの使用
Webサービスの信頼性のあるメッセージングの概要
WS-Policyを使用した信頼性のあるメッセージング・ポリシーのアサーションの指定
信頼性のあるメッセージ・シーケンスのライフサイクルの管理
Webサービスの信頼性のあるメッセージングの使用: 主な手順
前提条件
宛先WebLogic Serverインスタンスの構成
ソースWebLogic Serverインスタンスの構成
Webサービスの信頼性のあるメッセージングのWS-Policyファイルの作成
WS-ReliableMessagingポリシー・アサーション・バージョン1.1を使用したカスタムWS-Policyファイルの作成
WS-ReliableMessagingポリシー・アサーション・バージョン1.0を使用したカスタムWS-Policyファイルの作成(非推奨)
複数のポリシー選択肢の使用
信頼性のあるJWSファイルに関するプログラミングのガイドライン
@Policyアノテーションの使用
@Onewayアノテーションの使用
@BufferQueueアノテーションの使用
@ReliabilityBufferアノテーションの使用
信頼性のあるWebサービスの信頼性のあるメッセージングの構成
管理コンソールの使用
WLSTの使用
信頼性のあるWebサービスを呼び出すJWSファイルに関するプログラミングのガイドライン
信頼性のあるWebサービスのクライアント用build.xmlファイルの更新
信頼性のあるメッセージングとMTOMの使用
信頼性のあるWebサービスを再デプロイする際にクライアント側で考慮すべき事項
信頼性のあるメッセージングとプロキシ・サーバーの使用
9
会話型Webサービスの作成
会話型Webサービスの概要
会話型Webサービスの作成: 主な手順
会話型JWSファイルに関するプログラミングのガイドライン
会話型Webサービスを呼び出すJWSファイルに関するプログラミングのガイドライン
ConversationUtilsユーティリティ・クラス
会話型Webサービスのクライアント用build.xmlファイルの更新
会話型Webサービスを呼び出すためのスタンドアロンJavaクライアントの更新
会話型Webサービスの.NETクライアントの例
ConversationService.javaファイル
Service.csファイル
build.xmlファイル
会話型Webサービスを再デプロイする際にクライアント側で考慮すべき事項
10
バッファ付きWebサービスの作成
バッファ付きWebサービスの概要
バッファ付きWebサービスの作成: 主な手順
バッファ付きWebサービスのホストWebLogic Serverインスタンスの構成
バッファ付きJWSファイルに関するプログラミングのガイドライン
バッファ付きWebサービスを呼び出すJWSファイルのプログラミング
バッファ付きWebサービスのクライアント用build.xmlファイルの更新
11
非同期機能の併用
非同期機能の併用
信頼性のある会話型Webサービスを実装するJWSファイルの例
信頼性のある会話型Webサービスを非同期で呼び出すクライアントWebサービスの例
12
コールバックによるクライアントへのイベントの通知
コールバックの概要
コールバックの実装の概要と用語
コールバックのプログラミング: 主な手順
ターゲットWebサービスのプログラミングのガイドライン
コールバック・クライアントWebサービスのプログラミングのガイドライン
コールバック・インタフェースのプログラミングのガイドライン
クライアントWebサービスのbuild.xmlファイルの更新
13
接続プロトコルとしてのJMSトランスポートの使用
JMSトランスポートの使用の概要
Javaから開始するJMSトランスポートの使用: 主な手順
WSDLから開始するJMSトランスポートの使用: 主な手順
JMSトランスポートWebサービスのホストWebLogic Serverインスタンスの構成
@WLJmsTransport JWSアノテーションの使用
jwsc Antタスクの<WLJmsTransport>子要素の使用
JMSトランスポートを使用するためのWSDLの更新
JMSトランスポートを使用したWebLogic Webサービスの呼出し
デフォルトのサービス・アドレスURLのオーバーライド
デフォルトのTextMessageのかわりとしてのJMS BytesMessageの使用
WSDLファイルへのHTTPアクセスの無効化
14
SOAPメッセージ・ハンドラの作成と使用
SOAPメッセージ・ハンドラの概要
SOAPメッセージ・ハンドラのWebサービスへの追加: 主な手順
SOAPメッセージ・ハンドラおよびハンドラ・チェーンの設計
GenericHandlerクラスの作成
Handler.init()メソッドの実装
Handler.destroy()メソッドの実装
Handler.getHeaders()メソッドの実装
Handler.handleRequest()メソッドの実装
Handler.handleResponse()メソッドの実装
Handler.handleFault()メソッドの実装
SAAJを使用したSOAPリクエスト・メッセージおよびレスポンス・メッセージの直接操作
SOAPPartオブジェクト
AttachmentPartオブジェクト
SOAPメッセージ・ハンドラで画像添付ファイルの操作
JWSファイルでのハンドラの構成
@javax.jws.HandlerChain
@javax.jws.soap.SOAPMessageHandlers
ハンドラ・チェーン構成ファイルの作成
Webサービスのコンパイルと再ビルド
クライアント側SOAPメッセージ・ハンドラの作成と使用
クライアント側SOAPメッセージ・ハンドラの使用: 主な手順
クライアント側ハンドラ・クラスの例
クライアント側SOAPハンドラの構成ファイルの作成
クライアント側ハンドラの構成ファイル用XMLスキーマ
クライアント側SOAPハンドラの構成ファイルのclientgenへの指定
15
Database Webサービスの使用
Database Webサービスの概要
Databaseコールイン
Databaseコールアウト
SQLとXMLの間のタイプ・マッピング
Webサービスのコールインに対するSQLからXMLタイプへのマッピング
Webサービス・コールアウトに対するXMLからSQLタイプへのマッピング
A
信頼性のあるメッセージング用にパッケージ化されているWS-Policyファイル
DefaultReliability1.1.xml (WS-Policyファイル)
Reliability1.1_SequenceTransportSecurity.xml (WS-Policyファイル)
Reliability1.1_SequenceSTR.xml (WS-Policyファイル)
Reliability1.0_1.1.xml (WS-Policy.xmlファイル)
DefaultReliability.xml (WS-Policyファイル) [非推奨]
LongRunningReliability.xml (WS-Policyファイル) [非推奨]
