OEPEチュートリアル - OEPEによるMAFアプリケーションの構築

OEPEによるMAFアプリケーションの構築

パート3： Oracle MAF MobileアプリケーションによるWebサービスの使用

この項では、先ほど完成したアプリケーションを拡張します。まず、Webサービスを検索し、Web Services Description Language（WSDL）へのアクセス権を取得します。次に、MAFデータ・コントロールを作成し、アプリケーションのページからそれを使用します。

準備	アプリケーション
このチュートリアルは順番に完了できるように作られています。このパートはチュートリアルの3番目で最後のステップですが、パート1とパート2で作成するアプリケーションの完成版をダウンロードすることもできます。アプリケーションの完成版から開始する場合は、右側のDownloadボタンを使用して圧縮ファイルをダウンロードし、作業領域にインポートしてください。

準備

アプリケーション

このチュートリアルは順番に完了できるように作られています。このパートはチュートリアルの3番目で最後のステップですが、パート1とパート2で作成するアプリケーションの完成版をダウンロードすることもできます。アプリケーションの完成版から開始する場合は、右側のDownloadボタンを使用して圧縮ファイルをダウンロードし、作業領域にインポートしてください。

ステップ1：Webサービスの検出

このパートでは、アプリケーションに追加するWebサービスを検索します。これから使用するWebサービスは、webservice.netから取得できます。使用するのは、郵便番号を受け取って天気情報を返す天気Webサービスです。このチュートリアルではこのサービスを使用しますが、どのWebサービスにも簡単に置き換えることができます。

OEPEで開かれているエディタをすべて閉じます。
wsdlをOEPEにダウンロードするための準備として、wsdlリソースを保持するフォルダをプロジェクト内に作成します。
Project Explorerで「EmployeeView」を右クリックし、「New」→「Folder」を選択します。フォルダ名としてresourceを入力し、「Finish」をクリックします。
最初に、使用するWebサービスを任意のブラウザで検索します。ここでは、http://wsf.cdyne.com/WeatherWS/Weather.asmxにナビゲートします。「Service Description」リンクをクリックしてWDSLドキュメントを表示します。
先ほど作成したresourceフォルダにこのファイルをWeather.asmx.xmlという名前で保存します。デフォルトでこの名前が指定されているはずです。
Windowsエクスプローラを使用してファイルを検索し、ファイル名をweather.wsdlに変更します。ファイル拡張子が変更されることを示す警告ダイアログで「Yes」をクリックします。注：拡張子は必ずwsdlを使用してください。
OEPEのProject Explorerで、「EmployeeView」→「resource」の順に展開します。weather.wsdlファイルが表示されます。表示されない場合は「resource」を右クリックして「Refresh」を選択します（または[F5]を押します）。
「weather.wsdl」をダブルクリックしてwsdlエディタで開きます。サービスから使用できるインタフェースを表す図が表示されます。

これでWebサービスは用意できたので、アプリケーションの残りの部分のベースになるコンポーネントを作成します。

ステップ2：Webサービス・データ・コントロールの定義

このWebサービスをMAFアプリケーションで使用するには、MAFデータ・コントロールを作成する必要があります。データ・コントロールとは、Webサービスで使用できるサービスまたはメソッドを抽象化したものです。この抽象化レイヤーの存在により、アプリケーション開発者はサービスの実装に関わる詳細事項を気にせずにWebサービスを使用できます。データ・コントロールは、開発要件に関係なく使用できる新たなドラッグ・アンド・ドロップ・コンポーネントになります。

データ・コントロールを作成するには、「weather.wsdl」を右クリックして「Model Components 」→「Create Data Control」の順に選択します。
デフォルト名（Weather）のまま「Next」をクリックします。
Operationsパネルで「WeatherSoap12」を選択し、「Next」をクリックします。
Summaryページで「Finish」をクリックし、データ・コントロールを作成します。影響を受けるファイルを示すダイアログが表示されます。「OK」をクリックしてダイアログを閉じます。
Data Control Managerが開きます。Data Control Managerは次のように表示されます。

これで、Weather Webサービスに基づいたデータ・コントロールが作成されました。次の項では、このデータ・コントロールを使用するWeatherページを作成します。

ステップ3：Webサービス・データ・コントロールの使用

MAFでは、どのデータ・コントロールを使用する手順も同じです。データ・コントロールがJavaクラスとWebサービスのどちらに基づいているかは関係ありません。この項では、weatherデータ・コントロールを使用するアプリケーションに要素を追加します。

開いているエディタをすべて閉じて、MAF Feature Editorを開きます（ヒント：「EmployeeView」→「MAF」の順に展開し、「MAF Feature Editor」をダブルクリックします）。
新しい機能を追加（「追加」ボタンを使用）し、機能のIdをWeatherServiceに設定します。
新しいWeatherService機能を選択し、「Add」ボタンをクリックしてこの機能のコンテンツを作成します。「AMX Page」を選択し、IDはデフォルトにしたまま「OK」をクリックします。
amxページのコンテンツを選択した状態で、作成アイコンをクリックしてamxページを作成します。ページの名前をGetWeather.amxに設定し、「Finish」をクリックしてページを作成します。ページ・エディタにページが開きます。
作業内容を保存します。

