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
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
|
/* -*- C++ -*- */
//=============================================================================
/**
* @file FT_FaultConsumer.h
*
* $Id$
*
* This file is part of TAO's implementation of Fault Tolerant CORBA.
*
* @author Steve Totten <totten_s@ociweb.com>
*/
//=============================================================================
#ifndef FT_FAULT_CONSUMER_H_
#define FT_FAULT_CONSUMER_H_
#include /**/ "ace/pre.h"
#if !defined (ACE_LACKS_PRAGMA_ONCE)
#pragma once
#endif /* ACE_LACKS_PRAGMA_ONCE */
#include "orbsvcs/CosNotifyCommS.h"
#include "orbsvcs/FT_NotifierC.h"
#include "orbsvcs/FT_ReplicationManagerC.h"
#include "orbsvcs/FT_ReplicationManager/FT_FaultEventDescriptor.h"
namespace TAO
{
/**
* Implement the CosNotifyComm::StructuredPushConsumer interface.
*
*/
class FT_FaultConsumer
: public virtual POA_CosNotifyComm::StructuredPushConsumer
, public virtual PortableServer::RefCountServantBase
{
//////////////////////
// non-CORBA interface
public:
/**
* Default constructor.
*/
FT_FaultConsumer ();
/**
* Destructor.
*/
virtual ~FT_FaultConsumer ();
/**
* Connect to the FT::FaultNotifier.
* Note: We make the following assumptions about what the
* application will do:
* - Create an instance of this consumer class.
* - Obtain the object reference of the FaultNotifier to which this
* consumer should connect.
* - Call this init() method, passing it the POA with which we
* have been activated, the FaultNotifier, and ReplicationManager
* object references.
*/
int init (
PortableServer::POA_ptr poa,
FT::FaultNotifier_ptr fault_notifier,
FT::ReplicationManager_ptr replication_manager
ACE_ENV_ARG_DECL);
/**
* Clean house for process shut down.
* - Disconnect from FT::FaultNotifier.
* - Deactivate from the POA.
*/
int fini (ACE_ENV_SINGLE_ARG_DECL);
/**
* Accessor for a duplicate of this consumer's object reference.
*/
CosNotifyComm::StructuredPushConsumer_ptr consumer_ref ();
//@@ For testing purposes only, will be removed later.
/**
* Accessor for the number of notifications we have received.
*/
size_t notifications () const;
public:
/////////////////////////
// Implementation methods
private:
/**
* Validate event type to make sure it is one we can handle.
*/
int validate_event_type (
const CosNotification::StructuredEvent & event);
/**
* Analyze a fault event.
*/
int analyze_fault_event (
const CosNotification::StructuredEvent & event,
TAO::FT_FaultEventDescriptor & fault_event_desc
ACE_ENV_ARG_DECL_WITH_DEFAULTS)
ACE_THROW_SPEC ((CORBA::SystemException, CosEventComm::Disconnected));
/// Helper functions for fault analysis.
char* extract_type_id (const CORBA::Any& val);
FT::ObjectGroupId extract_object_group_id (const CORBA::Any& val);
/**
* Set a new primary member on an object group.
*/
int set_new_primary_on_object_group (
FT::ObjectGroup_ptr object_group,
const FT::Location & the_location
ACE_ENV_ARG_DECL_WITH_DEFAULTS
)
ACE_THROW_SPEC ((
CORBA::SystemException
, PortableGroup::ObjectGroupNotFound
, PortableGroup::MemberNotFound
, FT::PrimaryNotSet
, FT::BadReplicationStyle
));
/**
* Extract the value of the MinimumNumberReplicas property from
* the_criteria.
*/
int get_minimum_number_replicas (
const char * type_id,
const PortableGroup::Criteria & the_criteria,
CORBA::UShort & minimum_number_replicas);
public:
/**
* @name POA_CosNotifyComm::StructuredPushConsumer Methods
*
* Methods required by the POA_CosNotifyComm::StructuredPushConsumer
* interface.
*/
//@{
////////////////
// CORBA methods
virtual void push_structured_event (
const CosNotification::StructuredEvent ¬ification
ACE_ENV_ARG_DECL_WITH_DEFAULTS
)
ACE_THROW_SPEC ((CORBA::SystemException, CosEventComm::Disconnected));
virtual void offer_change (
const CosNotification::EventTypeSeq & added,
const CosNotification::EventTypeSeq & removed
ACE_ENV_ARG_DECL_WITH_DEFAULTS
)
ACE_THROW_SPEC ((CORBA::SystemException, CosNotifyComm::InvalidEventType));
virtual void disconnect_structured_push_consumer (
ACE_ENV_SINGLE_ARG_DECL_WITH_DEFAULTS
)
ACE_THROW_SPEC ((CORBA::SystemException));
//@}
////////////////////
// Forbidden methods
private:
/// Copy constructor.
FT_FaultConsumer (const FT_FaultConsumer & rhs);
/// Assignment operator.
FT_FaultConsumer & operator = (const FT_FaultConsumer & rhs);
///////////////
// Data Members
private:
/// The POA with which we are activated.
PortableServer::POA_var poa_;
/// The ObjectId from our activation in the POA.
PortableServer::ObjectId_var object_id_;
/// The FaultNotifier's object reference.
FT::FaultNotifier_var fault_notifier_;
/// The ReplicationManager's object reference.
FT::ReplicationManager_var replication_manager_;
/// ConsumerId assigned by the notifier.
FT::FaultNotifier::ConsumerId consumer_id_;
/// Our consumer object reference.
CosNotifyComm::StructuredPushConsumer_var consumer_ref_;
///TODO: Remove this later, it is just for testing.
// Keep track of how many notifications we have received.
size_t notifications_;
};
} // namespace TAO
#include /**/ "ace/post.h"
#endif /* FT_FAULT_CONSUMER_H_ */
|
