Index: sync/internal_api/public/base/cancelation_signal.h |
diff --git a/sync/internal_api/public/base/cancelation_signal.h b/sync/internal_api/public/base/cancelation_signal.h |
deleted file mode 100644 |
index 6a84b7a1c6b96ff18a446c4c3a7051c155b5cb7c..0000000000000000000000000000000000000000 |
--- a/sync/internal_api/public/base/cancelation_signal.h |
+++ /dev/null |
@@ -1,72 +0,0 @@ |
-// Copyright 2013 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 SYNC_INTERNAL_API_PUBLIC_BASE_CANCELATION_SIGNAL_H_ |
-#define SYNC_INTERNAL_API_PUBLIC_BASE_CANCELATION_SIGNAL_H_ |
- |
-#include "base/synchronization/lock.h" |
-#include "sync/base/sync_export.h" |
- |
-namespace syncer { |
- |
-class CancelationObserver; |
- |
-// This class is used to allow one thread to request that another abort and |
-// return early. |
-// |
-// The signalling thread owns this class and my call Signal() at any time. |
-// After that call, this class' IsSignalled() will always return true. The |
-// intended use case is that the task intending to support early exit will |
-// periodically check the value of IsSignalled() to see if it should return |
-// early. |
-// |
-// The receiving task may also choose to register an CancelationObserver whose |
-// OnSignalReceived() method will be executed on the signaller's thread when |
-// Signal() is called. This may be used for sending an early Signal() to a |
-// WaitableEvent. The registration of the handler is necessarily racy. If |
-// Signal() is executes before TryRegisterHandler(), TryRegisterHandler() will |
-// not perform any registration and return false. That function's caller must |
-// handle this case. |
-// |
-// This class supports only one handler, though it could easily support multiple |
-// observers if we found a use case for such a feature. |
-class SYNC_EXPORT CancelationSignal { |
- public: |
- CancelationSignal(); |
- ~CancelationSignal(); |
- |
- // Tries to register a handler to be invoked when Signal() is called. |
- // |
- // If Signal() has already been called, returns false without registering |
- // the handler. Returns true when the registration is successful. |
- // |
- // If the registration was successful, the handler must be unregistered with |
- // UnregisterHandler before this CancelationSignal is destroyed. |
- bool TryRegisterHandler(CancelationObserver* handler); |
- |
- // Unregisters the abort handler. |
- void UnregisterHandler(CancelationObserver* handler); |
- |
- // Returns true if Signal() has been called. |
- bool IsSignalled(); |
- |
- // Sets the stop_requested_ flag and calls the OnSignalReceived() method of |
- // the registered handler, if there is one registered at the time. |
- // SignalReceived() will be called with the |signal_lock_| held. |
- void Signal(); |
- |
- private: |
- // Protects all members of this class. |
- base::Lock signal_lock_; |
- |
- // True if Signal() has been invoked. |
- bool signalled_; |
- |
- // The registered abort handler. May be NULL. |
- CancelationObserver* handler_; |
-}; |
- |
-} // namespace syncer |
- |
-#endif // SYNC_INTERNAL_API_PUBLIC_BASE_CANCELATION_SIGNAL_H_ |