1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
|
// This may look like C, but it's really -*- C++ -*-
// $Id$
// ================================================================
//
// = LIBRARY
// TAO/examples/POA/On_Demand_Loading
//
// = FILENAME
// Servant_Activator.h
//
// = DESCRIPTION
// Defines a <ServantActivator_i> class, which uses a
// Servant_Manager to activate a servant by loading it and
// associates it with an object on-demand.
//
// = AUTHOR
// Kirthika Parameswaran <kirthika@cs.wustl.edu>
//
// ================================================================
#ifndef SERVANT_ACTIVATOR_H
#define SERVANT_ACTIVATOR_H
#include "Servant_Manager.h"
#include "tao/PortableServer/ServantActivatorC.h"
#include "tao/LocalObject.h"
class ServantActivator_i :
public virtual PortableServer::ServantActivator,
public virtual TAO_Local_RefCounted_Object
{
//= TITLE
// Servant Activator for the test servant.
//
//= DESCRIPTION
// This class associates an unassociated servant with an object in
// the POA Active Object Map.
public:
ServantActivator_i (CORBA::ORB_ptr orb);
// Initialization.
virtual PortableServer::Servant incarnate (const PortableServer::ObjectId &oid,
PortableServer::POA_ptr poa)
ACE_THROW_SPEC ((CORBA::SystemException,
PortableServer::ForwardRequest));
// This method is invoked by a POA with USE_SERVANT_MANAGER and
// RETAIN policies, whenever it receives a request for a test object
// that is not currently active. When an servant pointer
// corresponding to objectId is not found in the Active Object Map,
// the POA hands over the job of obtaining the servant to the
// Servant Manager. Depending upon whether the POA is created with
// RETAIN or NON_RETAIN as the servant_retention policy, the Servant
// Activator or the Servant Locator interface is invoked
// respectively.
virtual void etherealize (const PortableServer::ObjectId &oid,
PortableServer::POA_ptr adapter,
PortableServer::Servant servant,
CORBA::Boolean cleanup_in_progress,
CORBA::Boolean remaining_activations)
ACE_THROW_SPEC ((CORBA::SystemException));
// This method is invoked whenever a test servant is
// deactivated. This occurs when the POA is destroyed or the Object
// is deactivated. When the POA is getting destroyed, it needs to
// deactivate every object in the Active Object Map and on that call
// the ServantActivator invokes this method which will destroy the
// servant associated with the object.
PortableServer::ObjectId_var create_dll_object_id (const char *dllname,
const char *factory_function);
// Returns an ObjectId when given a DLL name and the factory
// function in the DLL that will create an appropriate Servant.
private:
ServantManager_i servant_manager_;
// An ServantManager object that provides utility methods. The
// methods include obtaining the servant using an ACE_DLL object,
// destroying the servant and extracting the dllname and factory
// function from the ObjectId.
};
#endif /* SERVANT_ACTIVATOR_H */
|
