简简单单探讨下starter

news2025/7/28 4:47:37

前言

     今天其实首先想跟大家探讨下：微服务架构，分业务线了，接入第三方服务、包啥的是否自己定义一个stater更好？

一、starter是什么？

在 Spring Boot 中，Starter 是一种特殊的依赖模块，用于快速引入一整套相关的依赖和默认配置，以简化开发者的配置工作。

1.starter的核心作用

Starter 的本质是一个 Maven 或 Gradle 的依赖包，它：

  • 封装了某种功能所需的所有依赖库；

  • 提供了该功能的默认自动配置；

  • 遵循 Spring Boot 的自动化配置规范（@Conditional 机制）；

  • 允许用户覆盖默认配置。

2.Starter 的内部结构（自定义时）

一个典型的自定义 Starter 包含两个模块：

  • starter 模块：用于提供自动配置类（通常使用 @Configuration + @Conditional），并注入 Bean。

  • starter-autoconfigure 模块：用于定义配置逻辑和默认行为。

也有时候直接打包成一个模块就行。

二、Starter自定义步骤

首先了解下starter的目录结构：
在这里插入图片描述

1.目前idea的New没看到有直接选择Starter这种（有说new project，maven勾选Create from archetype，试了下跟新建module差不多），但是问题不大，可以直接New Module，具体：

  • 1.新建Module，设置好name、group、artifact等等，注意name最好是项目名称开头-spring-boot-starter-模块功能。比如我这里是接入虹软的人脸识别，所以名称：项目名称-spring-boot-starter-arcface
  • 修改pom
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
         <-- 这个父级依赖，如果没有需要的在父级其实可以不要 -->
    <parent>
        <groupId>com.bsr.healthcheck</groupId>
        <artifactId>bsr-framework</artifactId>
        <version>${revision}</version>
    </parent>
    <modelVersion>4.0.0</modelVersion>
    <artifactId>bsr-spring-boot-starter-arcface</artifactId>
    <packaging>jar</packaging>
    <name>${project.artifactId}</name>
    <description>虹软人脸扩展</description>
    <url/>

    <dependencies>
    	<!-- 自定义的通用包 -->
        <dependency>
            <groupId>com.bsr.healthcheck</groupId>
            <artifactId>bsr-common</artifactId>
        </dependency>

        <!-- Spring 核心 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-configuration-processor</artifactId>
            <optional>true</optional>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter</artifactId>
            <optional>true</optional>
        </dependency>

        <!-- 虹软人脸识别 -->
        <dependency>
            <groupId>com.arcsoft.face</groupId>
            <artifactId>arcsoft-sdk-face</artifactId>
            <version>3.0.0.0</version>
            <scope>system</scope>
            <systemPath>${project.basedir}/libs/arcsoft-sdk-face-3.0.0.0.jar</systemPath>
        </dependency>


    </dependencies>

</project>

  • 因为虹软的jar，目前在maven源上没有公开，都是申请的时候下载的，这里在目录下建一个libs，放jar、dll（这个后期应该是放到服务器上）

  • 删除启动App、resources下的配置文件

  • resources下新建META_INF目录，目录下新建spring.factories，内容：org.springframework.boot.autoconfigure.EnableAutoConfiguration=
    com.bsr.healthcheck.framework.face.config.ArcFaceAutoConfiguration
    注意ArcFaceAutoConfiguration配置类目录要跟计划写的类对得上哦，最好是检查写好了，这里能点过去就ok的

  • src下建目录，写配置类、properties等
    我的starter的目录：
    在这里插入图片描述

2.具体代码

ArcFaceAutoConfiguration

/**
 * 虹软人脸识别
 *
 * @author zwmac
 */
@Slf4j
@Configuration
@EnableConfigurationProperties(ArcFaceProperties.class)
@ConditionalOnProperty(prefix = "arcface", name = "enabled", havingValue = "true", matchIfMissing = true)
public class ArcFaceAutoConfiguration {

    @Bean
    @ConditionalOnMissingBean
    public FaceEngineWrapper faceEngineWrapper(ArcFaceProperties properties) {
        if (SystemUtil.getOsInfo().isWindows()){
            return new FaceEngineWrapper(
                    properties.getWinAppId(),
                    properties.getWinSdkKey(),
                    properties.getWinLibPath()
            );
        }
        if(SystemUtil.getOsInfo().isLinux()){
            return new FaceEngineWrapper(
                properties.getAppId(),
                properties.getSdkKey(),
                properties.getLibPath()
            );

        }
        if(SystemUtil.getOsInfo().isMac()){
            log.info("虹软人脸识别不支持 Mac OS X");
            //throw new IllegalStateException("Unsupported OS for ArcFace engine");
        }
        log.warn("系统未知，虹软人脸识别引擎初始化失败");
        return null;
    }

