Oracle JDeveloper 11g Release 2チュートリアル - URLサービス・データ・コントロールの使用

URLサービス・データ・コントロールの使用

ウィザードを使用して、アプリケーションとプロジェクト、初期XSDドキュメントを素早く作成します。作成するURLサービス・データ・コントロールは、ライブRSSフィード用です。データ・コントロールを作成する前に、初期XSDドキュメントにサンプル・コードを追加して、URLサービスのXMLスキーマを定義します。

詳細表示

目的	所要時間	アプリケーション
このチュートリアルでは、RSSフィードの構造を定義するXMLスキーマから、URLデータ・コントロールを作成する方法を示します。これから作成するアプリケーションの完成版を確認するには、「Download」ボタンをクリックして最終的なアプリケーションのzipファイルをダウンロードし、JDeveloperの`mywork`フォルダに解凍してください。	40分

注：完全なアプリケーションをダウンロードする場合は、

ステップ1：新規アプリケーションとプロジェクトの作成

メイン・メニューから「File」→「New」を選択します。New Galleryで、「General」カテゴリを開き、「Applications」を選択します。Itemsリストで「Custom Application」を選択し、「OK」をクリックします。

JDeveloperアプリケーションは、組織構造の最上位レベルです。アプリケーションの開発中に、操作しているオブジェクトの情報がここに格納されます。

この例に合わせるため、アプリケーション名としてURLDataControlAppと入力し、「Next」をクリックします。

初期プロジェクト構造（アプリケーションの作業領域内の名前付きプロジェクト・フォルダ）および追加されるアプリケーション・ライブラリは、選択したアプリケーション・テンプレートによって決まります。

プロジェクト名にModelと入力します。
「Finish」をクリックします。

アプリケーション・ナビゲータのProjectsパネルは、次のようになります。

テンプレートから作成された新規アプリケーションは、プロジェクト階層に分割されてアプリケーション・ナビゲータに表示されます。各プロジェクトには関連する機能が設定されています。

詳細表示アプリケーション・ナビゲータでは、プロジェクトは階層内の最上位レベルとして表示されます。アプリケーションで使用したCustom Applicationテンプレートによって、1つのプロジェクトが作成されています。このプロジェクトには、デフォルトのプロジェクト名または事前に入力されたプロジェクト名が指定されています。

アプリケーション・ナビゲータのパネルはいずれも開閉できます。2つのパネルの間のスプリッタをドラッグすれば、パネルのサイズを調整できます。Projectsパネルで項目のグループ化やソートを行う場合は、

Navigator Display Optionsドロップダウン・メニューを使用します。アプリケーションを操作するには、「

」Applicationメニューをクリックしてドロップダウン・メニューからオプションを選択します。

JDeveloperには多種多様なファイル・タイプを識別する機能が備わっており、アプリケーション・ナビゲータでファイルをダブルクリックすると、適切なビューアまたはエディタでファイルが表示されます。アプリケーションまたはプロジェクトを終了すると、そのアプリケーションまたはプロジェクトのファイルを表示していたすべてのエディタまたはビューアが閉じられ、メモリからファイルがアンロードされます。

注：アプリケーション・ナビゲータのイタリック体のノードは、これらの要素が保存されていないことを示しています。プロジェクトに含まれるファイルが選択されている場合、プロジェクト・ノードは太字で表示されます。

メイン・メニューから「Application」→「Show Overview」を選択します。エディタ・ウィンドウ領域にApplication Overviewウィンドウが開きます。

Application Overviewウィンドウの一部

Application Overviewウィンドウの一部

このウィンドウの各ファイル概要ページには、JDeveloper内で作成されるすべてのオブジェクトがオブジェクト・タイプごとに分類されて表示されます。新規作成したファイルとアーチファクトは、ステータスやプロジェクトでフィルタして表示できます。

このアプリケーションのオブジェクトを作成する際には使用しないので、任意でApplication Overviewウィンドウを閉じることができます。

ステップ2： XMLスキーマの作成

