- java.lang.Object
- 
- org.omg.CORBA.Request
 
- 
 public abstract class Request extends Object メソッドを呼び出すために必要な情報を含むオブジェクトです。 このクラスは、動的作成と要求の呼出しを可能にするORB Dynamic Invocation Interface (DII)に似ています。 サーバーがクライアント・スタブを使用するクライアント呼び出しとDIIを使用する要求の間の違いを示すことはできません。次に、 Requestオブジェクトの構成要素を示します。- 呼び出されるオペレーションの名前
- 操作の引数を含むNVList。
 リスト内の各項目はNamedValueオブジェクトで、次の3つの部分があります。- 引数の名前
- 引数の値(Anyオブジェクト)
- 引数が入力、出力、またはその両方かどうかを示す引数モード・フラグ
 
 操作が元のIDLインタフェース定義にどのように定義されているかによって、 Requestオブジェクトも追加情報を含むことがあります。 たとえば、適切な場合は、戻り値または例外、コンテキスト、取り得る例外、および解決する必要のあるコンテキスト文字列のリストを保持するため、NamedValueオブジェクトを含むことがあります。新規 Requestオブジェクトは、Objectクラス内のcreate_requestメソッドの1つを使用して作成されます。 つまり、create_requestメソッドは、呼び出されるオブジェクトで実行されます。- 関連項目:
- NamedValue
 
- 
- 
コンストラクタのサマリーコンストラクタ コンストラクタ 説明 Request()
 - 
メソッドのサマリーすべてのメソッド インスタンス・メソッド 抽象メソッド 修飾子と型 メソッド 説明 abstract Anyadd_in_arg()入力引数を作成し、その入力引数をこのRequestオブジェクトに追加します。abstract Anyadd_inout_arg()入出力引数をこのRequestオブジェクトに追加します。abstract Anyadd_named_in_arg(String name)指定された名前の入力引数を作成し、その入力引数をこのRequestオブジェクトに追加します。abstract Anyadd_named_inout_arg(String name)指定された名前の入出力引数をこのRequestオブジェクトに追加します。abstract Anyadd_named_out_arg(String name)指定された名前の出力引数をこのRequestオブジェクトに追加します。abstract Anyadd_out_arg()出力引数をこのRequestオブジェクトに追加します。abstract NVListarguments()呼び出されるメソッドの引数を含むNVListオブジェクトを取得します。abstract ContextListcontexts()この要求に対するContextListオブジェクトを取得します。abstract Contextctx()この要求に対するContextオブジェクトを取得します。abstract voidctx(Context c)このリクエストのContextオブジェクトを、指定したオブジェクトに設定します。abstract Environmentenv()この要求に対するEnvironmentオブジェクトを取得します。abstract ExceptionListexceptions()この要求に対するExceptionListオブジェクトを取得します。abstract voidget_response()send_deferredメソッドで以前にトリガーされた呼出しの応答に、ユーザーがアクセスできます。abstract voidinvoke()Requestオブジェクトの情報を使用して同期呼出しを行います。abstract Stringoperation()呼び出されるメソッドの名前を取得します。abstract booleanpoll_response()send_deferredメソッドで以前にトリガーされた呼出しに対して応答が受信されたかどうかを、ユーザーが確認できます。abstract NamedValueresult()メソッドの戻り値を含むNamedValueを取得します。abstract Anyreturn_value()メソッドの結果に対する値を含むAnyオブジェクトです。abstract voidsend_deferred()要求で非同期を行います。abstract voidsend_oneway()要求で一方向呼出しを行います。abstract voidset_return_type(TypeCode tc)メソッドの戻り値の型コードを設定します。abstract Objecttarget()ターゲット・オブジェクト参照を取得します。
 
- 
- 
- 
メソッドの詳細- 
targetpublic abstract Object target() ターゲット・オブジェクト参照を取得します。- 戻り値:
- 呼び出されるメソッドのオブジェクト実装を示すオブジェクト参照
 
 - 
operationpublic abstract String operation() 呼び出されるメソッドの名前を取得します。- 戻り値:
- 呼び出されるメソッドの名前
 
 - 
argumentspublic abstract NVList arguments() 呼び出されるメソッドの引数を含むNVListオブジェクトを取得します。 リスト内の要素はNamedValueオブジェクトで、それぞれがメソッドの引数を記述します。- 戻り値:
- メソッドの引数を含むNVListオブジェクト
 
 - 
resultpublic abstract NamedValue result() メソッドの戻り値を含むNamedValueを取得します。- 戻り値:
- メソッドの結果を含むNamedValueオブジェクト
 
 - 
envpublic abstract Environment env() この要求に対するEnvironmentオブジェクトを取得します。 これは、呼出しが復帰したあと、呼び出されたメソッドがスローされたという例外を含みます。- 戻り値:
- このリクエストのEnvironmentオブジェクト
 
 - 
