org.omg.CORBA

インタフェース Object

既知のすべてのサブインタフェース:

AdapterActivator, BindingIterator, ClientRequestInfo, ClientRequestInterceptor, Codec, CodecFactory, Current, Current, Current, DomainManager, DynAny, DynAny, DynAnyFactory, DynArray, DynArray, DynEnum, DynEnum, DynFixed, DynFixed, DynSequence, DynSequence, DynStruct, DynStruct, DynUnion, DynUnion, DynValue, DynValue, DynValueBox, DynValueCommon, IdAssignmentPolicy, IDLType, IdUniquenessPolicy, ImplicitActivationPolicy, Interceptor, IORInfo, IORInterceptor, IORInterceptor_3_0, IRObject, LifespanPolicy, NamingContext, NamingContextExt, ORBInitializer, ORBInitInfo, POA, POAManager, Policy, PolicyFactory, RequestInfo, RequestProcessingPolicy, RunTime, ServantActivator, ServantLocator, ServantManager, ServantRetentionPolicy, ServerRequestInfo, ServerRequestInterceptor, ThreadPolicy

既知のすべての実装クラス:

_BindingIteratorImplBase, _BindingIteratorStub, _DynAnyFactoryStub, _DynAnyStub, _DynArrayStub, _DynEnumStub, _DynFixedStub, _DynSequenceStub, _DynStructStub, _DynUnionStub, _DynValueStub, _IDLTypeStub, _NamingContextExtStub, _NamingContextImplBase, _NamingContextStub, _PolicyStub, _Remote_Stub, _ServantActivatorStub, _ServantLocatorStub, DynamicImplementation, LocalObject, ObjectImpl, ObjectImpl, Stub

public interface Object

CORBA オブジェクト参照の定義です。

CORBA オブジェクト参照は、サーバーが実装する特定の CORBA オブジェクトのハンドルです。CORBA オブジェクトの参照を使って CORBA オブジェクトにメソッドを呼び出すたびに、その参照は同じ CORBA オブジェクトを識別します。CORBA オブジェクトは、別々のオブジェクト参照を複数持っていてもかまいません。

org.omg.CORBA.Object インタフェースは、RMI リモートオブジェクトの java.rmi.Remote に類似した、Java プログラミング言語のすべての CORBA オブジェクト参照についての継承階層のルートです。

CORBA オブジェクトは、ローカルオブジェクトでもリモートオブジェクトでもかまいません。CORBA オブジェクトがローカルオブジェクトである (つまり、クライアントと同じ VM で実行される) 場合、呼び出しはオブジェクトのインスタンスによって直接処理され、オブジェクト参照は、オブジェクト実装クラスの実際のインスタンスを示すポインタになります。CORBA オブジェクトがリモートオブジェクトである (つまり、クライアントとは異なる VM で実行される) 場合、オブジェクト参照はオブジェクト実装が格納されているサーバーでリモート呼び出しを行うために ORB 機構を使用するスタブ (プロキシ) を示すポインタになります。

org.omg.CORBA.Object インタフェース内のメソッドのデフォルトの実装は、org.omg.CORBA.portable.ObjectImpl クラスで提供されます。このクラスは、スタブとオブジェクト実装の基底クラスです。

関連項目:

ObjectImpl

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
Request	_create_request(Context ctx, String operation, NVList arg_list, NamedValue result) 指定されたコンテキスト、メソッド名、引数のリスト、メソッドの戻り値のコンテナで初期化された Request のインスタンスを生成します。
Request	_create_request(Context ctx, String operation, NVList arg_list, NamedValue result, ExceptionList exclist, ContextList ctxlist) 指定されたコンテキスト、メソッド名、引数のリスト、メソッドの戻り値のコンテナ、例外のリスト、解決する必要のあるコンテキスト文字列のリストで初期化された Request のインスタンスを生成します。
Object	_duplicate() この CORBA オブジェクト参照の複製を返します。
DomainManager[]	_get_domain_managers() このオブジェクトの DomainManagers を取り出します。
Object	_get_interface_def() このオブジェクト参照が参照するオブジェクト実装の InterfaceDef を取得します。
Policy	_get_policy(int policy_type) このオブジェクトに適用する、指定された型の Policy オブジェクトを返します。
int	_hash(int maximum) このオブジェクト参照の ORB 内部識別子を返します。
boolean	_is_a(String repositoryIdentifier) このオブジェクトが、指定されたインタフェースを実装するクラスのインスタンスかどうかを判定します。
boolean	_is_equivalent(Object other) 2 つのオブジェクト参照が等価かどうかを判定します。ただしこれは、ORB が簡単に判定できる範囲に限られます。
boolean	_non_existent() このオブジェクト参照のサーバーオブジェクトが破棄されたかどうかを判定します。
void	_release() このオブジェクト参照を使っている呼び出し側が終了したことを通知するので、このオブジェクト参照に関連した内部 ORB リソースは解放されます。
Request	_request(String operation) Dynamic Invocation Interface で使用される Request のインタフェースを作成します。
Object	_set_policy_override(Policy[] policies, SetOverrideType set_add) この Object の既存のポリシーを置換するよう指定したポリシー、または指定した SetOverrideType オブジェクトの値によって既存のポリシーに追加されるよう指定したポリシーを持つ、新規の Object を返します。

メソッドの詳細

_is_a

boolean _is_a(String repositoryIdentifier)

このオブジェクトが、指定されたインタフェースを実装するクラスのインスタンスかどうかを判定します。

パラメータ:

repositoryIdentifier - 調査対象のインタフェース

戻り値:

このオブジェクト参照がインタフェースを実装するクラスのインスタンスである場合は true、そうでない場合は false

_is_equivalent

boolean _is_equivalent(Object other)

2 つのオブジェクト参照が等価かどうかを判定します。ただしこれは、ORB が簡単に判定できる範囲に限られます。2 つのオブジェクト参照が一致すれば、等価といえます。また、別々の 2 つのオブジェクト参照が実際に同じオブジェクトを参照していても、それらは等価です。ただし、ORB は別々の 2 つのオブジェクト参照が同じオブジェクトを参照しているかどうか判定するように要求されることはありません。そのような判定にかかる負荷が非常に大きい場合があるためです。

パラメータ:

other - 等価かどうか調べる対象となるもう一方のオブジェクト参照

戻り値:

このオブジェクト参照が指定されたオブジェクト参照と等価であると判定された場合は true。ただし false の場合は、2 つのオブジェクト参照が別のものであることだけを示し、別々のオブジェクトを参照することを示すとは限らない。

_non_existent

boolean _non_existent()

このオブジェクト参照のサーバーオブジェクトが破棄されたかどうかを判定します。

戻り値:

サーバーオブジェクトが存在しないことを ORB が正式に認識している場合は true、そうでない場合は false

_hash

int _hash(int maximum)

このオブジェクト参照の ORB 内部識別子を返します。これはハッシュ識別子です。この識別子はオブジェクト参照の寿命があるうちは不変なので、その識別子のどのハッシュ関数も変化しません。返される値が一意であることは保証されません。つまり、別のオブジェクト参照が同じハッシュ値を持つこともあります。2 つのオブジェクト参照が別々にハッシュ値を持つ場合、それらは別々のオブジェクト参照です。しかし、どちらも同一の CORBA オブジェクトを参照していることもあります。

パラメータ:

maximum - ORB が返すハッシュ値の上限

戻り値:

このオブジェクト参照の ORB 内部ハッシュ識別子

_duplicate

Object _duplicate()

この CORBA オブジェクト参照の複製を返します。サーバーオブジェクト実装は、複製の生成には無関係で、その実装によって、元のオブジェクト参照と複製のどちらを使って要求を行ったかを見分けることはできません。

メモリー管理は VM によって処理されるので、このメソッドは Java プラットフォームではあまり有効ではないことに注意してください。これは、CORBA API に準拠するために含まれています。

_duplicate メソッドは、このオブジェクト参照自体を返すこともあります。

戻り値:

このオブジェクト参照自体またはその複製

_release

void _release()

このオブジェクト参照を使っている呼び出し側が終了したことを通知するので、このオブジェクト参照に関連した内部 ORB リソースは解放されます。ただし、オブジェクト実装はこの操作とは無関係で、同じオブジェクトへのほかの参照は影響を受けません。