URLサービス・データ・コントロールを作成する前に、使用するURLサービスを決定し、URLサービスのXMLスキーマを定義する必要があります。ステップに正確に従うことができるように、チュートリアル全体を通じて、手順で示した値を入力してください。例で使用するURLサービスについて詳しくは、次の情報をお読みください。

この例では、ライブRSSフィードのコンテンツを取得し、データバインドOracle ADF Facesコンポーネントを使用してWebページに表示します。

詳細表示使用するライブRSSフィードは、Oracle Technology Network（OTN）のWebサイトのJDeveloperページから入手可能なOracle JDeveloper RSSフィードです。

OTNのJDeveloperのWebサイト・ページ

OTNのJDeveloperのWebサイト・ページ

使用しているWebブラウザでOTNのJDeveloperページに移動します。

http://www.oracle.com/technetwork/developer-tools/jdev/overview/index.html

移動後、次の手順を実行します。

JDeveloper Newsの横にある「XML」をクリックして、RSSフィード・ページを開きます。
URLをメモします（例：http://www.oracle.com/ocom/groups/public/@otn/documents/webcontent/132361.xml）。

RSS（Really Simple Syndication）ファイルはXML構文で作成されています。 XMLコンテンツをJDeveloperで解析するには、RSSフィードのXMLスキーマが必要です。

メイン・メニューから「Tools」→「Preferences」を選択します。 Preferencesダイアログ左側の「Web Browser and Proxy」をクリックし、右側の「Use HTTP Proxy Server」を選択して、サーバー・プロキシを使用してインターネットにアクセスするようにします。組織のプロキシ・サーバーのURLまたはDNS名、マシンがプロキシ・サーバーにアクセスするために使用するポート番号を入力します。

外部Webサービスにアクセスするときに、マシンがファイアウォールの内側にある場合は、JDeveloperのプロキシ設定を変更する必要があります。

XMLスキーマを作成する前に、JDeveloperでHTTP Analyzerを開いて、URLのXMLコンテンツを表示します。次に、返されたコンテンツのXML要素を使用して、XMLスキーマの構造を定義します。必要に応じて、このステップの10番目にスキップしてもかまいません。
メイン・メニューから「Tools」→「HTTP Analyzer」を選択します。

HTTP Analyzerを使用すると、HTTPリクエスト/レスポンスのパッケージ・ペアのコンテンツを確認できます。

HTTP Analyzerのツール・ウィンドウで、「」Start HTTP Analyzerをクリックします。
「」Create New Requestをクリックして、テスト・ウィンドウを開きます。 HTTP Analyzerのテスト・ウィンドウ下部にある「HTTP Content」をクリックします。
http://www.oracle.com/ocom/groups/public/@otn/documents/webcontent/132361.xmlをURLフィールドに入力します。次に、Methodドロップダウン・リストから「GET」を選択します。
「」Send Requestをクリックします。 Message Content Warningダイアログが表示されたら、「Yes」をクリックします。

Responseペインにニュース・ページのXMLコンテンツが表示されます。

XMLフォームの予測されるレスポンスをもとに、JDeveloper News RSSフィードのXMLスキーマを設計できます。

詳細表示設計では、レスポンスに表示されるすべての要素（rss、channel、itemなど）を使用します。

RSSフィードのXMLコンテンツからXMLスキーマを作成するには、見つかった一意のXML要素ごとにXSD要素を定義して、必要に応じて、XSD複合型とシーケンス要素で囲みます。

「」Stopをクリックして、HTTP Analyzerを終了します。以降、このチュートリアルでは使用しないため、HTTP Analyzerウィンドウを閉じます。
アプリケーション・ナビゲータで「Model」プロジェクトを右クリックし、「New」→「General」→「XML」→「XML Schema」の順に選択して、「OK」をクリックします。
Create XML Schemaダイアログで、newsrssfeed.xsdというファイル名を入力します。
Directoryフィールドで、Modelの後に\srcと追加します（例：<JDEVELOPER_HOME>\jdeveloper\mywork\URLDataControlApp\Model\src）。「OK」をクリックします。
XSDスキーマ・エディタで、エディタ・ウィンドウの下部にある「Source」をクリックすると、XMLエディタに切り替わります。

