# epc

**Repository Path**: javagossip/epc

## Basic Information

- **Project Name**: epc
- **Description**: 基于spring框架的扩展点组件
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-09
- **Last Updated**: 2026-02-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# EPC 扩展点组件

## 简介

EPC（Extension Point Component）是一个基于 Spring Boot 的扩展点组件，支持通过注解方式实现扩展点注册与管理，便于业务扩展和插件化开发。

## 环境要求

- JDK 21 及以上
- Maven 3.6+
- Spring Boot 3.4.5 及以上

## 使用步骤

### 1. 添加依赖

在你的 `pom.xml` 中添加：

```xml
<dependency>
    <groupId>com.chaincoretech</groupId>
    <artifactId>epc</artifactId>
    <version>1.0.0</version>
</dependency>
```

### 2. 定义扩展点接口

使用 `@ExtensionPoint` 注解标记扩展点接口：

```java
@ExtensionPoint
public interface Validator {
    void validate(Object t);
}
```

### 3. 实现扩展

为每个扩展实现类添加 `@Extension` 注解，并指定唯一 key：

```java
@Extension(key = "pay.one")
public class ValidatorOne implements Validator {
    @Override
    public void validate(Object t) {
        // 实现逻辑
    }
}
```

### 4. 使用扩展点

通过 `ExtensionRegistry` 获取并使用扩展：

```java
Validator validator = ExtensionRegistry.getExtensionByKey(Validator.class, "pay.one");
if (validator != null) {
    validator.validate(obj);
}
```

在 Spring 环境下，只需将实现类加上 `@Extension` 注解，`ExtensionsLoader` 会自动注册所有扩展。

---