fastapi-best-architecture/backend/app/task/service/scheduler_service.py

#!/usr/bin/env python3
# -*- coding: utf-8 -*-
import json

from typing import Sequence

from sqlalchemy import Select
from starlette.concurrency import run_in_threadpool

from backend.app.task.celery import celery_app
from backend.app.task.crud.crud_scheduler import task_scheduler_dao
from backend.app.task.enums import TaskSchedulerType
from backend.app.task.model import TaskScheduler
from backend.app.task.schema.scheduler import CreateTaskSchedulerParam, UpdateTaskSchedulerParam
from backend.app.task.utils.tzcrontab import crontab_verify
from backend.common.exception import errors
from backend.database.db import async_db_session


class TaskSchedulerService:
    """任务调度服务类"""

    @staticmethod
    async def get(*, pk) -> TaskScheduler | None:
        """
        获取任务调度详情

        :param pk: 任务调度 ID
        :return:
        """
        async with async_db_session() as db:
            task_scheduler = await task_scheduler_dao.get(db, pk)
            if not task_scheduler:
                raise errors.NotFoundError(msg='任务调度不存在')
            return task_scheduler

    @staticmethod
    async def get_all() -> Sequence[TaskScheduler]:
        """获取所有任务调度"""
        async with async_db_session() as db:
            task_schedulers = await task_scheduler_dao.get_all(db)
            return task_schedulers

    @staticmethod
    async def get_select(*, name: str | None, type: int | None) -> Select:
        """
        获取任务调度列表查询条件

        :param name: 任务调度名称
        :param type: 任务调度类型
        :return:
        """
        return await task_scheduler_dao.get_list(name=name, type=type)

    @staticmethod
    async def create(*, obj: CreateTaskSchedulerParam) -> None:
        """
        创建任务调度

        :param obj: 任务调度创建参数
        :return:
        """
        async with async_db_session.begin() as db:
            task_scheduler = await task_scheduler_dao.get_by_name(db, obj.name)
            if task_scheduler:
                raise errors.ConflictError(msg='任务调度已存在')
            if obj.type == TaskSchedulerType.CRONTAB:
                crontab_split = obj.crontab.split(' ')
                if len(crontab_split) != 5:
                    raise errors.RequestError(msg='Crontab 表达式非法')
                crontab_verify('m', crontab_split[0])
                crontab_verify('h', crontab_split[1])
                crontab_verify('dow', crontab_split[2])
                crontab_verify('dom', crontab_split[3])
                crontab_verify('moy', crontab_split[4])
            await task_scheduler_dao.create(db, obj)

    @staticmethod
    async def update(*, pk: int, obj: UpdateTaskSchedulerParam) -> int:
        """
        更新任务调度

        :param pk: 任务调度 ID
        :param obj: 任务调度更新参数
        :return:
        """
        async with async_db_session.begin() as db:
            task_scheduler = await task_scheduler_dao.get(db, pk)
            if not task_scheduler:
                raise errors.NotFoundError(msg='任务调度不存在')
            if task_scheduler.name != obj.name:
                if await task_scheduler_dao.get_by_name(db, obj.name):
                    raise errors.ConflictError(msg='任务调度已存在')
            if task_scheduler.type == TaskSchedulerType.CRONTAB:
                crontab_split = obj.crontab.split(' ')
                if len(crontab_split) != 5:
                    raise errors.RequestError(msg='Crontab 表达式非法')
                crontab_verify('m', crontab_split[0])
                crontab_verify('h', crontab_split[1])
                crontab_verify('dow', crontab_split[2])
                crontab_verify('dom', crontab_split[3])
                crontab_verify('moy', crontab_split[4])
            count = await task_scheduler_dao.update(db, pk, obj)
            return count

    @staticmethod
    async def update_status(*, pk: int) -> int:
        """
        更新任务调度状态

        :param pk: 任务调度 ID
        :return:
        """
        async with async_db_session.begin() as db:
            task_scheduler = await task_scheduler_dao.get(db, pk)
            if not task_scheduler:
                raise errors.NotFoundError(msg='任务调度不存在')
            count = await task_scheduler_dao.set_status(db, pk, not task_scheduler.enabled)
            return count

    @staticmethod
    async def delete(*, pk) -> int:
        """
        删除任务调度

        :param pk: 用户 ID
        :return:
        """
        async with async_db_session.begin() as db:
            task_scheduler = await task_scheduler_dao.get(db, pk)
            if not task_scheduler:
                raise errors.NotFoundError(msg='任务调度不存在')
            count = await task_scheduler_dao.delete(db, pk)
            return count

    @staticmethod
    async def execute(*, pk: int) -> None:
        """
        执行任务

        :param pk: 任务调度 ID
        :return:
        """
        async with async_db_session() as db:
            workers = await run_in_threadpool(celery_app.control.ping, timeout=0.5)
            if not workers:
                raise errors.ServerError(msg='Celery Worker 暂不可用，请稍后重试')
            task_scheduler = await task_scheduler_dao.get(db, pk)
            if not task_scheduler:
                raise errors.NotFoundError(msg='任务调度不存在')
            celery_app.send_task(
                name=task_scheduler.task,
                args=json.loads(task_scheduler.args),
                kwargs=json.loads(task_scheduler.kwargs),
            )

    @staticmethod
    async def revoke(*, task_id: str) -> None:
        """
        撤销指定的任务

        :param task_id: 任务 UUID
        :return:
        """
        workers = await run_in_threadpool(celery_app.control.ping, timeout=0.5)
        if not workers:
            raise errors.ServerError(msg='Celery Worker 暂不可用，请稍后重试')
        celery_app.control.revoke(task_id)


task_scheduler_service: TaskSchedulerService = TaskSchedulerService()