# lzh-1.8-thread-spring-boot-starter

**Repository Path**: coding_13/lzh-1.8-thread-spring-boot-starter

## Basic Information

- **Project Name**: lzh-1.8-thread-spring-boot-starter
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-08-13
- **Last Updated**: 2025-08-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# lzh-1.8-thread-spring-boot-starter

`lzh-1.8-thread-spring-boot-starter` 是一个基于 Spring Boot 的线程管理启动器，旨在提供灵活且可扩展的线程执行能力。它通过封装线程池和线程装饰器，简化了在 Spring Boot 应用中管理多线程任务的过程。

## 特性

- **线程池支持**：提供自定义线程池实现，支持核心线程数、最大线程数、任务队列等配置。
- **线程装饰器**：允许通过 `ThreadDecorator` 接口对线程进行扩展和定制。
- **线程工厂**：提供统一的线程创建机制，支持线程名称前缀、守护线程设置等功能。
- **计划任务支持**：支持创建可调度的线程池，用于执行定时或周期性任务。

## 使用说明

### 1. 添加依赖

在 `pom.xml` 中添加以下依赖以使用该组件：

```xml
<dependency>
    <groupId>com.lzh</groupId>
    <artifactId>lzh-1.8-thread-spring-boot-starter</artifactId>
    <version>1.0.0</version>
</dependency>
```

### 2. 配置线程池

你可以通过代码直接创建和配置线程池：

```java
LzhThreadExecutor executor = new LzhThreadExecutor(
    2, 10, 60L, TimeUnit.SECONDS,
    new LinkedBlockingQueue<>(),
    new LzhThreadFactory("my-pool"),
    new MyThreadDecorator(), 
    new ThreadPoolExecutor.AbortPolicy()
);
```

### 3. 提交任务

使用线程池提交任务：

```java
executor.execute(() -> {
    // 执行任务逻辑
});
```

### 4. 创建定时任务

创建一个定时任务：

```java
ScheduledThreadPoolExecutor scheduledExecutor = LzhThreadExecutor.createScheduledThreadPoolExecutor(2, "scheduled-pool");
scheduledExecutor.scheduleAtFixedRate(() -> {
    // 定时任务逻辑
}, 0, 1, TimeUnit.SECONDS);
```

## 核心组件

- **LzhThreadExecutor**：继承自 `ThreadPoolExecutor`，提供增强的线程池功能。
- **LzhThreadFactory**：线程工厂类，用于创建具有统一命名规则的线程。
- **ThreadDecorator**：线程装饰接口，用于扩展线程行为。

## 贡献指南

欢迎贡献代码或提出建议！请遵循以下步骤：

1. Fork 本仓库。
2. 创建新分支 (`git checkout -b feature/your-feature-name`)。
3. 提交更改 (`git commit -am 'Add some feature'`)。
4. 推送分支 (`git push origin feature/your-feature-name`)。
5. 创建 Pull Request。

## 许可证

本项目采用 MIT 许可证。详情请查看 [LICENSE](LICENSE) 文件。