# ant-task

**Repository Path**: hwyhy/ant-task

## Basic Information

- **Project Name**: ant-task
- **Description**: 一个轻量级的定时任务管理器
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2021-09-17
- **Last Updated**: 2024-01-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ant-task
一个轻量级的定时任务管理器

## 简介
在**Spring Boot**中有一个自带的**@Scheduled**注解，可以用于启动定时任务，使用很方便，
但也存在着不足，例如定时任务直接写死、方法无参数、不能随时启停等等。
**ant-task**就是为了解决这些问题而存在的，在解决问题的同时也一如既往的方便接入，**ant-task**特性如下：
- 图形化界面管理
- 方便快捷接入
- 支持随时启停任务
- 支持动态参数传递
- 支持动态修改任务时间
- 支持Cron表达式
- 支持日志ID跟踪


## 安装
**maven**
```
<dependency>
  <groupId>com.github.hwywl</groupId>
  <artifactId>ant-task</artifactId>
  <version>1.0.1-RELEASE</version>
</dependency>
```

**Gradle**
```
implementation 'com.github.hwywl:ant-task:1.0.1-RELEASE'
```

## 使用
使用很简单，只要两步即可接入（本项目依赖**Spring Boot**中的**spring-boot-starter-web**组件）。

1. 在pom.xml中引入上面的依赖。
2. 在Spring Boot配置文件中设置如下配置,根据不同的配置文件二选一即可。

```
# application.yml

ant-task:
  conf:
    pool-size: 10
    file-path: /home/ec2-user/server/sms/task.properties
```

```
# application.properties

# 定时任务线程池，默认为 6
ant-task.conf.pool-size=10
# 任务数据配置存储路径(必填)
ant-task.conf.file-path=/home/ec2-user/server/sms/task.properties
```

此时就已经成功接入了，是不是很简单，我们启动项目访问：**http://localhost:{port}/task.html** 进入页面。

![](https://hwy-figure-bed.oss-cn-hangzhou.aliyuncs.com/blog/image/1631842589969-1.png)

看到页面说明我们接入成功了，接下来我们配置一个数据试一下。

新建一个测试类：
```java
/**
 * 测试定时任务
 * @author HWY
 * 2021年9月17日09:38:26
 */
@Component("schedulingTask")
public class TaskDemo {
    public void taskParams(String params) {
        System.out.println("定时执行有参任务：" + params);
    }

    public void taskNoParams() {
        System.out.println("定时执行无参任务！");
    }
}
```

写好测试类之后我们**重启**项目，进入上面URL那个配置界面，进行如下配置：

![](https://hwy-figure-bed.oss-cn-hangzhou.aliyuncs.com/blog/image/1631843002464-2.png)

配置非常简单，点击确定定时任务就开始执行了，我配置了两台测试，一个有参一个无参，来看看效果。

![](https://hwy-figure-bed.oss-cn-hangzhou.aliyuncs.com/blog/image/1631843346023-4.png)

运行结果如下：

![](https://hwy-figure-bed.oss-cn-hangzhou.aliyuncs.com/blog/image/1631843374250-3.png)

### 技术栈
- SpringBoot
- ThreadPoolTaskScheduler 线程池
- Vue

### 感谢
- 感谢[江南一点雨](https://github.com/lenve)提供了思路
- 工具还有不足之处，请大家Issues ヾ(๑╹◡╹)ﾉ"
- 我那么可爱你不点个star吗 φ(>ω<*) 


### 问题建议

- 联系我的邮箱：ilovey_hwy@163.com
- 我的博客：https://www.hwy.ac.cn
- GitHub：https://github.com/HWYWL