| OLD | NEW |
| (Empty) |
| 1 // Copyright (c) 2012 The Chromium Authors. All rights reserved. | |
| 2 // Use of this source code is governed by a BSD-style license that can be | |
| 3 // found in the LICENSE file. | |
| 4 | |
| 5 #ifndef REMOTING_JINGLE_GLUE_SIGNAL_STRATEGY_H_ | |
| 6 #define REMOTING_JINGLE_GLUE_SIGNAL_STRATEGY_H_ | |
| 7 | |
| 8 #include <string> | |
| 9 | |
| 10 #include "base/basictypes.h" | |
| 11 #include "base/memory/scoped_ptr.h" | |
| 12 | |
| 13 namespace buzz { | |
| 14 class XmlElement; | |
| 15 } // namespace buzz | |
| 16 | |
| 17 namespace remoting { | |
| 18 | |
| 19 class SignalStrategy { | |
| 20 public: | |
| 21 enum State { | |
| 22 // Connection is being established. | |
| 23 CONNECTING, | |
| 24 | |
| 25 // Signalling is connected. | |
| 26 CONNECTED, | |
| 27 | |
| 28 // Connection is closed due to an error or because Disconnect() | |
| 29 // was called. | |
| 30 DISCONNECTED, | |
| 31 }; | |
| 32 | |
| 33 enum Error { | |
| 34 OK, | |
| 35 AUTHENTICATION_FAILED, | |
| 36 NETWORK_ERROR, | |
| 37 }; | |
| 38 | |
| 39 // Callback interface for signaling event. Event handlers are not | |
| 40 // allowed to destroy SignalStrategy, but may add or remove other | |
| 41 // listeners. | |
| 42 class Listener { | |
| 43 public: | |
| 44 virtual ~Listener() {} | |
| 45 | |
| 46 // Called after state of the connection has changed. If the state | |
| 47 // is DISCONNECTED, then GetError() can be used to get the reason | |
| 48 // for the disconnection. | |
| 49 virtual void OnSignalStrategyStateChange(State state) = 0; | |
| 50 | |
| 51 // Must return true if the stanza was handled, false | |
| 52 // otherwise. The signal strategy must not be deleted from a | |
| 53 // handler of this message. | |
| 54 virtual bool OnSignalStrategyIncomingStanza( | |
| 55 const buzz::XmlElement* stanza) = 0; | |
| 56 }; | |
| 57 | |
| 58 SignalStrategy() {} | |
| 59 virtual ~SignalStrategy() {} | |
| 60 | |
| 61 // Starts connection attempt. If connection is currently active | |
| 62 // disconnects it and opens a new connection (implicit disconnect | |
| 63 // triggers CLOSED notification). Connection is finished | |
| 64 // asynchronously. | |
| 65 virtual void Connect() = 0; | |
| 66 | |
| 67 // Disconnects current connection if connected. Triggers CLOSED | |
| 68 // notification. | |
| 69 virtual void Disconnect() = 0; | |
| 70 | |
| 71 // Returns current state. | |
| 72 virtual State GetState() const = 0; | |
| 73 | |
| 74 // Returns the last error. Set when state changes to DISCONNECT. | |
| 75 virtual Error GetError() const = 0; | |
| 76 | |
| 77 // Returns local JID or an empty string when not connected. | |
| 78 virtual std::string GetLocalJid() const = 0; | |
| 79 | |
| 80 // Add a |listener| that can listen to all incoming | |
| 81 // messages. Doesn't take ownership of the |listener|. All listeners | |
| 82 // must be removed before this object is destroyed. | |
| 83 virtual void AddListener(Listener* listener) = 0; | |
| 84 | |
| 85 // Remove a |listener| previously added with AddListener(). | |
| 86 virtual void RemoveListener(Listener* listener) = 0; | |
| 87 | |
| 88 // Sends a raw XMPP stanza. | |
| 89 virtual bool SendStanza(scoped_ptr<buzz::XmlElement> stanza) = 0; | |
| 90 | |
| 91 // Returns new ID that should be used for the next outgoing IQ | |
| 92 // request. | |
| 93 virtual std::string GetNextId() = 0; | |
| 94 | |
| 95 private: | |
| 96 DISALLOW_COPY_AND_ASSIGN(SignalStrategy); | |
| 97 }; | |
| 98 | |
| 99 } // namespace remoting | |
| 100 | |
| 101 #endif // REMOTING_JINGLE_GLUE_SIGNAL_STRATEGY_H_ | |
| OLD | NEW |