IDLコンパイラが生成したスタブを用いたオペレーション呼び出しをStatic Invocation Interface(SII)と呼ぶのに対し、あらかじめオペレーション情報をアプリケーションプログラムの外に置き、実行時にそのオペレーション情報を取り出してリクエストを組み立ててオペレーションを呼び出すことをDynamic Invocation Interface(DII)と呼びます。この仕組みを用いることで、将来インタフェースが変更される可能性のあるプログラムに柔軟性をもたせることができます。また、SIIはリクエストの送信と受信を同期的に処理しますが、DIIは、非同期に処理することも可能です。これにより、サーバの応答を待つ間にローカルな処理を行うといった、複雑なアプリケーションを作成することができます。

DIIを使うとき、インタフェースリポジトリにオペレーション情報を格納すると、CORBA::Object::_get_interface、CORBA::ORB::create_operation_listなども使えるようになります。

CORBA::Requestクラスは、オブジェクト呼び出しを行うための機能を提供します。CORBA::RequestオブジェクトはCORBA::Object::_request、CORBA::Object::_create_requestによって作成されます。前者は、リクエストオブジェクトを作成してからそのリクエストオブジェクトにオペレーション情報を設定するという手順で使います。 後者は、オペレーションの情報を用意してからリクエストオブジェクトを作成するという手順で使います。オペレーション情報には、オペレーション名、引数リスト、戻り型、ユーザ例外リスト、コンテキストリストがあります。

Object Brokerでは通信に関する情報の取得や設定を行うなどの拡張機能があります。

target	ターゲットオブジェクトリファレンスを得る
operation	オペレーション名を得る
arguments	引数リストを得る
result	リクエストの戻り値を得る
exceptions	例外リストを得る
contexts	コンテキストリストを得る
env	Environmentを得る
ctx(CORBA::Context_ptr)	コンテキストオブジェクトを設定する
ctx	コンテキストオブジェクトを得る
invoke	オペレーションを実行する
send_oneway	応答を要求しないリクエストを送信する
send_deferred	応答を要求するリクエストを送信する
get_response	応答を受信する
poll_response	応答の到着を確認する
_duplicate	リクエストの論理的コピーを作る
_nil	nilリクエストを返す
add_in_arg	IN引数を追加する
add_in_arg(const char*)	IN引数を追加する
add_inout_arg	INOUT引数を追加する
add_inout_arg(const char*)	INOUT引数を追加する
add_out_arg	OUT引数を追加する
add_out_arg(const char*)	OUT引数を追加する
set_return_type	戻り値の型情報を設定する
return_value	戻り値を得る
__is_oneway	send_onewayで送られたかどうかを知る
__is_deferred	send_deferredまたはinvokeで送られたかどうかを知る
__is_call	送信を実行するかどうかを知る
__not_call	送信を実行しないことを指定する
__will_call	送信を実行することを指定する
__reply	擬似応答メッセージ設定用参照を得る

名前

CORBA::Request::target - ターゲットオブジェクトリファレンスを得る

形式

#include <orb.h>

CORBA::Object_ptr CORBA::Request::target(
	CORBA::Environment& env = Ob_default_environment()
) const;

機能説明

リクエストのターゲットオブジェクトのオブジェクトリファレンスを返します。

envは、関数を呼び出した後、例外の有無を調べるために指定します(オプション)。

戻り値

ターゲットのオブジェクトリファレンスを返します。

エラー

CORBA標準例外がthrowされます。

注意

戻り値を変更したり、削除してはいけません。

名前

CORBA::Request::operation - オペレーション名を得る

形式

#include <orb.h>

const char* CORBA::Request::operation(
	CORBA::Environment& env = Ob_default_environment()
);

機能説明

リクエストのオペレーション名を返します。

envは、関数を呼び出した後、例外の有無を調べるために指定します(オプション)。

戻り値

オペレーション名文字列を返します。

エラー

CORBA標準例外がthrowされます。

注意

戻り値を変更したり、削除してはいけません。

名前

CORBA::Request::arguments - 引数リストを得る

形式

#include <orb.h>

CORBA::NVList_ptr CORBA::Request::arguments(
	CORBA::Environment& env = Ob_default_environment()
);

機能説明

リクエストの引数リストを返します。

envは、関数を呼び出した後、例外の有無を調べるために指定します(オプション)。

戻り値