XMLスキーマ定義（XSD）とも呼ばれるXMLスキーマ言語は、XMLドキュメントの構造を定義します。

最初の行の後、<xsd:schema>要素全体とその子要素を次のコードに置き換えます。

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
            xmlns="http://www.example.org"
            targetNamespace="http://www.example.org"
            elementFormDefault="qualified">
  <xsd:element name="rss">
    <xsd:complexType>
      <xsd:sequence>
        <xsd:element name="channel" type="channel"></xsd:element>
      </xsd:sequence>
    </xsd:complexType>
  </xsd:element>
  <xsd:complexType name="channel">
    <xsd:sequence>
      <xsd:element name="lastBuildDate" type="xsd:string"></xsd:element>
      <xsd:element name="title" type="xsd:string"></xsd:element>
      <xsd:element name="link" type="xsd:string"></xsd:element>
      <xsd:element name="description" type="xsd:string"></xsd:element>
      <xsd:element name="managingEditor" type="xsd:string"></xsd:element>
      <xsd:element name="language" type="xsd:string"></xsd:element>
      <xsd:element name="item" type="item" minOccurs="0"        maxOccurs="100"></xsd:element>
    </xsd:sequence>
  </xsd:complexType>
  <xsd:complexType name="item">
    <xsd:sequence>
      <xsd:element name="title" type="xsd:string"></xsd:element>
      <xsd:element name="link" type="xsd:string"></xsd:element>
      <xsd:element name="description" type="xsd:string"></xsd:element>
      <xsd:element name="pubDate" type="xsd:string"></xsd:element>
    </xsd:sequence>
  </xsd:complexType>
</xsd:schema>

「」Save Allをクリックして作業内容を保存します。

XMLスキーマの作成ステップを完了すると、アプリケーション・ナビゲータのProjectsパネルは次のように表示されます。

作成したXMLスキーマ・ドキュメントの構造、コンテンツ、セマンティックを視覚表示するには、エディタ・ウィンドウの「Design」をクリックして、XSDスキーマ・エディタに切り替えます。

ステップ3：URLサービス・データ・コントロールの作成

アプリケーション・ナビゲータで「Model」プロジェクトを右クリックし、「New」→「Business Tier」→「Web Services」→「URL Service Data Control」の順に選択して、「OK」をクリックします。

URLサービス・データ・コントロールは、URLでアクセス可能なXMLファイルなど、URLサービス用のOracle ADFデータ・コントロールです。

ウィザードのステップ1のData Sourceで、Newsというデータ・コントロール名を入力します。「Next」をクリックします。
ステップ2のConnectionで、JDevNewsという接続名をNameフィールドに入力します。
URL Endpointフィールドに、ライブRSSフィードへのURLを入力します。

例： http://www.oracle.com/ocom/groups/public/@otn/documents/webcontent/132361.xml
Authentication TypeがNoneに、Http MethodがGETになっていることを確認します。確認したら、「Next」を2回クリックします。
ステップ4のData Formatで、ドロップダウン・リストから「XML」を選択します。
XSD URLフィールドに、file:///C:/<JDEVELOPER_HOME>/jdeveloper/mywork/URLDataControlApp/Model/src/newsrssfeed.xsdと入力します。ここで、<JDEVELOPER_HOME>は、JDeveloperインストールの場所を表します。「Next」をクリックします。

JDeveloper RSSフィード・ページはXMLドキュメントなので、URLデータソースの形式にXMLを選択します。

詳細表示

データソースをXMLとしてフォーマットする場合、XSDスキーマ定義を識別するURLを指定する必要があります。 XMLデータ・コントロールがXMLデータ・ストリームの形式を検証するには、XSDスキーマ定義が必要です。

