com.kddi.system
クラス DeviceController　＜Phase1/一部Phase2＞

java.lang.Object
  |
  +--com.kddi.system.DeviceController

public abstract class DeviceController

extends java.lang.Object

メーカー拡張デバイスの制御クラスを生成するためのクラスです。

移動機メーカーは独自にデバイス制御機能を提供する場合は、DeviceControllerクラスの派生クラスを実装しています。Javaアプリケーションはこの派生クラスを使用して移動機メーカー独自の機能を使用できます。

Javaアプリケーションは、スタティックメソッドgetInstance()に移動機メーカが提供するDeviceController派生クラスの名前を指定して、そのオブジェクトを取得します。下記に例を示します。

 try {
     DeviceController controller = DeviceController.getInstance("KeyLockController");
     controller.setAttribute(0, 1);  // 属性を設定する

     // KeyLockControllerクラスにアクセスできる実装者は
     // setAttribute/getAttribute以外の追加メソッドを利用できる。
 }
 catch (DeviceNotSupportedException e) {
     // 指定したデバイスをサポートしていない場合の処理
 }
 

移動機メーカーは、DeviceControllerの派生クラスで必ずgetAttribute()、setAttribute()を実装しています。また、これらに加えて、独自のメソッドも追加しているかもしれません。これらのメソッドに与えるパラメータの仕様は、DeviceController派生クラスに依存していますので詳細は各移動機メーカーに問い合わせてください。

getInstance()で取得できるオブジェクトはシステムで唯一のインスタンスです。

フィールドの概要

protected static int

baseID デバイスIDの最小値を表します。

コンストラクタの概要

protected

DeviceController() デフォルトのコンストラクタです。

メソッドの概要

abstract int	getAttribute(int attr) デバイス属性の値を返します。
protected int	getAttributeNative(int id, int attr) デバイス属性の値を返します。
static DeviceController	getInstance(java.lang.String deviceName) 拡張デバイス制御クラスのインスタンスを返します。
abstract void	setAttribute(int attr, int value) デバイス属性を設定します。
protected void	setAttributeNative(int id, int attr, int value) デバイス属性を設定します。

クラス java.lang.Object から継承したメソッド

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

フィールドの詳細

baseID　＜Phase2＞

protected static final int baseID

デバイスIDの最小値を表します。

コンストラクタの詳細

DeviceController

protected DeviceController()

デフォルトのコンストラクタです。

メソッドの詳細

getInstance

public static final DeviceController getInstance(java.lang.String deviceName)

拡張デバイス制御クラスのインスタンスを返します。 このインスタンスは、デバイスの種類ごとに唯一のインスタンスとなります。

パラメータ:

deviceName - デバイス名（制御クラス名）

戻り値:

デバイス制御クラスの新しいインスタンス

例外:

DeviceNotSupportedException - 指定したデバイスをサポートしていない移動機で発生する

setAttribute

public abstract void setAttribute(int attr,
                                  int value)

デバイス属性を設定します。

パラメータ:

attr - デバイスの属性

value - 設定する値

getAttribute

public abstract int getAttribute(int attr)

デバイス属性の値を返します。

パラメータ:

attr - デバイスの属性

戻り値:

値

setAttributeNative　＜Phase2＞

protected final void setAttributeNative(int id,
                                        int attr,
                                        int value)

デバイス属性を設定します。（ネイティブ呼び出し）

パラメータ:

id - デバイスID。baseID 以上の値。

attr - デバイスの属性

value - 設定する値

例外:

java.lang.IllegalArgumentException - id が baseID 未満の場合に発生する

SecurityException - getInstance() により生成されていないインスタンスで呼び出された場合に発生する

getAttributeNative　＜Phase2＞

protected final int getAttributeNative(int id,
                                       int attr)

デバイス属性の値を返します。（ネイティブ呼び出し）

パラメータ:

id - デバイスID。baseID 以上の値。

attr - デバイスの属性

戻り値:

値

例外:

java.lang.IllegalArgumentException - id が baseID 未満の場合に発生する

SecurityException - getInstance() により生成されていないインスタンスで呼び出された場合に発生する