jp.go.aist.rtm.RTC.SDOPackage
クラス Configuration_impl

java.lang.Object
  上位を拡張 org.omg.PortableServer.Servant
      上位を拡張 _SDOPackage.ConfigurationPOA
          上位を拡張 jp.go.aist.rtm.RTC.SDOPackage.Configuration_impl
すべての実装されたインタフェース:
ConfigurationOperations, org.omg.CORBA.portable.InvokeHandler

public class Configuration_impl
extends ConfigurationPOA

SDO Configuration 実装クラス
Configuration interface は Resource Data Model で定義されたデータの 追加、削除等の操作を行うためのインターフェースです。 DeviceProfile, ServiceProfile, ConfigurationProfile および Organization の変更を行うためのオペレーションを備えています。SDO の仕様ではアクセス制御 およびセキュリティに関する詳細については規定していません。
複数の設定 (Configuration) を保持することにより、容易かつ素早くある設定 を反映させることができます。事前に定義された複数の設定を ConfigurationSets および configuration profile として保持することができます。ひとつの ConfigurationSet は特定の設定に関連付けられた全プロパティ値のリストを、 ユニークID、詳細とともに持っています。これにより、各設定項目の詳細を記述し 区別することができます。Configuration interface のオペレーションはこれら ConfiguratioinSets の管理を支援します。

  1. ConfigurationSet: id, description, NVList から構成される1セットの設定
  2. ConfigurationSetList: ConfigurationSet のリスト
  3. Parameter: name, type, allowed_values から構成されるパラメータ定義。
  4. ActiveConfigurationSet: 現在有効なコンフィギュレーションの1セット。

以下、SDO仕様に明記されていないもしくは解釈がわからないため独自解釈

以下の関数は ParameterList に対して処理を行います。

  1. get_configuration_parameters()

以下の関数はアクティブなConfigurationSetに対する処理を行います

  1. get_configuration_parameter_values()
  2. get_configuration_parameter_value()
  3. set_configuration_parameter()

以下の関数はConfigurationSetListに対して処理を行います。

  1. get_configuration_sets()
  2. get_configuration_set()
  3. set_configuration_set_values()
  4. get_active_configuration_set()
  5. add_configuration_set()
  6. remove_configuration_set()
  7. activate_configuration_set()


フィールドの概要
protected  java.util.Map<java.lang.String,Properties> m_configsetopts
           
protected  ConfigAdmin m_configsets
          コンフィギュレーションセット情報
protected  DeviceProfile m_deviceProfile
          DeviceProfile
protected  Configuration m_objref
          オブジェクト参照
protected  OrganizationListHolder m_organizations
          Organization リスト
protected  ParameterListHolder m_parameters
          Parameter リスト
protected  ServiceProfileListHolder m_serviceProfiles
          ServiceProfile リスト
 
コンストラクタの概要
Configuration_impl(ConfigAdmin configsets)
          コンストラクタです。
 
メソッドの概要
 Configuration _this()
          オブジェクト・リファレンスを取得します。
 boolean activate_configuration_set(java.lang.String config_id)
          [CORBA interface] ConfigurationSet をアクティブ化します。
 boolean add_configuration_set(ConfigurationSet configuration_set)
          [CORBA interface] ConfigurationSet を追加します。
 boolean add_organization(Organization org)
          [CORBA interface] Organization を追加します。
 ConfigurationSet get_active_configuration_set()
          [CORBA interface] アクティブな ConfigurationSet を取得します。
 org.omg.CORBA.Any get_configuration_parameter_value(java.lang.String name)
          [CORBA interface] Configuration parameter の値を取得します。
 NameValue[] get_configuration_parameter_values()
          [CORBA interface] Configuration parameter の値のリストを取得します。
 Parameter[] get_configuration_parameters()
          [CORBA interface] 設定パラメータのリストを取得します。
 ConfigurationSet get_configuration_set(java.lang.String config_id)
          [CORBA interface] ConfigurationSet を取得します。
 ConfigurationSet[] get_configuration_sets()
          [CORBA interface] ConfigurationSet リストを取得します。
 DeviceProfile getDeviceProfile()
          [CORBA interface] SDO の DeviceProfile を取得します。
 Configuration getObjRef()
          オブジェクト参照を取得します。
 OrganizationListHolder getOrganizations()
          [CORBA interface] 設定された全Organizationを取得します。
 ServiceProfile getServiceProfile(java.lang.String id)
          [CORBA interface] SDO の ServiceProfile を取得します。
 ServiceProfileListHolder getServiceProfiles()
          [CORBA interface] SDO の 全DeviceProfile を取得します。
 boolean remove_configuration_set(java.lang.String config_id)
          [CORBA interface] ConfigurationSet を削除します。
 boolean remove_organization(java.lang.String organization_id)
          [CORBA interface] Organization の参照を削除します。
 boolean remove_service_profile(java.lang.String id)
          [CORBA interface] ServiceProfile を削除します。
 boolean set_configuration_parameter(java.lang.String name, org.omg.CORBA.Any value)
          [CORBA interface] Configuration パラメータを変更します。
 boolean set_configuration_set_values(java.lang.String config_id, ConfigurationSet configuration_set)
          [CORBA interface] ConfigurationSet を設定します。
 boolean set_device_profile(DeviceProfile dProfile)
          [CORBA interface] SDO の DeviceProfile をセットします。
 boolean set_service_profile(ServiceProfile sProfile)
          [CORBA interface] SDO の ServiceProfile を設定します。
 
