Delegate (Java Platform SE 7)

java.lang.Object
- org.omg.CORBA.portable.Delegate

直系の既知のサブクラス:

Delegate
```
public abstract class Delegate
extends Object
```
ORB ベンダー固有の org.omg.CORBA.Object メソッドを実装するためのポータブル API を指定します。各スタブ (プロキシ) は、すべての org.omg.CORBA.Object メソッドの転送先となる委譲オブジェクトを格納します。これにより、あるベンダーの ORB によって生成されたスタブが、ほかのベンダーの ORB からの委譲オブジェクトとともに動作できます。

関連項目:
Object

コンストラクタのサマリー

コンストラクタ
コンストラクタと説明

Delegate()

コンストラクタ
コンストラクタと説明
`Delegate()`

メソッドのサマリー

メソッド
修飾子と型	メソッドと説明
`abstract Request`	`create_request(Object obj, Context ctx, String operation, NVList arg_list, NamedValue result)` Dynamic Invocation Interface で使用される Request のインタフェースを作成します。
`abstract Request`	`create_request(Object obj, Context ctx, String operation, NVList arg_list, NamedValue result, ExceptionList exclist, ContextList ctxlist)` Dynamic Invocation Interface で使用される Request のインタフェースを作成します。
`abstract Object`	`duplicate(Object obj)` 指定されたオブジェクト参照の複製を返します。
`boolean`	`equals(Object self, Object obj)` 委譲 CORBA オブジェクトの equals(java.lang.Object obj) メソッドをオーバーライドする実装を提供します。
`DomainManager[]`	`get_domain_managers(Object self)` このオブジェクトの `DomainManagers` を取り出します。
`abstract Object`	`get_interface_def(Object self)` 指定されたオブジェクト参照の InterfaceDef を返します。
`Policy`	`get_policy(Object self, int policy_type)` このオブジェクトに適用する、指定された型の `Policy` オブジェクトを返します。
`abstract int`	`hash(Object obj, int max)` このオブジェクト参照の ORB 内部識別子 (ハッシュコード) を返します。
`int`	`hashCode(Object self)` 委譲 CORBA オブジェクトの hashCode() メソッドをオーバーライドする実装を提供します。
`InputStream`	`invoke(Object self, OutputStream output)` invoke は操作を呼び出すためにスタブによって呼び出されます。
`abstract boolean`	`is_a(Object obj, String repository_id)` オブジェクト参照が、指定されたインタフェースのインスタンスであるかどうかを判定します。
`abstract boolean`	`is_equivalent(Object obj, Object other)` 2 つのオブジェクト参照が等価かどうかを判定します。
`boolean`	`is_local(Object self)` このオブジェクトがローカルサーバントによって実装される場合は true を返します。
`abstract boolean`	`non_existent(Object obj)` オブジェクト参照のサーバーオブジェクトが破棄されているかどうかを判定します。
`ORB`	`orb(Object obj)` パラメータに関連した orb への参照を提供します。
`abstract void`	`release(Object obj)` 指定されたオブジェクト参照に関連したリソースを解放します。
`void`	`releaseReply(Object self, InputStream input)` releaseReply は、非整列化が完了したときに ORB へ戻される応答ストリームを解放するために、スタブによって任意に呼び出されることがあります。
`abstract Request`	`request(Object obj, String operation)` Dynamic Invocation Interface で使用される Request のインタフェースを作成します。
`OutputStream`	`request(Object self, String operation, boolean responseExpected)` request は、引数の整列化のため、OutputStream を取得する目的でスタブによって呼び出されます。
`void`	`servant_postinvoke(Object self, ServantObject servant)` servant_postinvoke() は、ローカルサーバントでこの操作が呼び出されたあとで、ローカルスタブによって呼び出されます。
`ServantObject`	`servant_preinvoke(Object self, String operation, Class expectedType)` この要求で使用される必要があるサーバントへの Java 参照を返します。
`Object`	`set_policy_override(Object self, Policy[] policies, SetOverrideType set_add)` 渡されたポリシーを、返される新しく作成されたオブジェクト参照と関連付けます。
`String`	`toString(Object self)` 委譲 CORBA オブジェクトの toString() メソッドをオーバーライドする実装を提供します。

クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- コンストラクタの詳細
  - Delegate
```
public Delegate()
```
- メソッドの詳細
  - get_interface_def
