JavaTM 2 Platform
Standard Ed. 5.0

org.omg.CORBA.portable
クラス ObjectImpl

java.lang.Object
  上位を拡張 org.omg.CORBA.portable.ObjectImpl
すべての実装されたインタフェース:
Object
直系の既知のサブクラス:
_BindingIteratorStub, _DynAnyFactoryStub, _DynAnyStub, _DynArrayStub, _DynEnumStub, _DynFixedStub, _DynSequenceStub, _DynStructStub, _DynUnionStub, _DynValueStub, _IDLTypeStub, _NamingContextExtStub, _NamingContextStub, _PolicyStub, _ServantActivatorStub, _ServantLocatorStub, DynamicImplementation, ObjectImpl

public abstract class ObjectImpl
extends Object
implements Object

すべてのスタブクラスに共通の基底クラスで、org.omg.CORBA.Object メソッドのデフォルト実装を提供します。すべてのメソッド実装は、ObjectImpl のインスタンスに格納されている Delegate オブジェクトに転送されます。ObjectImpl は、Delegate が別のベンダー固有の ORB によって実装できるため、ポータブルスタブを考慮しています。


コンストラクタの概要
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 exceptions, ContextList contexts)
          指定されたコンテキスト、メソッド、引数リスト、結果のコンテナ、例外、およびコンテキスト文字列の解決に使用されるプロパティ名のリストを格納する Request オブジェクトを作成します。
 Object _duplicate()
          この ObjectImpl オブジェクトの複製を返します。
 Delegate _get_delegate()
          呼び出されたすべてのメソッドをこの ObjectImpl オブジェクトが委譲する、ベンダ固有の Delegate オブジェクトへの参照を取得します。
 DomainManager[] _get_domain_managers()
          この ObjectImpl オブジェクトのドメインマネージャのリストを取得します。
 Object _get_interface_def()
          この ObjectImpl オブジェクトのインタフェース定義を取得します。
 Policy _get_policy(int policy_type)
          指定されたポリシー型を保持するこの ObjectImpl オブジェクトの Policy オブジェクトを取得します。
 int _hash(int maximum)
          この ObjectImpl オブジェクトの ORB 内部識別子として機能するハッシュコードを取得します。
abstract  String[] _ids()
          この ObjectImpl オブジェクトがサポートするリポジトリ識別子を含む文字列配列を取得します。
 InputStream _invoke(OutputStream output)
          操作を呼び出して、応答を読み込むための InputStream オブジェクトを返します。
 boolean _is_a(String repository_id)
          指定されたリポジトリ識別子が識別するオブジェクトが ObjectImpl オブジェクトであるかどうかを判定します。
 boolean _is_equivalent(Object that)
          指定された ObjectImpl オブジェクトがこの ObjectImpl オブジェクトと等価かどうかを判定します。
 boolean _is_local()
          この ObjectImpl オブジェクトがローカルサーバントにより実装されているかどうかを判定します。
 boolean _non_existent()
          この ObjectImpl オブジェクトのサーバオブジェクトが破棄されたかどうかを判定します。
 ORB _orb()
          このオブジェクトとその委譲に関連する ORB への参照を返します。
 void _release()
          この ObjectImpl オブジェクトに関連するリソースを解放します。
 void _releaseReply(InputStream input)
          _invoke メソッドの呼び出し後、非整列化が完了したときに、指定された応答ストリームを ORB に解放します。
 Request _request(String operation)
          Dynamic Invocation Interface で使用可能な指定されたメソッドを含む Request オブジェクトを作成します。
 OutputStream _request(String operation, boolean responseExpected)
          指定されたメソッドの引数の整列化に使用する OutputStream オブジェクトを返します。
 void _servant_postinvoke(ServantObject servant)
          _servant_preinvoke メソッドの呼び出しで以前に取得されたローカルサーバントに対し、操作を呼び出したあとでローカルスタブにより呼び出されます。
 ServantObject _servant_preinvoke(String operation, Class expectedType)
          指定されたメソッドの要求送信に使用されるローカルサーバントへの Java 参照を返します。
 void _set_delegate(Delegate delegate)
          この ObjectImpl インスタンスの、指定された Delegate オブジェクトに対する委譲を設定します。
 Object _set_policy_override(Policy[] policies, SetOverrideType set_add)
          この ObjectImpl オブジェクトの指定されたポリシー用のオーバーライド型を、指定された SetOverrideType インスタンスに設定します。
 boolean equals(Object obj)
          この ObjectImpl オブジェクトと指定されたオブジェクトの等価性を比較します。
 int hashCode()
          この ObjectImpl オブジェクトのハッシュコードを返します。
 String toString()
          この ObjectImpl オブジェクトを表す String を返します。
 