クラス _SDOPackage.ConfigurationPOA から継承されたメソッド
_all_interfaces, _invoke, _this
 
クラス org.omg.PortableServer.Servant から継承されたメソッド
_default_POA, _get_delegate, _get_interface_def, _is_a, _non_existent, _object_id, _orb, _poa, _set_delegate, _this_object, _this_object
 
クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

フィールドの詳細

m_objref

protected Configuration m_objref

オブジェクト参照


m_deviceProfile

protected DeviceProfile m_deviceProfile

DeviceProfile


m_serviceProfiles

protected ServiceProfileListHolder m_serviceProfiles

ServiceProfile リスト


m_parameters

protected ParameterListHolder m_parameters

Parameter リスト


m_configsets

protected ConfigAdmin m_configsets

コンフィギュレーションセット情報


m_configsetopts

protected java.util.Map<java.lang.String,Properties> m_configsetopts

m_organizations

protected OrganizationListHolder m_organizations

Organization リスト

コンストラクタの詳細

Configuration_impl

public Configuration_impl(ConfigAdmin configsets)

コンストラクタです。

パラメータ:
configsets - コンフィギュレーション情報
メソッドの詳細

_this

public Configuration _this()

オブジェクト・リファレンスを取得します。

オーバーライド:
クラス ConfigurationPOA 内の _this
戻り値:
オブジェクト・リファレンス

set_device_profile

public boolean set_device_profile(DeviceProfile dProfile)
                           throws InvalidParameter,
                                  NotAvailable,
                                  InternalError

[CORBA interface] SDO の DeviceProfile をセットします。
このオペレーションは SDO の DeviceProfile をセットします。SDO が DeviceProfile を保持している場合は新たな DeviceProfile を生成し、 DeviceProfile をすでに保持している場合は既存のものと置き換えます。

パラメータ:
dProfile - SDO に関連付けられる DeviceProfile。
戻り値:
オペレーションが成功したかどうかを返す。
例外:
NotAvailable - SDOは存在するが応答がない。
InvalidParameter - 引数 "dProfile" が null である。
InternalError - 内部的エラーが発生した。

set_service_profile

public boolean set_service_profile(ServiceProfile sProfile)
                            throws InvalidParameter,
                                   NotAvailable,
                                   InternalError

[CORBA interface] SDO の ServiceProfile を設定します。
このオペレーションはこの Configuration interface を所有する対象 SDO の ServiceProfile を設定します。もし引数の ServiceProfile の id が空であれば 新しい ID が生成されその ServiceProfile を格納します。もし id が空で なければ、SDO は同じ id を持つ ServiceProfile を検索します。 同じ id が存在しなければこの ServiceProfile を追加し、id が存在すれば 上書きをします。

パラメータ:
sProfile - 追加する ServiceProfile
戻り値:
オペレーションが成功したかどうかを返す。
例外:
InvalidParameter - 引数 "sProfile" が nullである。
NotAvailable - SDOは存在するが応答がない。
InternalError - 内部的エラーが発生した。

add_organization

public boolean add_organization(Organization org)
                         throws InvalidParameter,
                                NotAvailable,
                                InternalError

[CORBA interface] Organization を追加します。
このオペレーションは Organization object のリファレンスを追加します。

パラメータ:
org - 追加する Organization
戻り値:
オペレーションが成功したかどうかを返す。
例外:
NotAvailable - SDOは存在するが応答がない。
InvalidParameter - 引数 "organization" が null である。
InternalError - 内部的エラーが発生した。

remove_service_profile

public boolean remove_service_profile(java.lang.String id)
                               throws InvalidParameter,
                                      NotAvailable,
                                      InternalError