_get_interface_def

Object _get_interface_def()

このオブジェクト参照が参照するオブジェクト実装の InterfaceDef を取得します。InterfaceDef オブジェクトを使うと、このオブジェクト参照によって参照されるオブジェクトのメソッド、属性、およびその他の型情報を内部的に確認できます。

戻り値:

このオブジェクト参照が参照するオブジェクトの型情報を提供するインタフェースリポジトリ内の InterfaceDef オブジェクト

_request

Request _request(String operation)

Dynamic Invocation Interface で使用される Request のインタフェースを作成します。

パラメータ:

operation - Request のインスタンスを使って呼び出されるメソッドの名前

戻り値:

新しく生成された Request インスタンス

_create_request

Request _create_request(Context ctx,
                      String operation,
                      NVList arg_list,
                      NamedValue result)

指定されたコンテキスト、メソッド名、引数のリスト、メソッドの戻り値のコンテナで初期化された Request のインスタンスを生成します。

パラメータ:

ctx - プロパティーのリストを格納している Context オブジェクト

operation - 呼び出されるメソッドの名前

arg_list - 呼び出されるメソッドの実際の引数を格納している NVList

result - メソッドの戻り値のコンテナとして機能する NamedValue オブジェクト

戻り値:

新しく作成された Request オブジェクト

関連項目:

Request, NVList, NamedValue

_create_request

Request _create_request(Context ctx,
                      String operation,
                      NVList arg_list,
                      NamedValue result,
                      ExceptionList exclist,
                      ContextList ctxlist)

指定されたコンテキスト、メソッド名、引数のリスト、メソッドの戻り値のコンテナ、例外のリスト、解決する必要のあるコンテキスト文字列のリストで初期化された Request のインスタンスを生成します。

パラメータ:

ctx - プロパティーのリストを格納している Context オブジェクト

operation - 呼び出されるメソッドの名前

arg_list - 呼び出されるメソッドの実際の引数を格納している NVList

result - メソッドの戻り値のコンテナとして機能する NamedValue オブジェクト

exclist - メソッドによってスローされる例外のリストを格納している ExceptionList オブジェクト

ctxlist - Request のインスタンスで解決して送る必要があるコンテキスト文字列のリストを格納している ContextList オブジェクト

戻り値:

新しく作成された Request オブジェクト

関連項目:

Request, NVList, NamedValue, ExceptionList, ContextList

_get_policy

Policy _get_policy(int policy_type)

このオブジェクトに適用する、指定された型の Policy オブジェクトを返します。

パラメータ:

policy_type - 取得されるポリシーの型

戻り値:

policy_type パラメータで指定された型の Policy オブジェクト

例外:

BAD_PARAM - この ORB が指定された型をサポートしていないか、その型のポリシーオブジェクトがこのオブジェクトに関連していないために、ポリシー型の値が無効となる場合

_get_domain_managers

DomainManager[] _get_domain_managers()

このオブジェクトの DomainManagers を取り出します。これにより、管理サービスやアプリケーションは、ドメインマネージャーを取り出せます。したがって、ドメインのメンバーである個々のオブジェクトに適用可能なセキュリティーとほかのポリシーを取り出せるようになります。

戻り値:

このオブジェクトを直接囲むドメインマネージャーのリスト。各オブジェクトは作成時にデフォルトで 1 つ以上のドメインマネージャーに関連付けられるので、このリストでは常に 1 つ以上のドメインマネージャーが返される。

_set_policy_override

Object _set_policy_override(Policy[] policies,
                          SetOverrideType set_add)

この Object の既存のポリシーを置換するよう指定したポリシー、または指定した SetOverrideType オブジェクトの値によって既存のポリシーに追加されるよう指定したポリシーを持つ、新規の Object を返します。

パラメータ:

policies - 追加されるか、または置換に使用されるポリシーが格納された Policy オブジェクトの配列

set_add - 指定したポリシーが既存のポリシーと置換されることを示す SetOverrideType.SET_OVERRIDE、または指定したポリシーが既存のポリシーに追加されることを示す SetOverrideType.ADD_OVERRIDE

戻り値:

この Object のポリシーと置換、または追加される指定したポリシーを持つ新規の Object