JavaTM 2 Platform
Standard Ed. 5.0

org.omg.CORBA
クラス LocalObject

java.lang.Object
  上位を拡張 org.omg.CORBA.LocalObject
すべての実装されたインタフェース:
Object

public class LocalObject
extends Object
implements Object

Java 言語マッピングで、ローカル IDL インタフェースの実装基底クラスとして使用されます。これは、org.omg.CORBA.Object インタフェースのオペレーションすべてを実装するクラスです。

ローカルインタフェースは CORBA::LocalObject を使用して実装され、この種のオブジェクトに適した Object 擬似オペレーションおよびその他の ORB 固有サポート機構を実装します。オブジェクト実装技法は、本質的に言語マッピング固有です。したがって、LocalObject 型は IDL では定義されず、各言語マッピングで指定されます。

ローカルオブジェクトに適用されないメソッドは、「This is a locally contrained object.」というメッセージと共に org.omg.CORBA.NO_IMPLEMENT 例外をスローします。LocalObject を使用して DII 要求の作成を試みると NO_IMPLEMENT システム例外がスローされ、LocalObject の整列化または文字列化を試みると MARSHAL システム例外がスローされます。LocalObjects のナロー参照およびワイド参照は、通常のオブジェクト参照の場合と同じように動作する必要があります。

LocalObject は、PortableServer モジュールの場合のようにローカルに制約されるオブジェクトの基底クラスとして使用されます。この仕様は CORBA Components Volume I - orbos/99-07-01 に基づいています。

関連項目:
CORBA パッケージに実装されていない機能についてのコメント

コンストラクタの概要
LocalObject()
          デフォルトの LocalObject インスタンスを構築します。
 
メソッドの概要
 Request _create_request(Context ctx, String operation, NVList arg_list, NamedValue result)
          「This is a locally constrained object.」というメッセージと共に org.omg.CORBA.NO_IMPLEMENT 例外をスローします。
 Request _create_request(Context ctx, String operation, NVList arg_list, NamedValue result, ExceptionList exceptions, ContextList contexts)
          「This is a locally constrained object.」というメッセージと共に org.omg.CORBA.NO_IMPLEMENT 例外をスローします。
 Object _duplicate()
          「This is a locally constrained object.」というメッセージと共に org.omg.CORBA.NO_IMPLEMENT 例外をスローします。
 DomainManager[] _get_domain_managers()
          「This is a locally constrained object.」というメッセージと共に org.omg.CORBA.NO_IMPLEMENT 例外をスローします。
 Object _get_interface_def()
          「This is a locally constrained object.」というメッセージと共に org.omg.CORBA.NO_IMPLEMENT 例外をスローします。
 Object _get_interface()
          「This is a locally constrained object.」というメッセージと共に org.omg.CORBA.NO_IMPLEMENT 例外をスローします。
 Policy _get_policy(int policy_type)
          「This is a locally constrained object.」というメッセージと共に org.omg.CORBA.NO_IMPLEMENT 例外をスローします。
 int _hash(int maximum)
          指定された数を最大値として、オブジェクトの有効期間内で一貫したハッシュ値を返します。
 InputStream _invoke(OutputStream output)
          「This is a locally constrained object.」というメッセージと共に org.omg.CORBA.NO_IMPLEMENT 例外をスローします。
 boolean _is_a(String repository_id)
          「This is a locally constrained object.」というメッセージと共に org.omg.CORBA.NO_IMPLEMENT 例外をスローします。
 boolean _is_equivalent(Object that)
          2 つのオブジェクト参照が等価かどうかを判定します。
 boolean _is_local()
          「This is a locally constrained object.」というメッセージと共に org.omg.CORBA.NO_IMPLEMENT 例外をスローします。
 boolean _non_existent()
          常に false を返します。
 ORB _orb()
          「This is a locally constrained object.」というメッセージと共に org.omg.CORBA.NO_IMPLEMENT 例外をスローします。
 void _release()
          「This is a locally constrained object.」というメッセージと共に org.omg.CORBA.NO_IMPLEMENT 例外をスローします。
 void _releaseReply(InputStream input)
          「This is a locally constrained object.」というメッセージと共に org.omg.CORBA.NO_IMPLEMENT 例外をスローします。
 Request _request(String operation)
          「This is a locally constrained object.」というメッセージと共に org.omg.CORBA.NO_IMPLEMENT 例外をスローします。
 OutputStream _request(String operation, boolean responseExpected)
          「This is a locally constrained object.」というメッセージと共に org.omg.CORBA.NO_IMPLEMENT 例外をスローします。
 void _servant_postinvoke(ServantObject servant)
          「This is a locally constrained object.」というメッセージと共に org.omg.CORBA.NO_IMPLEMENT 例外をスローします。
 ServantObject _servant_preinvoke(String operation, Class expectedType)
          「This is a locally constrained object.」というメッセージと共に org.omg.CORBA.NO_IMPLEMENT 例外をスローします。
 Object _set_policy_override(Policy[] policies, SetOverrideType set_add)
          「This is a locally constrained object.」というメッセージと共に org.omg.CORBA.NO_IMPLEMENT 例外をスローします。
 boolean validate_connection()
          「This is a locally constrained object.」というメッセージと共に org.omg.CORBA.NO_IMPLEMENT 例外をスローします。
 
クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

コンストラクタの詳細

LocalObject

public LocalObject()
デフォルトの LocalObject インスタンスを構築します。

メソッドの詳細

_is_equivalent

public boolean _is_equivalent(Object that)

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

org.omg.CORBA.Object のメソッドに対するデフォルトの実装です。

定義:
インタフェース Object 内の _is_equivalent
パラメータ:
that - 等価の確認対象となるオブジェクト参照
戻り値:
このオブジェクト参照が指定されたオブジェクト参照と等価であると判定された場合は true。ただし false の場合は、2 つのオブジェクト参照が別のものであることだけを示し、別々のオブジェクトを参照することを示すとは限らない

_non_existent

public boolean _non_existent()
常に false を返します。このメソッドは org.omg.CORBA.Object メソッドのデフォルト実装です。

定義:
インタフェース Object 内の _non_existent
戻り値:
false

_hash

public int _hash(int maximum)
指定された数を最大値として、オブジェクトの有効期間内で一貫したハッシュ値を返します。このメソッドは org.omg.CORBA.Object メソッドのデフォルト実装です。

定義:
インタフェース Object 内の _hash
パラメータ:
maximum - ハッシュコードの最大値を示す int
戻り値:
このインスタンスのハッシュコード

_is_a

public boolean _is_a(String repository_id)
「This is a locally constrained object.」というメッセージと共に org.omg.CORBA.NO_IMPLEMENT 例外をスローします。このメソッドはローカルオブジェクトに適用されないため、実装されません。このメソッドは org.omg.CORBA.Object メソッドのデフォルト実装です。

定義:
インタフェース Object 内の _is_a
パラメータ:
repository_id - String
戻り値:
NO_IMPLEMENT。これはローカルに制約されるオブジェクトであり、このメソッドはローカルオブジェクトには適用されないため
例外:
NO_IMPLEMENT - これはローカルに制約されるオブジェクトであり、このメソッドはローカルオブジェクトには適用されないため
関連項目:
CORBA パッケージに実装されていない機能についてのコメント

_duplicate

public Object _duplicate()
「This is a locally constrained object.」というメッセージと共に org.omg.CORBA.NO_IMPLEMENT 例外をスローします。このメソッドは org.omg.CORBA.Object メソッドのデフォルトの実装です。

定義:
インタフェース Object 内の _duplicate
戻り値:
この LocalObject インスタンスの複製
例外:
NO_IMPLEMENT
関連項目:
CORBA パッケージに実装されていない機能についてのコメント

_release

public void _release()
「This is a locally constrained object.」というメッセージと共に org.omg.CORBA.NO_IMPLEMENT 例外をスローします。このメソッドは org.omg.CORBA.Object メソッドのデフォルトの実装です。

定義:
インタフェース Object 内の _release
例外:
NO_IMPLEMENT
関連項目:
CORBA パッケージに実装されていない機能についてのコメント