    @Lazy
    @Bean
    @ConditionalOnMissingBean
    public ArcFaceService arcFaceService() {
        return new ArcFaceServiceImpl();
    }

}

FaceEngineConfig

/**
 * @author zwmac
 */
@Configuration
public class FaceEngineConfig {

    @Value("${arcface.app-id}")
    private String appId;

    @Value("${arcface.sdk-key}")
    private String sdkKey;

    @Value("${arcface.lib-path}")
    private String libPath;

    @Bean
    public FaceEngineWrapper faceEngineWrapper() {
        return new FaceEngineWrapper(appId, sdkKey, libPath);
    }
}

FaceEngineWrapper


/**
 * @author zwmac
 */
@Lazy
@Slf4j
public class FaceEngineWrapper {

    private FaceEngine faceEngine;

    /**
     * 初始化人脸引擎
     * @param appId 授权id
     * @param sdkKey 授权key
     * @param libPath 脚本路径
     */
    public FaceEngineWrapper(String appId, String sdkKey, String libPath) {

        try {
            faceEngine = new FaceEngine(libPath);
            //激活引擎
            int errorCode = faceEngine.activeOnline(appId, sdkKey);

            if (errorCode != ErrorInfo.MOK.getValue() && errorCode != ErrorInfo.MERR_ASF_ALREADY_ACTIVATED.getValue()) {
                log.error("引擎激活失败");
            }


            ActiveFileInfo activeFileInfo = new ActiveFileInfo();
            errorCode = faceEngine.getActiveFileInfo(activeFileInfo);
            if (errorCode != ErrorInfo.MOK.getValue() && errorCode != ErrorInfo.MERR_ASF_ALREADY_ACTIVATED.getValue()) {
                log.error("获取激活文件信息失败");
            }

            //引擎配置
            EngineConfiguration engineConfiguration = new EngineConfiguration();
            engineConfiguration.setDetectMode(DetectMode.ASF_DETECT_MODE_IMAGE);
            engineConfiguration.setDetectFaceOrientPriority(DetectOrient.ASF_OP_ALL_OUT);
            engineConfiguration.setDetectFaceMaxNum(10);
            engineConfiguration.setDetectFaceScaleVal(16);
            //功能配置
            FunctionConfiguration functionConfiguration = new FunctionConfiguration();
            functionConfiguration.setSupportAge(true);
            functionConfiguration.setSupportFace3dAngle(true);
            functionConfiguration.setSupportFaceDetect(true);
            functionConfiguration.setSupportFaceRecognition(true);
            functionConfiguration.setSupportGender(true);
            functionConfiguration.setSupportLiveness(true);
            functionConfiguration.setSupportIRLiveness(true);
            engineConfiguration.setFunctionConfiguration(functionConfiguration);


            //初始化引擎
            errorCode = faceEngine.init(engineConfiguration);

            if (errorCode != ErrorInfo.MOK.getValue()) {
                log.error("初始化引擎失败");
            }
        } catch (RuntimeException e) {
            log.error("人脸引擎FaceEngine加载脚本异常，{}", e.getMessage(), e);
        }

    }

    public FaceEngine getEngine() {
        return this.faceEngine;
    }
/*
    public void destroy() {
        faceEngine.unInit();
    }*/

    @PreDestroy
    public void destroy() {
        if (faceEngine != null) {
            faceEngine.unInit();
            log.info("人脸识别引擎已释放");
        }
    }
}

ArcFaceProperties


/**
 * @author zwmac
 */
@ConfigurationProperties(prefix = "arcface")
@Data
public class ArcFaceProperties {
    private String appId;
    private String sdkKey;
    private String libPath;

    private String winAppId;
    private String winSdkKey;
    private String winLibPath;

    private float matchThreshold = 0.8f;

    private float rgbThreshold;
    private float irThreshold;
}

ArcFaceService

/**
 * @author zwmac
 */
public interface ArcFaceService {

    /**
     * 校验是否活体
     * @param imgFile 照片文件File
     * @return 是否活体
     */
    boolean checkLive(File imgFile);
}

ArcFaceServiceImpl


