Api Boot 框架： 为 Spring Boot 提供组件化服务

[Jmysy]

官网地址

开源仓库

什么是 ApiBoot ？

ApiBoot 是接口服务的落地解决方案，提供了一系列开箱即用的组件，通过封装来简化主流第三方框架的集成，从而提高开发者开发效率、学习成本、降低入门门槛，真正的实现开箱即用！！！

对 SpringBoot 简单了解的开发者就可以编写安全稳定的接口服务，可为移动端、网页端等多个端点提供丰富的安全接口。

ApiBoot 依赖于 SpringBoot，可以使用 ApiBoot 构建独立的 Java 应用程序。

愿景：

• 为 Java 开发者提供低门槛第三方框架集成解决方案，让复杂的框架集成使用的门槛更低。
• 开箱即用，内部封装了主流框架，只需添加依赖、简单配置即可使用。
• 各个组件可独立使用，不再冗余你的应用程序。
• 可简单快速的构建安全的 restful 资源接口服务。
• 可用于构建 SpringCloud 微服务服务实例。
• 为🇨🇳开源做贡献，希望开源框架可以帮助更多的开发者。

安装 & 入门

组件的使用请查看官方参考文档，开始使用请访问第一个 ApiBoot 应用程序

如果你是使用Maven来构建项目，你需要添加ApiBoot的固化版本依赖到你的pom.xml文件内，如下所示：

<dependencyManagement>
  <dependencies>
    <!--ApiBoot 版本依赖-->
    <dependency>
      <groupId>org.minbox.framework</groupId>
      <artifactId>api-boot-dependencies</artifactId>
      <version>${lastVersion}</version>
      <scope>import</scope>
      <type>pom</type>
    </dependency>
  </dependencies>
</dependencyManagement>

注意：lastVersion需要替换为最新的 ApiBoot 版本，请访问版本依赖 - 2.获取最新的 ApiBoot 依赖查看。

版本依赖添加完成后，我们接下来就可以进行添加项目内所需要的 ApiBoot 组件，下面是使用分布式链路组件 minbox-logging 示例：

<dependencies>
  <!--ApiBoot MinBox Logging-->
  <dependency>
    <groupId>org.minbox.framework</groupId>
    <artifactId>api-boot-starter-logging</artifactId>
  </dependency>
</dependencies>

添加完组件我们就可以根据官方参考文档找到对应组件的文档进行配置使用了。

使用指南

作者针对每一个组件都提供了一系列的文章进行讲解，请访问 ApiBoot 开源框架各个组件的系列使用文章汇总 进行学习。

获取帮助

如果在使用 ApiBoot 的过程中遇到了问题，你可以通过以下途径获取帮助！

• 查看官方参考文档，使用的每一个细节都会在文档中进行体现。
• 在https://gitee.com/minbox-projects/api-boot/issues提交你遇到的使用问题。

提交问题建议

每个人可能提出的问题不同，不过也会有一些相同的问题，如果您要提出问题，请遵循以下建议：

• 在提交问题之前，请搜索 issues 内是否已经有人提出过该问题。
• 如果您即将要提出的问题不存在，请创建 issue。
• 请在提出您的问题时提供尽可能有关 ApiBoot 可能多的信息，比如：ApiBoot 的版本、JDK 、使用组件等
• 如果提问题时需要粘贴代码，请尽量使用 markdown 语法```转义符。

源码方式构建

ApiBoot 正式版本都会发布到 Maven Center，如果你想使用源码最新版本的 ApiBoot （版本并未发布），可以直接通过源码的方式进行构建安装到本地使用，前提条件如下所示：

• 本地需要配置 Maven 环境变量，建议使用最新版
• 本地需要配置 JDK 环境变量，JDK1.8 下载地址
• 本地需要配置 Git 环境变量，Git 下载地址

# 下载 master 分支源码到本地
➜ git clone https://github.com/minbox-projects/api-boot.git
# 进入 api-boot 源码根目录
➜ cd api-boot
# 执行安装
➜ mvn clean install -Dmaven.test.skip=true -Dmaven.javadoc.skip=true -Dgpg.skip

模块

ApiBoot的源码构建使用到了多个模块，下面是一个快速概述：

api-boot

api-boot模块是编译整个项目的根目录，所提供的能力如下所示：

• 提供项目统一版本revision的配置
• 提供项目编译时使用的公共插件（flatten、cobertura...）
• 提供项目编译时使用的Maven仓库配置
• 统一项目编译的 JDK 版本

api-boot-autoconfigure

api-boot-autoconfigure是最为主要的核心模块，内部提供了全部组件的自动化配置类，这一点完全是利用SpringBoot所提供的条件判断注解，位于resources/META-INF目录下还提供了附加的配置参数元数据定义内容文件：additional-spring-configuration-metadata.json，项目启用时我们所看到的banner输出内容也位于该模块中。

api-boot-dependencies

该模块的功能与spring-boot-dependencies一致，都是为了固化项目中所使用的依赖版本号，让我们在构建项目中可以很好地对某一个依赖进行升级，不再担心各个依赖之间版本不兼容的困扰。

api-boot-parent

该模块继承自api-boot-dependencies，可直接使用固化版本后的依赖，是构建其他模块的统一父依赖。

api-boot-starters

该模块下定义了开发过程中具体使用的Starter依赖，Starter依赖内不包含任何的框架代码，只有一个pom.xml文件，具体的自动化配置实现以及具体集成第三方的实现分别位于：api-boot-autoconfigure、api-boot-plugins模块内。

使用方式与spring-boot-starter-xxx一致，比如：在项目中集成限流组件，我们只需要在pom.xml中添加api-boot-starter-rate-limiter依赖即可，版本也无需添加，因为已经通过api-boot-dependencies模块进行了固化版本依赖。

api-boot-tools

该模块会定义一些常用到的工具类，比如：ApplicationContext、BeanFactory等。

该模块同样是由api-boot-autoconfigure进行自动化配置，将部分工具类自动注册到IOC。

示例

项目源码中api-boot-samples模块提供了各个组件的使用示例，也可以结合我博客文章来学习使用，详情请访问：ApiBoot 基础教程。

License

ApiBoot 采用 Apache2 开源许可进行编写。

[GM]

首先，开源是非常值得称赞的事情。

然后，说真的，点进组件使用文章看到那些看到营销味满满的标题，根本没有想尝试一下的欲望。

《原来 SpringSecurity 整合 OAuth2 后开放权限拦截路径还能这么玩？》
《见过这么简单的方式整合 Spring Security & OAuth2 的自定义查询用户吗？》
《我以为 OAuth2 整合 JWT 是很困难的事情，直到我使用了 ApiBoot，一切都变了！》

[Jmysy]

@GM 这只是具体的使用文章示例，具体文档可前往 https://apiboot.minbox.org/zh-cn/ 查看