_request

public Request _request(String operation)
「This is a locally constrained object.」というメッセージと共に org.omg.CORBA.NO_IMPLEMENT 例外をスローします。このメソッドは org.omg.CORBA.Object メソッドのデフォルトの実装です。

定義:
インタフェース Object 内の _request
パラメータ:
operation - 返された要求により実行されるオペレーション名を指定する String
戻り値:
オペレーションの指定された Request オブジェクト
例外:
NO_IMPLEMENT
関連項目:
CORBA パッケージに実装されていない機能についてのコメント

_create_request

public Request _create_request(Context ctx,
                               String operation,
                               NVList arg_list,
                               NamedValue result)
「This is a locally constrained object.」というメッセージと共に org.omg.CORBA.NO_IMPLEMENT 例外をスローします。このメソッドは org.omg.CORBA.Object メソッドのデフォルトの実装です。

定義:
インタフェース Object 内の _create_request
パラメータ:
ctx - プロパティのリストを格納している Context オブジェクト
operation - 呼び出されるメソッドの名前を表す String
arg_list - 呼び出されるメソッドの実際の引数を格納している NVList
result - メソッドの戻り値のコンテナとして機能する NamedValue オブジェクト
戻り値:
指定された引数で初期化された新しい Request オブジェクト
例外:
NO_IMPLEMENT
関連項目:
CORBA パッケージに実装されていない機能についてのコメント

_create_request

public Request _create_request(Context ctx,
                               String operation,
                               NVList arg_list,
                               NamedValue result,
                               ExceptionList exceptions,
                               ContextList contexts)
「This is a locally constrained object.」というメッセージと共に org.omg.CORBA.NO_IMPLEMENT 例外をスローします。このメソッドは org.omg.CORBA.Object メソッドのデフォルトの実装です。

定義:
インタフェース Object 内の _create_request
パラメータ:
ctx - プロパティのリストを格納している Context オブジェクト
operation - 呼び出されるメソッドの名前
arg_list - 呼び出されるメソッドの実際の引数を格納している NVList
result - メソッドの戻り値のコンテナとして機能する NamedValue オブジェクト
exceptions - メソッドによってスローされる例外のリストを格納している ExceptionList オブジェクト
contexts - Request のインスタンスで解決して送る必要があるコンテキスト文字列のリストを格納している ContextList オブジェクト
戻り値:
指定された引数で初期化された新しい Request オブジェクト
例外:
NO_IMPLEMENT
関連項目:
CORBA パッケージに実装されていない機能についてのコメント

_get_interface

public Object _get_interface()
「This is a locally constrained object.」というメッセージと共に org.omg.CORBA.NO_IMPLEMENT 例外をスローします。このメソッドはローカルオブジェクトに適用されないため、実装されません。このメソッドは org.omg.CORBA.Object メソッドのデフォルト実装です。

戻り値:
NO_IMPLEMENT。これはローカルに制約されるオブジェクトであり、このメソッドはローカルオブジェクトには適用されないため
例外:
NO_IMPLEMENT - これはローカルに制約されるオブジェクトであり、このメソッドはローカルオブジェクトには適用されないため
関連項目:
CORBA パッケージに実装されていない機能についてのコメント

_get_interface_def

public Object _get_interface_def()
「This is a locally constrained object.」というメッセージと共に org.omg.CORBA.NO_IMPLEMENT 例外をスローします。このメソッドは org.omg.CORBA.Object メソッドのデフォルトの実装です。

定義:
インタフェース Object 内の _get_interface_def
戻り値:
このオブジェクト参照が参照するオブジェクトの型情報を提供するインタフェースリポジトリ内の InterfaceDef オブジェクト
例外:
NO_IMPLEMENT
関連項目:
CORBA パッケージに実装されていない機能についてのコメント

_orb

public ORB _orb()
「This is a locally constrained object.」というメッセージと共に org.omg.CORBA.NO_IMPLEMENT 例外をスローします。このメソッドは org.omg.CORBA.Object メソッドのデフォルトの実装です。

