Home

Awesome

simple-robot Springboot快速启动器

img <br> codebeat badge <br>

<br>

项目地址

Github or Gitee

使用

首先,在使用springboot启动器之前,你需要使用springboot的 properties 格式配置文件:application.properties, 并将simple-robot中的配置项写入此类配置文件中。 <br> 其次,一般拥有springboot启动器的组件所处的核心系版本,都是从核心的1.9.x开始的。

组件启动器

我为一些特定的组件提供了其专属的启动器。 一般来讲,所有官方(即我)推出的启动器都只需要如上文所说的, 将配置文件更换为properties格式 并将@SpringbootApplication注解替换为@SimpleRobotSpringbootApplication即可。

1.9.1开始,不再需要任何自定义注解。直接使用@SpringbootApplication启动即可。除非你要使用tomcat或者undertow之类的服务器来代替原本的内置http服务器,否则无需书写额外代码,直接编写监听器即可。

<br> 以下我将展示已经提供了官方启动器的项目地址,以供参考。 <br>

CQ HTTP 组件Springboot启动器

https://github.com/ForteScarlet/simple-robot-component-cqhttp-springboot-starter

Mirai 组件Springboot启动器

https://github.com/ForteScarlet/simple-robot-component-mirai-springboot-starter

<br>

自定义启动器

如果你想要通过核心启动器来自定义一个启动器,那么你需要先选择导入核心启动器:

https://search.maven.org/artifact/io.github.ForteScarlet.simple-robot/core-spring-boot-starter/

Maven

        <dependency>
            <groupId>io.github.ForteScarlet.simple-robot</groupId>
            <artifactId>core-spring-boot-starter</artifactId>
            <version>${version}</version>
        </dependency>

Gradle

implementation 'io.github.ForteScarlet.simple-robot:core-spring-boot-starter:${version}'

然后参考注解类@SimpleRobotSpringBootApplication内容。 @SimpleRobotSpringBootApplication内默认继承了springboot的启动类注解@SpringbootApplication, 并且其中会去默认扫描一个组件的自动配置包路径: - com.simplerobot.core.springboot.configuration

1.9.1之后使用spring.factory进行自动配置,将不会为组件扫描特定的包路径了。

核心启动器需要某个组件启动器通过Spring向其提供一些启动所需的必要对象

而核心会为组件启动器的构建所提供的bean有:

使用

如果你使用的是我编写的标准版的快速启动器,你只需要将原本Springboot启动器上的@SpringbootApplication注解替换为@SimpleRobotSpringBootApplication即可。

1.9,1后无需变更注解,导入官方的快速启动器坐标后即可直接使用。(记得删除旧的config代码,防止依赖冲突。)

如果是第三方所提供的启动器,则遵循其定义的规则。

如果启动器完整且正常,你最终可以得到如下内容:

版本规则

对于所有的启动器版本命名规则定义如下: 格式为a.b, 其中,a 为此启动器所对应的核心版本系,b 代表当前启动器的版本。 例如: 1.9.0, 1.9.1

这两个版本中,a均为1.9b01,都代表其内部使用的是1.9.x的核心(一般来讲都是最后一个版本的核心版本。),只不过1.9.1相对于1.9.0来讲更新、修复、改善了一些东西。

注意事项

1 启动器中的核心版本系与当前核心版本系

一般来讲,启动器所提供的核心版本系总是会比当前的核心版本系要低一个级别。例如,当前核心是1.10.4版本,即1.10.x系列,则最高版本的启动器一般会是1.9.x系列。

为什么呢?因为启动器一般来讲是需要保证其中所使用的核心为最新版本的,而当前所处的核心版本系中是无法保证最新版本的版本号的。

2 快速启动器中的springboot版本

截至到当前启动器版本为止,快速启动器中所包含的Springboot项目依赖的坐标与版本如下:

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter</artifactId>
            <version>2.2.5.RELEASE</version>
        </dependency>

如有需要请自行覆盖并更替其版本。

3 快速启动器的日志整合

官方的组件快速启动器中,QQLog的日志输出已经被重定向到了Springboot所使用的slf4j日志中,其中日志等级的对应关系为:

QQLog的日志等级slf4j的日志等级
debugdebug
infoinfo
successinfo
warningwarn
errorerror

整合后,日志所使用的namesimple-robot-app + 随机颜表情的名称。其中,simple-robot-app后面是有一个空格的。

如果想要关闭颜表情,你可以在项目启动之前调用FaceUtil.close()

更新日志

查看UPDATE.md文件