前のステップで、<JDEVELOPER_HOME>/jdeveloper/mywork/URLDataControlApp/Model/srcにXSDスキーマ定義を作成しました。ローカル・マシン上のXSDスキーマ定義の場所を指定するには、file:///にその場所を接頭辞として付ける必要があります。次に例を示します。

file:///C:JDevInstall/jdeveloper/mywork/URLDataControlApp/Model/src/newsrssfeed.xsd

ウィザードのステップ5で、「Test URL Connection」をクリックします。

ダイアログにテキストURL Test:URL Successfulが表示されます。
「Finish」をクリックし、次に「」Save Allをクリックして、作業内容を保存します。

プロジェクトにデータ・コントロール定義ファイル（DataControls.dcx）が追加され、概要エディタでファイルが開きます。
アプリケーション・ナビゲータで、「Data Controls」パネルを展開します。

作成したNewsデータ・コントロールが表示され、アプリケーションで利用可能になっています。作成したデータ・コントロールが表示されない場合は、パネル・ツールバーの「」Refreshをクリックします。

Modelプロジェクトに追加された新しいファイルは、次のとおりです。

ステップ4：JSFページの作成

メイン・メニューから、「File」→「New」→「General」→「Projects」→「Custom Project」を選択して、「OK」をクリックします。
プロジェクト名にViewと入力します。次に、Availableリストから「ADF Faces」を選択し、「」を選択して、Selectedリストに移動します。

プロジェクト用の機能を選択すると、New Galleryによって提示される選択肢をフィルタで選別することが可能になり、実行している作業の種類に適した選択肢だけを表示できます。

「Finish」をクリックします。

アプリケーション・ナビゲータにViewプロジェクトが表示されます。
アプリケーション・ナビゲータで「View」プロジェクトを右クリックし、「New」→「Web Tier」→「JSF/Facelets」→「Page」の順に選択して、「OK」をクリックします。
Create JSF Pageダイアログで、NewsPage.jsfというファイル名を入力します。ドキュメント・タイプとしてFaceletsが選択されていることを確認します。

JavaServer Facesを使用するアプリケーション向けに作成するJSFページには、Faceletsドキュメント（ファイル拡張子は.jsf）、またはXML構文で記述されたJSPドキュメント（ファイル拡張子は.jspx）を使用できます。

Page Layoutページで「Blank Page」を選択します。Managed Beanページで、「Do Not Automatically Expose UI Components in a Managed Bean」を選択します。

Create JSF Pageダイアログでは、新しいページのルック・アンド・フィールの一部を任意で定義でき（PageLayoutタブ）、また、ページ上のコンポーネントをマネージドBeanで公開するかどうかを指定できます（Managed Beanタブ）。

「OK」をクリックします。

デフォルトでは、ビジュアル・エディタに新しいJSF Faceletsページが表示されます。

新しいJSFページをFaceletsドキュメント・タイプ（ファイル拡張子は.jsf）にすると、初期ページ構造が自動的に作成されます。

詳細表示 JSF Coreタグ・ライブラリ用のxmlns属性とADF Facesタグ・ライブラリ用のxmlns属性が1つずつ含まれます。初期ファイルに含まれるその他の要素には、ページのレイアウト用要素、特に<f:view>と</f:view>で囲まれた他のすべての要素が挙げられます。

ページ・コードを表示するには、「Source」タブをクリックしてビジュアル・エディタからXMLエディタに切り替えます。たとえば、新規ページには次のコードが生成されます。

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<f:view xmlns:f="http://java.sun.com/jsf/core"
xmlns:af="http://xmlns.oracle.com/adf/faces/rich">
  <af:document title="NewsPage.jsf" id="d1">
<af:form id="f1"></af:form>
</af:document>
</f:view>

コンポーネント・パレットのADF FacesページのLayoutパネルで、「」Panel Stretch Layoutをドラッグして、ビジュアル・エディタの空白ページにドロップします。

ビジュアル・エディタにコンポーネントをドラッグすると、Formという名前の長方形の領域が表示されます。これは、今ドラッグしているコンポーネントがそのターゲット・コンポーネント内に挿入されることを意味しています。
「」Save Allをクリックして作業内容を保存します。