戻り値:
この ObjectImpl に格納されている Delegate を作成した ORB インスタンス
例外:
NO_IMPLEMENT
関連項目:
CORBA パッケージに実装されていない機能についてのコメント

_get_policy

public Policy _get_policy(int policy_type)
「This is a locally constrained object.」というメッセージと共に org.omg.CORBA.NO_IMPLEMENT 例外をスローします。このメソッドはローカルオブジェクトに適用されないため、実装されません。このメソッドは org.omg.CORBA.Object メソッドのデフォルト実装です。

定義:
インタフェース Object 内の _get_policy
パラメータ:
policy_type - int
戻り値:
NO_IMPLEMENT。これはローカルに制約されるオブジェクトであり、このメソッドはローカルオブジェクトには適用されないため
例外:
NO_IMPLEMENT - これはローカルに制約されるオブジェクトであり、このメソッドはローカルオブジェクトには適用されないため
関連項目:
CORBA パッケージに実装されていない機能についてのコメント

_get_domain_managers

public DomainManager[] _get_domain_managers()
「This is a locally constrained object.」というメッセージと共に org.omg.CORBA.NO_IMPLEMENT 例外をスローします。このメソッドはローカルオブジェクトに適用されないため、実装されません。このメソッドは org.omg.CORBA.Object メソッドのデフォルト実装です。

定義:
インタフェース Object 内の _get_domain_managers
戻り値:
このオブジェクトを直接囲むドメインマネージャのリスト。各オブジェクトは作成時にデフォルトで 1 つ以上のドメインマネージャに関連するので、このリストでは常に 1 つ以上のドメインマネージャが返される
例外:
NO_IMPLEMENT
関連項目:
CORBA パッケージに実装されていない機能についてのコメント

_set_policy_override

public Object _set_policy_override(Policy[] policies,
                                   SetOverrideType set_add)
「This is a locally constrained object.」というメッセージと共に org.omg.CORBA.NO_IMPLEMENT 例外をスローします。このメソッドはローカルオブジェクトに適用されないため、実装されません。このメソッドは org.omg.CORBA.Object メソッドのデフォルト実装です。

定義:
インタフェース Object 内の _set_policy_override
パラメータ:
policies - 配列
set_add - フラグ
戻り値:
NO_IMPLEMENT。これはローカルに制約されるオブジェクトであり、このメソッドはローカルオブジェクトには適用されないため
例外:
NO_IMPLEMENT - これはローカルに制約されるオブジェクトであり、このメソッドはローカルオブジェクトには適用されないため
関連項目:
CORBA パッケージに実装されていない機能についてのコメント

_is_local

public boolean _is_local()
「This is a locally constrained object.」というメッセージと共に org.omg.CORBA.NO_IMPLEMENT 例外をスローします。このメソッドは org.omg.CORBA.Object メソッドのデフォルトの実装です。

この LocalObject インスタンスについて true を返します。

戻り値:
常に true
例外:
NO_IMPLEMENT
関連項目:
CORBA パッケージに実装されていない機能についてのコメント

_servant_preinvoke

public ServantObject _servant_preinvoke(String operation,
                                        Class expectedType)
「This is a locally constrained object.」というメッセージと共に org.omg.CORBA.NO_IMPLEMENT 例外をスローします。このメソッドは org.omg.CORBA.Object メソッドのデフォルトの実装です。

パラメータ:
operation - 事前に呼び出すオペレーションを示す String
expectedType - 上記のオペレーションタイプのクラス@return NO_IMPLEMENT。これはローカルに制約されるオブジェクトであり、このメソッドはローカルオブジェクトには適用されないため
例外:
NO_IMPLEMENT - これはローカルに制約されるオブジェクトであり、このメソッドはローカルオブジェクトには適用されないため
関連項目:
CORBA パッケージに実装されていない機能についてのコメント

_servant_postinvoke

public void _servant_postinvoke(ServantObject servant)
「This is a locally constrained object.」というメッセージと共に org.omg.CORBA.NO_IMPLEMENT 例外をスローします。このメソッドは org.omg.CORBA.Object メソッドのデフォルトの実装です。

