# XxlJobDotNetCore

**Repository Path**: zongyu1119/xxljob-dotnetcore

## Basic Information

- **Project Name**: XxlJobDotNetCore
- **Description**: 使用.NET 7开发的XXLJOB执行器示例项目，支持Consul动态配置
- **Primary Language**: C#
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 1
- **Created**: 2023-02-21
- **Last Updated**: 2025-08-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# XxlJobDotNetCore

#### 介绍
这是一个使用 .NET 7 开发的 XXL-JOB 执行器示例项目，支持通过 Consul 实现动态配置管理。

XXL-JOB 是一个轻量级的分布式任务调度平台，本项目展示了如何在 .NET Core 中集成其执行器，并结合 Consul 实现配置的动态更新功能。

#### 软件架构
该项目基于 .NET 7 构建，采用以下主要组件：
- **Consul 集成**：支持从 Consul 获取配置信息，并实现配置的动态刷新。
- **XXL-JOB 执行器**：提供任务处理器框架，可自定义业务逻辑。
- **Refit 和 HTTP 客户端**：用于处理外部服务调用。
- **中间件支持**：包含日志记录和任务调度的中间件逻辑。

#### 安装教程
1. 确保已安装 .NET 7 SDK。
2. 下载或克隆本仓库。
3. 根据需要修改 `appsettings.json` 和 `appsettings.Development.json` 文件。
4. 启动项目并确保 Consul 服务正常运行。

#### 使用说明
- 在 `Handler` 文件夹中定义任务处理逻辑，例如 `SmartParkingHandler.cs` 和 `TestTaskNetTestHandler.cs`。
- 通过 `Controllers/TestJobController.cs` 提供的 API 可以测试任务执行。
- 配置 Consul 地址和配置路径以启用动态配置功能。

#### 示例功能
- `TestJobController.Test`：一个简单的测试接口。
- `SmartParkingHandler.Execute`：演示了如何实现一个异步任务处理逻辑。
- `ZyAlertSync`：另一个演示任务处理的接口。

#### 参与贡献
1. Fork 本仓库。
2. 新建 `Feat_xxx` 分支。
3. 提交代码。
4. 创建 Pull Request。

#### 特技
1. 支持动态配置，适合微服务环境。
2. 提供了良好的扩展性，方便集成其他服务。
3. 使用中间件统一处理调度请求和日志记录。

#### 其他文档
- 英文版 README：[README.en.md](README.en.md)