Web 层（forge-starter-web）

Web 层基础模块，集成 Undertow 服务器、Actuator 监控和验证码生成。

快速开始

引入依赖

<dependency>
    <groupId>com.mdframe.forge</groupId>
    <artifactId>forge-starter-web</artifactId>
</dependency>

核心功能

Undertow 服务器

默认使用 Undertow 作为 Web 服务器（非 Tomcat），在 pom.xml 中已排除 Tomcat：

<exclusions>
    <exclusion>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-tomcat</artifactId>
    </exclusion>
</exclusions>

Undertow 相比 Tomcat 具有更高的并发性能和更低的内存占用。

Actuator 监控

集成 spring-boot-starter-actuator，默认暴露以下端点：

端点	说明
`/actuator/health`	健康检查
`/actuator/info`	应用信息
`/actuator/metrics`	指标数据

安全提示：生产环境建议配置端点访问控制，避免暴露敏感信息。

验证码

集成 Hutool 验证码库，支持生成图形验证码：

@Autowired
private CaptchaService captchaService;

// 生成图形验证码
@GetMapping("/captcha")
public RespInfo getCaptcha() {
    LineCaptcha captcha = captchaService.generateCaptcha();
    String code = captcha.getCode();
    BufferedImage image = captcha.getImage();
    // ...
}

// 验证验证码
boolean valid = captchaService.verifyCaptcha(inputCode);

支持以下验证码类型：

LineCaptcha — 线段干扰型验证码
CircleCaptcha — 圆圈干扰型验证码
ShearCaptcha — 扭曲型验证码

配置项

server:
  port: 8080
  undertow:
    threads:
      io: 4           # IO 线程数
      worker: 20      # Worker 线程数
    buffer-size: 1024 # 缓冲区大小

management:
  endpoints:
    web:
      exposure:
        include: health,info,metrics
  endpoint:
    health:
      show-details: when-authorized

web.md 1.9 KB История Исходник