| Oracle Database Application Expressアドバンスト・チュートリアル リリース3.0 E05693-01 |
|
 戻る |
 次へ |
Webサービスを使用すると、プラットフォームおよび言語に依存しない環境で、Webを介したアプリケーション間の通信が可能になります。典型的なWebサービスの使用例には、ビジネス・アプリケーションでHTTPプロトコルを使用して、指定したURLのサービスにリクエストを送信することがあります。サービスは、リクエストを受信すると、これを処理し、レスポンスを返します。外部Webサービスとのコールは、Oracle Application Expressで開発したアプリケーション内に組み込むことができます。
Oracle Application ExpressのWebサービスは、SOAP（Simple Object Access Protocol）に基づいています。SOAPは、World Wide Web Consortium（W3C）が策定した、インターネットを介したリクエストとレスポンスの送受信用の標準プロトコルです。SOAPメッセージは、サービス・プロバイダとサービス・ユーザー間でSOAPエンベロープに入れて送受信できます。
このチュートリアルでは、Oracle Application Expressアプリケーション内からWebサービスをコールする2つの方法について説明します。
この項の内容は次のとおりです。
|
注意: SOAP 1.1仕様はW3C覚書です。（SOAPより優先される標準を作成するために、W3C XML Protocol Working Groupが結成されています。）Simple Object Access Protocol（SOAP）1.1については、次のWebサイトを参照してください。 http://www.w3.org/TR/SOAP/ |
|
参照: 『Oracle Database Application Expressユーザーズ・ガイド』の「Webサービスの実装」 |
Oracle Application ExpressでWebサービスを使用するには、ウィザードを使用してWebサービス参照を作成します。Web参照を作成する場合、次の方法のいずれかを使用できます。
WSDLドキュメントへのURLを指定します。続いてウィザードによってWSDLを分析し、有効なSOAPメッセージの作成に必要なすべての情報を収集します。
このウィザードでは、Universal Description, Discovery, and Integration（UDDI）レジストリを使用してWSDLを検索できるステップが提供されます。 UDDIレジストリは、企業のWebサービスを登録するディレクトリです。ユーザーは、サービス名または企業名を入力してWSDLを検索します。
SOAPリクエスト・エンベロープなどのWeb参照との通信方法に関連する情報を指定して、手動でWeb参照を作成します。
このチュートリアルでは、両方の方法を説明します。まず、UDDIレジストリを検索して、Webサービス参照を作成します。その後、2つ目のWebサービス参照を手動で作成します。
最初に、新しいアプリケーションを作成します。
アプリケーションを作成するには、次のステップを実行します。
「作業領域」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
「アプリケーション・ビルダー」ホームページで、「作成」をクリックします。
「方法」で、「アプリケーションの作成」を選択して「次へ」をクリックします。
「名前」で、次のステップを実行します。
「名前」に、Web Servicesと入力します。
残りのデフォルトを受け入れて「次へ」をクリックします。
次のステップで空白ページを追加します。
図7-1に示すように、「ページ・タイプの選択」で、デフォルトの「空白」を受け入れます。
「ページ名」に、Web Servicesと入力して「ページの追加」をクリックします。
ページ上部のリストに、新しいページが表示されます。
「次へ」をクリックします。
「タブ」で、デフォルトの「1レベルのタブ」を受け入れて「次へ」をクリックします。
「共有コンポーネント」で、デフォルトの「いいえ」を受け入れて「次へ」をクリックします。
「属性」で、「認証スキーム」、「言語」、「ユーザー言語プリファレンスの派生元」にデフォルトを受け入れて、「次へ」をクリックします。
「ユーザー・インタフェース」で、「テーマ2」を選択して「次へ」をクリックします。
選択内容を確認して、「作成」をクリックします。
「アプリケーション」ホームページが表示されます。
インターネットのアクセスにプロキシ・サーバーが必要な環境の場合は、Webサービス参照を作成する前に「アプリケーション属性」ページでプロキシ・サーバー・アドレスを指定する必要があります。
プロキシ・アドレスを指定するには、次のステップを実行します。
「アプリケーション」ホームページで、「共有コンポーネント」をクリックします。
「アプリケーション」で、「定義」をクリックします。
「名前」で、「プロキシ・サーバー」フィールドにプロキシ・サーバーを入力します。
「変更の適用」をクリックします。
「アプリケーション」ホームページが表示されます。
この演習では、UDDIレジストリでサービス名を検索して、Webサービス参照を作成します。その後で、映画館と場所を表示するためのフォームとレポートを作成します。
|
注意: 次の演習は、指定したUDDIレジストリおよび最終的に起動されるWebサービスの可用性によって異なります。UDDIレジストリまたはWebサービスを使用できない場合、この演習を行う際に問題が発生する可能性があります。 |
サービス名を検索して、新しいWebサービスを作成するには、次のステップを実行します。
「アプリケーション」ホームページで、「共有コンポーネント」をクリックします。
「共有コンポーネント」ページが表示されます。
「ロジック」で、「Webサービス参照」を選択します。
「Webサービス参照」ページが表示されます。
「作成」をクリックします。
WSDLを検出するためにUDDIレジストリを検索するかどうかを尋ねるプロンプトが表示されたら、「はい」を選択して「次へ」をクリックします。
「UDDIの位置」で、「XMethods UDDI v2」を選択して「次へ」をクリックします。
「検索」で、次の各項目を指定します。
「検索タイプ」で、「サービス名」を選択します。
「名前」に、ignyteと入力して「検索」をクリックします。
「一致しているサービス」で、「Ignyte's Retrieve Theaters and Movie Showtimes」を選択します。
「次へ」をクリックします。
選択したWebサービスについて説明するサマリー・ページが表示されます。
選択内容を確認して、「次へ」をクリックします。
「WSDLの位置」フィールドに、WSDLドキュメントへのURLが表示されます。
デフォルトを受け入れて「終了」をクリックします。このサービスは認証を必要としないため、ユーザー名およびパスワードを入力する必要はありません。
「Webサービス参照の作成」ページが表示されます。Webサービス参照（MovieInformation）がWebサービス参照リポジトリに追加されます。
次に、Webサービス参照で使用するフォームとレポートを含むページを作成する必要があります。
Webサービス参照を作成した後に、フォームとレポートを作成するには、次のステップを実行します。
「Webサービス参照の作成」ページで、「Webサービスのフォームとレポートの作成」を選択します。
「サービスと操作の選択」で、次のステップを実行します。
「Webサービス参照」で、「MovieInformation」を選択します。
「操作」で、「GetTheatersAndMovies」を選択します。
「次へ」をクリックします。
「ページおよびリージョン属性」で、次のステップを実行します。
「フォーム・リージョン・タイトル」を、「Theater Information」に変更します。
その他のデフォルトを受け入れて「次へ」をクリックします。
「入力アイテム」で、次のステップを実行します。
P2_ZIPCODEおよびP2_RADIUSで、「作成」列のデフォルトである「はい」を受け入れます。
P2_ZIPCODEで、「アイテム・ラベル」のデフォルトをZIP Codeに変更します。
「次へ」をクリックします。
「Webサービスの結果」で、次のステップを実行します。
「一時結果セット名(コレクション)」で、デフォルトを受け入れます。
「レポート対象の結果ツリー」で、「Theater (tns:Theater)」を選択します。
「次へ」をクリックします。
「結果パラメータ」で、すべてのパラメータを選択して「終了」をクリックします。
「ページの実行」をクリックします。
ログインするように要求されたら、作業領域のユーザー名およびパスワードを入力して「ログイン」をクリックします。
図7-2に示すようなフォームとレポートが表示されます。ページの上部にある「Theater Information」フォームには、データ・エントリ・フィールドおよび「送信」ボタンがありますが、「Results」レポートにはデータがありません。
フォームをテストするには、「ZIP Code」フィールドに43221、「Radius」フィールドに5と入力します。続いて、「送信」をクリックします。
ページの下部にあるレポートは、図7-3のようになります。レポートには、「ZIP code」および「radius」の値が、入力された値と一致する映画館の名前と住所が表示されます。
この演習では、Webサービスに関する情報を指定し、手動のファシリティを使用してWeb参照を作成します。手動によるWeb参照は、WSDLドキュメントを目視で確認し、Webサービス・リクエスト用のSOAPエンベロープを特定するツールを使用して作成します。
この項の内容は次のとおりです。
Web参照を手動で作成するには、MovieInformationというサービス用のWSDLからコードをコピーします。
手動でWeb参照を作成するには、次のステップを実行します。
「アプリケーション」ホームページで、「共有コンポーネント」をクリックします。
「ロジック」で、「Webサービス参照」をクリックします。
「作成」をクリックします。
「UDDIの検索」で、「いいえ」を選択して「次へ」をクリックします。
右側にある「タスク」リストから、「Webサービス参照の手動作成」リンクをクリックします。
「Webサービスの作成/編集」ページが表示されます。
「名前」フィールドに、Movie Infoと入力します。
次のステップを実行して、MovieInformationサービスのエンドポイントを検出します。
次のURLに移動してWSDLを開きます。
http://www.ignyte.com/webservices/ignyte.whatsshowing.webservice/moviefunctions.asmx?wsdl
WSDLで、soap:address要素のlocation属性を検索します。これは、port要素の子要素です。コード内で、soap:address locationという文字列を検索します。
このリリースの時点では、属性の値は次のようになっていました。
http://www.ignyte.com/webservices/ignyte.whatsshowing.webservice/moviefunctions.asmx
「Webサービスの作成/編集」ページの「URL」フィールドで、検出したMovieInformationサービスのエンドポイント（例: http://www.ignyte.com/webservices/ignyte.whatsshowing.webservice/moviefunctions.asmx）を入力します。
GetTheatersAndMovies操作に対するSOAPアクションを検索するには、次のステップを実行します。
必要に応じて、再度、WSDLを開きます。ステップ7aを参照してください。
WSDLで、soap:operation要素のsoapAction属性を検索します。これは、GetTheatersAndMoviesというname属性を持つoperation要素の子要素です。コード内で、soap:operation soapActionという文字列を検索します。
このリリースの時点では、属性の値は次のようになっていました。
http://www.ignyte.com/whatsshowing/GetTheatersAndMovies
「Webサービスの作成/編集」ページの「アクション」フィールドで、検出したSOAPアクション（例: http://www.ignyte.com/whatsshowing/GetTheatersAndMovies）を入力します。
SOAPリクエスト・エンベロープを検出するには、次のステップを実行します。
MindreefなどのWebサービス・ツ―ルに移動します。
http://www.mindreef.net/tide/scopeit/start.do?referer=xmethods&url=http://www.ignyte.com/webservices/ignyte.whatsshowing.webservice/moviefunctions.asmx?wsdl
「Invoke」タブをクリックし、「GetTheatersAndMovies」をクリックします。
Mindreefの「Message Envelope」セクションで、次を実行します。
- 「xs:string tns:zipCode」フィールドに#ZIP#と入力します。
- 「xs:int tns:radius」フィールドに#RADIUS#と入力します。
後で、ページに2つのアイテム「ZIP Code」および「Radius」を作成します。このサービスがコールされると、2つのアイテムに入力された値がリクエストとともに送信されます。
Mindreefの「Invoke」ページにある「Preview/Edit」をクリックします。これにより、入力した値で定義されたパラメータを含むSOAPリクエスト・エンベロープが表示されます。
このリリースの時点では、「Invoke」ページの「HTTP Authentication」リージョンの下に次の内容が表示されました。
<?xml version="1.0" encoding="UTF-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:tns="http://www.ignyte.com/whatsshowing"
xmlns:xs="http://www.w3.org/2001/XMLSchema">
<soap:Body>
<tns:GetTheatersAndMovies>
<tns:zipCode>#ZIP#</tns:zipCode>
<tns:radius>#RADIUS#</tns:radius>
</tns:GetTheatersAndMovies>
</soap:Body>
</soap:Envelope>
「Web参照の作成/編集」の「SOAPエンベロープ」フィールドに、「Invoke」ページの「HTTP Authentication」リージョンの下に表示されたXMLコード（例: ステップ11dに示したコード）を入力します。
「コレクションにレスポンスを格納」フィールドに、MOVIE_RESULTSと入力します。これは、Webサービスからのレスポンスが格納される場所です。
「Webサービスの作成/編集」ページは、図7-4のようになります。
「作成」をクリックします。
「Webサービス参照」ページが表示され、リストには「Movie Info」が表示されます。
Webサービスをテストするには、次のステップを実行します。
「Webサービス参照」ページで、「Movie Info」Web参照の横にある「テスト」アイコンをクリックします。
「Webサービスのテスト」ページが表示されます。
「SOAPエンベロープ」フィールドで、#ZIP#を43221に置き換え、#RADIUS#を5に置き換えます。
「テスト」をクリックします。
「結果」フィールドで、レスポンスについて次の各項目を確認します。
リターン・エンベロープのベース・ノードに次のような名前が付いている。
GetTheatersAndMoviesResponse
メッセージの名前空間が次のようになっている。
http://www.ignyte.com/whatsshowing
結果要素に表示されたレスポンスの該当部分へのXPathが次のようになっている。
/GetTheatersAndMoviesResponse/GetTheatersAndMoviesResult/Theater/Movies/Movie
結果内の該当する要素に、次のような名前が付いている。
Name Rating RunningTime ShowTimes
次に、手動Webサービスをコールするためのページを作成します。
手動Webサービスをコールするためのページを作成するには、次のステップを実行します。
「アプリケーション」ブレッドクラム・リンクをクリックします。
「アプリケーション」ホームページで、「ページの作成」をクリックします。
「ページ」で、「空白ページ」を選択して「次へ」をクリックします。
「ページ番号」のデフォルト値を受け入れて、「次へ」をクリックします。
「名前」にFind Moviesと入力して、「次へ」をクリックします。
「タブ」で、デフォルトの「いいえ」を受け入れて「次へ」をクリックします。
「終了」をクリックします。
「成功」ページで、「ページの編集」をクリックします。
ページ定義で、「リージョン」セクションに移動します。
「作成」アイコンをクリックします。
「リージョン」で、「HTML」を選択して「次へ」をクリックします。
HTMLリージョン・コンテナとして「HTML」を選択して「次へ」をクリックします。
「タイトル」フィールドに、Movie Informationと入力して「次へ」をクリックします。
「リージョンの作成」をクリックします。
次に、このページから検索を開始するための「送信」ボタンをリージョンに追加します。
「送信」ボタンを作成するには、次のステップを実行します。
ページ定義で、「ボタン」セクションにある「作成」アイコンをクリックします。
「ボタン・リージョン」でデフォルトの「Movie Information」を受け入れて、「次へ」をクリックします。
「ボタン位置」で、デフォルトの「リージョン位置にボタンを作成」を受け入れて「次へ」をクリックします。
「ボタン属性」の「ボタン名」に送信と入力して、「次へ」をクリックします。
「ボタン・テンプレート」で、デフォルトの「ボタン」を受け入れて、「次へ」をクリックします。
「表示プロパティ」で、「位置」リストから「リージョン・テンプレートの位置の#CREATE#」を選択して「次へ」をクリックします。
「ページにブランチ」フィールドで、リストから「Movie Information」を選択します。フィールドにページ番号が表示されます。
「ボタンの作成」をクリックします。
次に、ユーザーが検索したい用語を入力できるアイテムを2つ作成します。
「ZIP Code」アイテムを作成するには、次のステップを実行します。
ページ定義で、「アイテム」セクションにある「作成」アイコンをクリックします。
「アイテム・タイプ」で、「テキスト」を選択して「次へ」をクリックします。
「テキスト制御の表示タイプ」で、デフォルトの「テキスト・フィールド」を受け入れて「次へ」をクリックします。
「表示位置および名前」で、次のように指定します。
「アイテム名」に、ZIPCODEと入力します。
「リージョン」で、デフォルトのMovie Informationを受け入れます。
「次へ」をクリックします。
「ラベル」フィールドの既存のテキストをZIP Codeに置き換え、「次へ」をクリックします。
「アイテムの作成」をクリックします。
「Radius」アイテムを作成するには、次のステップを実行します。
ページ定義で、「アイテム」セクションにある「作成」アイコンをクリックします。
「アイテム・タイプ」で、「テキスト」を選択して「次へ」をクリックします。
「テキスト制御の表示タイプ」で、デフォルトの「テキスト・フィールド」を受け入れて「次へ」をクリックします。
「表示位置および名前」で、次のように指定します。
「アイテム名」に、RADIUSと入力します。
「リージョン」で、デフォルトのMovie Informationを受け入れます。
「次へ」をクリックします。
「ラベル」フィールドに、Radiusと入力して「次へ」をクリックします。
「アイテムの作成」をクリックします。
次に、手動で作成したWeb参照をコールするプロセスを作成します。
手動で作成したWeb参照をコールするプロセスを作成するには、次のステップを実行します。
ページ定義で、「プロセス」セクションにある「作成」アイコンをクリックします。
「プロセス・タイプ」で、「Webサービス」を選択して「次へ」をクリックします。
「名前」フィールドに、Call Movie Infoと入力して「次へ」をクリックします。
「Webサービス参照」リストから「Movie Info」を選択して、「次へ」をクリックします。
「成功メッセージ」領域に、Called Movie Infoと入力します。
「失敗メッセージ」領域にError calling Movie Infoと入力して、「次へ」をクリックします。
「対象ボタン」リストから「送信」を選択して、「プロセスの作成」をクリックします。
次に、コールされたWebサービスの結果を表示するレポートを追加します。
Webサービスの結果のレポートを作成するには、次のステップを実行します。
ページ定義で、「リージョン」セクションにある「作成」アイコンをクリックします。
「レポート」を選択して「次へ」をクリックします。
「リージョン」で、「Webサービスの結果を含むコレクションのレポート」を選択して、「次へ」をクリックします。
「タイトル」フィールドに、Search Resultsと入力して「次へ」をクリックします。
「Web参照タイプ」で、「手動で作成済」を選択して、「次へ」をクリックします。
「Web参照情報」で、次の各項目を指定します。
「Webサービス参照」で、リストから「Movie Info」を選択します。
「SOAPスタイル」で、「ドキュメント」を選択します。
「メッセージの書式」で、「リテラル」を選択します。
これらの2つの属性は、サービスのWSDLドキュメントを手動で確認することにより特定できます。
「結果ノード・パス」に、次のように入力します。
/GetTheatersAndMoviesResponse/GetTheatersAndMoviesResult/Theater/Movies/Movie
「メッセージの名前空間」に、次のように入力します。
http://www.ignyte.com/whatsshowing
「結果ノード・パス」および「メッセージの名前空間」は、両方とも、サービスをテストしたときに確認が完了しています。
「次へ」をクリックします。
「パラメータ名」の最初の4箇所に、Name、Rating、RunningTimeおよびShowTimesと入力して、「SQLレポートの作成」をクリックします。
ページをテストするには、次のステップを実行します。
「ページの実行」をクリックします。ログインするように要求されたら、作業領域のユーザー名およびパスワードを入力します。図7-5に示すような、「Movie Information」フォームが表示されます。
「ZIP Code」および「Radius」フィールドに情報を入力して、「送信」をクリックします。
「Search Results」領域に結果が表示されます。