クラス java.lang.Object から継承されたメソッド
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
 

コンストラクタの詳細

ObjectImpl

public ObjectImpl()
メソッドの詳細

_get_delegate

public Delegate _get_delegate()
呼び出されたすべてのメソッドをこの ObjectImpl オブジェクトが委譲する、ベンダ固有の Delegate オブジェクトへの参照を取得します。

戻り値:
この ObjectImpl インスタンスに格納されている Delegate
例外:
BAD_OPERATION - 委譲が設定されていない場合
関連項目:
_set_delegate(org.omg.CORBA.portable.Delegate)

_set_delegate

public void _set_delegate(Delegate delegate)
この ObjectImpl インスタンスの、指定された Delegate オブジェクトに対する委譲を設定します。この ObjectImpl オブジェクトに対するすべてのメソッド呼び出しが、この委譲に転送されます。

パラメータ:
delegate - この ObjectImpl オブジェクトに対するすべてのメソッド呼び出しが委譲される Delegate のインスタンス。サードパーティの ORB により実装可能
関連項目:
_get_delegate()

_ids

public abstract String[] _ids()
この ObjectImpl オブジェクトがサポートするリポジトリ識別子を含む文字列配列を取得します。たとえばスタブの場合、このメソッドはスタブがサポートするすべてのインタフェースに関する情報を返します。

戻り値:
この ObjectImpl のインスタンスがサポートするすべてのリポジトリ識別子の配列

_duplicate

public Object _duplicate()
この ObjectImpl オブジェクトの複製を返します。

定義:
インタフェース Object 内の _duplicate
戻り値:
このオブジェクトの複製である orb.omg.CORBA.Object オブジェクト

_release

public void _release()
この ObjectImpl オブジェクトに関連するリソースを解放します。

定義:
インタフェース Object 内の _release

_is_a

public boolean _is_a(String repository_id)
指定されたリポジトリ識別子が識別するオブジェクトが ObjectImpl オブジェクトであるかどうかを判定します。

定義:
インタフェース Object 内の _is_a
パラメータ:
repository_id - 判定するリポジトリ識別子を保持する String オブジェクト
戻り値:
指定されたリポジトリ識別子で識別されたオブジェクトが ObjectImpl のインスタンスの場合は true、そうでない場合は false

_is_equivalent

public boolean _is_equivalent(Object that)
指定された ObjectImpl オブジェクトがこの ObjectImpl オブジェクトと等価かどうかを判定します。

定義:
インタフェース Object 内の _is_equivalent
パラメータ:
that - この ObjectImpl オブジェクトと比較する ObjectImpl のインスタンス
戻り値:
指定されたオブジェクトがこの ObjectImpl オブジェクトと等価である場合は true、そうでない場合は false

_non_existent

public boolean _non_existent()
この ObjectImpl オブジェクトのサーバオブジェクトが破棄されたかどうかを判定します。

定義:
インタフェース Object 内の _non_existent
戻り値:
サーバオブジェクトが存在しないことを ORB が正式に認識している場合は true、そうでない場合は false

_hash

public int _hash(int maximum)
この ObjectImpl オブジェクトの ORB 内部識別子として機能するハッシュコードを取得します。

定義:
インタフェース Object 内の _hash
パラメータ:
maximum - ORB によって返されるハッシュ値の上限を示す int
戻り値:
この ObjectImpl オブジェクトのハッシュコードを表す int

_request

public Request _request(String operation)
Dynamic Invocation Interface で使用可能な指定されたメソッドを含む Request オブジェクトを作成します。

定義:
インタフェース Object 内の _request
パラメータ:
operation - 新しい Request オブジェクトにより呼び出されるメソッド
戻り値:
指定されたメソッドで初期化された新しい Request オブジェクト

_create_request

public Request _create_request(Context ctx,
                               String operation,
                               NVList arg_list,
                               NamedValue result)
指定されたコンテキスト、メソッド、引数リスト、および結果のコンテナを格納する Request オブジェクトを作成します。

定義:
インタフェース Object 内の _create_request
パラメータ:
ctx - 要求のコンテキスト
operation - 新しい Request オブジェクトが呼び出すメソッド
arg_list - メソッドの引数で、各引数が NamedValue オブジェクトである NVList
result - 要求されたメソッドの実行結果を返すために使用される NamedValue オブジェクト
戻り値:
指定されたコンテキスト、メソッド、引数リスト、および戻り値のコンテナで初期化された新しい Request オブジェクト
関連項目:
Request, NVList, NamedValue