```
public abstract Object get_interface_def(Object self)
```
    指定されたオブジェクト参照の InterfaceDef を返します。
    
    パラメータ:
    self - InterfaceDef を返す必要があるオブジェクト参照
    
    戻り値:
    InterfaceDef
  - duplicate
```
public abstract Object duplicate(Object obj)
```
    指定されたオブジェクト参照の複製を返します。
    
    パラメータ:
    obj - 複製を返す必要があるオブジェクト参照
    
    戻り値:
    複製されたオブジェクト参照
  - release
```
public abstract void release(Object obj)
```
    指定されたオブジェクト参照に関連したリソースを解放します。
    
    パラメータ:
    obj - リソースを解放する必要があるオブジェクト参照
  - is_a
```
public abstract boolean is_a(Object obj,
           String repository_id)
```
    オブジェクト参照が、指定されたインタフェースのインスタンスであるかどうかを判定します。
    
    パラメータ:
    obj - 調査対象のオブジェクト参照。
    repository_id - 調査対象のインタフェースのリポジトリ ID。
    
    戻り値:
    オブジェクト参照がインタフェースをサポートしている場合は true
  - non_existent
```
public abstract boolean non_existent(Object obj)
```
    オブジェクト参照のサーバーオブジェクトが破棄されているかどうかを判定します。
    
    パラメータ:
    obj - この委譲オブジェクトに委譲したオブジェクト参照。
    
    戻り値:
    サーバーオブジェクトが存在しないことを ORB が正式に認識している場合は true、そうでない場合は false
  - is_equivalent
```
public abstract boolean is_equivalent(Object obj,
                    Object other)
```
    2 つのオブジェクト参照が等価かどうかを判定します。
    
    パラメータ:
    obj - この委譲オブジェクトに委譲したオブジェクト参照。
    other - 等価かどうか調べる対象となるオブジェクト参照。
    
    戻り値:
    オブジェクトの CORBA が等価の場合 true。
  - hash
```
public abstract int hash(Object obj,
       int max)
```
    このオブジェクト参照の ORB 内部識別子 (ハッシュコード) を返します。
    
    パラメータ:
    obj - この委譲オブジェクトに委譲したオブジェクト参照。
    max - ORB によって返されるハッシュ値の上限。
    
    戻り値:
    オブジェクト参照の ORB 内部ハッシュ識別子
  - request
```
public abstract Request request(Object obj,
              String operation)
```
    Dynamic Invocation Interface で使用される Request のインタフェースを作成します。
    
    パラメータ:
    obj - この委譲オブジェクトに委譲したオブジェクト参照。
    operation - Request インスタンスを使って呼び出されるオペレーションの名前。
    
    戻り値:
    生成された Request のインスタンス
  - create_request
```
public abstract Request create_request(Object obj,
                     Context ctx,
                     String operation,
                     NVList arg_list,
                     NamedValue result)
```
    Dynamic Invocation Interface で使用される Request のインタフェースを作成します。
    
    パラメータ:
    obj - この委譲オブジェクトに委譲したオブジェクト参照。
    ctx - 使用されるコンテキスト。
    operation - 呼び出されるオペレーションの名前。
    arg_list - NVList 形式のオペレーションの引数。
    result - 結果が格納される、NamedValue としてのコンテナ。
    
    戻り値:
    作成された Request オブジェクト
  - create_request
```
public abstract Request create_request(Object obj,
                     Context ctx,
                     String operation,
                     NVList arg_list,
                     NamedValue result,
                     ExceptionList exclist,
                     ContextList ctxlist)
```
    Dynamic Invocation Interface で使用される Request のインタフェースを作成します。
    
    パラメータ:
    obj - この委譲オブジェクトに委譲したオブジェクト参照。
    ctx - 使用されるコンテキスト。
    operation - 呼び出されるオペレーションの名前。
    arg_list - NVList 形式のオペレーションの引数。
    result - 結果が格納される、NamedValue としてのコンテナ。
    exclist - オペレーションがスローする可能性がある例外のリスト。
    ctxlist - Request とともに解決し送信される必要があるコンテキスト文字列のリスト。
    
    戻り値:
    作成された Request オブジェクト
  - orb
```
public ORB orb(Object obj)
```
    パラメータに関連した orb への参照を提供します。
    
    パラメータ:
    obj - この委譲オブジェクトに委譲したオブジェクト参照。
    
    戻り値:
    関連した orb
    関連項目:
    portable パッケージに実装されていない機能についてのコメント
  - get_policy