引数リストをCORBA::NVList_ptr型で返します。

エラー

CORBA標準例外がthrowされます。

関連項目

引き数リストを表すインタフェース

注意

戻り値を削除してはいけません。

名前

CORBA::Request::result - リクエストの戻り値を得る

形式

#include <orb.h>

CORBA::NamedValue_ptr CORBA::Request::result(
	CORBA::Environment& env = Ob_default_environment()
);

機能説明

リクエストの戻り値を返します。

envは、関数を呼び出した後、例外の有無を調べるために指定します(オプション)。

戻り値

リクエストの戻り値をCORBA::NamedValue_ptr型で返します。

エラー

CORBA標準例外がthrowされます。

関連項目

引き数リストを表すインタフェース

注意

戻り値を削除してはいけません。

名前

CORBA::Request::exceptions - 例外リストを得る

形式

#include <orb.h>

CORBA::ExceptionList_ptr CORBA::Request::exceptions(
	CORBA::Environment& env = Ob_default_environment()
);

機能説明

リクエストの例外リストを返します。 CORBA::ExceptionListは例外リストを操作するクラスです。

namespace CORBA {
	class ExceptionList {
	public:
		// 例外リストの長さを返す
		CORBA::ULong count(
			CORBA::Environment& env = Ob_default_environment()
		);

		// tcの論理コピーを作り例外リストに追加する
		void add(
			CORBA::TypeCode_ptr tc,
			CORBA::Environment& env = Ob_default_environment()
		);

		// tcの論理コピーを作らずに例外リストに追加する
		void add_consume(
			CORBA::TypeCode_ptr tc,
			CORBA::Environment& env = Ob_default_environment()
		);

		//index番目の例外を取得する
		// 戻り値を消去してはいけない
		CORBA::TypeCode_ptr item(
			CORBA::ULong index,
			CORBA::Environment& env = Ob_default_environment()
		);

		// index番目の例外を削除する
		CORBA::Status remove(
			CORBA::ULong index,
			CORBA::Environment& env = Ob_default_environment()
		);
	};
};

envは、関数を呼び出した後、例外の有無を調べるために指定します(オプション)。

戻り値

例外リストをCORBA::ExceptionList_ptr型で返します。

エラー

CORBA標準例外がthrowされます。

注意

戻り値を削除してはいけません。

名前

CORBA::Request::contexts - コンテキストリストを得る

形式

#include <orb.h>

CORBA::ContextList_ptr CORBA::Request::contexts(
	CORBA::Environment& env = Ob_default_environment()
);

機能説明

リクエストのコンテキストリストを返します。CORBA::ContextListはコンテキストの操作を行うクラスです。

namespace CORBA {
	class ContextList {
	public:
		// コンテキストリストの長さを返す
		CORBA::ULong count(
			CORBA::Environment& env = Ob_default_environment()
		);
		
		// コンテキストリストに追加する(const char*)
		void add(
			const char* ctxt,
			CORBA::Environment& env = Ob_default_environment()
		);
		
		// コンテキストリストに追加する(char*)
		void add_consume(
			char* ctxt,
			CORBA::Environment& env = Ob_default_environment()
		);
		
		// index番目のコンテキストを取得する
		// 戻り値を消去してはいけない
		const char* item(
			CORBA::ULong index,
			CORBA::Environment& env = Ob_default_environment()
		);
		
		// index番目のコンテキストを削除する
		CORBA::Status remove(
			CORBA::ULong index,
			CORBA::Environment& env = Ob_default_environment()
		);
	};
};

envは、関数を呼び出した後、例外の有無を調べるために指定します(オプション)。

戻り値

コンテキストリストをCORBA::ContextList_ptr型で返します。

エラー

CORBA標準例外がthrowされます。

注意

戻り値を削除してはいけません。

名前

CORBA::Request::env - Environmentを得る

形式

#include <orb.h>

CORBA::Environment_ptr CORBA::Request::env(
	CORBA::Environment& env = Ob_default_environment()
);

機能説明

リクエストのEnvironmentを返します。

envは、関数を呼び出した後、例外の有無を調べるために指定します(オプション)。

戻り値

リクエストのEnvironmentをCORBA::Environment_ptr型で返します。

エラー

CORBA標準例外がthrowされます。

注意

戻り値を削除してはいけません。

名前

CORBA::Request::ctx(CORBA::Context_ptr)

