|
|
|
|
|
|
通常、クライアントは一度オブジェクト参照を作成し、それを自身の恒久的なストレージに保存し、そのオブジェクトが復帰するたびに、オブジェクトのサーバントを再アクティブ化します。たとえばOracle Tuxedo CORBA通知サービスのアプリケーションと共に使用した場合、これらは永続的なサブスクリプションの概念に対応するコールバックです。つまり、通知サービスはコールバック・リファレンスを記憶しており、クライアントが起動して再びイベントを受信する準備が整ったことを宣言すると、イベントを送達します。これにより、通知サービスのサブスクリプションは、クライアントの障害やオフライン時間の影響を受けずに済みます。(対応するPOAポリシーの値は、PERSISTENTおよびSYSTEM_IDです。)
interface Callbacks
{
exception ServantAlreadyActive{ };
exception ObjectAlreadyActive { };
exception NotInRequest{ };
// set up transient callback Object
// -- prepare POA, activate object, return objref
Object start_transient(
in PortableServer::Servant Servant,
in CORBA::RepositoryId rep_id)
raises (ServantAlreadyActive);// set up persistent/systemid callback Object
Object start_persistent_systemid(
in PortableServer::Servant servant,
in CORBA::Repository rep_id,
out string stroid)
raises (ServantAlreadyActive);// set up persistent/userid callback Object
Object start_persistent_userid(
in PortableServer::Servant servant,
in CORBA::RepositoryId rep_id,
in string stroid)
raises (ServantAlreadyActive, ObjectAlreadyActive);// get oid string for the current request
string get_string_oid() raises (NotInRequest);
};
}
#endif /* _BEA_WRAPPER _IDL_ */リスト11-4に示すように、OracleWrapperはC++で記述されます。リスト11-4 C++宣言(beawrapper.h内)BEAWrapper::CallbacksクラスはすでにORBポインタでインスタンス化されています。プロセス内で使用できるこのクラスのインスタンスは1つだけです。より柔軟性が必要なユーザーは、POAを直接使用する必要があります。サーバントはすでにコールバックに使用されています。サーバントは、ObjectIdが1つのコールバックのみに使用できます。複数のObjectIdがあるオブジェクトに対するコールバックを受信するには、複数のサーバントを作成して、個別にアクティブ化する必要があります。同じサーバントを再利用できるのは、stop_object操作がシステムに対して、サーバントを元のObjectIdについて使用することを止めるように指示する場合のみです。
in PortableServer::Servant servant,
in CORBA::RepositoryId rep_id,
out string stroid)
raises ( ServantAlreadyActive );CORBA::Object_ptr start_persistent_systemid(
PortableServer::Servant servant,
const char* rep_id,
char*& stroid);
この引数は、システムによって設定され、ユーザーにとっては非透過的です。クライアントは、後になって、おそらくはクライアント・プロセスが終了して再起動してから、restart_persistent_systemidでオブジェクトを再アクティブ化する場合に、これを使用します。サーバントはすでにコールバックに使用されています。サーバントは、ObjectIdが1つのコールバックのみに使用できます。複数のObjectIdがあるコールバックを受信するには、複数のサーバントを作成して、個別にアクティブ化する必要があります。同じサーバントを再利用できるのは、stop操作がシステムに対して、元のObjectIdについてこのサーバントを使用することを止めるように指示する場合のみです。
in PortableServer::Servant servant,
in CORBA::RepositoryId rep_id,
in string stroid)
raises (ServantAlreadyActive, ObjectAlreadyActive);CORBA::Object_ptr restart_persistent_systemid(
PortableServer::Servant servant,
const char* rep_id
const char* stroid);
作成されているオブジェクト参照内で設定される、ユーザー指定のObjectIdの文字列化されたバージョン。start_persistent_systemidに対する以前の呼出しから返されたものである必要があります。サーバントはすでにコールバックに使用されています。サーバントは、ObjectIdが1つのコールバックのみに使用できます。複数のObjectIdがあるオブジェクトに対するコールバックを受信するには、複数のサーバントを作成して、個別にアクティブ化する必要があります。同じサーバントを再利用できるのは、stop_object操作がシステムに対して、サーバントを元のObjectIdについて使用することを止めるように指示する場合のみです。文字列化されたObjectIdはすでにコールバックに使用されています。ある特定のObjectIdには、1つのサーバントしか関連付けられません。別のサーバントに変更する場合は、まず現在使用しているサーバントでstop_objectを呼び出す必要があります。リポジトリIDがNULL文字列であったか、またはサーバントがNULLポインタであったか、または指定されたObjectIdが事前にシステムによって割り当てられていませんでした。
portableServer::Servant a_servant,
in CORBA::RepositoryId rep_id,
in string stroid)
raises ( ServantAlreadyActive, ObjectAlreadyActive );サーバントはすでにコールバックに使用されています。サーバントは、ObjectIdが1つのコールバックのみに使用できます。複数のObjectIdがあるオブジェクトに対するコールバックを受信するには、複数のサーバントを作成して、個別にアクティブ化する必要があります。同じサーバントを再利用できるのは、stop_object操作がシステムに対して、サーバントを元のObjectIdについて使用することを止めるように指示する場合のみです。文字列化されたObjectIdはすでにコールバックに使用されています。ある特定のObjectIdには、1つのサーバントしか関連付けられません。別のサーバントに変更する場合は、まず現在使用しているサーバントでstop_objectを呼び出す必要があります。