exceptionspublic abstract ExceptionList exceptions() この要求に対するExceptionListオブジェクトを取得します。 このリストは、呼び出されるメソッドによってスローされることがある例外を記述するTypeCodeオブジェクトを含みます。- 戻り値:
- 呼び出されるメソッドによってスローされることがある例外を記述するExceptionListオブジェクト
 
 - 
contextspublic abstract ContextList contexts() この要求に対するContextListオブジェクトを取得します。 このリストは、この呼出しで解決して送る必要があるコンテキストStringを含みます。- 戻り値:
- この呼出しで解決して送る必要があるコンテキスト文字列のリスト。
 
 - 
ctxpublic abstract Context ctx() この要求に対するContextオブジェクトを取得します。 これは、この要求のクライアント、環境、または状況に関する情報を提供するプロパティのリストです。- 戻り値:
- 呼出しで値を渡す必要のある任意のコンテキスト文字列の解決で使用されるContextオブジェクト
 
 - 
ctxpublic abstract void ctx(Context c) このリクエストのContextオブジェクトを、指定したオブジェクトに設定します。- パラメータ:
- c- コンテキスト文字列を解決するために使用される新しい- Contextオブジェクト
 
 - 
add_in_argpublic abstract Any add_in_arg() 入力引数を作成し、その入力引数をこのRequestオブジェクトに追加します。- 戻り値:
- 付加的な入力引数の値および型コードを含むAnyオブジェクト
 
 - 
add_named_in_argpublic abstract Any add_named_in_arg(String name) 指定された名前の入力引数を作成し、その入力引数をこのRequestオブジェクトに追加します。- パラメータ:
- name- 追加される引数の名前
- 戻り値:
- 付加的な入力引数の値および型コードを含むAnyオブジェクト
 
 - 
add_inout_argpublic abstract Any add_inout_arg() 入出力引数をこのRequestオブジェクトに追加します。- 戻り値:
- 付加的な入出力引数の値および型コードを含むAnyオブジェクト
 
 - 
add_named_inout_argpublic abstract Any add_named_inout_arg(String name) 指定された名前の入出力引数をこのRequestオブジェクトに追加します。- パラメータ:
- name- 追加される引数の名前
- 戻り値:
- 付加的な入出力引数の値および型コードを含むAnyオブジェクト
 
 - 
add_out_argpublic abstract Any add_out_arg() 出力引数をこのRequestオブジェクトに追加します。- 戻り値:
- 付加的な出力引数の値および型コードを含むAnyオブジェクト
 
 - 
add_named_out_argpublic abstract Any add_named_out_arg(String name) 指定された名前の出力引数をこのRequestオブジェクトに追加します。- パラメータ:
- name- 追加される引数の名前
- 戻り値:
- 付加的な出力引数の値および型コードを含むAnyオブジェクト
 
 - 
set_return_typepublic abstract void set_return_type(TypeCode tc) メソッドの戻り値の型コードを設定します。- パラメータ:
- tc- 戻り値の型情報を含む- TypeCodeオブジェクト
 
 - 
return_valuepublic abstract Any return_value() メソッドの結果に対する値を含むAnyオブジェクトです。- 戻り値:
- 戻り値の値および型コードを含むAnyオブジェクト
 
 - 
invokepublic abstract void invoke() Requestオブジェクトの情報を使用して同期呼出しを行います。 例外情報は、Requestオブジェクトの環境オブジェクトに格納されます。
 - 
send_onewaypublic abstract void send_oneway() 要求で一方向呼出しを行います。 つまり、応答は前提とされたり待機されたりしません。 これは、IDL宣言で操作が一方向として宣言されていない場合でも使用できることに注意してください。 応答または例外情報は返されません。
 - 
send_deferredpublic abstract void send_deferred() 要求で非同期を行います。 つまり、ユーザーに返す前は応答を待機しません。 ユーザーは、あとでpoll_responseおよびget_responseメソッドを使用して、呼出しの結果または例外情報を取得します。
 - 
poll_responsepublic abstract boolean poll_response() send_deferredメソッドで以前にトリガーされた呼出しに対して応答が受信されたかどうかを、ユーザーが確認できます。- 戻り値:
- メソッド応答があらかじめ受信されている場合はtrue、そうでない場合はfalse
 
 - 
get_responsepublic abstract void get_response() throws WrongTransactionsend_deferredメソッドで以前にトリガーされた呼出しの応答に、ユーザーがアクセスできます。- 例外:
- WrongTransaction- 元のリクエストの送信元とは異なるトランザクション・スコープから- get_responseメソッドが呼び出された場合。 詳細は、「OMGトランザクション・サービスの仕様」を参照してください。
 
 
- 
 
-