Yunjiao Spring Boot 参考手册

<parent>
    <groupId>io.gitee.yunjiao-source.spring-boot</groupId>
    <artifactId>starter-parent</artifactId>
    <version>3.0.13</version>
</parent>

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>io.gitee.yunjiao-source.spring-boot</groupId>
            <artifactId>dependencies</artifactId>
            <version>0.4.0</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

# cd yunjiao-spring-boot
# mvn clean install

# cd starter-parent
# mvn clean install

<dependency>
    <groupId>io.gitee.yunjiao-source.spring-boot</groupId>
    <artifactId>starter-id</artifactId>
</dependency>

@Slf4j
@Component
public class IdCommandLineRunner implements CommandLineRunner {
    @Autowired
    private Snowflake snowflake;
    @Autowired
    private UidGeneratorCached uidGeneratorCached;
    @Autowired
    private UidGeneratorDefault uidGeneratorDefault;

    @Override
    public void run(String... args) throws Exception {
        TimeUnit.SECONDS.sleep(3);

        log.info("Snowflake = {}",  generator(() -> snowflake.nextId()).size());
        log.info("uidGeneratorCached = {}", generator(() -> uidGeneratorCached.getUID()).size() );
        log.info("uidGeneratorDefault = {}", generator(() -> uidGeneratorDefault.getUID()).size() );
    }

    private Set<Long> generator(Supplier<Long> supplier) {
        return IntStream.range(0, 4000).mapToObj(i -> supplier.get())
                .peek(l -> System.out.print(l + ","))
                .collect(Collectors.toSet());
    }
}

WARN   --- [           main] y.s.e.i.u.EnvironmentWorkerIdAssigner    : Uid-Generator 框架雪花算法配置使用默认参数。如需支持分布式，请设置系统环境变量：SNOWFLAKE_WORKER_ID
WARN   --- [           main] y.s.a.id.HutoolIdConfiguration           : Hutool 框架雪花算法配置使用默认参数。如需支持分布式，请设置系统环境变量：SNOWFLAKE_WORKER_ID 与 SNOWFLAKE_DATACENTER_ID

@Slf4j
@Configuration
public class IdConfiguration {

    @Bean
    CachedUidGeneratorConfigurer CachedUidGeneratorConfigurer() {
        return generator -> {
            log.info("自定义配置");
            generator.setBoostPower(3);
            generator.setPaddingFactor(50);
            generator.setScheduleInterval(60);
        };
    }

}

<dependency>
    <groupId>io.gitee.yunjiao-source.spring-boot</groupId>
    <artifactId>starter-captcha</artifactId>
</dependency>

@Slf4j
@Component
public class CaptchaCommandLineRunner implements CommandLineRunner {
    @Autowired
    private CaptchaServiceFactory factory;

    @Override
    public void run(String... args) throws Exception {
        CaptchaService circleService = factory.findService(CaptchaCategory.circle);
        CaptchaData data = circleService.draw();
        log.info(GsonUtils.toJson(data));
        saveImage(data);

        CaptchaService lineService = factory.findService(CaptchaCategory.line);
        data = lineService.draw();
        saveImage(data);

        CaptchaService gifService = factory.findService(CaptchaCategory.gif);
        data = gifService.draw();
        saveImage(data);

        CaptchaService shearService = factory.findService(CaptchaCategory.shear);
        data = shearService.draw();
        saveImage(data);

        CaptchaService blockPuzzleService = factory.findService(CaptchaCategory.blockPuzzle);
        data = blockPuzzleService.draw();
        saveImage(data);

        CaptchaService clickWordService = factory.findService(CaptchaCategory.clickWord);
        data = clickWordService.draw();
        saveImage(data);
    }

    private void saveImage(CaptchaData data) throws IOException {
        Path targetDir = Paths.get("target", "processed-images");
        if (!Files.exists(targetDir)) {
            Files.createDirectories(targetDir);
        }

        Path filePath = targetDir.resolve(data.category().name() + "-captcha." + data.category().getExt());
        Files.write(filePath, data.captchaImage());

        if (data.backgroundImage() != null) {
            filePath = targetDir.resolve(data.category().name() + "-background." + data.category().getExt());
            Files.write(filePath, data.backgroundImage());
        }
    }
}

{"key":"5e1bf15c178b4ea3a6d0599ba8fb3743","captchaImage":[-119,80,78,71,13,10,....],"backgroundImage":null,"code":"z8yOk","category":"circle"}

@Slf4j
@Configuration
public class CaptchaConfiguration {

    @PostConstruct
    void postConstruct() {
        // 设置过期时间
        CaptchaCacheFactory.initHtoolCache(Duration.ofSeconds(30));
    }

}

@RestController
@RequiredArgsConstructor
public class CaptchaController {
    private final CaptchaServiceFactory factory;
    private final CaptchaCache cache = CaptchaCacheFactory.getInstance();

    @GetMapping("/captcha")
    public CaptchaReponse get(@RequestParam(name = "category") CaptchaCategory category) {
        CaptchaService service = factory.findService(category);
        CaptchaData data = service.draw();

        CaptchaReponse reponse = new CaptchaReponse();
        reponse.setKey(data.key());
        reponse.setCategory(service.getCategory());
        reponse.setCaptchaImageBase64(data.captchaImageBase64Url());
        reponse.setBackgroundImageBase64(data.backgroundImageBase64Url());

        cache.put(data.key(), data.code());
        System.out.println("code=" + data.code());
        return reponse;
    }

    @PostMapping("/captcha")
    public String post(@RequestBody CaptchaValidate validate) {
        String cacheCode = cache.get(validate.getKey()).orElse(null);
        if (!StringUtils.hasText(cacheCode)) {
            return "验证码校验失败";
        }

        CaptchaService service = factory.findService(validate.getCategory());
        boolean pass = service.verify(cacheCode, validate.getCode());
        if (pass) {
            return "验证码校验成功";
        } else {
            return "验证码校验失败";
        }
    }
}

curl --location --request GET 'http://localhost:8080/captcha?category=line' \
--header 'Accept: /' \
--header 'Host: localhost:8080' \
--header 'Connection: keep-alive'

curl --location --request POST 'http://localhost:8080/captcha' \
--header 'Content-Type: application/json' \
--header 'Accept: /' \
--header 'Host: localhost:8080' \
--header 'Connection: keep-alive' \
--data-raw '{
    "key": "e3d15841b93543f88e2404fc93cd8edb",
    "category": "line",
    "code": "1kNk9"
}'