パラメータ:
servant - 後で呼び出すサーバントオブジェクト
例外:
NO_IMPLEMENT
関連項目:
CORBA パッケージに実装されていない機能についてのコメント

_request

public OutputStream _request(String operation,
                             boolean responseExpected)
「This is a locally constrained object.」というメッセージと共に org.omg.CORBA.NO_IMPLEMENT 例外をスローします。このメソッドは org.omg.CORBA.Object メソッドのデフォルトの実装です。

引数を整列化するための OutputStream を取得する目的で、スタブによって呼び出されます。スタブは、オペレーション名を提供し、応答が予期されるかどうか (つまり、これが一方向の呼び出しであるかどうか) を示す必要があります。

パラメータ:
operation - 要求されるオペレーションの名前
responseExpected - 応答が予期される場合は true、一方向の呼び出しの場合は false
戻り値:
NO_IMPLEMENT。これはローカルに制約されるオブジェクトであり、このメソッドはローカルオブジェクトには適用されないため
例外:
NO_IMPLEMENT - これはローカルに制約されるオブジェクトであり、このメソッドはローカルオブジェクトには適用されないため
関連項目:
CORBA パッケージに実装されていない機能についてのコメント

_invoke

public InputStream _invoke(OutputStream output)
                    throws ApplicationException,
                           RemarshalException
「This is a locally constrained object.」というメッセージと共に org.omg.CORBA.NO_IMPLEMENT 例外をスローします。このメソッドは org.omg.CORBA.Object メソッドのデフォルトの実装です。

オペレーションを呼び出す場合にコールされます。スタブは、_request() 呼び出しによって以前に返された OutputStream を提供します。_invoke は、整列化された応答が格納されている InputStream を返します。例外が発生した場合、_invoke は、ユーザ例外状態の非整列化に関係する InputStream を含む ApplicationException オブジェクトをスローすることがあります。

パラメータ:
output - 呼び出す OutputStream
戻り値:
NO_IMPLEMENT。これはローカルに制約されるオブジェクトであり、このメソッドはローカルオブジェクトには適用されないため
例外:
ApplicationException - 例外が発生すると、_invokeApplicationException オブジェクトをスローする場合があります。ApplicationException オブジェクトには、ユーザ例外状態の非整列化に関係する InputStream が含まれます。
RemarshalException - 例外が発生すると、_invokeApplicationException オブジェクトをスローする場合があります。ApplicationException オブジェクトには、ユーザ例外状態の非整列化に関係する InputStream が含まれます。
NO_IMPLEMENT - これはローカルに制約されるオブジェクトであり、このメソッドはローカルオブジェクトには適用されないため
関連項目:
CORBA パッケージに実装されていない機能についてのコメント

_releaseReply

public void _releaseReply(InputStream input)
「This is a locally constrained object.」というメッセージと共に org.omg.CORBA.NO_IMPLEMENT 例外をスローします。このメソッドは org.omg.CORBA.Object メソッドのデフォルトの実装です。

非整列化が完了したときに ORB へ戻される応答ストリームを解放するために、必要に応じて、スタブによって呼び出されることがあります。スタブは _invoke() または ApplicationException.getInputStream() によって返された InputStream を渡します。また、null 値も _releaseReply に渡されることがあり、その場合このメソッドは何も行いません。

パラメータ:
input - ORB に戻される応答ストリーム、または null
例外:
NO_IMPLEMENT
関連項目:
CORBA パッケージに実装されていない機能についてのコメント

validate_connection

public boolean validate_connection()
「This is a locally constrained object.」というメッセージと共に org.omg.CORBA.NO_IMPLEMENT 例外をスローします。このメソッドはローカルオブジェクトに適用されないため、実装されません。このメソッドは org.omg.CORBA.Object メソッドのデフォルト実装です。

戻り値:
NO_IMPLEMENT。これはローカルに制約されるオブジェクトであり、このメソッドはローカルオブジェクトには適用されないため
例外:
NO_IMPLEMENT - これはローカルに制約されるオブジェクトであり、このメソッドはローカルオブジェクトには適用されないため
関連項目:
CORBA パッケージに実装されていない機能についてのコメント

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 も参照してください。