JSFページの作成ステップが完了すると、アプリケーション・ナビゲータにはViewプロジェクトが次のように表示されます。

ステップ5： JSFページへのデータ・コントロールの追加

Data Controlsパネルで、「News」→「loadData()」→「Return」→「rss」→「channel」の順に展開します。

データ・コントロールはビジネス・サービスを表示したものであり、コレクション、属性、メソッドなど、利用可能なビジネス・オブジェクトの階層表示から成ります。

「item」をクリックして、ビジュアル・エディタのページのcenterファセットにドラッグします。Createコンテキスト・メニューから、「Table」→「ADF Read-only Table」を選択します。
Edit Table Columnsダイアログで「Enable Sorting」を選択します。
その他のデフォルト値はそのままにして、「OK」をクリックします。

ビジュアル・エディタには次のようなページが表示されます。

Data Controlsパネルを使用してUIコンポーネントを作成すると、選択したデータ・コントロールにコンポーネントをバインドするための各種コードとオブジェクトがJDeveloperによって自動的に作成されます。

詳細表示ページ用に定義されたOracle ADFデータ・バインディングを表示するには、エディタ・ウィンドウ下部の「Bindings」をクリックします。

JSFページのバインディング・エディタ

JSFページのバインディング・エディタ

Data Controlsパネルを使用してデータバインド表を作成すると、JDeveloperによって次のOracle ADF Facesタグがページに追加されます。

<af:messages>：ユーザーに重要なメッセージ情報を提供するためにアプリケーション・ページ上部で使用されます。
<af:table>：表データを表示するために使用されます。
<af:column>：表内で個々の列を作成するために使用されます。
<af:outputText>：書式設定されたテキストをサポートします。

Oracle ADFデータ・バインディングの式は、バインディング・オブジェクトのデータまたは参照プロパティのいずれかを表示する各コンポーネント属性に追加されます。エディタ・ウィンドウの「Source」をクリックすると、コンポーネント属性とOracle ADFデータ・バインディングの式をXMLエディタで確認できます。EL（式言語）を使用するバインディング式は実行時に評価されます。

典型的なOracle ADFデータ・バインディングのEL式は次の構文を使用して、バインディング・コンテナの各種バインディング・オブジェクトのタイプのいずれかを参照します。

#{bindings.BindingObject.propertyName}

ここで、bindingsは、式によって参照されるバインディング・オブジェクトが現在のページのバインディング・コンテナ内にあることを特定する変数です。 Oracle ADFデータ・バインディングのEL式はすべて、bindings変数で始める必要があります。

実行時にEL式が評価されて、値がバインディング・オブジェクトから引き出され、ページが表示されるときにコンポーネントにデータが移入されます。

アプリケーション・ナビゲータで「NewsPage.jsf」を右クリックし、「Run」を選択します。

Create Default Domainダイアログが表示されたら、PasswordフィールドとConfirm Passwordフィールドにデフォルト・パスワード（例：weblogic1）を入力し、「OK」をクリックします。

次のようなページがブラウザに表示されます。

デフォルトでJDeveloperは、IDEにバンドルされたOracle WebLogic Serverのユーザー固有のインスタンスを参照する、Integrated WebLogic Serverという名前の統合サーバーを自動的に構成します。

詳細表示Integrated WebLogic Serverは、パッケージ化されたアーカイブ・デプロイメント用のJava EEランタイム・サービスです。ゼロコピー・デプロイメントに基づき、Integrated WebLogic Serverでは、アプリケーションとそのプロジェクトのJava EEアプリケーションとしての実行とテストをJava EEコンテナ内で行えます。Integrated WebLogic Serverの使用に際し、特別な接続設定は必要ありません。アプリケーション全体、プロジェクト、または個別のJSFページを実行できます。

IDEでJSFアプリケーションを実行すると、次の処理が自動的に実行されます。