_create_request

public Request _create_request(Context ctx,
                               String operation,
                               NVList arg_list,
                               NamedValue result,
                               ExceptionList exceptions,
                               ContextList contexts)
指定されたコンテキスト、メソッド、引数リスト、結果のコンテナ、例外、およびコンテキスト文字列の解決に使用されるプロパティ名のリストを格納する Request オブジェクトを作成します。この Request オブジェクトは、Dynamic Invocation Interface で使用されます。

定義:
インタフェース Object 内の _create_request
パラメータ:
ctx - 要求とともに送信する前に解決する必要のあるコンテキスト文字列を格納する Context オブジェクト
operation - 新しい Request オブジェクトが呼び出すメソッド
arg_list - メソッドの引数で、各引数が NamedValue オブジェクトである NVList
result - 要求されたメソッドの実行結果を返すために使用される NamedValue オブジェクト
exceptions - 指定されたメソッドがスローする例外のリスト
contexts - ctx のコンテキストの解決に必要なプロパティのリスト。コンテキスト内の文字列は、指定されたプロパティに関連した値を返す Context.get_values メソッドへの引数として使用される
戻り値:
解決の必要な指定されたコンテキスト文字列、メソッド、引数リスト、結果のコンテナ、例外、およびコンテキスト文字列の解決で使用されるプロパティ名のリストで初期化された新しい Request オブジェクト
関連項目:
Request, NVList, NamedValue, ExceptionList, ContextList

_get_interface_def

public Object _get_interface_def()
この ObjectImpl オブジェクトのインタフェース定義を取得します。

定義:
インタフェース Object 内の _get_interface_def
戻り値:
この ObjectImpl オブジェクトのインタフェース定義である org.omg.CORBA.Object インスタンス

_orb

public ORB _orb()
このオブジェクトとその委譲に関連する ORB への参照を返します。これは委譲を作成した ORB オブジェクトです。

戻り値:
この ObjectImpl に格納されている Delegate オブジェクトを生成した ORB インスタンス

_get_policy

public Policy _get_policy(int policy_type)
指定されたポリシー型を保持するこの ObjectImpl オブジェクトの Policy オブジェクトを取得します。

定義:
インタフェース Object 内の _get_policy
パラメータ:
policy_type - ポリシー型を示す int
戻り値:
指定されたポリシー型であり、この ObjectImpl オブジェクトに適用される Policy オブジェクト
関連項目:
PolicyOperations.policy_type()

_get_domain_managers

public DomainManager[] _get_domain_managers()
この ObjectImpl オブジェクトのドメインマネージャのリストを取得します。

定義:
インタフェース Object 内の _get_domain_managers
戻り値:
この ObjectImpl インスタンスの DomainManager オブジェクトを格納する配列

_set_policy_override

public Object _set_policy_override(Policy[] policies,
                                   SetOverrideType set_add)
この ObjectImpl オブジェクトの指定されたポリシー用のオーバーライド型を、指定された SetOverrideType インスタンスに設定します。

定義:
インタフェース Object 内の _set_policy_override
パラメータ:
policies - 現行のポリシーと置き換える、または現行のポリシーに追加するポリシーを保持する Policy オブジェクトの配列
set_add - 指定したポリシーが既存のポリシーと置換されることを示す SetOverrideType.SET_OVERRIDE、または指定したポリシーが既存のポリシーに追加されることを示す SetOverrideType.ADD_OVERRIDE
戻り値:
以前のポリシーと置き換える、または以前のポリシーに追加する、指定されたポリシーの Object

_is_local

public boolean _is_local()
この ObjectImpl オブジェクトがローカルサーバントにより実装されているかどうかを判定します。実装されている場合は、ローカル呼び出し API を使用できます。

戻り値:
このオブジェクトがローカルサーバントにより実装されている場合は true、そうでない場合は false

_servant_preinvoke

public ServantObject _servant_preinvoke(String operation,
                                        Class expectedType)
指定されたメソッドの要求送信に使用されるローカルサーバントへの Java 参照を返します。この ObjectImpl オブジェクトがローカルスタブの場合、_servant_preinvoke メソッドを呼び出してから、使用する ServantObject インスタンスを取得するための要求を送信します。

ServantObject オブジェクトが返される場合、その servant フィールドは予期される型のオブジェクトに設定されます (注: オブジェクトは実際のサーバントインスタンスの場合もそうでない場合もある)。ローカルスタブによりサーバントフィールドが予期される型にキャストされ、操作が直接呼び出されます。ServantRequest オブジェクトは 1 つの呼び出しにのみ有効で、複数の呼び出しには使用できません。