- コンテキストオブジェクトを設定する

形式

#include <orb.h>

void CORBA::Request::ctx(
	CORBA::Context_ptr ctx,
	CORBA::Environment& env = Ob_default_environment()
);

機能説明

リクエストにコンテキストctxを設定します。

envは、関数を呼び出した後、例外の有無を調べるために指定します(オプション)。

戻り値

ありません。

エラー

CORBA標準例外がthrowされます。

関連項目

CORBA::Request::ctx

名前

CORBA::Request::ctx - コンテキストオブジェクトを得る

形式

#include <orb.h>

CORBA::Context_ptr CORBA::Request::ctx(
	CORBA::Environment& env = Ob_default_environment()
);

機能説明

リクエストに設定されたコンテキストを返します。

envは、関数を呼び出した後、例外の有無を調べるために指定します(オプション)。

戻り値

コンテキストオブジェクトが返ります。

エラー

CORBA標準例外がthrowされます。

関連項目

CORBA::Request::ctx(CORBA::Context_ptr)

注意

戻り値を削除してはいけません。

名前

CORBA::Request::invoke - オペレーションを実行する

形式

#include <orb.h>

CORBA::Status CORBA::Request::invoke(
	CORBA::Environment& env = Ob_default_environment()
);

機能説明

リクエストを送信して、応答を待ちます。

envは、関数を呼び出した後、例外の有無を調べるために指定します(オプション)。

戻り値

CORBA::Status型でオペレーションの成否が返ります。

エラー

CORBA標準例外がthrowされます。

関連項目

CORBA::Request::__is_deferred

名前

CORBA::Request::send_oneway - 応答を要求しないリクエストを送信する

形式

#include <orb.h>

CORBA::Status CORBA::Request::send_oneway(
	CORBA::Environment& env = Ob_default_environment()
);

機能説明

応答を要求しないリクエストを送信します。このリクエストを受信したサーバは返事を返しません。

envは、関数を呼び出した後、例外の有無を調べるために指定します(オプション)。

戻り値

CORBA::Status型でオペレーションの成否が返ります。

エラー

CORBA標準例外がthrowされます。

関連項目

CORBA::Request::__is_oneway,

CORBA::Request::__is_deferred

注意

onewayオペレーションではサーバに要求を送信しおわった後に発生したエラーを知ることはできません。

名前

CORBA::Request::send_deferred - 応答を要求するリクエストを送信する

形式

#include <orb.h>

CORBA::Status CORBA::Request::send_deferred(
	CORBA::Environment& env = Ob_default_environment()
);

機能説明

応答を要求するリクエストを送信します。オペレーションの結果はget_responseにより受信することができます。

envは、関数を呼び出した後、例外の有無を調べるために指定します(オプション)。

戻り値

CORBA::Status型でオペレーションの成否が返ります。

エラー

CORBA標準例外がthrowされます。

関連項目

CORBA::Request::get_response,

CORBA::Request::poll_response,

CORBA::Request::__is_oneway,

CORBA::Request::__is_deferred

名前

CORBA::Request::get_response - 応答を受信する

形式

#include <orb.h>

CORBA::Status CORBA::Request::get_response(
	CORBA::Environment& env = Ob_default_environment()
);

機能説明

send_deferredにより送信したオペレーションの結果を受信します。

envは、関数を呼び出した後、例外の有無を調べるために指定します(オプション)。

戻り値

CORBA::Status型でオペレーションの成否が返ります。

エラー

CORBA標準例外がthrowされます。

関連項目

CORBA::Request::send_deferred

名前

CORBA::Request::poll_response - 応答の到着を確認する

形式

#include <orb.h>

CORBA::Boolean CORBA::Request::poll_response(
	CORBA::Environment& env = Ob_default_environment()
);

機能説明

send_deferredにより送信したオペレーションの結果が受信できる状態であるかどうかを確認します。

envは、関数を呼び出した後、例外の有無を調べるために指定します(オプション)。

戻り値

受信待ちをせずに応答が受信できる状態のとき1が返ります。

受信待ちが発生する場合は0が返ります。

エラー

CORBA標準例外がthrowされます。

関連項目

CORBA::Request::send_deferred

注意

自動起動サーバの場合などLocationForwardメッセージを受信した場合であっても1が返ります。この場合get_responseを呼び出すと転送先のサーバプロセスが応答を返すまで返ってきません。

名前

