// ================================================================================
// Code generated and maintained by GoFrame CLI tool. DO NOT EDIT.
// You can delete these comments if you wish manually maintain this interface file.
// ================================================================================

package service

import (
	"context"
	"easygoadmin/api/v1"
)

// 按模块独立拆分（源：gf gen service 产物手工重组）。
// logic 方法签名变更时需同步维护本文件（手维护，勿整体运行 gf gen service）。

// IJob 定时任务服务接口
type IJob interface {
	// Page 任务分页
	Page(ctx context.Context, req *v1.JobPageReq) (res *v1.JobPageRes, err error)
	// List 任务列表
	List(ctx context.Context, req *v1.JobListReq) (res v1.JobListRes, err error)
	// Detail 任务详情
	Detail(ctx context.Context, req *v1.JobDetailReq) (res *v1.JobDetailRes, err error)
	// Add 新增任务
	// 默认未发布状态，发布操作走 Status 或 Resume 方法
	Add(ctx context.Context, req *v1.JobAddReq) (res *v1.IdRes, err error)
	// Update 修改任务
	// 运行中任务先摘除再重挂
	Update(ctx context.Context, req *v1.JobUpdateReq) (res *v1.JobUpdateRes, err error)
	// Delete 删除任务
	// 软删记录并摘除调度
	Delete(ctx context.Context, req *v1.JobDeleteReq) (res *v1.JobDeleteRes, err error)
	// BatchDelete 批量删除任务
	BatchDelete(ctx context.Context, req *v1.JobBatchDeleteReq) (res *v1.JobBatchDeleteRes, err error)
	// RunOnce 立即执行一次
	// 异步触发
	RunOnce(ctx context.Context, req *v1.JobRunOnceReq) (res *v1.JobRunOnceRes, err error)
	// Pause 暂停任务
	Pause(ctx context.Context, req *v1.JobPauseReq) (res *v1.JobPauseRes, err error)
	// Resume 恢复任务
	// 重新挂载调度
	Resume(ctx context.Context, req *v1.JobResumeReq) (res *v1.JobResumeRes, err error)
	// Status 设置任务状态
	// 运行中挂载，暂停与未发布状态摘除调度
	Status(ctx context.Context, req *v1.JobStatusReq) (res *v1.JobStatusRes, err error)
	// DaemonStatus 查询调度器状态
	DaemonStatus(ctx context.Context, req *v1.JobDaemonStatusReq) (res *v1.JobDaemonStatusRes, err error)
}

// localJob 定时任务服务实现实例
var localJob IJob

// Job 获取定时任务服务实例
func Job() IJob {
	if localJob == nil {
		panic("implement not found for interface IJob, forgot register?")
	}
	return localJob
}

// RegisterJob 注册定时任务服务实现
func RegisterJob(i IJob) {
	localJob = i
}