b36f6faa7e
Worker is now the base class of all workers. It has a message queue and can be run in a thread of its own, or in the calling thread. Worker can not be used as such, but a concrete worker class must be derived from it. Currently there is only one concrete class RoutingWorker. There is some overlapping in functionality between Worker and RoutingWorker, as there is e.g. a need for broadcasting a message to all routing workers, but not to other workers. Currently other workers can not be created as the array for holding the pointers to the workers is exactly as large as there will be RoutingWorkers. That will be changed so that the maximum number of threads is hardwired to some ridiculous value such as 128. That's the first step in the path towards a situation where the number of worker threads can be changed at runtime.
85 lines
1.8 KiB
C++
85 lines
1.8 KiB
C++
#pragma once
|
|
/*
|
|
* Copyright (c) 2016 MariaDB Corporation Ab
|
|
*
|
|
* Use of this software is governed by the Business Source License included
|
|
* in the LICENSE.TXT file and at www.mariadb.com/bsl11.
|
|
*
|
|
* Change Date: 2020-01-01
|
|
*
|
|
* On the date above, in accordance with the Business Source License, use
|
|
* of this software will be governed by version 2 or later of the General
|
|
* Public License.
|
|
*/
|
|
|
|
#include <maxscale/cppdefs.hh>
|
|
|
|
namespace maxscale
|
|
{
|
|
|
|
class Worker;
|
|
|
|
/**
|
|
* A WorkerTask represents a task to be performed by a Worker.
|
|
*/
|
|
class WorkerTask
|
|
{
|
|
public:
|
|
/**
|
|
* Destructor
|
|
*/
|
|
virtual ~WorkerTask();
|
|
|
|
/**
|
|
* @brief Called in the context of a specific worker.
|
|
*
|
|
* @param worker The worker in whose context `execute` is called.
|
|
*
|
|
* @attention As the function is called by a worker, the body of `execute`
|
|
* should execute quickly and not perform any blocking operations.
|
|
*/
|
|
virtual void execute(Worker& worker) = 0;
|
|
};
|
|
|
|
/**
|
|
* A WorkerDisposableTask represents a task to be performed by a Worker.
|
|
*
|
|
* When the task has been executed, the instance will automatically be
|
|
* deleted.
|
|
*/
|
|
class WorkerDisposableTask
|
|
{
|
|
public:
|
|
/**
|
|
* Destructor
|
|
*/
|
|
virtual ~WorkerDisposableTask();
|
|
|
|
protected:
|
|
/**
|
|
* Constructor
|
|
*/
|
|
WorkerDisposableTask();
|
|
|
|
/**
|
|
* @brief Called in the context of a specific worker.
|
|
*
|
|
* @param worker The worker in whose context `execute` is called.
|
|
*
|
|
* @attention As the function is called by a worker, the body of `execute`
|
|
* should execute quickly and not perform any blocking operations.
|
|
*/
|
|
virtual void execute(Worker& worker) = 0;
|
|
|
|
private:
|
|
friend class Worker;
|
|
|
|
void inc_ref();
|
|
void dec_ref();
|
|
|
|
private:
|
|
int32_t m_count;
|
|
};
|
|
|
|
}
|