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
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
|
// This may look like C, but it's really -*- C++ -*-
// $Id$
// ============================================================================
//
// = LIBRARY
// TAO
//
// = FILENAME
// Servant_Base.h
//
// = AUTHOR
// Irfan Pyarali
//
// ============================================================================
#ifndef TAO_SERVANT_BASE_H
#define TAO_SERVANT_BASE_H
#include "tao/corbafwd.h"
#include "tao/POAC.h"
class TAO_Operation_Table;
class TAO_Export TAO_ServantBase
{
// = TITLE
// Base class for skeletons and servants.
//
// = DESCRIPTION
// The POA spec requires that all servants inherit from this
// class.
public:
friend class TAO_POA;
friend class CORBA_Object;
virtual ~TAO_ServantBase (void);
// destructor
TAO_ServantBase &operator= (const TAO_ServantBase &);
// assignment operator.
virtual PortableServer::POA_ptr _default_POA (CORBA_Environment &TAO_IN_ENV = CORBA::default_environment ());
// Returns the default POA for this servant.
virtual void *_downcast (const char *repository_id) = 0;
// Get the correct vtable.
virtual STUB_Object *_create_stub (CORBA_Environment &TAO_IN_ENV = CORBA::default_environment ());
// This is an auxiliar method for _this() and _narrow().
protected:
TAO_ServantBase (void);
// Default constructor, only derived classes can be created.
TAO_ServantBase (const TAO_ServantBase &);
// Copy constructor, protected so no instances can be created.
virtual CORBA::Boolean _is_a (const char* logical_type_id,
CORBA_Environment &TAO_IN_ENV = CORBA::default_environment ());
// Local implementation of the CORBA::Object::_is_a method.
virtual void _dispatch (CORBA::ServerRequest &request,
void *context,
CORBA_Environment &TAO_IN_ENV = CORBA::default_environment ()) = 0;
// Dispatches a request to the object: find the operation, cast the
// type to the most derived type, demarshall all the parameters from
// the request and finally invokes the operation, storing the
// results and out parameters (if any) or the exceptions thrown into
// <request>.
virtual int _find (const char *opname,
TAO_Skeleton &skelfunc);
// Find an operation in the operation table.
virtual int _bind (const char *opname,
const TAO_Skeleton skel_ptr);
// Register a CORBA IDL operation name.
virtual const char *_interface_repository_id (void) const = 0;
// Get this interface's repository id.
TAO_Operation_Table *optable_;
// The operation table for this servant, it is initialized by the
// most derived class.
};
class TAO_Export TAO_Servant_Hash
{
public:
u_long operator () (PortableServer::Servant servant) const;
// Returns hash value.
};
class TAO_Export TAO_Local_ServantBase : public TAO_ServantBase
{
// = TITLE
// Base class for local skeletons and servants.
protected:
STUB_Object *_create_stub (CORBA_Environment &TAO_IN_ENV = CORBA::default_environment ());
// This is an auxiliar method for _this(). Make sure *not* to
// register with the default POA
};
class TAO_Export TAO_DynamicImplementation : public virtual TAO_ServantBase
{
// = TITLE
// Base class for DSI.
//
// = DESCRIPTION
// It is expected that the <invoke> and <_primary_interface>
// methods will be only invoked by the POA in the context of
// serving a CORBA request. Invoking this method in other
// circumstances may lead to unpredictable results.
public:
virtual void invoke (CORBA::ServerRequest_ptr request,
CORBA_Environment &TAO_IN_ENV = CORBA::default_environment ()) = 0;
// The invoke() method receives requests issued to any CORBA object
// incarnated by the DSI servant and performs the processing
// necessary to execute the request.
virtual CORBA::RepositoryId _primary_interface (const PortableServer::ObjectId &oid,
PortableServer::POA_ptr poa,
CORBA_Environment &TAO_IN_ENV = CORBA::default_environment ()) = 0;
// The _primary_interface() method receives an ObjectId value and a
// POA_ptr as input parameters and returns a valid RepositoryId
// representing the most-derived interface for that oid.
CORBA::Object_ptr _this (CORBA_Environment &TAO_IN_ENV = CORBA::default_environment ());
// Returns a CORBA::Object_ptr for the target object.
protected:
virtual const char *_interface_repository_id (void) const;
// Return 0. Should never be used.
virtual void *_downcast (const char *repository_id);
// Simply returns "this"
virtual STUB_Object *_create_stub (CORBA_Environment &TAO_IN_ENV = CORBA::default_environment ());
// This is an auxiliar method for _this() and _narrow().
virtual void _dispatch (CORBA::ServerRequest &request,
void *context,
CORBA_Environment &TAO_IN_ENV = CORBA::default_environment ());
// Turns around and calls invoke.
};
#if defined (__ACE_INLINE__)
# include "tao/Servant_Base.i"
#endif /* __ACE_INLINE__ */
#endif /* TAO_SERVANT_BASE_H */
|
