FactoryFinder インターフェイス

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

サイトマップ

用語集

検索

e-docs > Tuxedo > Tuxedo CORBA プログラミング・リファレンス > FactoryFinder インターフェイス

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

DI.find_one_factory_by_id

概要

アプリケーション・ファクトリを 1 つ取得します。

MIDL マッピング

HRESULT find_one_factory_by_id(
  [in] BSTR factory_id, 
  [in,out,optional] VARIANT* exceptionInfo, 
  [out,retval] IDispatch** returnValue);

オートメーション・マッピング

Function find_one_factory_by_id(factory_id As String,
                                   [exceptionInfo]) As Object

パラメータ

factory_id

このパラメータは、アプリケーション・ファクトリの種類または型を識別するために使用される文字列識別子を表します。この文字列を構成する際のヒントについては、『BEA Tuxedo CORBA サーバ・アプリケーションの開発方法』を参照してください。

exceptionInfo

エラーが発生した場合にアプリケーションが追加の例外データを取得できるようにするオプションの入力引数。

例外

NoFactory

この例外は、入力 factory_id に対応するアプリケーション・ファクトリ・オブジェクト・リファレンスを FactoryFinder が見つけられない場合に発生します。

この例外が発生するのは、FactoryFinder または CORBA サービス・ネーミング・サービスが検索中に内部エラーに遭遇した場合です。エラーは、ユーザ・ログ (ULOG) に書き込まれます。この例外が発生した場合は、すぐに作業担当者に通知されます。内部エラーの重要度によっては、FactoryFinder または CORBA サービス・ネーミング・サービスが実行されていたサーバが、終了していることがあります。FactoryFinder サービスが終了した場合は、新しい FactoryFinder サービスを開始します。CORBA サービス・ネーミング・サービスの 1 つが終了しており、別の CORBA サービス・ネーミング・サービスは実行中である場合は、新規の CORBA サービス・ネーミング・サービスを開始します。稼動中のネーミング・サービスがない場合は、アプリケーションを再起動します。

RegistrarNotAvailable

この例外は、FactoryFinder が CORBA サービス・ネーミング・サービスのオブジェクトを見つけられない場合に発生します。この例外が発生した場合は、すぐに作業担当者に通知されます。ネーミング・サービス用のサーバが実行されていない場合は、アプリケーションを再起動します。

説明

このメンバ関数は、キーの id がメソッドの入力 factory_id に一致するアプリケーション・ファクトリ・オブジェクト・リファレンスを 1 つ返すように、FactoryFinder に指示します。が等価性の照合を行う必要があります。つまり、入力 factory_id が、アプリケーション・ファクトリのキーの <id, kind> ペアの id と完全に一致していなければなりません。入力された factory_id を含むファクトリ・キーが複数存在する場合、FactoryFinder は内部で定義されたロード・バランシング・スキーマに基づき、1 つを選択します。同じ id で find_one_factory_by_id を複数回呼び出すと、さまざまなオブジェクト・リファレンスが返ることがあります。

戻り値