アダプタのマッピング

2008-09-17

更新 : 2007 年 11 月

アダプタは、個々の要求元デバイスの特性セットを定義します。たとえば、Palm Pilot をベースとした新しいデバイスを設計していて、ハードウェアの修正と拡張を行うとします。新しいデバイスに対応した ASP.NET モバイル Web ページを開発するには、ハードウェアの拡張機能セットを十分に活用するための、カスタマイズされたデバイスアダプタが必要です。

Web.config ファイル内では、あらかじめ作成したカスタマイズされたアダプタに、各モバイルコントロールをマップします。デバイス固有のカスタマイズに対してデバイスアダプタのセットを個別に指定できるだけでなく、あるデバイスアダプタのセットを別のセットから継承し、特定のデバイスとコントロールの組み合わせに対する動作をカスタマイズすることもできます。

Web.config ファイル内部

モバイルコントロールとデバイスアダプタをマッピングするには、<system.web> 要素の <mobileControls> セクションでそれらを宣言して構成します。変更を特定のアプリケーションに限定する場合は Web.config ファイルで宣言できます。サーバー全体の設定は、Microsoft Windows ディレクトリの下の .NET Framework をインストールした場所にある Machine.config ファイルにあります。この構成ファイルでは、実行時に選択されるアダプタセットを個別に指定できます。

メモ :
<mobileControls> セクションが現在の Web.config ファイルに存在しない場合は、<system.web> 要素の子要素として任意の場所に追加できます。

アダプタセットの宣言

デバイスアダプタセットは、Web.config ファイル内部のマッピングメカニズムです。カスタマイズされたデバイスアダプタを使用する各コントロールでは、以下の情報をデバイスアダプタセット内部に追加する必要があります。

述語クラス
述語メソッド
ページアダプタ
コントロールの名前および関連付けられたデバイスアダプタ

デバイスアダプタセットをアプリケーションの Web.config ファイルに追加するには、以下のコード例に示すように、Web.config ファイルにある <mobileControls> セクションの <device> 要素を使用して、デバイスアダプタセットを宣言する必要があります。

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <system.web>
    <!-- Other settings previously specified reside here. -->
    <mobileControls>
      <device name="myDeviceAdapter"
        predicateClass="fullyQualifiedAdapterClass"
        predicateMethod="specificMethodToInvoke"
        pageAdapter="fullyQualifiedPageAdapter">
          <control name="fullyQualifiedControl"
            adapter="fullyQualifiedPageAdapter"/>
          <!-- Add additional control names here. -->
      </device>
    </mobileControls>
  </system.web>
</configuration>

デバイス属性の定義

前のコード例に示したように、以下の一覧に示す属性を各アダプタセットに追加する必要があります。

用語	定義
name	デバイスアダプタセットを一意に認識します。
InheritsFrom	(省略可能) 名前によって識別される他のデバイスアダプタセットから、現在のデバイスアダプタセットが継承されていることを示します。親のデバイスアダプタセットは、同じ Web.config ファイルにある同じ <mobileControls> セクションの任意の場所に配置することも、親の Web.config ファイル内に配置することもできます。
PredicateClassおよびPredicateMethod	アダプタセットが現在のデバイスに対して適切であるかどうかを評価するために呼び出される静的メソッドを指しています。このメソッドは、HttpContext 型の単一のパラメータを使用し、アダプタセットが適合するかどうかを示すブール値を返します。このメソッドは、MobileCapabilities オブジェクトを返す、指定された HttpContext オブジェクトの Browser プロパティを使用して対象デバイスの機能を調べます。
PageAdapter	IPageAdapter インターフェイスを実装する型である、デバイスセットのページアダプタクラスを識別します。

<device> セクションに InheritsFrom 属性が含まれている場合、PredicateClass、PredicateMethod、PageAdapter の各属性を宣言する必要はありません。その代わり、デバイスアダプタセットはこれらの属性を親のデバイスアダプタセットの定義から継承することができます。

メモ :
これらの属性は必須ではありませんが、アプリケーションにとって使用すると有効な場合に定義できます。

アダプタセットの内部には <control> 要素をいくつでも配置できます。それぞれが、特定のコントロールアダプタマッピング (IControlAdapter を実装するクラス) を提供します。<control> 要素には 2 つの属性があります。1 つはマップされるコントロールのクラスを指定する name 属性であり、もう 1 つはコントロールアダプタのクラスを指定する adapter 属性です。