まだ実行中でない場合は、Integrated WebLogic Serverを起動します。
アプリケーションをコンパイルしてIntegrated WebLogic Serverにデプロイします。
次のデフォルトのアドレスを使用して、デフォルトのブラウザ内でアプリケーションを起動します。http://<your_machine_IP_address>:<http_port>/<your_application_name>-<your_project_name>-context-root>/faces/<path_to_the_page>

アプリケーションを終了する場合は、JDeveloperで「

」Terminateをクリックし、ドロップダウン・メニューからアプリケーション・バウンド・インスタンス「URLDataControlApp」を選択します。

注：アプリケーションを終了すると、アプリケーションは停止し、Integrated WebLogic Serverからアンデプロイされますが、Integrated WebLogic Serverは終了されません。

データ・コントロールをJSFページに追加するステップを完了すると、アプリケーション・ナビゲータのViewプロジェクトは次のように表示されます。

アプリケーション・ナビゲータ、Viewプロジェクト

アプリケーション・ナビゲータ、Viewプロジェクト

ViewプロジェクトのApplication Sourcesフォルダに追加された新しいファイルには、次のものがあります。

NewsPagePageDef.xml：JSFページのページ定義ファイル。ページ定義ファイルは、実行時にデータをUIコンポーネントに移入するバインディング・オブジェクトを定義します。ページ定義ファイルで定義されたバインディング・オブジェクトは、バインディング・コンテナでインスタンス化され、ページ定義ファイルのランタイム・インスタンスになります。
DataBindings.cpx：このファイルは、アプリケーション全体のバインディング・コンテキストを定義し、実行時にバインディング・オブジェクトが作成されるメタデータを提供します。また、個々のページをページ定義ファイルにマッピングして、アプリケーションで使用されるデータ・コントロールを宣言します。

ステップ6：レイアウトの拡張

ADF Facesは、多くの便利なコンポーネントをサポートし、プラグインの不要なWebブラウザでの豊富なユーザー・エクスペリエンスを実現します。ページ・レイアウトを改善するため、表の列幅を広げて、列の1つを削除します。

アプリケーション・ナビゲータのViewプロジェクトで、「NewsPage.jsf」を選択します。 Structureウィンドウで、af:tableコンポーネントが表示されるまで、コンポーネントの階層を展開します。
af:tableを展開したら、第1列のコンポーネント「af:column - #{bindings.item.hints.title.label}」を展開します。

Data Controlsパネルを使用して、表をJSFページにドロップすると、ADF Faces Tableコンポーネントが挿入されます。

コンポーネント・パレットのADF FacesページのGeneral Controlsパネルで、「」Link (Go)をドラッグし、Structureウィンドウの最初のaf:columnコンポーネントにドロップします。

すると、af:goLinkがStructureウィンドウのaf:outputTextの下に挿入されます。

ニュース・タイトルの列をテキスト・リンクに変換するため、Oracle ADF Output Textコンポーネントの最初の列をGo Linkコンポーネントに置き換えます。

先ほど追加したGo Linkコンポーネントのプロパティ・インスペクタで、Textフィールドの端にあるドロップダウン・メニューから「Expression Builder」を選択します。
Expressionボックスで、デフォルト・テキストのgoLink 1を削除します。次に、Variablesの下のボックスで、「JSP Objects」→「row」の順に展開して、「title」を選択します。

式#{row.title}が表示されます。
「OK」をクリックします。

式#{row.title}は、プロパティ・インスペクタのTextフィールドに移入されます。
同じGo Linkコンポーネントのプロパティ・インスペクタで、Destinationフィールドの端にあるドロップダウン・メニューから「Expression Builder」を選択します。
VariablesボックスのJSP Objects→rowで、「link」を選択して、「OK」をクリックします。

式#{row.link}は、プロパティ・インスペクタのDestinationフィールドに移入されます。

Go Linkコンポーネントは、最初と2番目の列（それぞれ、titleとlink）で、OutputTextコンポーネントと同じ属性値にバインドされています。
同じGo Linkコンポーネントのプロパティ・インスペクタで、TargetFrameドロップダウン・リストから「_blank」を選択します。

