概要

1 つまたは複数のファクトリ・オブジェクト・リファレンスのシーケンスを取得します。

C++ マッピング

Java マッピング

public org.omg.CORBA.Object[]
   find_factories_by_id( java.lang.String factory_id) 
     throws
         org.omg.CosLifeCycle.NoFactory,
         com.beasys.Tobj.CannotProceed,
         com.beasys.Tobj.RegistrarNotAvailable;

パラメータ

例外

説明

アプリケーションによって find_factories_by_id メソッドが呼び出され、1 つまたは複数のファクトリ・オブジェクト・リファレンスのシーケンスが取得されます。メソッドには、探しているファクトリの識別子が含まれた、NULL で終了する文字列が渡されます。指定した ID で登録されたファクトリ・オブジェクトが複数存在した場合、FactoryFinder は一致する登録済みオブジェクトのオブジェクト・リファレンスのリストを返します。

find_factories_by_id メソッドは、factory_id パラメータと同じ値を含む id フィールドおよび値 "FactoryInterface" を含む kind フィールドを備えた単一の NameComponent が含まれるキーを渡された、find_factory オペレーションと同じように振る舞います。

ファクトリの登録された識別子が factory_id パラメータの値と等価であると見なされるのは、単一の NameComponent を含む CosLifeCycle::Key 構造体を構成した結果に、id フィールドの値として factory_id パラメータが、kind フィールドの値として factory_id パラメータが含まれる場合です。値は、大文字と小文字、場所など、すべての面で一致している必要があります。

戻り値

factory_key パラメータの値として指定された情報に一致する、ファクトリ・オブジェクトへのリファレンスのアンバウンディッド・シーケンスです。C++ では、メソッドは CosLifeCycle::Factory 型のオブジェクト・リファレンスのシーケンスを返します。Java では、メソッドは org.omg.CORBA.Object 型のオブジェクト・リファレンスのアンバウンディッド配列を返します。

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