org.omg.PortableInterceptor

インタフェースClientRequestInfoOperations

すべてのスーパー・インタフェース:

RequestInfoOperations

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

ClientRequestInfo

public interface ClientRequestInfoOperations
extends RequestInfoOperations

クライアント側の要求インタセプタがアクセスできる要求情報です。

ClientRequestInfoに対する一部の属性や操作は、すべての遮断点で有効であるとは限りません。次の表に、各属性または操作の有効性を示します。有効でない属性や操作にアクセスしようとすると、標準マイナー・コード14が設定されたBAD_INV_ORDERがスローされます。

	send_request	send_poll	receive_reply	receive_exception	receive_other
RequestInfoから継承される:
request_id	はい	はい	はい	はい	はい
operation	はい	はい	はい	はい	はい
arguments	はい1	いいえ	はい	いいえ	いいえ
exceptions	はい	いいえ	はい	はい	はい
contexts	はい	いいえ	はい	はい	はい
operation_context	はい	いいえ	はい	はい	はい
result	いいえ	いいえ	はい	いいえ	いいえ
response_expected	はい	はい	はい	はい	はい
sync_scope	はい	いいえ	はい	はい	はい
reply_status	いいえ	いいえ	はい	はい	はい
forward_reference	いいえ	いいえ	いいえ	いいえ	はい2
get_slot	はい	はい	はい	はい	はい
get_request_service_context	はい	いいえ	はい	はい	はい
get_reply_service_context	いいえ	いいえ	はい	はい	はい
ClientRequestInfo固有:
target	はい	はい	はい	はい	はい
effective_target	はい	はい	はい	はい	はい
effective_profile	はい	はい	はい	はい	はい
received_exception	いいえ	いいえ	いいえ	はい	いいえ
received_exception_id	いいえ	いいえ	いいえ	はい	いいえ
get_effective_component	はい	いいえ	はい	はい	はい
get_effective_components	はい	いいえ	はい	はい	はい
get_request_policy	はい	いいえ	はい	はい	はい
add_request_service_context	はい	いいえ	いいえ	いいえ	いいえ

1. ClientRequestInfoがsend_requestに渡されるときは、各引数のリストにin、inout、outのどれかのエントリがあります。しかし、使用できるのはinとinoutの引数だけです。
2. reply_status属性がLOCATION_FORWARDでない場合は、この属性にアクセスすると、標準マイナー・コード14が設定されたBAD_INV_ORDERがスローされます。

関連項目:

ClientRequestInterceptor

メソッドのサマリー

修飾子と型	メソッドと説明
void	add_request_service_context(ServiceContext service_context, boolean replace) インタセプタがサービス・コンテキストを要求に追加できるようにします。
TaggedProfile	effective_profile() 要求の送信に使用されるプロファイルを返します。
Object	effective_target() オペレーションの呼出しの対象となる実際オブジェクトを返します。
TaggedComponent	get_effective_component(int id) このリクエストに対して選択されたプロファイルから、指定されたIDを持つIOP.TaggedComponentを返します。
TaggedComponent[]	get_effective_components(int id) この要求に対して選択されたプロファイルから、指定されたIDを持つすべてのタグ付きコンポーネントの配列を返します。
Policy	get_request_policy(int type) このオペレーションに対して有効になっている指定されたポリシーを返します。
String	received_exception_id() クライアントに返される例外のリポジトリIDを返します。
Any	received_exception() クライアントに返される例外を格納するanyを返します。
Object	target() オペレーションを実行するためにクライアントが呼び出したオブジェクトを返します。

インタフェース org.omg.PortableInterceptor.RequestInfoOperationsから継承されたメソッド

arguments, contexts, exceptions, forward_reference, get_reply_service_context, get_request_service_context, get_slot, operation_context, operation, reply_status, request_id, response_expected, result, sync_scope

メソッドの詳細

target

Object target()

オペレーションを実行するためにクライアントが呼び出したオブジェクトを返します。

関連項目:

effective_target()

effective_target

Object effective_target()

オペレーションの呼出しの対象となる実際オブジェクトを返します。reply_statusがLOCATION_FORWARDの場合は、後続のリクエストで、effective_targetには転送されたIORが格納されますが、ターゲットは変わりません。

関連項目:

target()

effective_profile

TaggedProfile effective_profile()

要求の送信に使用されるプロファイルを返します。このオペレーションのオブジェクトに対して位置転送(location forward)が発生し、それに従ってオブジェクトのプロファイルが変更された場合、このプロファイルはその位置指定されたプロファイルとなります。

received_exception

Any received_exception()

クライアントに返される例外を格納するanyを返します。

例外が、anyに挿入できないユーザー例外(例外が不明であったり、バインディングによってTypeCodeが提供されないなど)である場合、この属性は標準マイナー・コード1が設定されたシステム例外UNKNOWNを含むanyとなります。ただし、received_exception_id属性では例外のリポジトリIDが使用できます。

関連項目:

received_exception_id()

received_exception_id

String received_exception_id()

クライアントに返される例外のリポジトリIDを返します。

関連項目:

received_exception(), PortableInterceptorパッケージの制限/実装されていないメソッドについてのコメント

get_effective_component

TaggedComponent get_effective_component(int id)

このリクエストに対して選択されたプロファイルから、指定されたIDを持つIOP.TaggedComponentを返します。

指定されたコンポーネントIDを持つコンポーネントが複数ある場合、このオペレーションによってどのコンポーネントが返されるかは不定です。指定されたコンポーネントIDを持つコンポーネントが複数ある場合は、代わりにget_effective_componentsを呼び出してください。

パラメータ:

id - 返されるコンポーネントのコンポーネントID。

戻り値:

指定されたIDを使って取得されたIOP.TaggedComponent。

例外:

BAD_PARAM - 指定のコンポーネントIDを持つコンポーネントがない場合、標準マイナー・コード28でスローされる。

関連項目:

get_effective_components(int)

get_effective_components

TaggedComponent[] get_effective_components(int id)

この要求に対して選択されたプロファイルから、指定されたIDを持つすべてのタグ付きコンポーネントの配列を返します。

パラメータ:

id - 返されるコンポーネントのコンポーネントID。

戻り値:

それぞれが指定されたIDを持つTaggedComponentオブジェクトの配列。

例外:

BAD_PARAM - 指定のコンポーネントIDを持つコンポーネントがない場合、標準マイナー・コード28でスローされる。

関連項目:

get_effective_component(int)

get_request_policy

Policy get_request_policy(int type)

このオペレーションに対して有効になっている指定されたポリシーを返します。

パラメータ:

type - 返されるポリシーを示すポリシー型。

戻り値:

指定の型を使って取得されたCORBA.Policy。

例外:

INV_POLICY - このORBが指定された型をサポートしていないか、その型のポリシー・オブジェクトがこのObjectに関連付けられていないために、ポリシー型の値が有効でない場合、標準マイナー・コード1でスローされる

関連項目:

PortableInterceptorパッケージの制限/実装されていないメソッドについてのコメント

add_request_service_context

void add_request_service_context(ServiceContext service_context,
                                 boolean replace)

インタセプタがサービス・コンテキストを要求に追加できるようにします。

サービス・コンテキストの順序の宣言はありません。このため、追加された順に表示される場合も表示されない場合もあります。

パラメータ:

service_context - リクエストに追加されるIOP.ServiceContext。

replace - 指定されたIDを持つサービス・コンテキストがすでに存在しているときのこのオペレーションの動作を示す。falseの場合は、標準マイナー・コード15が設定されたBAD_INV_ORDERがスローされる。trueの場合は、既存のサービス・コンテキストが新しいものに置換される。