この項では、先ほど完成したアプリケーションを利用し、コンポーネントを追加して拡張します。 アプリケーションにいくつかのビュー・コンポーネントを追加します。 次に、Webサービスに基づいたADFデータ・コントロールを定義します。 最後の項では、Webサービスを使用して従業員の給与情報を更新するページを作成します。

準備	アプリケーション
この項では、Webサービスを使用するデータ・コントロールを作成します。 Webサービスは、マシン上でローカルで実行されます。 このチュートリアルを完了するため、Webサービスを含むOracle JDeveloper Workspaceをダウンロードしなければなりません。 このチュートリアルの後半で、Webサービスの実行方法について学習します。 右のDownloadボタンを使用して圧縮ファイルをダウンロードし、そのファイルをmyWorkディレクトリに解凍します。

このパートでは、既存のアプリケーションにビュー・コンポーネントとナビゲーション・ルールを追加します。 これらのコンポーネントのためのページは、次の項で作成します。

1. エディタで「EmpsTaskFlow.xml」を開きます。

   

2. コンポーネント・パレットからタスク・フローにView Activityを追加し、それにsalaryUpgradeという名前を付けます。

   

3. EmpListとSalaryUpgradeの間にControl Flow Caseを描画します。 このフローにgoWSという名前を付けます。

   

これで、アプリケーションの残りの部分の基礎となるコンポーネントが作成されました。

この項では、アプリケーションで使用するWebサービスを開いて実行します。 次に、Webサービスに基づいたデータ・コントロールを作成し、そのデータ・コントロールをアプリケーションから使用します。

1. このチュートリアルの「準備」の手順では、SampleWS.zipをダウンロードし、それを任意のmyWorkディレクトリに解凍しました。 まだしていない場合は、このチュートリアルの先頭に移動し、ファイルを今すぐダウンロードおよび解凍してください。

2. JDeveloperで、「File」→「Open」をクリックして、SampleWS.jwsを解凍するときに使用したディレクトリに移動します。 「SampleWS.jws」を選択し、「Open」をクリックします。

   

3. アプリケーション・ナビゲータで、「Project 1」→「Application Sources」→「a」を展開してService.javaを表示します。 「Service.java」を右クリックして、「Run」を選択します。

   

4. WebLogic Server（WLS）を初めて起動した場合は、パスワードを入力するよう求められます。 パスワードを入力し、そのパスワードを確認して、「OK」をクリックします。 Oracle WLSを初めて実行している場合は、デフォルト・ドメインが構築されるため、始まるまでに数分かかることがあります。

   

5. Webサービスがデプロイされ、実行中になると、Runningメッセージ・タブ・ペインに完了メッセージが表示されます。 重要な注意点： Webサービスが何らかの理由で停止した場合は、Webサービスを再起動する必要があります。そうしないと、デプロイされたモバイル・アプリケーションが正しく機能しません。 特に、従業員の給与を更新しようとすると、エラーが表示されます。

   

6. Target URLのリンクをクリックして、HTTP Analyzerを開きます。 このHTTP Analyzerを使用して、Webサービスをテストできます。 次に各パラメータに値を入力することができ、「Send Request」をクリックします。 Webサービスがリクエストを処理し、すべてHTTP Analyzer内から結果を返します。

   

7. HTTP Analyzerペインの上部にある「WSDL URL」を右クリックして、「Copy」を選択します。 このWSDLアドレスは、データ・コントロールを作成するときに使用します。

   

これでWebサービスが実行中になったので、Employeesワークスペースに戻ってWebサービスを使用します。

8. アプリケーション・ナビゲータのドロップダウン・リストを使用して、Employeesワークスペースに戻ります。

   

9. 「ViewController」プロジェクトを右クリックして、「New」→「From Gallery」を選択します。

   

10. New Galleryで、「Business Tier」→「Data Controls」→「Web Service Data Control (SOAP/REST)」を選択し、「OK」をクリックします。

    

11. デバイスまたはエミュレータにデプロイしている場合は、Webサービスが実行されているマシンのIPアドレスを指定する必要があります。

    1. WindowsマシンでIPアドレスを見つけるには、コマンド・ウィンドウを起動します（「スタート」→「ファイル名を指定して実行」を選択し、CMDと入力して「OK」をクリックします）。

       

    2. コマンド・ウィンドウで、ipconfigと入力し、[Enter]キーを押します。
       
       Macを使用している場合、次にターミナル・ウィンドウでifconfig | grep "inet " | grep -v 127.0.0.1と入力し、[Enter]キーを押します。

       

    3. マシンのIPアドレスをコピーします。 このIPアドレスをWebサービス・データ・コントロールのURLに使用します。 下の図では、セキュリティのためにIPアドレスが黒く塗りつぶされています。

       

