モジュール java.corba
パッケージ 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

    • メソッドの詳細

      • 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()

      • 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の場合は、既存のサービス・コンテキストが新しいものに置換される。