blob: 8aca1431706e2effc40713795c13451dbd8a8a84 (
plain)
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
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
|
//=============================================================================
/**
* @file Servant_Manager.h
*
* Helper class for <ServantActivator_i> and <ServantLoactor_i>.
*
* @author Kirthika Parameswaran <kirthika@cs.wustl.edu>
*/
//=============================================================================
#ifndef SERVANT_MANAGER_H
#define SERVANT_MANAGER_H
#include "ace/DLL.h"
#include "ace/Containers.h"
#include "tao/PortableServer/PortableServer.h"
#include "tao/PortableServer/Servant_Base.h"
#include "tao/PortableServer/Active_Object_Map.h"
#include "tao/ORB.h"
#include "ace/SString.h"
#if !defined (ACE_LACKS_PRAGMA_ONCE)
# pragma once
#endif /* ACE_LACKS_PRAGMA_ONCE */
/**
* @class ServantManager_i
*
* @brief This class is the helper class for the ServantActivator_i and
* ServantLocator_i classes.
*
* The methods provided by this class are used by the ServantActivator_i
* and ServantLocator_i classes. This class contains the common methods
* needed by them.
*/
class ServantManager_i
{
public:
/// This typedef is used to typecast the void* obtained when finding
/// a symbol in the DLL.
typedef PortableServer::Servant
(*SERVANT_FACTORY) (CORBA::ORB_ptr orb,
PortableServer::POA_ptr poa);
/// Initialization.
ServantManager_i (CORBA::ORB_ptr orb);
/// Destruction.
~ServantManager_i ();
/**
* Returns an ObjectId when given an DLL name and the factory method
* to be invoked in the DLL. The application developer can initialise the
* ServantActivator object by providing the dllname and the factory function.
*/
PortableServer::ObjectId_var create_dll_object_id (const char *libname,
const char *factory_function);
// @@ *done*Kirthika, please explain what this function is USED for, i.e.,
// who calls it and why?
/**
* Obtains a servant on activation by linking and loading the
* appropriate DLL and creating the servant object. The <str>
* argument is the ObjectId that contains the servant DLL name and
* the factory function name. The <long> argument is an
* servant-specific argument needed to create the servant for this
* particular use-case.
*/
PortableServer::Servant obtain_servant (const ACE_TCHAR *str,
PortableServer::POA_ptr poa);
/// The servant is destroyed and the DLL that was dynamically linked
/// is closed.
void destroy_servant (PortableServer::Servant servant,
const PortableServer::ObjectId &oid);
private:
/**
* Parse the string to obtain the DLL name and the factory function
* symbol that we will used to dynamically obtain the servant
* pointer.
*/
void parse_string (const ACE_TCHAR *s);
/// A reference to the ORB.
CORBA::ORB_var orb_;
/// The name of the dll containing the servant.
ACE_TString dllname_;
/// The symbol which on getting invoked will give us the servant
/// pointer.
ACE_TString create_symbol_;
typedef ACE_Hash_Map_Manager_Ex<PortableServer::ObjectId,
ACE_DLL *,
TAO_ObjectId_Hash,
ACE_Equal_To<PortableServer::ObjectId>,
ACE_Null_Mutex>
SERVANT_MAP;
/**
* This is the hash map object. The hash map is used to provide
* an quick access to the dll object associated with every servant
* using the unique ObjectId as key.
*/
SERVANT_MAP servant_map_;
};
#endif /* SERVANT_MANAGER_H */
|