この操作により、リンクが実行時に選択されたときに新しいブラウザ・タブまたはウィンドウが開きます。
Structureウィンドウで、af:goLinkの上にある「af:outputText」を選択して、[Delete]キーを押し、選択したコンポーネントを削除します。OutputTextコンポーネントはもう必要ありません。

最初のaf:columnコンポーネントは次のように表示されます。
Structureウィンドウで、2番目の列コンポーネント「af:column - #{bindings.item.hints.link.label}」を選択して、[Delete]を押し、選択した列を削除します。リンクの列はもう必要ありません。

これで、af:columnコンポーネントは3つだけになります。
Structureウィンドウで、列コンポーネントaf:column - #{bindings.item.hints.description.label}が選択されていることを確認します。プロパティ・インスペクタのAppearanceセクションで、Widthの値を200に変更します。
Structureウィンドウで、最初の列コンポーネント「af:column - #{bindings.item.hints.title.label}」を選択します。プロパティ・インスペクタのAppearanceセクションで、Widthの値を300に変更します。

ビジュアル・エディタには次のような表が表示されます。
アプリケーション・ナビゲータのViewプロジェクトで、「NewsPage.jsf」を右クリックして、「Run」を選択します。

次のようなページがブラウザに表示されます。

タイトル・テキスト・リンクの1つをクリックしてください。リンクが新しいブラウザ・タブまたはウィンドウで開きます。

ステップ7：ラベルの設定

エディタ・ウィンドウで、「DataControls.dcx」タブをクリックして、DCX概要エディタを前面に表示します。

DCXファイルがまだ開いていない場合は、アプリケーション・ナビゲータのModelプロジェクトの「DataControls.dcx」をダブルクリックして、ファイルを開きます。
「News」→「loadData()」→「Return」→「rss」→「channel」の順に展開します。次に、「item」を選択し、「」Editをクリックして、概要エディタを別に開きます。
loadData_Data_item.xml概要エディタで、左側の「Attributes」をクリックします。
Attributes表でtitleを選択した状態で、「UI Hints」タブをクリックします。次に、LabelフィールドにNews Titleと入力します。

Oracle ADFコントロール・ヒントは、JavaBeansベースのビジネス・サービス・データ項目をあらゆるクライアント・タイプに一貫した方法でレンダリングするための一元メカニズムを提供します。

詳細表示コントロール・ヒントとして知られるこのメカニズムを使用すると、アプリケーション開発者は特定のUI設定を複数のクライアントで統一して、UIとデータ項目のやり取りを多肢にわたって制御できます。コントロール・ヒントはビジネス・サービスのレベルで設定されるため、UIコーディングの数も減らせます。

Oracle ADFコントロール・ヒント・メカニズムは、カスタマイズ可能な次のコントロール・ヒント・プロパティをサポートします。

Display Hint：属性の表示/非表示を決定します。
Label：データ項目の値の前に表示されるプロンプトまたは表見出しで使用されるテキストです。
Tooltip：ツールチップまたはフライオーバー・テキストで使用されるテキストです。Webアプリケーションでは、HTML ALT属性の値として表示されます。
Format Type：データ項目が表示されるときに使用されるフォーマッタを定義します。フォーマッタは基本的に、<JDeveloper_Install>/jdeveloper/systemn.n.n.../o.BC4J/formatinfo.xmlファイルで定義できるフォーマット・マスクの集合です。
Format：選択したフォーマッタで使用される特定のフォーマット・マスクです。
Control Type：クライアントUIでデータ項目を表示するために使用されるコントロール・タイプです。Editはコントロールを編集可能にし、Dateはカレンダ・ピッカーを表示し、Defaultは、もっとも適切なコントロールを選択するためにクライアントによって解析されます。
Display Width：データ項目を表示するコントロールの文字幅を定義します。
Display Height：データ項目を表示するコントロールの文字の行数を定義します。
Form Type：属性をDetailモードまたはSummaryモードで表示するかを決定します。Detailモードでは長いフォームが、Summaryモードでは短いフォームが生成されます。このプロパティはOracle ADF Swingアプリケーションのみでサポートされ、Oracle ADF Business Components Webアプリケーションでは利用できません。
Field Order：カテゴリ内で属性のレンダリングを実行する順序を定義します。
Category：属性をグループ化して表示するために、動的なレンダリング・ユーザー・インタフェースによって使用される識別子です。ユーザー・インタフェースにより、その属性は同じカテゴリの別の属性とともにレンダリングされます。カテゴリ・ヒントを使用すると、ユーザー・インタフェースは大規模リストのビュー・オブジェクト属性をカテゴリ別に小さいグループに分けることができます。このコントロール・ヒントは、属性を表示するすべての動的なレンダリング・ユーザー・インタフェースによって利用されます。
Auto Submit：true（有効）に設定すると、ユーザー・インタフェースで値が変更されたときに、部分的な送信をトリガーします。

