すべてのスーパー・インタフェース:: 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	はい₁	いいえ	はい	いいえ	いいえ
exceptions	はい	いいえ	はい	はい	はい
contexts	はい	いいえ	はい	はい	はい
operation_context	はい	いいえ	はい	はい	はい
result	いいえ	いいえ	はい	いいえ	いいえ
response_expected	はい	はい	はい	はい	はい
sync_scope	はい	いいえ	はい	はい	はい
reply_status	いいえ	いいえ	はい	はい	はい
forward_reference	いいえ	いいえ	いいえ	いいえ	はい₂
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	はい	いいえ	いいえ	いいえ	いいえ

ClientRequestInfoがsend_requestに渡されるときは、各引数のリストにin、inout、outのどれかのエントリがあります。しかし、使用できるのはinとinoutの引数だけです。
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)`	このオペレーションに対して有効になっている指定されたポリシーを返します。
`Any`	`received_exception()`	クライアントに返される例外を格納するanyを返します。
`String`	`received_exception_id()`	クライアントに返される例外のリポジトリIDを返します。
`Object`	`target()`	オペレーションを実行するためにクライアントが呼び出したオブジェクトを返します。

インタフェース org.omg.PortableInterceptor.RequestInfoOperationsから継承されたメソッド
arguments, contexts, exceptions, forward_reference, get_reply_service_context, get_request_service_context, get_slot, operation, operation_context, 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の場合は、既存のサービス・コンテキストが新しいものに置換される。

インタフェースClientRequestInfoOperations

メソッドのサマリー

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

メソッドの詳細

target

effective_target

effective_profile

received_exception

received_exception_id

get_effective_component

get_effective_components

get_request_policy

add_request_service_context