ppapi/utility/private/network_list_observer_private.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 PPAPI_UTILITY_PRIVATE_NETWORK_LIST_OBSERVER_H_
   6 #define PPAPI_UTILITY_PRIVATE_NETWORK_LIST_OBSERVER_H_
   7
   8 #include "ppapi/cpp/private/network_monitor_private.h"
   9
  10 namespace pp {
  11
  12 class NetworkListPrivate;
  13
  14 /// <code>NetworkListObserver</code> is a wrapper for
  15 /// <code>pp::NetworkMonitorPrivate</code> that makes it easier to
  16 /// handle network list update notifications. A child class must
  17 /// implement the <code>OnNetworkListChanged()</code> method. That
  18 /// method will be called once after the object is created and then
  19 /// every time network configuration changes.
  20 class NetworkListObserverPrivate {
  21  public:
  22   explicit NetworkListObserverPrivate(const InstanceHandle& instance);
  23   virtual ~NetworkListObserverPrivate();
  24
  25  protected:
  26   /// Called once after this object is created and later every time
  27   /// network configuration changes. Child classes must implement this
  28   /// method.
  29   ///
  30   /// @param[in] list The current list of network interfaces.
  31   virtual void OnNetworkListChanged(const NetworkListPrivate& list) = 0;
  32
  33  private:
  34   // Private copy constructor and assign operator to disallow copying of this
  35   // object. This is necessary to guarantee that |monitor_| is not shared with
  36   // another list observer and is always destroyed when this object is
  37   // destroyed.
  38   NetworkListObserverPrivate(const NetworkListObserverPrivate&);
  39   void operator=(const NetworkListObserverPrivate&);
  40
  41   static void NetworkListCallbackHandler(void* user_data,
  42                                          PP_Resource list_resource);
  43
  44   NetworkMonitorPrivate monitor_;
  45 };
  46
  47 }  // namespace pp
  48
  49 #endif  // PPAPI_UTILITY_PRIVATE_NETWORK_LIST_OBSERVER_H_