TP フレームワーク

ドキュメントのダウンロード

サイトマップ

用語集

検索

e-docs > Tuxedo > Tuxedo CORBA プログラミング・リファレンス > TP フレームワーク

Tuxedo CORBA プログラミング・リファレンス

TP::create_object_reference()

概要

オブジェクト・リファレンスを作成します。作成されたオブジェクト・リファレンスは、オブジェクトへのアクセスで使用するクライアントに渡されます。

C++ バインディング

static CORBA::Object_ptr    TP::create_object_reference (
                               const char* interfaceName,
                               const char* stroid,
                               CORBA::NVList_ptr criteria);

引数

interfaceName; stroid; criteria

例外

create_object_reference() メソッドの例外は以下のとおりです。

InvalidInterface

指定された interfaceName が NULL であることを示します。

InvalidObjectId

指定された stroid が NULL であることを示します。

説明

create_object_reference() メソッドの呼び出しは、サーバ・アプリケーションの役割です。このメソッドによって、オブジェクト・リファレンスが作成されます。作成されたオブジェクト・リファレンスは、オブジェクトへのアクセスで使用するクライアントに渡されます。

通常、サーバ・アプリケーションではこのメソッドを以下の 2 か所で呼び出します。

Server::initialize() 内。サーバのファクトリを作成します。
クライアントに返すオブジェクト・リファレンスを作成するファクトリ・メソッド内。

create_object_reference() メソッドの呼び出し方法とタイミングの例については、『BEA Tuxedo CORBA サーバ・アプリケーションの開発方法』を参照してください。

戻り値

Object

新しく作成されたオブジェクト・リファレンス。

例

次のコード例は、criteria 引数の使用方法を示しています。

CORBA::NVList_ptr criteria;
CORBA::Long branch_id = 7;
CORBA::Long account_id = 10001;
CORBA::Any any_val;

// リストを作成して  _var に割り当てて、終了時にクリーンアップ
CORBA::ORB::create_list (2, criteria);
CORBA::NVList_var criteria_var(criteria);

// BRANCH_ID を追加
any_val <<= branch_id;
criteria->add_value("BRANCH_ID", any_val, 0);

// ACCOUNT_ID を追加
any_val <<= account_id;
criteria->add_value("ACCOUNT_ID", any_val, 0);

// オブジェクト・リファレンスを作成
TP::create_object_reference ("IDL:BankApp/Teller:1.0",
"Teller_01", criteria);