Introducing remoting::Stoppable helper base class implementing asynchronous shutdown on a specific t

remoting/base/shutdownable.h

+// Copyright (c) 2012 The Chromium Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style license that can be
+// found in the LICENSE file.
+
+#ifndef REMOTING_BASE_SHUTDOWNABLE_H_
+#define REMOTING_BASE_SHUTDOWNABLE_H_
+
+#include "base/basictypes.h"
+#include "base/callback.h"
+#include "base/memory/ref_counted.h"
+
+namespace base {
+class SingleThreadTaskRunner;
+}  // namespace base
+
+namespace remoting {
+
+// A wrapper implementing two-step shutdown for an object.
+class Shutdownable {
+ public:
+  typedef base::Callback<void(Shutdownable*)> Callback;
+
+  // Constructs an object and stores the callback to be posted to |task_runner|
+  // once the object has been shutdown completely.
+  explicit Shutdownable(scoped_refptr<base::SingleThreadTaskRunner> task_runner,
+                        const Callback& done);
+  virtual ~Shutdownable();
+
+  // Initiates shutdown. It can be called by both the owner of the object and
+  // the object itself resulting in the same shutdown sequence.
+  void Shutdown();
+
+ protected:
+  // Completes shutdown by posting the completion task on the caller's message
+  // loop.
+  void CompleteShutdown();
+
+  // Derived classes can override this method to implement additional shutdown
+  // logic.
+  virtual void DoShutdown();
+
+  enum State {
+    kRunning,
+    kShutdown,
+    kStopped
+  };
+
+  State get_shutdownable_state() const { return state_; }
+
+ private:
+  // The target task runner where the shutdown notification will be posted.
+  scoped_refptr<base::SingleThreadTaskRunner> task_runner_;
+
+  // The shutdown notification callback.
+  Callback done_;
+
+  State state_;
+
+  DISALLOW_COPY_AND_ASSIGN(Shutdownable);
+};
+
+}  // namespace remoting
+
+#endif  // REMOTING_BASE_SHUTDOWNABLE_H_