12. Create Web Service Data Controlウィザードで、Webサービス・データ・コントロールにSalaryServiceという名前を付け、WSDLのURLをURLフィールドに貼り付けます。 「Next」をクリックします。
    
    ここでも、セキュリティのために、下の図のIPアドレスは見えなくなっています。

    

13. 「SalaryUpgrade」メソッドを選択し、それをSelectedリストに移動して、「Finish」をクリックします。

    

14. 作業内容を保存します。

15. 「Data Controls」パレットを開き、「Refresh」をクリックして、新しいWebサービス・データ・コントロールであるSalaryServiceを表示します。

    

これで、SalaryService Webサービスに基づいたデータ・コントロールが作成されました。 次の手順では、前に追加したビュー・アクティビティのためのSalaryUpgradeページを作成します。 また、EmpsListページへのナビゲーションも追加します。

MAFでは、すべてのデータ・コントロールを使用する手順は同じです。 データ・コントロールがJavaクラス、ADF Business Component、Webサービスのいずれに基づいていても、問題ありません。 この項では、Salary Serviceデータ・コントロールを使用するアプリケーションに要素を追加します。

1. エディタで「EmpsList.amx」を開きます。

   

2. ソース・コード・エディタで、Id cb2を含むボタン（ページの右端のボタン）を選択します。 プロパティ・インスペクタで、TextをUpdateに、ActionをgoWSに設定します。

   

3. 作業内容を保存します。

次に、Webサービスを利用するために使用する2ページ目のSalaryUpgradeを設計します。

4. エディタで「EmpsTaskFlow.xml」を開きます。

   

5. 「salaryUpgrade」をダブルクリックして、ページを作成します。 「OK」をクリックして、新しいページをデフォルト値のままにします。

   

このページには2つの部分があります。 最初の部分は、現在選択されている行の従業員データを表示します。 2番目の部分は、Webサービスを起動するために使用されます。

6. 従業員データを表示するには、「emps」コレクションをPanel Pageにドラッグし、MAF Formとしてドロップします。

   

7. NameとSalaryを除くすべての属性を削除し、「OK」をクリックして、フォームをページに追加します。

   

8. エディタの一番下にある「Bindings」タブをクリックして、NameとSalaryのバインディングがページに追加されていることを確認します。
   empsコレクションからそれがきているかを確認するためにsalaryバインディングをクリックします。

   

このデータ・コントロールおよびバインディングには従業員データが表示され、それがempListページ上で同じデータ・コントロール・コレクションであるため、現在の行はupdateSalaryページ上に渡され、表示されます。

次のいくつかのステップで、Webサービスをコールするコンポーネントを追加します。

9. 作業内容を保存します。

10. SalaryUpgrade.amxページの「Source」タブをクリックします。

11. SalaryServiceデータ・コントロールから、「SalaryUpgrade」メソッドをPanel Pageにドラッグし、MAF Buttonとしてドロップします。

    

Salary Upgrade Webサービスは、Name、Date、Salary、Commissionの各パラメータを受け入れます。 NameとSalaryは、今追加したフォーム上のフィールドです。 そのため、このWebサービスをコールする場合は、そのフォーム上のフィールドからNameとSalaryを渡します。

12. nameパラメータのValueプロパティの隣にある下矢印をクリックし、「Show El Expression Builder」をクリックします。

    

13. Expression Builderを使用して「bindings.name.inputValue」を選択し、「OK」をクリックします。 （この式は、フォーム上のnameフィールドの現在の値を取得します。）

    

14. 同じ手順をsalフィールドに対して繰り返します。 （ヒント：Expression Builderで、「bindings.salary.inputValue」を選択し、「OK」をクリックします。）

    

次の2つのパラメータの場合は、各値に、後でデータを移入するviewScope変数を入力します。

15. 「date」パラメータを選択し、Valueに#{viewScope.start}と入力します。

    

16. 「comm」パラメータを選択し、Valueに#{viewScope.commission}と入力します。

    

17. 「OK」をクリックして、ボタンを作成します。

    

18. 作業内容を保存します。

19. 「Bindings」タブをクリックして、今追加したバインディングを調べます。

    

20. Structureペインの「SalaryUpgrade」を展開して、パラメータを表示します。

    

21. 各パラメータをクリックし、プロパティ・インスペクタに各パラメータのND値が表示されることを確認します。

    

