mirror of
https://gitee.com/acl-dev/acl.git
synced 2024-12-15 01:10:52 +08:00
89 lines
2.5 KiB
C++
89 lines
2.5 KiB
C++
#pragma once
|
|
|
|
////////////////////////////////////////////////////////////////////////////////
|
|
// 配置内容项
|
|
|
|
extern acl::master_str_tbl var_conf_str_tab[];
|
|
extern acl::master_bool_tbl var_conf_bool_tab[];
|
|
extern acl::master_int_tbl var_conf_int_tab[];
|
|
extern acl::master_int64_tbl var_conf_int64_tab[];
|
|
|
|
////////////////////////////////////////////////////////////////////////////////
|
|
|
|
//class acl::socket_stream;
|
|
|
|
class master_service : public acl::master_threads
|
|
{
|
|
public:
|
|
master_service();
|
|
~master_service();
|
|
|
|
protected:
|
|
/**
|
|
* 纯虚函数：当某个客户端连接有数据可读或关闭或出错时调用此函数
|
|
* @param stream {socket_stream*}
|
|
* @return {bool} 返回 false 则表示当函数返回后需要关闭连接，
|
|
* 否则表示需要保持长连接，如果该流出错，则应用应该返回 false
|
|
*/
|
|
virtual bool thread_on_read(acl::socket_stream* stream);
|
|
|
|
/**
|
|
* 当线程池中的某个线程获得一个连接时的回调函数，
|
|
* 子类可以做一些初始化工作
|
|
* @param stream {socket_stream*}
|
|
* @return {bool} 如果返回 false 则表示子类要求关闭连接，而不
|
|
* 必将该连接再传递至 thread_main 过程
|
|
*/
|
|
virtual bool thread_on_accept(acl::socket_stream* stream);
|
|
|
|
/**
|
|
* 当某个网络连接的 IO 读写超时时的回调函数，如果该函数返回 true 则表示继续等待下一次
|
|
* 读写，否则则希望关闭该连接
|
|
* @param stream {socket_stream*}
|
|
* @return {bool} 如果返回 false 则表示子类要求关闭连接，而不
|
|
* 必将该连接再传递至 thread_main 过程
|
|
*/
|
|
virtual bool thread_on_timeout(acl::socket_stream* stream);
|
|
|
|
/**
|
|
* 当与某个线程绑定的连接关闭时的回调函数
|
|
* @param stream {socket_stream*}
|
|
*/
|
|
virtual void thread_on_close(acl::socket_stream* stream);
|
|
|
|
/**
|
|
* 当线程池中一个新线程被创建时的回调函数
|
|
*/
|
|
virtual void thread_on_init();
|
|
|
|
/**
|
|
* 当线程池中一个线程退出时的回调函数
|
|
*/
|
|
virtual void thread_on_exit();
|
|
|
|
/**
|
|
* 当进程切换用户身份后调用的回调函数，此函数被调用时，进程
|
|
* 的权限为普通受限级别
|
|
*/
|
|
virtual void proc_on_init();
|
|
|
|
/**
|
|
* 当子进程需要退出时框架将回调此函数，框架决定子进程是否退出取决于：
|
|
* 1) 如果此函数返回 true 则子进程立即退出，否则：
|
|
* 2) 如果该子进程所有客户端连接都已关闭，则子进程立即退出，否则：
|
|
* 3) 查看配置文件中的配置项(ioctl_quick_abort)，如果该配置项非 0 则
|
|
* 子进程立即退出，否则：
|
|
* 4) 等所有客户端连接关闭后才退出
|
|
* @param ncleints {size_t} 当前连接的客户端个数
|
|
* @param nthreads {size_t} 当前线程池中繁忙的工作线程个数
|
|
* @return {bool} 返回 false 表示当前子进程还不能退出，否则表示当前
|
|
* 子进程可以退出了
|
|
*/
|
|
virtual bool proc_exit_timer(size_t nclients, size_t nthreads);
|
|
|
|
/**
|
|
* 当进程退出前调用的回调函数
|
|
*/
|
|
virtual void proc_on_exit();
|
|
};
|