1/* 2 * Copyright 2015 The WebRTC Project Authors. All rights reserved. 3 * 4 * Use of this source code is governed by a BSD-style license 5 * that can be found in the LICENSE file in the root of the source 6 * tree. An additional intellectual property rights grant can be found 7 * in the file PATENTS. All contributing project authors may 8 * be found in the AUTHORS file in the root of the source tree. 9 */ 10 11#ifndef WEBRTC_BASE_NETWORKMONITOR_H_ 12#define WEBRTC_BASE_NETWORKMONITOR_H_ 13 14#include "webrtc/base/logging.h" 15#include "webrtc/base/scoped_ptr.h" 16#include "webrtc/base/sigslot.h" 17#include "webrtc/base/thread.h" 18 19namespace rtc { 20/* 21 * Receives network-change events via |OnNetworksChanged| and signals the 22 * networks changed event. 23 * 24 * Threading consideration: 25 * It is expected that all upstream operations (from native to Java) are 26 * performed from the worker thread. This includes creating, starting and 27 * stopping the monitor. This avoids the potential race condition when creating 28 * the singleton Java NetworkMonitor class. Downstream operations can be from 29 * any thread, but this class will forward all the downstream operations onto 30 * the worker thread. 31 * 32 * Memory consideration: 33 * NetworkMonitor is owned by the caller (NetworkManager). The global network 34 * monitor factory is owned by the factory itself but needs to be released from 35 * the factory creator. 36 */ 37// Generic network monitor interface. It starts and stops monitoring network 38// changes, and fires the SignalNetworksChanged event when networks change. 39class NetworkMonitorInterface { 40 public: 41 NetworkMonitorInterface(); 42 virtual ~NetworkMonitorInterface(); 43 44 sigslot::signal0<> SignalNetworksChanged; 45 46 virtual void Start() = 0; 47 virtual void Stop() = 0; 48 49 // Implementations should call this method on the base when networks change, 50 // and the base will fire SignalNetworksChanged on the right thread. 51 virtual void OnNetworksChanged() = 0; 52}; 53 54class NetworkMonitorBase : public NetworkMonitorInterface, 55 public MessageHandler, 56 public sigslot::has_slots<> { 57 public: 58 NetworkMonitorBase(); 59 ~NetworkMonitorBase() override; 60 61 void OnNetworksChanged() override; 62 63 void OnMessage(Message* msg) override; 64 65 private: 66 Thread* thread_; 67}; 68 69/* 70 * NetworkMonitorFactory creates NetworkMonitors. 71 */ 72class NetworkMonitorFactory { 73 public: 74 // This is not thread-safe; it should be called once (or once per audio/video 75 // call) during the call initialization. 76 static void SetFactory(NetworkMonitorFactory* factory); 77 78 static void ReleaseFactory(NetworkMonitorFactory* factory); 79 static NetworkMonitorFactory* GetFactory(); 80 81 virtual NetworkMonitorInterface* CreateNetworkMonitor() = 0; 82 83 virtual ~NetworkMonitorFactory(); 84 85 protected: 86 NetworkMonitorFactory(); 87}; 88 89} // namespace rtc 90 91#endif // WEBRTC_BASE_NETWORKMONITOR_H_ 92