[CORBA interface] ServiceProfile を削除します。
このオペレーションはこの Configuration interface を持つ SDO の Service の ServiceProfile を削除します。 削除する ServiceProfileは引数により指定されます。

パラメータ:
id - 削除する ServcieProfile の serviceID。
戻り値:
オペレーションが成功したかどうかを返す。
例外:
InvalidParameter - 引数 "id" が null である。もしくは "id" に 関連付けられた ServiceProfile が存在しない。
NotAvailable - SDOは存在するが応答がない。
InternalError - 内部的エラーが発生した。

remove_organization

public boolean remove_organization(java.lang.String organization_id)
                            throws InvalidParameter,
                                   NotAvailable,
                                   InternalError

[CORBA interface] Organization の参照を削除します。
このオペレーションは Organization の参照を削除します。

パラメータ:
organization_id - 削除する Organization の一意な id。
戻り値:
オペレーションが成功したかどうかを返す。
例外:
InvalidParameter - 引数 "id" が null である。もしくは "id" に 関連付けられた Organization が存在しない。
NotAvailable - SDOは存在するが応答がない。
InternalError - 内部的エラーが発生した。

get_configuration_parameters

public Parameter[] get_configuration_parameters()
                                         throws NotAvailable,
                                                InternalError

[CORBA interface] 設定パラメータのリストを取得します。
このオペレーションは configuration parameter のリストを返します。 SDO が設定可能なパラメータを持たなければ空のリストを返します。

戻り値:
設定を特徴付けるパラメータ定義のリスト。
例外:
NotAvailable - SDOは存在するが応答がない。
InternalError - 内部的エラーが発生した。

get_configuration_parameter_values

public NameValue[] get_configuration_parameter_values()
                                               throws NotAvailable,
                                                      InternalError

[CORBA interface] Configuration parameter の値のリストを取得します。
このオペレーションは configuration パラメータおよび値を返します。 ※未実装

戻り値:
全ての configuration パラメータと値のリスト。
例外:
NotAvailable - SDOは存在するが応答がない。
InternalError - 内部的エラーが発生した。

get_configuration_parameter_value

public org.omg.CORBA.Any get_configuration_parameter_value(java.lang.String name)
                                                    throws InvalidParameter,
                                                           NotAvailable,
                                                           InternalError

[CORBA interface] Configuration parameter の値を取得します。
このオペレーションは引数 "name" で指定されたパラメータ値を返します。 ※未実装

パラメータ:
name - 値を要求するパラメータの名前。
戻り値:
指定されたパラメータの値。
例外:
InvalidParameter - 引数 "name" が null である。
NotAvailable - SDOは存在するが応答がない。
InternalError - 内部的エラーが発生した。

set_configuration_parameter

public boolean set_configuration_parameter(java.lang.String name,
                                           org.omg.CORBA.Any value)
                                    throws InvalidParameter,
                                           NotAvailable,
                                           InternalError

[CORBA interface] Configuration パラメータを変更します。
このオペレーションは "name" で指定したパラメータの値を "value" に変更します。 ※未実装

パラメータ:
name - 変更したいパラメータの名前。
value - 変更したいパラメータの値。
戻り値:
オペレーションが成功したかどうかを返す。
例外:
InvalidParameter - 引数 "name" が null である。
NotAvailable - SDOは存在するが応答がない。
InternalError - 内部的エラーが発生した。

get_configuration_sets

public ConfigurationSet[] get_configuration_sets()
                                          throws NotAvailable,
                                                 InternalError

[CORBA interface] ConfigurationSet リストを取得します。
このオペレーションは ConfigurationProfile が持つ ConfigurationSet の リストを返します。 SDO が ConfigurationSet を持たなければ空のリストを返します。

戻り値:
保持している ConfigurationSet のリストの現在値。
例外:
NotAvailable - SDOは存在するが応答がない。
InternalError - 内部的エラーが発生した。

get_configuration_set

public ConfigurationSet get_configuration_set(java.lang.String config_id)
                                       throws NotAvailable,
                                              InternalError

[CORBA interface] ConfigurationSet を取得します。
このオペレーションは引数で指定された ConfigurationSet の ID に関連 付けられた ConfigurationSet を返します。

パラメータ:
config_id - ConfigurationSet の識別子。
戻り値:
引数により指定された ConfigurationSet。
例外:
NotAvailable - SDOは存在するが応答がない。
InternalError - 内部的エラーが発生した。

set_configuration_set_values

public boolean set_configuration_set_values(java.lang.String config_id,
                                            ConfigurationSet configuration_set)
                                     throws InvalidParameter,
                                            NotAvailable,
                                            InternalError

