5 MAFアプリケーション機能のコンテンツ・タイプの定義
この章の内容は次のとおりです。
アプリケーション機能のコンテンツ・タイプの概要
アプリケーション機能のコンテンツ・タイプには、ユーザー・インタフェースの形式が記述されます。このコンテンツ・タイプは、MAF AMXコンポーネントまたはHTML(5)タグを使用して構成できます。
また、アプリケーション機能では、モバイル・コンテキストに適したコンテンツを含む、リモートでホストされたページから、自身のコンテンツを導出することもできます。このようなWebページとして考えられるのは、スマートフォン向けのApache Trinidadで作成されたJavaServerページや、タブレット・デバイス上で実行されるアプリケーション向けのADF Facesコンポーネントから構成されたページです。MAFアプリケーションに埋め込まれた各アプリケーション機能では、様々なコンテンツ・タイプを保持できます。
MAFアプリケーションには、様々なコンテンツ・タイプを持つアプリケーション機能が含まれますが、アプリケーション機能自体も、ユーザーおよびデバイス固有の要件に応じた様々なコンテンツ・タイプを保持する場合があります。アプリケーション機能で異なるコンテンツ・タイプを配信する方法の詳細は、「アプリケーション機能に関する制約の設定」を参照してください。<adfmf:content>要素に子要素を追加すると(例5-1を参照)、アプリケーション機能でユーザー・インタフェースを実装する方法を定義できます。
図に示すように、概要エディタの「コンテンツ」タブには、例5-1に示したターゲット・コンテンツ関連の要素と属性を定義するためのドロップダウン・リストとフィールドが表示されます。このタブのフィールドを使用すると、アプリケーション機能用に配信されるコンテンツのタイプと、そのコンテンツ・タイプで使用するナビゲーションとSpringboardアイコンのイメージを制御できる制約を設定できます。
各コンテンツ・タイプには、独自のパラメータ・セットがあります。たとえば、図に示すように、MAF AMXコンテンツとして実装するアプリケーション機能のMAF AMXページまたはタスク・フローの場所を指定する必要があります。さらにオプションで、アプリケーション機能に他のアプリケーション機能(またはMAFアプリケーション自体)とは異なるルック・アンド・フィールを設定するCSSファイルを選択したり、MAF AMXコンポーネントのアクションを制御するJavaScriptファイルを選択することもできます。
例5-1 <adfmf:content>要素
<adfmf:content id="Feature1">
<adfmf:amx file="FeatureContent.amx">
</adfmf:content>
アプリケーション機能のコンテンツをリモートURLまたはローカルHTMLとして定義する方法
「コンテンツ」タブのフィールドを使用すると、アプリケーション機能用に配信されるコンテンツのタイプと、そのコンテンツ・タイプで使用するナビゲーションとスプリングボード・アイコンのイメージを制御できる制約を設定できます。
概要エディタの「コンテンツ」タブ(図5-1を参照)には、例5-1に示したターゲット・コンテンツ関連の要素と属性を定義するためのドロップダウン・リストとフィールドが表示されます。
始める前に:
各コンテンツ・タイプには、次のような独自の前提条件があります。
-
リモートURL: Webアプリケーションへの参照。既存のWebアプリケーションをモバイル用に拡張し、さらにデバイス・サービスを拡張できます。リモート・コンテンツでは、ローカル・データ・キャッシュや、サーバー側データおよび機能の一式を提供することによって、MAF AMXおよびローカルHTMLコンテンツの両方を補完できます。リモートURL実装には、有効なWebアドレスが必要です。「リモートURLを使用したアプリケーション機能コンテンツの実装」を参照してください。
-
ローカルHTML: MAFアプリケーション内にパッケージ化されたHTMLページを参照します。「サンプルのMAFアプリケーション」で説明されている
HelloWorldサンプル・アプリケーションが示すように、このようなHTMLページはJavaScriptを参照できます。MAFが自分のアプリケーションの機能の実装に最適ではない場合に、Cordova JavaScript APIの使用によるアプリケーション機能を実装するため、このコンテンツ・タイプの使用を検討してください。ローカルHTMLおよびアプリケーション・コンテナAPI。
アプリケーション・コンテンツをリモートURLまたはローカルHTMLとして定義するには:
- コンテンツ固有のパラメータを定義します。
-
リモートURLコンテンツの場合は、図に示すように接続を選択します。これは、サーバー上のWebページのアドレス(および起動ページの場所)を表しています。
次の図に示すように、この接続を作成するには、まず「追加」をクリックして、次に「URL接続の作成」ダイアログに入力します。このダイアログの詳細は、Oracle JDeveloperのオンライン・ヘルプを参照してください。この接続は、
connections.xmlファイルに格納されます。注意:
この接続は、アプリケーション・リソースとしてのみ作成できます。
-
ローカルHTMLコンテンツの場合は、ローカル・バンドルの場所を入力します。または、「URL」フィールドで「追加」をクリックし、次の図に示すようにダイアログに入力して、JDeveloperのHTMLエディタを使用してページを構築することで、HTMLページを作成します。これはアプリケーション機能なので、このページはビュー・コントローラ・プロジェクトのWeb Contentフォルダに格納されます。
-
アプリケーション機能のコンテンツをMAF AMXページまたはタスク・フローとして定義する方法
「コンテンツ」タブのフィールドを使用すると、アプリケーション機能用に配信されるコンテンツのタイプと、そのコンテンツ・タイプで使用するナビゲーションとスプリングボード・アイコンのイメージを制御できる制約を設定できます。
概要エディタの「コンテンツ」タブ(図5-1を参照)には、例5-1に示したターゲット・コンテンツ関連の要素と属性を定義するためのドロップダウン・リストとフィールドが表示されます。
始める前に:
各コンテンツ・タイプには、次のような独自の前提条件があります。
-
MAF AMX: アプリケーション機能に対するデフォルトのコンテンツ・タイプ。「MAF AMXページの作成」 を参照してください。
MAF AMXとして実装されるアプリケーション機能には、ビュー(単一のMAF AMXページ)か、バインド・タスク・フローまたはバインドなしタスク・フローが必要です。JavaScriptファイルを追加すると、MAF AMXコンポーネントに対するレンダリング・ロジックが提供されるか、既存のレンダリング・ロジックがオーバーライドされます。アプリケーション機能に対するカスタムのルック・アンド・フィールを指定するセレクタを持つスタイル・シート(CSS)を含めます。これは、MAFアプリケーション・レベルで定義されたスタイル(アプリケーション機能にデフォルトで使用されるスタイル)をオーバーライドします。つまり、アプリケーション機能全体で確実に独自のルック・アンド・フィールを持つようになります。
MAF AMXページとこれらを格納するMAFアプリケーションは、両方とも「新規ギャラリ」のウィザードを使用して作成できます。これらのウィザードにアクセスするには、まず「アプリケーション」ウィンドウでビュー・コントローラ・プロジェクトを強調表示してから、次に「新規」を選択します。
注意:
maf-feature.xmlファイル内にある、タスク・フロー、MAF AMXページ、CSSおよびJavaScriptファイルへの参照を手動で編集する場合、デバイスで使用されているファイル・システムによって大文字と小文字が区別され、特殊文字が許可されない可能性があることに注意してください。これらのファイルを確実に参照できるようにするには、モバイル・デバイスの仕様を確認してください。 -
MAFタスク・フロー: アプリケーション機能の制御フローの定義にモジュール型アプローチを提供します。タスク・フローを使用して、1つのタスクを構成する一連のアクティビティを定義します。タスク・フローに含めることのできるアクティビティには、ビュー(MAF AMXページの表示に使用)、メソッド・コール(マネージドBeanのメソッドの起動に使用)、タスク・フロー・コール(別のタスク・フローのコールに使用)などがあります。「タスク・フローの作成」を参照してください。
MAF AMXページまたはタスク・フローをアプリケーション機能のコンテンツとして使用する手順:
- 必要に応じて、「追加」をクリックして「コンテンツ」表に行を作成し、「タイプ」列のドロップダウン・リストから「MAF AMXページ」または「MAFタスク・フロー」を選択します(次の図を参照)。
iOSでのAMXコンテンツを使用するアプリケーション機能のWebビューの構成
iOS デバイスにデプロイされている場合、MAFアプリケーションでは、AMXコンテンツのレンダリングにデフォルトでWKWebViewが使用されます。
WKWebViewは、UIWebViewと比べてパフォーマンスが改善されている、iOS Webビューです。ローカルHTMLまたはリモートURLコンテンツ・タイプを使用するアプリケーション機能では、デフォルトでUIWebViewが使用されます。これは、このWebビューでは、JavaScript APIへのアクセスのために/~maf.device~/仮想パスがサポートされているためです。/~maf.device~/仮想パスが必要ない場合は、ローカルHTMLおよびリモートURLコンテンツ・タイプを使用するアプリケーション機能を、WKWebViewを使用するよう構成できます。必要な場合は、AMXコンテンツを使用するアプリケーション機能を、古いUIWebViewを使用するよう構成することもできます。これらの構成変更を行うには、次の例で示すように、maf-features.xml内のiOSWebViewプロパティを構成します。
<adfmf:feature id="WKWebViewExample" name="WKWebViewExample">
<adfmf:constraints>
<adfmf:constraint property="device.os" operator="contains" value="iOS" id="c6"/>
</adfmf:constraints>
<adfmf:content id="WKWebViewExample.1">
<adfmf:amx file="WKWebViewExample/home.amx"/>
</adfmf:content>
<adfmf:properties id="wkp1">
<!-- To use WKWebView, set to modern -->
<adfmf:property id="wkp1-1" name="iOSWebView" value="modern" />
<!-- To use UIWebView, set to legacy -->
<!-- name="iOSWebView" value="legacy" -->
</adfmf:properties>
</adfmf:feature>
iOSWebViewプロパティが不足しているかdefaultに設定されている場合は、AMXコンテンツにはWKWebViewが使用され、ローカルHTMLおよびリモートURLコンテンツ・タイプにはUIWebViewが使用されます。
アプリケーション機能での使用のための外部リソースの選択
デプロイメントを可能にするために、属性によって参照されるすべてのリソースは、ビュー・コントローラ・プロジェクトのpublic_htmlディレクトリ内に配置する必要があります。
すべてのリソースは次の属性によって参照されます。
-
<adfmf:feature>のiconおよびimage属性(例:<adfmf:feature id="PROD" name="Products" icon="feature_icon.png" image="springboard.png">)。 -
<adfmf:content>のiconおよびimage属性(例:<adfmf:content id="PROD" icon="feature_icon.png" image="springboard_image.png">)。 -
<adfmf:amx>のfile属性(例:<adfmf:amx file="PRODUCT/home.amx" />)。 -
<
adfmf: localHTML>のurl属性(例:<adfmf:localHTML url="oracle.hello/index.html"/>)。 -
<adfmf:includes>のtype=stylesheetおよびtype=JavaScriptに対して定義するファイル属性(例:<adfmf:include type="JavaScript" file="myotherfile.js"/>または<adfmf:include type="StyleSheet" file="resources/css/stylesheet.css" id="i3"/>)。
MAFは、別の場所から参照されるリソースをサポートしていません。つまり、たとえば、../を接頭辞として使用して、public_htmlディレクトリ外部に値を入力することはできません。public_html外部のリソースを参照しないようにする安全策として、MAFには、「ファイルがpublic_htmlディレクトリにありません」と呼ばれる監査ルールが含まれています。図に示すように、「ツール」→「プリファレンス」→「監査」→「プロファイル」と選択して、「プリファレンス」の「監査」の下にある「プロファイル」ノードから、MAFの監査プロファイルにアクセスできます。
このプロファイルを選択した場合、リソースの場所を変更すると、JDeveloperによって警告が発行されます。次の図に示すように、デフォルト値がオーバーライドされると、JDeveloperはこうした警告を表示します。監査の詳細は、『Oracle JDeveloperによるアプリケーションの開発』の「Javaプロジェクトの監査とモニタリング」の章を参照してください。
