org.omg.CORBA
インタフェース Object

既知の実装クラスの一覧:

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

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() このオブジェクトの DomainManager を取り出します。
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 つのオブジェクト参照が等価かどうかを判定します。
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

public boolean _is_a(String repositoryIdentifier)

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

パラメータ:

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

戻り値:

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

_is_equivalent

public boolean _is_equivalent(Object other)

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

パラメータ:

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

戻り値:

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

_non_existent

public boolean _non_existent()

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

戻り値:

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

_hash

public int _hash(int maximum)

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

パラメータ:

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

戻り値:

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

_duplicate

public Object _duplicate()

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

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

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

戻り値:

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

_release

public void _release()

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

_get_interface_def

public Object _get_interface_def()

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

戻り値:

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

_request

public Request _request(String operation)

Dynamic Invocation Interface で使う Request のインスタンスを生成します。

パラメータ:

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

戻り値:

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

_create_request

public 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

public 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

public Policy _get_policy(int policy_type)

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

パラメータ:

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

戻り値:

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

例外:

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

_get_domain_managers

public DomainManager[] _get_domain_managers()

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

戻り値:

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

_set_policy_override

public Object _set_policy_override(Policy[] policies,
                                   SetOverrideType set_add)

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

パラメータ:

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

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

戻り値:

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