| Index: chrome/browser/chromeos/file_system_provider/queue.h
|
| diff --git a/chrome/browser/chromeos/file_system_provider/queue.h b/chrome/browser/chromeos/file_system_provider/queue.h
|
| index 106a9039f12faae1c295e5ba1275078b7ff668ce..7eca4f96dba929d3d794d4d0d92b1a7a1ec71ca0 100644
|
| --- a/chrome/browser/chromeos/file_system_provider/queue.h
|
| +++ b/chrome/browser/chromeos/file_system_provider/queue.h
|
| @@ -27,16 +27,16 @@ namespace file_system_provider {
|
| // 4. Call Remove() to remove a completed task from the queue and run other
|
| // enqueued tasks.
|
| //
|
| -// Enqueued tasks can be aborted with the callback returned by Enqueue() any
|
| -// time until they are marked as completed. Aborted tasks are automatically
|
| -// removed from the queue if they were not executed yet, or executed but not
|
| -// completed.
|
| +// Enqueued tasks can be aborted with Abort() at any time until they are marked
|
| +// as completed or removed from the queue, as long as the task supports aborting
|
| +// (it's abort callback is not NULL). Aorting does not remove the task from the
|
| +// queue.
|
| //
|
| // In most cases you'll want to call Remove() and Complete() one after the
|
| // other. However, in some cases you may want to separate it. Eg. for limiting
|
| // number of opened files, you may want to call Complete() after opening is
|
| // completed, but Remove() after the file is closed. Note, that they can be
|
| -// called at most once, and they must not be called for aborted tasks.
|
| +// called at most once.
|
| class Queue {
|
| public:
|
| typedef base::Callback<AbortCallback(void)> AbortableCallback;
|
| @@ -52,13 +52,16 @@ class Queue {
|
| // Enqueues a task using a token generated with NewToken(). The task will be
|
| // executed if there is space in the internal queue, otherwise it will wait
|
| // until another task is finished. Once the task is finished, Complete() and
|
| - // Remove() must be called.
|
| - //
|
| - // The returned callback can be called to abort the task at any time. Once
|
| - // aborted, the task is automatically removed from the queue if the task
|
| - // was not executed, or executed but not completed, despite the result of
|
| - // |callback|'s aborting closure.
|
| - AbortCallback Enqueue(size_t token, const AbortableCallback& callback);
|
| + // Remove() must be called. The callback's abort callback may be NULL. In
|
| + // such case, Abort() must not be called.
|
| + void Enqueue(size_t token, const AbortableCallback& callback);
|
| +
|
| + // Forcibly aborts a previously enqueued task. May be called at any time as
|
| + // long as the task is still in the queue and is not marked as completed.
|
| + // Note, that Remove() must be called in order to remove the task from the
|
| + // queue. Must not be called if the task doesn't support aborting (it's
|
| + // abort callback is NULL).
|
| + void Abort(size_t token);
|
|
|
| // Marks the previously enqueued task as complete. Must be called for each
|
| // enqueued task (unless aborted). Note, that Remove() must be called in order
|
| @@ -66,9 +69,8 @@ class Queue {
|
| // It must not be called more than one, nor for aborted tasks.
|
| void Complete(size_t token);
|
|
|
| - // Removes the previously enqueued and completed task from the queue. Must not
|
| - // be called for aborted, or not completed tasks. Must not be called more than
|
| - // once.
|
| + // Removes the previously enqueued and completed or aborted task from the
|
| + // queue. Must not be called more than once.
|
| void Remove(size_t token);
|
|
|
| private:
|
| @@ -79,7 +81,6 @@ class Queue {
|
| ~Task();
|
|
|
| size_t token;
|
| - bool completed;
|
| AbortableCallback callback;
|
| AbortCallback abort_callback;
|
| };
|
| @@ -88,16 +89,12 @@ class Queue {
|
| // |max_in_parallel_| tasks running at once.
|
| void MaybeRun();
|
|
|
| - // Aborts a previously enqueued task. Returns the result asynchronously via
|
| - // |callback|. May be called at any time, but if already completed then
|
| - // FILE_ERROR_INVALID_OPERATION error code will be returned.
|
| - void Abort(size_t token,
|
| - const storage::AsyncFileUtil::StatusCallback& callback);
|
| -
|
| const size_t max_in_parallel_;
|
| size_t next_token_;
|
| std::deque<Task> pending_;
|
| std::map<int, Task> executed_;
|
| + std::map<int, Task> completed_;
|
| + std::map<int, Task> aborted_;
|
|
|
| base::WeakPtrFactory<Queue> weak_ptr_factory_;
|
| DISALLOW_COPY_AND_ASSIGN(Queue);
|
|
|