概要

現在 FactoryFinder で登録されているファクトリ・オブジェクトのリストを取得します。

C++ マッピング

virtual FactoryListing * list_factories() = 0;

Java マッピング

public com.beasys.Tobj.FactoryComponent[] list_factories()
  throws
      com.beasys.Tobj.CannotProceed,
       com.beasys.Tobj.RegistrarNotAvailable;

例外

説明

アプリケーションによって list_factories メソッドが呼び出され、FactoryFinder で現在登録されているファクトリ・オブジェクトのリストが取得されます。メソッドは、ファクトリの登録に使用されるキーと、ファクトリ・オブジェクトへのリファレンスの両方を返します。

戻り値

Tobj::FactoryComponent のアンバウンディッド・シーケンスです。シーケンス中の Tobj::FactoryComponent の各オカレンスには、登録されたファクトリ・オブジェクトへのリファレンス、およびそのファクトリ・オブジェクトの登録に使用された CosLifeCycle::Key が含まれます。

オペレーションが例外を生成した場合には、戻り値は無効であり、呼び出し側によって解放される必要はありません。

オートメーションのメソッド

ここでは、DITobj_FactoryFinder オートメーション・メソッドについて説明します。

DIMIDL マッピング

HRESULT find_one_factory(
  [in] VARIANT factory_key, 
  [in,out,optional] VARIANT* exceptionInfo, 
  [out,retval] IDispatch** returnValue);

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

Function find_one_factory(factory_key, [exceptionInfo]) As Object

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

戻り値

アプリケーション・ファクトリのインターフェイス・ポインタへのリファレンスを返します。