/**
 * @author zwmac
 */
@Slf4j
@Service
@RequiredArgsConstructor
public class ArcFaceServiceImpl implements ArcFaceService {

    @Resource
    private FaceEngineWrapper engineWrapper;

    @Override
    public boolean checkLive(File imgFile) {

        boolean liveOk = false;
        Assert.notNull(imgFile, "照片文件为空");
        ImageInfo imageInfo = getRGBData(imgFile);

        FaceEngine faceEngine = engineWrapper.getEngine();

        //人脸检测
        List<FaceInfo> faceInfoList = new ArrayList<>();
        int errorCode = faceEngine.detectFaces(imageInfo.getImageData(), imageInfo.getWidth(), imageInfo.getHeight(), imageInfo.getImageFormat(), faceInfoList);
        Assert.isTrue(errorCode == ErrorInfo.MOK.getValue(), "人脸检测失败");

        //特征提取
        FaceFeature faceFeature = new FaceFeature();
        errorCode = faceEngine.extractFaceFeature(imageInfo.getImageData(), imageInfo.getWidth(), imageInfo.getHeight(), imageInfo.getImageFormat(), faceInfoList.get(0), faceFeature);
        Assert.isTrue(errorCode == ErrorInfo.MOK.getValue(), "人脸特征提取失败");

        //开启活体检测
        errorCode = faceEngine.setLivenessParam(0.5f, 0.7f);
        Assert.isTrue(errorCode == ErrorInfo.MOK.getValue(), "设置活体测试失败");

        List<LivenessInfo> livenessInfoList = new ArrayList<>();
        errorCode = faceEngine.getLiveness(livenessInfoList);
        Assert.isTrue(errorCode == ErrorInfo.MOK.getValue(), "活体检测失败");
        int liveness = livenessInfoList.get(0).getLiveness();
        log.info("活体liveness:{}", liveness);
        liveOk = liveness == 1;

        //释放引擎
        engineWrapper.destroy();
        return liveOk;
    }
}

总结

  • 这里的ArcFaceService在业务模块是可以懒加载的，好处就不解释了
  • 目前starter里service就写了一个接口，需要的可以自己扩展
  • 其实以前我也不赞成微服务还搞好多starter，但是最近想法有点改变。
    – 首先是业务线细分后，可能多个服务都需要接入某项技术，用starter可以细粒度管理模块。
    – 其次，让业务更加专注业务，第三方仅仅是第三方服务
    – 最后，其实就是可以复用，但是不得不说开发工作量增加了
  • 总结一句话：Spring Boot Starter 就是为了“开箱即用”而准备的功能集装箱。
    – 通过引入一个 starter，就可以获得一整套某个功能的支持，开发者只需关注业务逻辑，而无需自己配置和管理底层依赖。
         最后，希望能帮到大家，未来之所以迷人，是因为是机遇也是挑战，加油！

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.coloradmin.cn/o/2399252.html

如若内容造成侵权/违法违规/事实不符，请联系多彩编程网进行投诉反馈，一经查实，立即删除！

相关文章

PyTest框架学习

PyTest框架学习

0. 优先查看学习教程 超棒的学习教程 1. yield 语句 yield ptc_udp_clientyield&#xff1a;在 Pytest fixture 中&#xff0c;yield 用于分隔设置和清理代码。yield 之前的代码在测试用例执行前运行&#xff0c;yield 之后的代码在测试用例执行后运行。ptc_udp_client&…
阅读更多...
SIP、SAP、SDP、mDNS、SSH、PTP

SIP、SAP、SDP、mDNS、SSH、PTP

&#x1f308; 一、SIP 会话初始协议 会话初始协议 SIP 是一个在 IP 网络上进行多媒体通信的应用层控制协议&#xff0c;它被用来创建、修改和终结 1 / n 个参加者参加的会话进程。SIP 不能单独完成呼叫功能&#xff0c;需要和 RTP、SDP 和 DNS 配合来完成。 1. SIP 协议的功…
阅读更多...
【AI学习笔记】Coze工作流写入飞书多维表格（即：多维表格飞书官方插件使用教程）

【AI学习笔记】Coze工作流写入飞书多维表格（即：多维表格飞书官方插件使用教程）

背景前摇&#xff1a; 今天遇到一个需求&#xff0c;需要把Coze平台大模型和用户的对话记录保存进飞书表格&#xff0c;这个思路其实不难&#xff0c;因为官方提供了写入飞书表格和多维表格的插件&#xff0c;但是因为平台教程和案例的资料匮乏&#xff0c;依据现有的官方文档…
阅读更多...
在 Windows 系统下配置 VSCode + CMake + Ninja 进行 C++ 或 Qt 开发

