org.omg.PortableInterceptor

インタフェースServerRequestInfoOperations

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

RequestInfoOperations

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

ServerRequestInfo

public interface ServerRequestInfoOperations
extends RequestInfoOperations

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

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

	receive_request_ service_contexts	receive_request	send_reply	send_exception	send_other
RequestInfoから継承される:
request_id	はい	はい	はい	はい	はい
operation	はい	はい	はい	はい	はい
arguments	いいえ	はい1	はい	いいえ2	いいえ2
exceptions	いいえ	はい	はい	はい	はい
contexts	いいえ	はい	はい	はい	はい
operation_context	いいえ	はい	はい	いいえ	いいえ
result	いいえ	いいえ	はい	いいえ	いいえ
response_expected	はい	はい	はい	はい	はい
sync_scope	はい	はい	はい	はい	はい
request_id	はい	はい	はい	はい	はい
operation	はい	はい	はい	はい	はい
arguments	いいえ	はい1</sub	はい	いいえ2	いいえ2
exceptions	いいえ	はい	はい	はい	はい
contexts	いいえ	はい	はい	はい	はい
operation_context	いいえ	はい	はい	いいえ	いいえ
result	いいえ	いいえ	はい	いいえ	いいえ
response_expected	はい	はい	はい	はい	はい
sync_scope	はい	はい	はい	はい	はい
reply_status	いいえ	いいえ	はい	はい	はい
forward_reference	いいえ	いいえ	いいえ	いいえ	はい2
get_slot	はい	はい	はい	はい	はい
get_request_service_context	はい	いいえ	はい	はい	はい
get_reply_service_context	いいえ	いいえ	はい	はい	はい
ServerRequestInfo固有:
sending_exception	いいえ	いいえ	いいえ	はい	いいえ
object_id	いいえ	はい	はい	はい3	はい3
adapter_id	いいえ	はい	はい	はい3	はい3
server_id	いいえ	はい	はい	はい	はい
orb_id	いいえ	はい	はい	はい	はい
adapter_name	いいえ	はい	はい	はい	はい
target_most_derived_interface	いいえ	はい	いいえ4	いいえ4	いいえ4
get_server_policy	はい	はい	はい	はい	はい
set_slot	はい	はい	はい	はい	はい
target_is_a	いいえ	はい	いいえ4	いいえ4	いいえ4
add_reply_service_context	はい	はい	はい	はい	はい

1. ServerRequestInfoがreceive_requestに渡されるときは、各引数のリストにin、inout、outのどれかのエントリがあります。しかし、使用できるのはinとinoutの引数だけです。
2. reply_status属性がLOCATION_FORWARDでない場合は、この属性にアクセスすると、標準マイナー・コード14が設定されたBAD_INV_ORDERがスローされます。
3. サーバント・ロケータによって位置転送が行われたか、例外がスローされた場合、この属性/操作がこの遮断点で使用できなくなる可能性があります。使用できない場合は、標準マイナー・コード1が設定されたNO_RESOURCESがスローされます。
4. 必要な情報がターゲット・オブジェクトのサーバントにアクセスする必要があるのに、ORBがこれ以上そのサーバントを使用できない可能性があるため、この操作はこの遮断点で使用できません。たとえば、オブジェクトのアダプタがServantLocatorを使用するPOAである場合、ORBはServantLocator.postinvoke()を呼び出したあとでこの遮断点を呼び出します。
.

関連項目:

ServerRequestInterceptor

メソッドのサマリー

修飾子と型	メソッドと説明
byte[]	adapter_id() オブジェクト・アダプタの不透明な識別子を返します。
String[]	adapter_name() この要求を処理中のオブジェクト・アダプタ・インスタンスを識別する一連の文字列を返します。
void	add_reply_service_context(ServiceContext service_context, boolean replace) インタセプタがサービス・コンテキストを要求に追加できるようにします。
Policy	get_server_policy(int type) この操作に有効な指定されたポリシー型のポリシーを返します。
byte[]	object_id() オペレーション呼出しのターゲットを表している不透明なobject_idを返します。
String	orb_id() ORBを作成するのに使用されたIDを返します。
Any	sending_exception() クライアントに返される例外を格納するanyを返します。
String	server_id() -ORBServerId引数を使用してORB::initで指定されたサーバーIDを返します。
void	set_slot(int id, Any data) インタセプタが、リクエストの範囲内にあるPortableInterceptor.Currentにスロットを設定できるようにします。
boolean	target_is_a(String id) サーバントが指定されたリポジトリIDである場合はtrueを返し、そうでない場合はfalseを返します。
String	target_most_derived_interface() サーバントの最上位の派生インタフェースのリポジトリIDを返します。

インタフェース 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

メソッドの詳細

sending_exception

Any sending_exception()

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

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

関連項目:

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

object_id

byte[] object_id()

オペレーション呼出しのターゲットを表している不透明なobject_idを返します。

adapter_id

byte[] adapter_id()

オブジェクト・アダプタの不透明な識別子を返します。

server_id

String server_id()

-ORBServerId引数を使用してORB::initで指定されたサーバーIDを返します。

orb_id

String orb_id()

ORBを作成するのに使用されたIDを返します。

adapter_name

String[] adapter_name()

この要求を処理中のオブジェクト・アダプタ・インスタンスを識別する一連の文字列を返します。

target_most_derived_interface

String target_most_derived_interface()

サーバントの最上位の派生インタフェースのリポジトリIDを返します。

get_server_policy

Policy get_server_policy(int type)

この操作に有効な指定されたポリシー型のポリシーを返します。返されたCORBA.Policyオブジェクトは、register_policy_factoryを介して型が登録されている唯一のポリシーです。

パラメータ:

type - 返されるポリシーを指定するCORBA.PolicyType。

戻り値:

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

例外:

INV_POLICY - 指定された型のポリシーがregister_policy_factoryを介して登録されていなかった場合、標準マイナー・コード2でスローされる。

関連項目:

ORBInitInfoOperations.register_policy_factory(int, org.omg.PortableInterceptor.PolicyFactory)

set_slot

void set_slot(int id,
              Any data)
       throws InvalidSlot

インタセプタが、リクエストの範囲内にあるPortableInterceptor.Currentにスロットを設定できるようにします。そのスロットにデータがすでに存在する場合、既存のデータは上書きされます。

パラメータ:

id - スロットのID。

data - そのスロットに格納するany形式のデータ。

例外:

InvalidSlot - このIDによって割当て済みのスロットが定義されていない場合にスローされる。

関連項目:

Current

target_is_a

boolean target_is_a(String id)

サーバントが指定されたリポジトリIDである場合はtrueを返し、そうでない場合はfalseを返します。

パラメータ:

id - 呼出し側では、サーバントがこのリポジトリIDであるかどうかを確認する必要がある。

戻り値:

サーバントが指定されたRepositoryIdであるか

add_reply_service_context

void add_reply_service_context(ServiceContext service_context,
                               boolean replace)

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

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

パラメータ:

service_context - 応答に追加するIOP.ServiceContext。

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

例外:

BAD_INV_ORDER - replaceがfalseであるときに、指定されたIDのサービス・コンテキストがすでに存在する場合、標準マイナー・コード15でスローされる。