パラメータ:
operation - 呼び出されるメソッドの名前を格納する String。この名前は GIOP 要求で符号化されるため、メソッド名に対応する必要がある
expectedType - 返されるサーバントの予期される型を表す Class オブジェクト。この予期される型は、スタブのインタフェースの操作クラスに関連する Class オブジェクトである。たとえば、Foo インタフェースのスタブは FooOperations インタフェースの Class オブジェクトを渡す
戻り値:
(1) ServantObject オブジェクト (実際のサーバントインスタンスの場合もそうでない場合もある)。(2) (a) サーバントがローカルでない、または (b) POA ServantManagert からの ForwardRequest によりローカルでなくなった場合は null
例外:
BAD_PARAM - サーバントが予期する型でない場合

_servant_postinvoke

public void _servant_postinvoke(ServantObject servant)
_servant_preinvoke メソッドの呼び出しで以前に取得されたローカルサーバントに対し、操作を呼び出したあとでローカルスタブにより呼び出されます。_servant_preinvoke メソッドが null 以外の値を返す場合は、サーバントで呼び出されたメソッドから例外がスローされても _servant_postinvoke メソッドを呼び出す必要があります。この理由のため、_servant_postinvoke メソッドの呼び出しは Java finally 節に配置する必要があります。

パラメータ:
servant - _servant_preinvoke から返される ServantObject のインスタンス

_request

public OutputStream _request(String operation,
                             boolean responseExpected)
指定されたメソッドの引数の整列化に使用する OutputStream オブジェクトを返します。このメソッドはスタブにより呼び出され、応答が予期されるかどうか、つまり呼び出しが一方向かどうかを示す必要があります。

パラメータ:
operation - メソッドの名前を指定する String
responseExpected - boolean -- 要求が一方向でない場合、つまり応答が予期される場合は true
戻り値:
要求をディスパッチするための OutputStream オブジェクト

_invoke

public InputStream _invoke(OutputStream output)
                    throws ApplicationException,
                           RemarshalException
操作を呼び出して、応答を読み込むための InputStream オブジェクトを返します。このスタブにより、以前に _request メソッドの呼び出しで返された OutputStream オブジェクトが提供されます。このメソッドが呼び出すメソッドは、以前の呼び出しで _request への引数として指定されたメソッドです。

例外が発生すると、_invoke メソッドは、ユーザ例外状態が非整列化される場合がある InputStream を格納する ApplicationException オブジェクトをスローする場合があります。

パラメータ:
output - 要求をディスパッチする OutputStream オブジェクト
戻り値:
呼び出されたメソッドの整列化された応答を格納する InputStream オブジェクト
例外:
ApplicationException - 呼び出しがアプリケーション定義の例外と一致する場合
RemarshalException - 呼び出しにより再整列化エラーとなる場合
関連項目:
_request(java.lang.String)

_releaseReply

public void _releaseReply(InputStream input)
_invoke メソッドの呼び出し後、非整列化が完了したときに、指定された応答ストリームを ORB に解放します。スタブの場合、このメソッドの呼び出しは任意です。

パラメータ:
input - _invoke メソッドまたは ApplicationException.getInputStream メソッドから返された InputStream オブジェクト。null の場合があり、この場合はこのメソッドは何も実行しない
関連項目:
_invoke(org.omg.CORBA.portable.OutputStream)

toString

public String toString()
この ObjectImpl オブジェクトを表す String を返します。

オーバーライド:
クラス Object 内の toString
戻り値:
このオブジェクトの String 表現

hashCode

public int hashCode()
この ObjectImpl オブジェクトのハッシュコードを返します。

オーバーライド:
クラス Object 内の hashCode
戻り値:
このオブジェクトのハッシュコード
関連項目:
Object.equals(java.lang.Object), Hashtable

equals

public boolean equals(Object obj)
この ObjectImpl オブジェクトと指定されたオブジェクトの等価性を比較します。

オーバーライド:
クラス Object 内の equals
パラメータ:
obj - このオブジェクトと比較するオブジェクト @return オブジェクトが等しい場合は true、そうでない場合は false
戻り値:
obj 引数に指定されたオブジェクトとこのオブジェクトが等しい場合は true、そうでない場合は false
関連項目:
Object.hashCode(), Hashtable

JavaTM 2 Platform
Standard Ed. 5.0

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java 2 SDK SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。