```
public Policy get_policy(Object self,
                int policy_type)
```
    このオブジェクトに適用する、指定された型の Policy オブジェクトを返します。
    
    パラメータ:
    self - この委譲オブジェクトに委譲したオブジェクト参照。
    policy_type - 取得されるポリシーの型。
    
    戻り値:
    policy_type パラメータで指定された型の Policy オブジェクト。
    
    例外:
    
    BAD_PARAM - この ORB が指定された型をサポートしていないか、その型のポリシーオブジェクトがこのオブジェクトに関連していないために、ポリシー型の値が無効となる場合にスローされる。
    関連項目:
    portable パッケージに実装されていない機能についてのコメント
  - get_domain_managers
```
public DomainManager[] get_domain_managers(Object self)
```
    このオブジェクトの DomainManagers を取り出します。これにより、管理サービスやアプリケーションは、ドメインマネージャーを取り出せます。したがって、ドメインのメンバーである個々のオブジェクトに適用可能なセキュリティーとほかのポリシーを取り出せるようになります。
    
    パラメータ:
    self - この委譲オブジェクトに委譲したオブジェクト参照。
    
    戻り値:
    このオブジェクトを直接囲むドメインマネージャーのリスト。各オブジェクトは作成時にデフォルトで 1 つ以上のドメインマネージャーに関連付けられるので、このリストでは常に 1 つ以上のドメインマネージャーが返される。
    関連項目:
    portable パッケージに実装されていない機能についてのコメント
  - set_policy_override
```
public Object set_policy_override(Object self,
                         Policy[] policies,
                         SetOverrideType set_add)
```
    渡されたポリシーを、返される新しく作成されたオブジェクト参照と関連付けます。クライアント側の操作呼び出しに適合する特定のポリシーだけを、この操作を使ってオーバーライドできます。ほかのポリシーをオーバーライドしようとすると、CORBA::NO_PERMISSION 例外がスローされます。
    
    パラメータ:
    self - この委譲オブジェクトに委譲したオブジェクト参照。
    policies - Policy オブジェクトへの参照のシーケンス。
    set_add - オブジェクト参照にすでに存在する他のオーバーライドにこれらのポリシーを追加する (ADD_OVERRIDE) のか、あるいはオーバーライドされていないクリーンなオブジェクト参照に追加する (SET_OVERRIDE) のかを示す。
    
    戻り値:
    関連した新しいポリシーのある新しいオブジェクト参照。
    関連項目:
    portable パッケージに実装されていない機能についてのコメント
  - is_local
```
public boolean is_local(Object self)
```
    このオブジェクトがローカルサーバントによって実装される場合は true を返します。
    
    パラメータ:
    self - この委譲オブジェクトに委譲したオブジェクト参照。
    
    戻り値:
    このオブジェクトを生成するサーバントがこの Java VM に置かれている場合にのみ true。サーバントがローカルでない場合、あるいは ORB がこの特定のサーバントのローカルスタブをサポートしていない場合は false。is_local() のデフォルトの動作では false を返す。
  - servant_preinvoke
```
public ServantObject servant_preinvoke(Object self,
                              String operation,
                              Class expectedType)
```
    この要求で使用される必要があるサーバントへの Java 参照を返します。 servant_preinvoke() はローカルスタブによって呼び出されます。ServantObject オブジェクトが返される場合、そのサーバントフィールドは予想されるオブジェクト型に設定されています (注:オブジェクトは実際のサーバントインスタンスの場合もそうでない場合もある)。ローカルスタブによりサーバントフィールドが予期される型にキャストされ、操作が直接呼び出されます。ServantRequest オブジェクトは 1 回の呼び出しに対してだけ有効であり、複数の呼び出しに対しては使用できません。
    
    パラメータ:
    self - この委譲オブジェクトに委譲したオブジェクト参照。
    operation - 操作名が格納されている文字列。操作名は、GIOP 要求でエンコードされる操作名に対応する。
    expectedType - サーバントの予想される型を表す Class オブジェクト。予想される型は、スタブのインタフェースの操作クラスに関連した Class オブジェクト。たとえば、Foo インタフェースのスタブの場合は、FooOperations インタフェースの Class オブジェクトを渡す。
    
    戻り値:
    ServantObject オブジェクト。メソッドが、セキュリティー、トランザクションなどのためこの最適化をサポートしない場合、このメソッドは null 値を返すことがある。サーバントが予想される型でない場合、このメソッドは null を返す必要がある。
  - servant_postinvoke
