Support external task cancellation mechanisms in base::Callback::IsCancelled

base/bind_helpers.h

 // Copyright (c) 2011 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.
 
 // This defines a set of argument wrappers and related factory methods that
 // can be used specify the refcounting and reference semantics of arguments
 // that are bound by the Bind() function in base/bind.h.
 //
 // It also defines a set of simple functions and utilities that people want
 // when using Callback<> and Bind().
@@ skipping 161 matching lines @@
 namespace base {
 
 template <typename T>
 struct IsWeakReceiver;
 
 template <typename>
 struct BindUnwrapTraits;
 
 namespace internal {
 
+template <typename Functor, typename SFINAE = void>
+struct FunctorTraits;
+
 template <typename T>
 class UnretainedWrapper {
  public:
   explicit UnretainedWrapper(T* o) : ptr_(o) {}
   T* get() const { return ptr_; }
  private:
   T* ptr_;
 };
 
 template <typename T>
@@ skipping 322 matching lines @@
   }
 };
 
 template <typename T>
 struct BindUnwrapTraits<internal::PassedWrapper<T>> {
   static T Unwrap(const internal::PassedWrapper<T>& o) {
     return o.Take();
   }
 };
 
+// An injection point to support Callback::IsCancelled in a specific form of
+// base::Bind.

[dcheng, 2016/11/10 07:36:23]

Nit: I'd make this comment mostly descriptive about the purpose (allow
customization of callback's cancellation semantics) and fix the references to
Run() below.

// CallbackCancellationTraits allows customization of Callback's
// cancellation semantics. By default, callbacks are not cancellable.
// A specialization should set is_cancellable = true and implement an
// IsCancelled() that returns if the callback should be cancelled.

[alex clarke (OOO till 29th), 2016/11/10 10:02:21]

+1

[tzik, 2016/11/15 11:40:35]

Done.

+// Specialize CallbackCancellationTraits to support Callback::IsCancelled, set
+// is_cancellable to true in the specialization, and implement Run() method.
+// CallbackCancellationTraits<>::Run() should return true if the resulting
+// callback is cancelled.
+template <typename Functor, typename BoundArgsTuple, typename SFINAE = void>
+struct CallbackCancellationTraits {
+  static constexpr bool is_cancellable = false;
+};
+
+// Specialization for method bound to weak pointer receiver.
+template <typename Functor, typename... BoundArgs>
+struct CallbackCancellationTraits<
+    Functor,
+    std::tuple<BoundArgs...>,
+    typename std::enable_if<
+        internal::IsWeakMethod<internal::FunctorTraits<Functor>::is_method,
+                               BoundArgs...>::value>::type> {
+  static constexpr bool is_cancellable = true;
+
+  template <typename Receiver, typename... Args>
+  static bool IsCancelled(const Functor&,
+                          const Receiver& receiver,
+                          const Args&...) {
+    return !receiver;
+  }
+};
+
+// Specialization for a nested bind.
+template <typename Signature,
+          typename... BoundArgs,
+          internal::CopyMode copy_mode,
+          internal::RepeatMode repeat_mode>
+struct CallbackCancellationTraits<Callback<Signature, copy_mode, repeat_mode>,
+                                  std::tuple<BoundArgs...>> {
+  static constexpr bool is_cancellable = true;
+
+  template <typename Functor>
+  static bool IsCancelled(const Functor& functor, const BoundArgs&...) {
+    return functor.IsCancelled();
+  }
+};
+
 }  // namespace base
 
 #endif  // BASE_BIND_HELPERS_H_