[CORBA interface] ConfigurationSet を設定します。
このオペレーションは指定された id の ConfigurationSet を更新します。

パラメータ:
config_id - 変更する ConfigurationSet の ID。
configuration_set - 変更する ConfigurationSet そのもの。
戻り値:
ConfigurationSet が正常に更新できた場合は true。 そうでなければ false を返す。
例外:
InvalidParameter - config_id が null か ConfigurationSet
NotAvailable - SDOは存在するが応答がない。
InternalError - 内部的エラーが発生した。

get_active_configuration_set

public ConfigurationSet get_active_configuration_set()
                                              throws NotAvailable,
                                                     InternalError

[CORBA interface] アクティブな ConfigurationSet を取得します。
このオペレーションは当該SDOの現在アクティブな ConfigurationSet を返します。 (もしSDOの現在の設定が予め定義された ConfigurationSet により設定されて いるならば。) ConfigurationSet は以下の場合にはアクティブではないものとみなされます。

  1. 現在の設定が予め定義された ConfigurationSet によりセットされていない
  2. SDO の設定がアクティブになった後に変更された
  3. SDO を設定する ConfigurationSet が変更された
    1. これらの場合には、空の ConfigurationSet が返されます。

      戻り値:
      現在アクティブな ConfigurationSet。
      例外:
      NotAvailable - SDOは存在するが応答がない。
      InternalError - 内部的エラーが発生した。

add_configuration_set

public boolean add_configuration_set(ConfigurationSet configuration_set)
                              throws InvalidParameter,
                                     NotAvailable,
                                     InternalError

[CORBA interface] ConfigurationSet を追加します。
ConfigurationProfile に ConfigurationSet を追加するオペレーション。

パラメータ:
configuration_set - 追加される ConfigurationSet。
戻り値:
オペレーションが成功したかどうか。
例外:
InvalidParameter - 引数 "configuration_set" が null である、 もしくは、引数で指定された ConfigurationSet が存在しない。
NotAvailable - SDOは存在するが応答がない。
InternalError - 内部的エラーが発生した。

remove_configuration_set

public boolean remove_configuration_set(java.lang.String config_id)
                                 throws InvalidParameter,
                                        NotAvailable,
                                        InternalError

[CORBA interface] ConfigurationSet を削除します。
ConfigurationProfile から ConfigurationSet を削除します。

パラメータ:
config_id - 削除する ConfigurationSet の id。
戻り値:
オペレーションが成功したかどうか。
例外:
InvalidParameter - 引数 "configurationSetID" が null である、 もしくは、引数で指定された ConfigurationSet が存在しない。
NotAvailable - SDOは存在するが応答がない。
InternalError - 内部的エラーが発生した。

activate_configuration_set

public boolean activate_configuration_set(java.lang.String config_id)
                                   throws InvalidParameter,
                                          NotAvailable,
                                          InternalError

[CORBA interface] ConfigurationSet をアクティブ化します。
ConfigurationProfile に格納された ConfigurationSet のうち一つを アクティブにします。 このオペレーションは特定の ConfigurationSet をアクティブにします。 すなわち、SDO のコンフィギュレーション・プロパティがその格納されている ConfigurationSet により設定されるプロパティの値に変更されます。 指定された ConfigurationSet の値がアクティブ・コンフィギュレーション にコピーされるということを意味します。

パラメータ:
config_id - アクティブ化する ConfigurationSet の id。
戻り値:
オペレーションが成功したかどうか。
例外:
InvalidParameter - 引数 "config_id" が null である、もしくは 引数で指定された ConfigurationSet が存在しない。
NotAvailable - SDOは存在するが応答がない。
InternalError - 内部的エラーが発生した。

getObjRef

public Configuration getObjRef()

オブジェクト参照を取得します。

戻り値:
オブジェクト参照

getDeviceProfile

public final DeviceProfile getDeviceProfile()

[CORBA interface] SDO の DeviceProfile を取得します。

戻り値:
SDOのDeviceProfile。

getServiceProfiles

public final ServiceProfileListHolder getServiceProfiles()

[CORBA interface] SDO の 全DeviceProfile を取得します。

戻り値:
SDOのDeviceProfile。

getServiceProfile

public final ServiceProfile getServiceProfile(java.lang.String id)

[CORBA interface] SDO の ServiceProfile を取得します。 指定したIDのServiceProfileが存在しない場合は,空のServiceProfileを返します。

パラメータ:
id - 取得対象 ServiceProfile の id
戻り値:
SDOのServiceProfile

getOrganizations

public final OrganizationListHolder getOrganizations()

[CORBA interface] 設定された全Organizationを取得します。

戻り値:
Organizationリスト