remoting/jingle_glue/signal_strategy.h

   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_