マッピングに関する考慮事項

コントロールとアダプタは一対一でマッピングされていますが、コントロールとデバイスの組み合わせごとに別のコントロールアダプタクラスを記述する必要はありません。通常、新しいモバイルコントロールが継承または単純な合成を使用し、カスタマイズされた出力が必要ない場合は、コントロールアダプタを必要としません。以下の代替手段を検討してください。

アダプタまたはアダプタのセットは、一般的な種類のデバイスに適用できることがあります。たとえば、すべての HTML 3.2 デバイスは、同じデバイスアダプタのセットを持っていることがあります。ただし、一部のコントロールでは、デバイスに特化されたデバイスアダプタが存在することがあります。たとえば、Pocket PC に特化した Calendar コントロールのデバイスアダプタを記述する場合などがあります。
コントロールアダプタは、個々のコントロールではなく、コントロールの基本クラスに関連付けられていることがあります。たとえば、BaseValidator クラスから継承しているすべての検証コントロールをレンダリングするのに、1 つのアダプタで十分な場合があります。
デバイスアダプタを使用しない、完全に機能するモバイルコントロールを記述できます。ただし、開発者は必要な場合にだけデバイスアダプタを記述することを強くお勧めします。これは、ページのどのコントロールもデバイスアダプタを使用しない場合、アーキテクチャの柔軟性が大きく損なわれるためです。
既存のコントロールを拡張して作成された新しいコントロールには、ユーザーコントロール、複合コントロール、および継承を通じて作成された既存のコントロールを含むコントロールがあります。これらのコントロールでは、含まれているコントロールのアダプタが使用されるため、デバイスアダプタは必要ありません。

デバイスアダプタの選択プロセスの理解

ここでは、ページのデバイスアダプタセットの選択手順について説明します。

ASP.NET は、Web.config ファイルの <device> セクションの定義に従って、デバイスアダプタセットのコレクションを反復処理します。要求されたページに最も近い Web.config ファイルが最初に処理され、次に構成の階層の上にある Web.config ファイルから順に処理されます。最後に Machine.config ファイルが処理されます。
各デバイスアダプタセットの関連付けられた述語が、predicateClass 属性および predicateMethod 属性を使用して評価されます。
各述語は、指定された HttpContext オブジェクトを使用して、対象デバイスのデバイス機能を調べ、デバイスアダプタセットが利用可能かどうかを示す true または false を返します。
いずれかの述語が true を返すと、そのデバイスアダプタセットは選択されたものと見なされます。この時点で、システムは <device> 要素の pageAdapter 属性を使用して、アダプタを作成するためのインスタンスを作成するクラスを決定します。
Web.config ファイルの述語がいずれも true を返さない場合は、親ディレクトリの Web.config ファイルにあるデバイスアダプタセットに対してプロセスが繰り返されます。

各コントロールに対しては、ページが呼び出され、指定されたコントロールの型のデバイスアダプタが提供されます。ASP.NET は、以下の手順に従って適切なコントロールアダプタを選択します。

使用されるデバイスアダプタセットは、ページのデバイスアダプタに対して選択されたものと同じです。
コントロールクラスをデバイスアダプタクラスに直接マップする <control> 要素がデバイスアダプタのセットに含まれている場合は、指定されたアダプタクラスのインスタンスが作成されます。
デバイスアダプタセットを直接マップできない場合は、コントロールの基本クラスの新しいインスタンスが作成されます。

Control 基本クラスに到達するまで、このプロセスが繰り返されます。直接のマッピングが見つかった時点で、指定されたデバイスアダプタクラスの新しいインスタンスが作成されます。
マッピングが依然として見つからず、デバイスアダプタセットが他のアダプタセットから継承している場合は、親のアダプタセットに対してアダプタ選択手順が繰り返されます。この処理は、マッピングが見つかるまで、アダプタのセットの階層を上に向かって継続されます。

検索の結果はキャッシュされるため、指定された検索は、最初の該当するコントロールに対して一度だけ実行する必要があります。上記の動作は維持されます。

参照

その他の技術情報

新しいデバイスアダプタおよびデバイスサポートの追加

次の方法で共有