手順を繰り返して、属性descriptionとpubDateのUIヒント・ラベルを追加します。ラベル・テキストDescriptionとDateをそれぞれ使用します。

ビジネス・サービス・レベルでコントロール・ヒントを追加すると、プロジェクトのテキスト・リソースを含んだ.propertiesファイルが作成されます。

詳細表示

設定するコントロール・ヒントの値を定義するファイルは、プロジェクトで使用される特定のビジネス・サービスによって決まります。Beanベースのビジネス・サービス（JavaBeans、Enterprise JavaBeans、Oracle TopLinkを含む）の場合、デフォルトにより、プロジェクトのテキスト・リソース用の標準.propertiesファイルが生成され、コントロール・ヒント定義は変換可能な文字列として保存されます。

アプリケーション・ナビゲータでは、ファイルModelBundle.propertiesがmodelパッケージのModelプロジェクトに追加されています。

アプリケーション・ナビゲータ、Modelプロジェクト

アプリケーション・ナビゲータ、Modelプロジェクト

コントロール・ヒントを保存するためにJDeveloperによって使用されるプロジェクト・レベルのリソース・バンドル・オプションは、Project PropertiesダイアログのResource Bundleページによって決まります。デフォルトでは、Resource Bundle TypeオプションはProperties Bundleに設定されて、.propertiesファイルが生成されます。

プロジェクトでコントロール・ヒントを初めてカスタマイズすると、ModelBundle.propertiesファイルが作成されます。ModelBundle.propertiesファイルには、追加したコントロール・ヒント定義の変換可能なキー文字列が含まれています。たとえば、ソース・エディタでModelBundle.propertiesを開くと、変換可能な文字列を識別する次のコードが表示されます。

# 
model.News.loadData_Data_item.title_LABEL=News Title

アプリケーション・ナビゲータのViewプロジェクトで、「NewsPage.jsf」を右クリックして、「Run」を選択します。

ブラウザのページに、入力した新しいラベルが表示されます。

追加した新しいラベルは、列ヘッダーに表示されます。

まとめ

このチュートリアルでは、XMLスキーマからURLサービス・データ・コントロールを作成しました。このチュートリアルで学習した内容は、以下のとおりです。

JDeveloperのウィザードおよびダイアログを使用して、アプリケーション、初期ページ、および初期XSDドキュメントを作成する
ビジュアル・エディタ、コンポーネント・パレット、プロパティ・インスペクタを使用して、UIページを作成する
ウィザードを使用して、XML形式でURLサービス・データ・コントロールを作成する
Data Controlsパネルを使用して、コードを作成せずに、データバインドUIコンポーネントを作成する
ビジネス・サービスの中央ロケーションでラベルを設定する
Integrated WebLogic Serverを使用してOracle ADF Facesアプリケーションを実行する

Oracle ADFデータ・バインディングとデータバインド・アプリケーションについて詳しくは、以下を参照してください。

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

トップへ戻る

Copyright © 2011, Oracle and/or its affiliates.All rights reserved.