// -------------------------------------------------------------------
//
// thread_tasks.h
//
// Copyright (c) 2011-2015 Basho Technologies, Inc. All Rights Reserved.
//
// This file is provided to you under the Apache License,
// Version 2.0 (the "License"); you may not use this file
// except in compliance with the License.  You may obtain
// a copy of the License at
//
//   http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing,
// software distributed under the License is distributed on an
// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
// KIND, either express or implied.  See the License for the
// specific language governing permissions and limitations
// under the License.
//
// -------------------------------------------------------------------

// -------------------------------------------------------------------
//  Modeled after eleveldb's workitems.h/.cc
// -------------------------------------------------------------------


#ifndef STORAGE_LEVELDB_INCLUDE_THREAD_TASKS_H_
#define STORAGE_LEVELDB_INCLUDE_THREAD_TASKS_H_

#include <stdint.h>

#include "db/db_impl.h"
#include "db/version_set.h"
#include "leveldb/atomics.h"
#include "refobject_base.h"

namespace leveldb {


/**
 * Virtual base class for leveldb background tasks
 */
class ThreadTask : public RefObjectBase
{
 protected:
    bool m_ResubmitWork;          //!< true if this work item is loaded for prefetch

 public:
    uint64_t m_QueueStart;        //!< NowMicros() time placed on work queue

 public:
    ThreadTask() : m_ResubmitWork(false), m_QueueStart(0) {}

    virtual ~ThreadTask() {}

    // this is the derived object's task routine
    virtual void operator()() = 0;

    // methods used by the thread pool to potentially reuse this task object
    bool resubmit() const {return(m_ResubmitWork);}
    virtual void recycle() {}

 private:
    ThreadTask(const ThreadTask &);
    ThreadTask & operator=(const ThreadTask &);

};  // class ThreadTask


/**
 * Background write of imm buffer to Level-0 file
 */
// 给某个db进行压缩
class ImmWriteTask : public ThreadTask
{
protected:
    DBImpl * m_DBImpl;

public:
    explicit ImmWriteTask(DBImpl * Db)
        : m_DBImpl(Db) {};

    virtual ~ImmWriteTask() {};

    virtual void operator()() {m_DBImpl->BackgroundImmCompactCall();};

private:
    ImmWriteTask();
    ImmWriteTask(const ImmWriteTask &);
    ImmWriteTask & operator=(const ImmWriteTask &);

};  // class ImmWriteTask


/**
 * Background compaction
 */

class CompactionTask : public ThreadTask
{
protected:
    DBImpl * m_DBImpl;
    Compaction * m_Compaction;

public:
    CompactionTask(DBImpl * Db, Compaction * Compact)
        : m_DBImpl(Db), m_Compaction(Compact) {};

    virtual ~CompactionTask() {delete m_Compaction;};

    virtual void operator()();

private:
    CompactionTask();
    CompactionTask(const CompactionTask &);
    CompactionTask & operator=(const CompactionTask &);

};  // class CompactionTask


/**
 * Poll all databases for grooming opportunities
 */

class GroomingPollTask : public ThreadTask
{
protected:

public:
    GroomingPollTask() {};

    virtual ~GroomingPollTask() {};

    virtual void operator()();

private:
    GroomingPollTask(const GroomingPollTask &);
    GroomingPollTask & operator=(const GroomingPollTask &);

};  // class GroomingPollTask


/**
 * Original env_posix.cc task
 */

class LegacyTask : public ThreadTask
{
protected:
    void (*m_Function)(void*);
    void * m_Arg;

public:
    LegacyTask(void (*Function)(void*), void * Arg)
        : m_Function(Function), m_Arg(Arg) {};

    virtual ~LegacyTask() {};

    virtual void operator()()
    {
        (*m_Function)(m_Arg);
    };

private:
    LegacyTask();
    LegacyTask(const LegacyTask &);
    LegacyTask & operator=(const LegacyTask &);

};  // class LegacyTask


/**
 * Riak Enterprise Edition's hot backup entry point
 *
 *  Called every 60 seconds to test for external hot backup trigger
 *   (initiates backup if trigger seen)
 */

void CheckHotBackupTrigger();

} // namespace leveldb


#endif  // STORAGE_LEVELDB_INCLUDE_THREAD_TASKS_H_
