1 | // [License]
|
---|
2 | // The Ariba-Underlay Copyright
|
---|
3 | //
|
---|
4 | // Copyright (c) 2008-2009, Institute of Telematics, UniversitÀt Karlsruhe (TH)
|
---|
5 | //
|
---|
6 | // Institute of Telematics
|
---|
7 | // UniversitÀt Karlsruhe (TH)
|
---|
8 | // Zirkel 2, 76128 Karlsruhe
|
---|
9 | // Germany
|
---|
10 | //
|
---|
11 | // Redistribution and use in source and binary forms, with or without
|
---|
12 | // modification, are permitted provided that the following conditions are
|
---|
13 | // met:
|
---|
14 | //
|
---|
15 | // 1. Redistributions of source code must retain the above copyright
|
---|
16 | // notice, this list of conditions and the following disclaimer.
|
---|
17 | // 2. Redistributions in binary form must reproduce the above copyright
|
---|
18 | // notice, this list of conditions and the following disclaimer in the
|
---|
19 | // documentation and/or other materials provided with the distribution.
|
---|
20 | //
|
---|
21 | // THIS SOFTWARE IS PROVIDED BY THE INSTITUTE OF TELEMATICS ``AS IS'' AND
|
---|
22 | // ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
---|
23 | // IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
|
---|
24 | // PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE INSTITUTE OF TELEMATICS OR
|
---|
25 | // CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
|
---|
26 | // EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
|
---|
27 | // PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
|
---|
28 | // PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
|
---|
29 | // LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
|
---|
30 | // NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
|
---|
31 | // SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
---|
32 | //
|
---|
33 | // The views and conclusions contained in the software and documentation
|
---|
34 | // are those of the authors and should not be interpreted as representing
|
---|
35 | // official policies, either expressed or implied, of the Institute of
|
---|
36 | // Telematics.
|
---|
37 | // [License]
|
---|
38 |
|
---|
39 | #ifndef COMMUNICATIONLISTENER_H_
|
---|
40 | #define COMMUNICATIONLISTENER_H_
|
---|
41 |
|
---|
42 | namespace ariba {
|
---|
43 | // forward declaration
|
---|
44 | class CommunicationListener;
|
---|
45 | }
|
---|
46 |
|
---|
47 | #include "Message.h"
|
---|
48 | #include "Identifiers.h"
|
---|
49 | #include "LinkProperties.h"
|
---|
50 | #include "DataMessage.h"
|
---|
51 |
|
---|
52 | namespace ariba {
|
---|
53 |
|
---|
54 | /**
|
---|
55 | * Listener for communication events on links.
|
---|
56 | */
|
---|
57 | class CommunicationListener {
|
---|
58 | friend class Node;
|
---|
59 | protected:
|
---|
60 | CommunicationListener();
|
---|
61 | virtual ~CommunicationListener();
|
---|
62 |
|
---|
63 | // --- link events ---
|
---|
64 |
|
---|
65 | virtual void onLinkUp(const LinkID& lnk, const NodeID& remote);
|
---|
66 |
|
---|
67 | virtual void onLinkDown(const LinkID& lnk, const NodeID& remote);
|
---|
68 |
|
---|
69 | virtual void onLinkChanged(const LinkID& lnk, const NodeID& remote);
|
---|
70 |
|
---|
71 | virtual void onLinkFail(const LinkID& lnk, const NodeID& remote);
|
---|
72 |
|
---|
73 | virtual void onLinkQoSChanged(const LinkID& lnk, const NodeID& remote,
|
---|
74 | const LinkProperties& prop);
|
---|
75 |
|
---|
76 | virtual bool onLinkRequest(const NodeID& remote, const DataMessage& msg);
|
---|
77 |
|
---|
78 | // --- general receive method ---
|
---|
79 |
|
---|
80 | virtual void onMessage(const DataMessage& msg, const NodeID& remote,
|
---|
81 | const LinkID& lnk = LinkID::UNSPECIFIED);
|
---|
82 |
|
---|
83 | // --- extended message functionality ---
|
---|
84 | // virtual void onMessageSent(seqnum_t seq_num, bool failed,
|
---|
85 | // const DataMessage& msg = DataMessage::UNSPECIFIED);
|
---|
86 |
|
---|
87 | // --- dht functionality ---
|
---|
88 | // virtual void onGetResponse( const Identifier<> id, const Message* msg );
|
---|
89 | // virtual void onPutResponse( const Identifier<> id, const Message* msg );
|
---|
90 | };
|
---|
91 |
|
---|
92 | } // namespace ariba
|
---|
93 |
|
---|
94 | #endif /* COMMUNICATIONLISTENER_H_ */
|
---|