次は、このWebサービス・データ・コントロールを使用するページを設計します。

GetWeather.amxページで、headerファセットのValueプロパティをGet Weatherに設定します。
「primary commandButton」を選択し、Actionを__backに設定します（ヒント：Properties InspectorとActionの横にあるドロップダウンを使用します）。
作業内容を保存します。

基本ページがセットアップされます。次は、このWebサービスを使用するデータ・コントロールを追加します。
パレットのDataタブで「Weather」を展開し、GetCityWeatherByZIP(String)を表示します。
「GetCityWeatherByZIP(String)を</amx:facet>終了タグの直後にドラッグし、コンポーネント・タイプとして「Parameter Form」を選択します。Form Configurationのバインディングはそのままにして「Finish」をクリックします。
作業内容を保存します。

コードを見てわかるとおり、郵便番号を受け取る入力テキスト・コンポーネントへのバインディングがあります。また、Webサービスをコールするバインディングを実行するボタンもあります。不足しているのは、戻り値を表示する出力テキストです。
Webサービスの戻り値（結果）を表示するには、Data Paletteで「returnGetCityWeatherByZipResult」を選択し、</amx:panlePage>終了タグの直前にこれをドラッグし、「Form」を選択します。
Form Configurationダイアログで、City、Temperature、RelativeHumidity、Wind以外のValue Bindingsをすべて削除します。「Finish」をクリックしてフォームを作成します。
作業内容を保存します。

UIに関する考慮事項の1つは、Webサービスをコールするボタンをユーザーがクリックするまで出力テキストを表示しないようにすることです。このUI変更はとても簡単ですが、2つのことを行う必要があります。まず、ボタンがクリックされたら、変数になんらかの値が設定されるようにします。次に、変数が設定されている場合のみ値を表示するよう指示するプロパティを、出力テキストに追加します。
Set Property Listenerをコマンド・ボタンに追加します。まず、埋め込まれている終了タグ・マーク（/）をamx:commandButtonの末尾から削除します。
この行の末尾に</を入力します。もっとも近くにある閉じられていないタグは、</amx:commandButton>が追加されて自動的に閉じられます。

</amx:commandButton>の前に新しい行をいくつか挿入します。
パレットの「Tags」タブを選択し、フィルタを使用してset propertyを探します。
先ほどコマンド・ボタン・タグ内に追加した空の行に、「Set Property Listener」をドラッグします。
このダイアログで、Fromの値を#{'Y'}に設定します。
Toの値を設定するために、「Bind to a Dynamic value」アイコンをクリックしてExpression Builderを開きます。
Expressionに#{viewScope.displayResult}と入力します。
「OK」をクリックし、「Finish」をクリックしてSet Property Listenerを作成します。

このSet Property Listenerを作成しておくと、ユーザーが「GetCiyWeatherByZIP」ボタンをクリックしたときにWebサービスがコールされるだけでなく、viewScope変数のdisplayResultがYに設定されるようになります。以降の手順では、変数が設定されていない場合は出力テキストが表示されないように設定します。
作業内容を保存します。
「<amx:panelFormLayout」タグをクリックし、Propertiesタブで「Common」を選択します。
「Bind to Dynamic Value」アイコン（稲妻マーク）をクリックしてExpression Builderを開きます。
Expression Builderで、式#{viewScope.displayResult == 'Y'}を入力し、「OK」をクリックします。
作業内容を保存します。

アプリケーションはもう少しでデプロイできる状態になります。デプロイできるようにするには、カメラ機能や電子メール機能で行ったのと同様に、デバイス機能へのアクセス権を付与する必要があります。
「maf-feature.xml」タブをクリックします。タブが開いていない場合は、Project Explorerを使用してMAF Features Editorを検索して開きます。
「WeatherService」を展開して「Device Access」を選択します。
Device Accessリストで「Network Access」を選択します。すると、要求したアクセス権をアプリケーションに付与する必要があることを示す警告アイコンが表示されます。
作業内容を保存します。
「application editor」リンクをクリックしてMobile Application Editorを開きます。
Mobile Application Editorで「Network access」を選択し、機能へのアクセス権を付与します。
作業内容を保存します。

これで、アプリケーションをデプロイできる状態になりました。

ファイアウォールの内側からエミュレータを実行している場合は、プロキシを構成する特殊なパラメータを使用して、コマンドラインからエミュレータを起動することが必要になります。
ファイアウォールの内側からでない場合はこれまでと同様にエミュレータを使用できるため、手順38に進みます。
コマンド・ウィンドウを開き、<your Android SDK Install>\sdk\toolsディレクトリにナビゲートします。
emulator -avd MAF -verbose -http-proxy MyProxyHere:80と入力してエミュレータを起動します（ヒント：MyProxyHereの部分は、各自のプロキシの名前に置き換えてください。以前に作成したAVDデバイスの名前がMAFの場合はそれを使用しますが、そうでない場合はここで使用した名前に置き換えます）。

これで、アプリケーションはデプロイできる状態になりました。
メニュー・バーで、「Debug」→「Debug Configuration」の順にクリックします。
「MAF Application」→「MAF」の順に選択し、「Debug」をクリックします。
正常にデプロイされたことを示すメッセージがログ・ウィンドウに表示されたら、デプロイメントは完了です。