```
public void servant_postinvoke(Object self,
                      ServantObject servant)
```
    servant_postinvoke() は、ローカルサーバントでこの操作が呼び出されたあとで、ローカルスタブによって呼び出されます。このメソッドは、サーバントのメソッドにより例外がスローされた場合でも、servant_preinvoke() が null 以外の値を返した場合に呼び出される必要があります。このため、servant_postinvoke() の呼び出しは、Java の finally 節に置かなければいけません。
    
    パラメータ:
    self - この委譲オブジェクトに委譲したオブジェクト参照。
    servant - servant_preinvoke() メソッドから返された ServantObject のインスタンス。
  - request
```
public OutputStream request(Object self,
                   String operation,
                   boolean responseExpected)
```
    request は、引数の整列化のため、OutputStream を取得する目的でスタブによって呼び出されます。スタブは操作名を指定し、応答が予想されるかどうか (つまり、一方向の呼び出しかどうか) を指定する必要があります。
    
    パラメータ:
    self - この委譲オブジェクトに委譲したオブジェクト参照。
    operation - 操作名が格納されている文字列。操作名は、GIOP 要求でエンコードされる操作名に対応する。
    responseExpected - オペレーションが一方向のオペレーションの場合は false、そうでない場合は true。
    
    戻り値:
    要求引数が整列化される OutputStream。
    関連項目:
    portable パッケージに実装されていない機能についてのコメント
  - invoke
```
public InputStream invoke(Object self,
                 OutputStream output)
                   throws ApplicationException,
                          RemarshalException
```
    invoke は操作を呼び出すためにスタブによって呼び出されます。このスタブは、以前に request() 呼び出しによって返された OutputStream を提供します。invoke は整列化された応答が格納される InputStream を返します。例外が発生した場合、invoke は、ユーザー例外状態が非整列化される InputStream が格納されている ApplicationException オブジェクトをスローする場合もあります。
    
    パラメータ:
    self - この委譲オブジェクトに委譲したオブジェクト参照。
    output - 整列化された引数を格納する OutputStream。
    
    戻り値:
    input 応答パラメータが非整列化される InputStream。
    
    例外:
    
    ApplicationException - 実装がリモートメソッドの一部として定義された例外を (呼び出し時に) スローする場合。
    
    RemarshalException - 非整列化が失敗した場合。
    関連項目:
    portable パッケージに実装されていない機能についてのコメント
  - releaseReply
```
public void releaseReply(Object self,
                InputStream input)
```
    releaseReply は、非整列化が完了したときに ORB へ戻される応答ストリームを解放するために、スタブによって任意に呼び出されることがあります。スタブは invoke() または ApplicationException.getInputStream() によって返された InputStream を渡します。また、null 値も releaseReply に渡されることがあり、その場合このメソッドは何も行いません。
    
    パラメータ:
    self - この委譲オブジェクトに委譲したオブジェクト参照。
    input - invoke() から返される InputStream。
    関連項目:
    portable パッケージに実装されていない機能についてのコメント
  - toString
```
public String toString(Object self)
```
    委譲 CORBA オブジェクトの toString() メソッドをオーバーライドする実装を提供します。
    
    パラメータ:
    self - この委譲オブジェクトに委譲したオブジェクト参照。
    
    戻り値:
    この Delegate オブジェクトに委譲したオブジェクト参照を表す String オブジェクト
  - hashCode
```
public int hashCode(Object self)
```
    委譲 CORBA オブジェクトの hashCode() メソッドをオーバーライドする実装を提供します。
    
    パラメータ:
    self - この委譲オブジェクトに委譲したオブジェクト参照。
    
    戻り値:
    この Delegate オブジェクトに委譲したオブジェクト参照を表す int
  - equals
```
public boolean equals(Object self,
             Object obj)
```
    委譲 CORBA オブジェクトの equals(java.lang.Object obj) メソッドをオーバーライドする実装を提供します。
    
    パラメータ:
    self - この委譲オブジェクトに委譲したオブジェクト参照。
    obj - 比較対象の Object。
    
    戻り値:
    obj が self の場合は true、それ以外の場合は false

バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.

クラス Delegate

コンストラクタのサマリー

メソッドのサマリー

クラス java.lang.Object から継承されたメソッド

コンストラクタの詳細

Delegate

メソッドの詳細

get_interface_def

duplicate

release

is_a

non_existent

is_equivalent

hash

request

create_request

create_request

orb

get_policy

get_domain_managers

set_policy_override

is_local

servant_preinvoke

servant_postinvoke

request

invoke

releaseReply

toString

hashCode

equals