blob: 8cb50b3d57c84882937360338664488bbdd22ef1 (
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
|
/* -*- C++ -*- */
/**
* @file ESF_Peer_Admin.h
*
* $Id$
*
* @author Carlos O'Ryan (coryan@cs.wustl.edu)
*
* http://doc.ece.uci.edu/~coryan/EC/index.html
*/
#ifndef TAO_ESF_PEER_ADMIN_H
#define TAO_ESF_PEER_ADMIN_H
#include "ESF_Proxy_Admin.h"
#if !defined (ACE_LACKS_PRAGMA_ONCE)
# pragma once
#endif /* ACE_LACKS_PRAGMA_ONCE */
/**
* @class TAO_ESF_Peer_Admin
*
* @brief Extend the Proxy_Admin interface to provide methods for
* filtering
*
* Some Event Services that perform filtering have to propagate
* the consumer connect/disconnect activities to the suppliers,
* and vice-versa.
* In that scenario the ESF_Proxy_Admin<> interface is augmented
* with connected()/reconnected()/disconnected() operations for
* the proxy peers (i.e. the ProxySuppliers for the ProxyConsumers
* and vice-versa).
*
* <H2>Requirements</H2>
*
* In addition to the requirements imposed by ESF_Proxy_Admin<>
* the PROXY interface must implement:
*
* @verbatim
* void connected (PEER *peer ACE_ENV_ARG_DECL_NOT_USED) throw ();
* void reconnected (PEER *peer ACE_ENV_ARG_DECL_NOT_USED) throw ();
* void disconnected (PEER *peer ACE_ENV_ARG_DECL_NOT_USED) throw ();
* @endverbatim
*
* Similarly, the PEER interface must implement:
*
* @verbatim
* void connected (PROXY *proxy ACE_ENV_ARG_DECL_NOT_USED) throw ();
* void reconnected (PROXY *proxy ACE_ENV_ARG_DECL_NOT_USED) throw ();
* void disconnected (PROXY *proxy ACE_ENV_ARG_DECL_NOT_USED) throw ();
* @endverbatim
*/
template<class EVENT_CHANNEL, class PROXY, class INTERFACE, class PEER>
class TAO_ESF_Peer_Admin : public TAO_ESF_Proxy_Admin<EVENT_CHANNEL,PROXY,INTERFACE>
{
public:
/// Constructor
TAO_ESF_Peer_Admin (EVENT_CHANNEL *ec);
/// destructor
virtual ~TAO_ESF_Peer_Admin (void);
/**
* A <peer> has connected, this is invoked when the peer's client
* has invoked the connect_xxx_yyy() method.
* The default implementation is a no-op.
*/
virtual void peer_connected (PEER *peer
ACE_ENV_ARG_DECL)
ACE_THROW_SPEC ((CORBA::SystemException));
/**
* A <peer> has reconnected, i.e. its client has invoked the
* connect_xxx_yyy() method, but the peer was connected already.
* The default implementation delegates on the collection
* <reconnected> method
*/
virtual void peer_reconnected (PEER *peer
ACE_ENV_ARG_DECL)
ACE_THROW_SPEC ((CORBA::SystemException));
/**
* A <peer> has been disconnected. The default implementation
* removes the object from the collection and deactivates the
* proxy.
*/
virtual void peer_disconnected (PEER *peer
ACE_ENV_ARG_DECL)
ACE_THROW_SPEC ((CORBA::SystemException));
};
// ****************************************************************
#if defined (ACE_TEMPLATES_REQUIRE_SOURCE)
#include "ESF_Peer_Admin.cpp"
#endif /* ACE_TEMPLATES_REQUIRE_SOURCE */
#if defined (ACE_TEMPLATES_REQUIRE_PRAGMA)
#pragma implementation ("ESF_Peer_Admin.cpp")
#endif /* ACE_TEMPLATES_REQUIRE_PRAGMA */
#endif /* TAO_ESF_PEER_ADMIN_H */
|