CORBA::Request::_duplicate - リクエストの論理的コピーを作る

形式

#include <orb.h>

static CORBA::Request_ptr CORBA::Request::_duplicate(
	CORBA::Request_ptr req,
	CORBA::Environment& env = Ob_default_environment()
);

機能説明

引数reqの論理的コピーを作ります。

envは、関数を呼び出した後、例外の有無を調べるために指定します(オプション)。

戻り値

引数reqの論理的コピーが返ります。

エラー

CORBA標準例外がthrowされます。

名前

CORBA::Request::_nil - nilリクエストを返す

形式

#include <orb.h>

static CORBA::Request_ptr CORBA::Request::_nil(
	CORBA::Environment& env = Ob_default_environment()
);

機能説明

nilリクエストを返します。

envは、関数を呼び出した後、例外の有無を調べるために指定します(オプション)。

戻り値

nilリクエストが返ります。

エラー

CORBA標準例外がthrowされます。

名前

CORBA::Request::add_in_arg - IN引数を追加する

形式

#include <orb.h>

CORBA::Any& CORBA::Request::add_in_arg(
	CORBA::Environment& env = Ob_default_environment()
);

CORBA::Any& CORBA::Request::add_in_arg(
	const char* name,
	CORBA::Environment& env = Ob_default_environment()
);

機能説明

リクエストにIN引数を追加します。実際の引数は戻り値のCORBA::Any&型を使って設定します。引数設定関数は引数の順番どおりに呼び出さなければなりません。Object Brokerではname付きの形式でも、無しの形式でも結果は同じです。

envは、関数を呼び出した後、例外の有無を調べるために指定します(オプション)。

戻り値

引数値設定用のCORBA::Any&が返ります。

エラー

CORBA標準例外がthrowされます。

名前

CORBA::Request::add_inout_arg - INOUT引数を追加する

形式

#include <orb.h>

CORBA::Any& CORBA::Request::add_inout_arg(
	CORBA::Environment& env = Ob_default_environment()
);

CORBA::Any& CORBA::Request::add_inout_arg(
	const char* name,
	CORBA::Environment& env = Ob_default_environment()
);

機能説明

リクエストにINOUT引数を追加します。実際の引数は戻り値のCORBA::Any&型を使って設定します。引数設定関数は引数の順番どおりに呼び出さなければなりません。Object Brokerではname付きの形式でも、無しの形式でも結果は同じです。

envは、関数を呼び出した後、例外の有無を調べるために指定します(オプション)。

戻り値

引数値設定用のCORBA::Any&が返ります。

エラー

CORBA標準例外がthrowされます。

名前

CORBA::Request::add_out_arg - OUT引数を追加する

形式

#include <orb.h>

CORBA::Any& CORBA::Request::add_out_arg(
	CORBA::Environment& env = Ob_default_environment()
);

CORBA::Any& CORBA::Request::add_out_arg(
	const char* name,
	CORBA::Environment& env = Ob_default_environment()
);

機能説明

リクエストにOUT引数を追加します。実際の引数は戻り値のCORBA::Any&型を使って設定します。引数設定関数は引数の順番どおりに呼び出さなければなりません。Object Brokerではname付きの形式でも、無しの形式でも結果は同じです。

envは、関数を呼び出した後、例外の有無を調べるために指定します(オプション)。

戻り値

引数型情報設定および引数値取り出し用のCORBA::Any&が返ります。

エラー

CORBA標準例外がthrowされます。

名前

CORBA::Request::set_return_type - 戻り値の型情報を設定する

形式

#include <orb.h>

void CORBA::Request::set_return_type(
	CORBA::TypeCode_ptr tc,
	CORBA::Environment& env = Ob_default_environment()
);

機能説明

リクエストに戻り値の型情報を設定します。

envは、関数を呼び出した後、例外の有無を調べるために指定します(オプション)。

戻り値

ありません。

エラー

CORBA標準例外がthrowされます。

名前

CORBA::Request::return_value - 戻り値を得る

形式

#include <orb.h>

CORBA::Any& CORBA::Request::return_value(
	CORBA::Environment& env = Ob_default_environment()
);

機能説明

応答受信後のリクエストから戻り値を取り出します。

envは、関数を呼び出した後、例外の有無を調べるために指定します(オプション)。

戻り値

戻り値取り出し用のCORBA::Any&が返ります。

エラー