在 Windows 系统下配置 VSCode + CMake + Ninja 进行 C++ 或 Qt 开发

在 Windows 系统下配置 VSCode CMake Ninja 进行 C 或 Qt 开发&#xff0c;是一个轻量级但功能强大的开发环境。下面我将分步骤详细说明如何搭建这个开发环境&#xff0c;支持纯 C 和 Qt 项目。 &#x1f9f0; 所需工具安装 1. 安装 Visual Studio Code&#xff08;VSCode&…
阅读更多...
leetcode 二叉搜索树中第k小的元素 java

leetcode 二叉搜索树中第k小的元素 java

中序遍历 定义一个栈&#xff0c;用于存取二叉树中的元素 Deque<TreeNode> stack new ArrayDeque<TreeNode>();进入while循环while(! stack.isEmpty()|| root ! null){}将root的左节点入栈&#xff0c;直到rootnull while(rootnull){stack.push(root);root ro…
阅读更多...
5.1 初探大数据流式处理

5.1 初探大数据流式处理

在本节中&#xff0c;我们深入探讨了大数据流式处理的基础知识和关键技术。首先&#xff0c;我们区分了批式处理和流式处理两种大数据处理方式&#xff0c;了解了它们各自的适用场景和特点。流式处理以其低延迟和高实时性适用于需要快速响应的场景&#xff0c;而批式处理则适用…
阅读更多...
传输层协议 UDP 介绍 -- UDP 协议格式，UDP 的特点，UDP 的缓冲区

传输层协议 UDP 介绍 -- UDP 协议格式，UDP 的特点，UDP 的缓冲区

目录 1. 再识的端口号 1.1 端口号范围划分 1.2 知名端口号&#xff08;Well-Know Port Number&#xff09; 2. UDP 协议 2.1 UDP 协议格式 2.2 UDP 的特点 2.3 UDP 的缓冲区 2.4 一些基于 UDP 的应用层协议 传输层&#xff08;Transport Layer&#xff09;是计算机网络…
阅读更多...
ApacheSuperset CVE-2023-27524

ApacheSuperset CVE-2023-27524

前言:CVE-2023-27524 是一种远程代码执行漏洞&#xff0c;攻击者通过该漏洞可在受影响系统上执行任意代码&#xff0c;从而获得未授权访问权 CVE-2023-27524 GitHubhttps://github.com/horizon3ai/CVE-2023-27524 任务一 代理 | 拉取镜像 vi /etc/proxychains4.conf //最下面修…
阅读更多...
如何在 HTML 中添加按钮

如何在 HTML 中添加按钮

原文&#xff1a;如何在 HTML 中添加按钮 | w3cschool笔记 &#xff08;请勿将文章标记为付费&#xff01;&#xff01;&#xff01;&#xff01;&#xff09; 在网页开发中&#xff0c;按钮是用户界面中不可或缺的元素之一。无论是用于提交表单、触发动作还是导航&#xff0…
阅读更多...
Linux--进程的程序替换

Linux--进程的程序替换

问题导入&#xff1a; 前面我们知道了&#xff0c;fork之后&#xff0c;子进程会继承父进程的代码和“数据”&#xff08;写实拷贝&#xff09;。 那么如果我们需要子进程完全去完成一个自己的程序怎么办呢&#xff1f; 进程的程序替换来完成这个功能&#xff01; 1.替换原理…
阅读更多...
调教 DeepSeek - 输出精致的 HTML MARKDOWN

调教 DeepSeek - 输出精致的 HTML MARKDOWN

【序言】 不知道是不是我闲的蛋疼&#xff0c;对百度AI 和 DeepSeek 的回答都不太满意。 DeepSeek 回答句子的引用链接&#xff0c;始终无法准确定位。有时链接只是一个域名&#xff0c;有时它给的链接是搜索串如: baidu.com/?q"搜索内容"。 百度AI 回答句子的引用…
阅读更多...
【笔记】Windows系统部署suna基于 MSYS2的Poetry 虚拟环境backedn后端包编译失败处理

【笔记】Windows系统部署suna基于 MSYS2的Poetry 虚拟环境backedn后端包编译失败处理