これまで見てきたように、SalaryUpgrade Webサービスは4つのパラメータを受け入れます。 最初の2つの値は、empsデータ・コントロールからすでに作成したフォームから取得されます。 そのため、残りの2つの値をどこからか取得する必要があります。 2つのフォーム・フィールドを使用するためのSalaryUpgradeメソッド・コールに対するバインディングは、すでに設定されています。 ここで、2つの追加のパラメータ値（dateおよびcommission）を受け入れるためのフィールドを作成し、それらの値を作成済みのviewScopeパラメータに保存する必要があります。

22. SalaryUpgradeページの「Source」タブをクリックし、コンポーネント・ウィンドウから「Switch (Boolean)」コンポーネントをStructureウィンドウ内のPanel Form Layoutコンポーネントにドラッグします。（ヒント：Switchコンポーネントは、コンポーネント・パレット内のText and Selectionの下にあります。）

    
    

23. プロパティ・インスペクタで、labelをCommissioned?に、Valueを#{viewScope.commission}に設定します。
    
    

24. 「Input Date」コンポーネントをPanel Form Layoutにドラッグします。

    
    

25. プロパティ・インスペクタで、labelをStartingに、Valueを#{viewScope.start}に設定します。
    
    

これにより、Webサービスに渡されるパラメータ値が作成されましたが、Webサービスからの結果も表示させるようにします。

26. 「SalaryService」データ・コントロールを展開して、Webサービスからの結果を表すStringを表示します。

    

27. 「String」をPanel Pageにドラッグし、MAF Output Textとしてドロップします。

    

この時点で、ページは完成し、動作可能になります。 ただし、出力フィールドはWebサービスのコールに基づいているため、ページがWebサービスをコールした後で、ユーザーは開始日や歩合値を入力できるようになります。 次の手順では、SalaryUpgradeボタンがクリックされた後にのみWebサービスをコールするようにページを設定します。

28. 最初に、Webサービスからの結果を保持するOutput Textフィールドのレンダリングを制御します。 それには、Renderedプロパティに条件を追加します。 Expression Builderを使用して、Renderedプロパティを設定し、新しい変数#{viewScope.displayResults == 'Y'}を評価します。 「OK」をクリックします。

    
    
    
    
    

29. 次に、viewScope.displayResults変数の値をYに設定するsetPropertyListenerコンポーネントを追加します。 これを行うには、「Set Property Listener」コンポーネントをSalaryUpgradeボタンにドラッグし、次のプロパティを設定します。
        From：#{'Y'}
        To：#{viewScope.displayResults}
        Type：action

    
    

30. 最後に、コール元のページに戻るための方法を提供する必要があります。 最初のボタン（cb1）を選択し、プロパティ・インスペクタで、TextをBackに、Actionを__backに設定します。
    
    

31. 作業内容を保存します。

前のいくつかの手順の結果として、ユーザーがcommissionおよびdateフィールドに値を入力し、SalaryUpgradeボタンをクリックすると、ページはWebサービスをコールして結果を表示します。

次に、アプリケーションをデプロイおよびテストします。

32. JDeveloperのApplicationメニューから「Deploy Android2 to Android emulator」を選択します。

    

33. LogウィンドウのDeploymentタブで、デプロイメントが完了していることを確認します。

    

34. アプリケーションが動作するには、SalaryUpgrade Webサービスが実行されている必要があることを覚えておいてください。 Webサービスを実行するための手順は、このチュートリアルのステップ2にあります。

35. エミュレータまたはデバイスで、Applicationsページに移動し、「Employees」アプリケーションを開きます。

    

エミュレータに、アプリケーションのエントリ・ページであるEmp Listページが表示されます。



36. ページの左側にある右矢印をクリックして、従業員のリストを表示します。

    

37. 「Shay」（またはリスト内の任意の従業員）をクリックして、従業員を選択し、employeeリストを隠します。

    

38. 「Update」ボタンをクリックします。 アプリケーションに、SalaryUpgradeページが表示されます。

    

39. Android Emulator UIを使用して、salaryを5555に変更し、CommissionをOnに設定して、Start Dateを今日から数日後に変更します。

    

40. 「SalaryUpgrade」をクリックします。 SalaryUpgradeボタンの下に表示されるメッセージに注意してください。 このメッセージは、SalaryUpgrade Webサービスから返されたものです。 アプリケーションは正常にWebサービスをコールし、返された値を表示しました。

    

これで、Webサービスを使用するアプリケーションにMAFコントロールが正常に追加されました。

すべて表示 | すべて非表示