CORBA標準例外がthrowされます。

名前

CORBA::Request::__is_oneway - send_onewayで送られたかどうかを知る

形式

#include <orb.h>

int CORBA::Request::__is_oneway();

機能説明

フックの中で、リクエストがsend_onewayで送られたかどうかを知ります。

戻り値

send_onewayで送られたとき0以外の値が返ります。

invokeあるいはsend_deferredで送られたときは0が返ります。

エラー

起こりません。

関連項目

CORBA::Request::send_oneway,

CORBA::Request::send_deferred,

[ アプリケーション開発ガイド（CORBA） > 1. CORBA アプリケーション > 1.2. プログラミング・開発ガイド > 1.2.2. Object Broker > 1.2.2.6. Object Broker C++の機能 ] > フック

注意

この関数はフックの中でのみ正しい値を返します。

名前

CORBA::Request::__is_deferred - send_deferredまたはinvokeで送られたかどうかを知る

形式

#include <orb.h>

int CORBA::Request::__is_deferred();

機能説明

フックの中でリクエストがsend_deferredまたはinvokeで送られたかどうかを知ります。

戻り値

send_deferredまたはinvokeで送られたとき0以外の値が返ります。

send_onewayで送られたときは0が返ります。

エラー

起こりません。

関連項目

CORBA::Request::send_oneway,

CORBA::Request::send_deferred,

CORBA::Request::invoke,

[ アプリケーション開発ガイド（CORBA） > 1. CORBA アプリケーション > 1.2. プログラミング・開発ガイド > 1.2.2. Object Broker > 1.2.2.6. Object Broker C++の機能 > フック]

注意

この関数はフックの中でのみ正しい値を返します。

名前

CORBA::Request::__is_call - 送信を実行するかどうかを知る

形式

#include <orb.h>

int CORBA::Request::__is_call();

機能説明

フックの中でリクエストがサーバに送信されるかどうかを知ります。

戻り値

送信されるとき0以外の値が返ります。

送信されないとき0が返ります。

エラー

起こりません。

関連項目

[ アプリケーション開発ガイド（CORBA） > 1. CORBA アプリケーション > 1.2. プログラミング・開発ガイド > 1.2.2. Object Broker > 1.2.2.6. Object Broker C++の機能 > フック]

注意

この関数はフックの中でのみ正しい値を返します。

名前

CORBA::Request::__not_call - 送信を実行しないことを指定する

形式

#include <orb.h>

int CORBA::Request::__not_call();

機能説明

リクエストをサーバに送信せずに処理を終了させます。この関数はフック関数内で使用します。

戻り値

ありません。

エラー

起こりません。

関連項目

CORBA::Request::__reply,

[ アプリケーション開発ガイド（CORBA） > 1. CORBA アプリケーション > 1.2. プログラミング・開発ガイド > 1.2.2. Object Broker > 1.2.2.6. Object Broker C++の機能 > フック]

注意

この関数はフックの中でのみ使用可能です。

名前

CORBA::Request::__will_call - 送信を実行することを指定する

形式

#include <orb.h>

int CORBA::Request::__will_call();

機能説明

リクエストをサーバに送信するよう指定します。この関数はフック関数内で使用します。

戻り値

ありません。

エラー

起こりません。

関連項目

[ アプリケーション開発ガイド（CORBA） > 1. CORBA アプリケーション > 1.2. プログラミング・開発ガイド > 1.2.2. Object Broker > 1.2.2.6. Object Broker C++の機能 > フック]

注意

この関数はフックの中でのみ使用可能です。

名前

CORBA::Request::__reply - 擬似応答メッセージ設定用参照を得る

形式

#include <orb.h>

Ob_MesBuf& CORBA::Request::__reply();

機能説明

__not_callでサーバに送信せずに処理を終了する場合に、応答メッセージをあたかも受信したかのように処理を継続するために用います。この関数はフック内で使用します。

戻り値

擬似戻りメッセージ設定用Ob_MesBuf&型データが返ります。

エラー

起こりません。

関連項目

CORBA::Request::__not_call,

エンコード/デコード,

[ アプリケーション開発ガイド（CORBA） > 1. CORBA アプリケーション > 1.2. プログラミング・開発ガイド > 1.2.2. Object Broker > 1.2.2.6. Object Broker C++の機能 > フック]

注意

この関数はフックの中でのみ使用可能です。