基于 MSYS2&#xff08;MINGW64&#xff09;中 Python 的 Poetry 虚拟环境包编译失败处理笔记 一、背景 在基于 MSYS2&#xff08;MINGW64&#xff09;中 Python 创建的 Poetry 虚拟环境里&#xff0c;安装 Suna 开源项目相关包时编译失败&#xff0c;阻碍项目正常部署。 后端…
阅读更多...
【深度学习优化算法】02：凸性

【深度学习优化算法】02：凸性

【作者主页】Francek Chen 【专栏介绍】 ⌈ ⌈ ⌈PyTorch深度学习 ⌋ ⌋ ⌋ 深度学习 (DL, Deep Learning) 特指基于深层神经网络模型和方法的机器学习。它是在统计机器学习、人工神经网络等算法模型基础上&#xff0c;结合当代大数据和大算力的发展而发展出来的。深度学习最重…
阅读更多...
策略公开了：年化494%，夏普比率5.86，最大回撤7% | 大模型查询akshare，附代码

策略公开了：年化494%，夏普比率5.86，最大回撤7% | 大模型查询akshare，附代码

原创内容第907篇&#xff0c;专注智能量化投资、个人成长与财富自由。 这位兄弟的策略公开了&#xff0c;年化494%&#xff0c;夏普比率5.86&#xff0c;最大回撤7%&#xff0c;欢迎大家前往围观&#xff1a; http://www.ailabx.com/strategy/683ed10bdabe146c4c0b2293 系统代…
阅读更多...
多模态大语言模型arxiv论文略读（101）

多模态大语言模型arxiv论文略读（101）

ML-Mamba: Efficient Multi-Modal Large Language Model Utilizing Mamba-2 ➡️ 论文标题&#xff1a;ML-Mamba: Efficient Multi-Modal Large Language Model Utilizing Mamba-2 ➡️ 论文作者&#xff1a;Wenjun Huang, Jiakai Pan, Jiahao Tang, Yanyu Ding, Yifei Xing, …
阅读更多...
电网“逆流”怎么办？如何实现分布式光伏发电全部自发自用？

电网“逆流”怎么办？如何实现分布式光伏发电全部自发自用？

2024年10月9日&#xff0c;国家能源局综合司发布了《分布式光伏发电开发建设管理办法&#xff08;征求意见稿&#xff09;》&#xff0c;意见稿规定了户用分布式光伏、一般工商业分布式光伏以及大型工商业分布式光伏的发电上网模式&#xff0c;当选择全部自发自用模式时&#x…
阅读更多...
如何查看电脑电池性能

如何查看电脑电池性能

检查电脑电池性能的方法如下&#xff1a; 按下winR键&#xff0c;输入cmd回车&#xff0c;进入命令行窗口 在命令行窗口输入powercfg /batteryreport 桌面双击此电脑&#xff0c;把刚刚复制的路径粘贴到文件路径栏&#xff0c;然后回车 回车后会自动用浏览器打开该报告 红…
阅读更多...
kubernetes》》k8s》》kubectl proxy 命令后面加一个

kubernetes》》k8s》》kubectl proxy 命令后面加一个

命令后面加一个& 在Linux终端中&#xff0c;如果在命令的末尾加上一个&符号&#xff0c;这表示将这个任务放到后台去执行 kubectl proxy 官网资料 是 Kubernetes 提供的一个命令行工具&#xff0c;用于在本地和 Kubernetes API Server 之间创建一个安全的代理通道。…
阅读更多...
网络安全运维实训室建设方案

网络安全运维实训室建设方案

一、网络安全运维人才需求与实训困境 在数字化时代&#xff0c;网络安全已成为国家安全、社会稳定和经济发展的重要基石。随着信息技术的飞速发展&#xff0c;网络安全威胁日益复杂多样&#xff0c;从个人隐私泄露到企业商业机密被盗&#xff0c;从关键基础设施遭受攻击到社会…
阅读更多...
DBeaver 连接mysql报错：CLIENT_PLUGIN_AUTH is required

DBeaver 连接mysql报错：CLIENT_PLUGIN_AUTH is required

DBeaver 连接mysql报错&#xff1a;CLIENT_PLUGIN_AUTH is required 一、必须要看这个 >> &#xff1a;参考文献 二、补充 2.1 说明 MySQL5、6这些版本比较老&#xff0c;而DBeaver默认下载的是MySQL8的连接库&#xff0c;所以连接旧版本mysql报错&#xff1a;CLIEN…
阅读更多...
推荐文章
最新文章

Copyright @ 2022~2023