# next-components

**Repository Path**: lsrztt/next-components

## Basic Information

- **Project Name**: next-components
- **Description**: springboot 常用组件启动加载，基于springboot 2.3.5进行，包括全局序列化生成，groovy脚本加载，适配redis，class，db等， redis集成分布式锁或缓存队列通知等高级应用，基于阿里云oss和阿里云ons消息队列集成，同时优化logback进行日志选择性脱敏，并区分环境进行打印 
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2025-12-02
- **Last Updated**: 2025-12-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# next-components

#### 介绍
springboot 常用组件启动加载，基于springboot 2.3.5进行，包括全局序列化生成，groovy脚本加载，适配redis，class，db等， redis集成分布式锁或缓存队列通知等高级应用，基于阿里云oss和阿里云ons消息队列集成，同时优化logback进行日志选择性脱敏，并区分环境进行打印 

#### 软件架构
软件架构说明


#### 安装教程

1.  xxxx
2.  xxxx
3.  xxxx



#### 使用说明
分支说明


1.  develop 基于jdk8 springboot 2.3.5 或2.7.6 进行。 不支持3.*版本
2.  ai 分支 基于jdk17及以上 springboot3.3.* 或更高版本
 


 # 在启动的时候，application.yml中的配置 
ksvip:
  groovy:
    engine:
      enable: true  #true启动groovy引擎，如不需要可设置false或不用配置
      mysql-loader:  #启用mysql数据库加载groovy 如果redis可以参考设置即可
        enable: true
  redis:
    host: 127.0.0.1
    password: 123456
    port: 6379
server:
  port: 8080
  servlet:
    context-path: /
    encoding:
      charset: UTF-8
      enabled: true
      force: true
spring:
  datasource:
    driver-class-name: com.mysql.jdbc.Driver
    password: 123456
    url: jdbc:mysql://localhost:3306/design?useSSL=false&useUnicode=true&characterEncoding=UTF-8&serverTimezone=UTC&nullCatalogMeansCurrent=true
    username: root
  global:
    redis-open: true

 *****
logback参考配置并引入即可
<included>
	<!-- 引入日志datasecure begin -->
	<property scope="context" name="sensitiveDataAllowRun"
		value="true" />
	<property scope="context" name="sensitiveDataKeys" value='[]' />
	<property scope="context" name="sensitiveDataKeys1" value='[]' />
	<property scope="context" name="sensitiveDataKeys2" value='[]' />
	<property scope="context" name="sensitiveDataKeys3" value='[]' />
	<property name="pattern_format"
		value="%d [%t] %-5p [%logger] [%F:%L] [trace=%mdc{trace_id},span=%mdc{span_id}] - %msg%n" />
	<conversionRule conversionWord="msg"
		converterClass="com.ksvip.next.components.datasecure.logback.SensitiveDataConverter" />
	<conversionRule conversionWord="ex"
		converterClass="com.ksvip.next.components.datasecure.logback.SensitiveDataThrowableProxyConverter" />
	<conversionRule conversionWord="exception"
		converterClass="com.ksvip.next.components.datasecure.logback.SensitiveDataThrowableProxyConverter" />
	<conversionRule conversionWord="throwable"
		converterClass="com.ksvip.next.components.datasecure.logback.SensitiveDataThrowableProxyConverter" />

	<if condition='",prd".indexOf(property("DEPLOY_ENV")) > 0'>
		<then>
			<property scope="context" name="SensitiveDataAllowRun"
				value="true" />
		</then>
	</if>

	<!-- 控制台打印 -->
	<appender name="STDOUT"
		class="ch.qos.logback.core.ConsoleAppender">
		<target>System.out</target>
		<encoder
			class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
			<charset>UTF-8</charset>
			<!-- <pattern>%d [%thread] %-5p [%c] [%F:%L] - %msg%n</pattern> -->
			<pattern>${pattern_format}</pattern>
		</encoder>
	</appender>

	<property name="logging.infoAppender.fileName"
		value="${app.name.monitor.prex}-ss_micro_app_${app.name.monitor}_lt_info" />


	<appender name="infoAppender"
		class="ch.qos.logback.core.rolling.RollingFileAppender">
		<file>${logging.path}/${logging.infoAppender.fileName}.log</file>
		<rollingPolicy
			class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
			<fileNamePattern>${logging.path}/${logging.infoAppender.fileName}-%d{yyyy-MM-dd}.log
			</fileNamePattern>
			<maxHistory>365</maxHistory>
		</rollingPolicy>
		<encoder
			class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
			<charset>UTF-8</charset>
			<!-- <pattern>%d [%thread] %-5p [%c] [%F:%L] [trace=%X{trace_id:-},span=%X{span_id:-}] 
				- %msg%n</pattern> -->
			<pattern>${pattern_format}</pattern>
		</encoder>
	</appender>

	<!-- 异步输出 infoAppender 的日志 -->
	<!-- AsyncAppender并不处理日志，只是将日志缓冲到一个BlockingQueue里面去，并在内部创建一个工作线程从队列头部获取日志，之后将获取的日志 
		循环记录到附加的其他appender上去，从而达到不阻塞主线程的效果。因此AsyncAppender仅仅充当事件转发器，必须引用另一个appender来做事。 -->
	<appender name="infoAppenderAsync"
		class="ch.qos.logback.classic.AsyncAppender">
		<!-- 包含调用者信息,默认是false,官方提到如果开启会有性能上的损失,开启用于输出[%F:%L]等信息 -->
		<includeCallerData>true</includeCallerData>
		<!-- 不丢失日志.默认的,如果队列的80%已满,则会丢弃TRACT、DEBUG、INFO级别的日志 -->
		<discardingThreshold>0</discardingThreshold>
		<!-- 更改默认的队列的深度,该值会影响性能.默认值为256 -->
		<queueSize>2048</queueSize>
		<!-- 添加附加的appender,最多只能添加一个 -->
		<appender-ref ref="infoAppender" />
	</appender>

	<property name="logging.errorAppender.fileName"
		value="${app.name.monitor.prex}-ss_micro_app_${app.name.monitor}_lt_error" />
	<appender name="errorAppender"
		class="ch.qos.logback.core.rolling.RollingFileAppender">
		<file>${logging.path}/${logging.errorAppender.fileName}.log</file>
		<filter class="ch.qos.logback.classic.filter.ThresholdFilter">
			<level>ERROR</level>
		</filter>
		<rollingPolicy
			class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
			<fileNamePattern>${logging.path}/${logging.errorAppender.fileName}-%d{yyyy-MM-dd}.log
			</fileNamePattern>
			<maxHistory>365</maxHistory>
		</rollingPolicy>
		<encoder
			class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
			<charset>UTF-8</charset>
			<!-- <pattern>%d [%thread] %-5p [%c] [%F:%L] [trace=%X{trace_id:-},span=%X{span_id:-}] 
				- %msg%n</pattern> -->
			<pattern>${pattern_format}</pattern>
		</encoder>
	</appender>

	<appender name="errorAppenderAsync"
		class="ch.qos.logback.classic.AsyncAppender">
		<includeCallerData>true</includeCallerData>
		<discardingThreshold>0</discardingThreshold>
		<queueSize>2048</queueSize>
		<appender-ref ref="errorAppender" />
	</appender>

	<logger name="ERROR_LOGGER" additivity="false" level="info">
		<appender-ref ref="errorAppender" />
	</logger>


	<property name="logging.bizAppender.fileName"
		value="${app.name.monitor.prex}-ss_micro_app_${app.name.monitor}_lt_biz" />
	<appender name="bizAppender"
		class="ch.qos.logback.core.rolling.RollingFileAppender">
		<file>${logging.path}/${logging.bizAppender.fileName}.log</file>
		<filter class="ch.qos.logback.classic.filter.ThresholdFilter">
			<level>INFO</level>
		</filter>
		<rollingPolicy
			class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
			<fileNamePattern>${logging.path}/${logging.bizAppender.fileName}-%d{yyyy-MM-dd}.log
			</fileNamePattern>
			<maxHistory>30</maxHistory>
		</rollingPolicy>
		<encoder charset="UTF-8"
			class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
			<pattern>%msg%n</pattern>
		</encoder>
	</appender>

	<logger name="BIZ_LOGGER" additivity="false" level="info">
		<appender-ref ref="bizAppender" />
	</logger>

	<appender name="bizAppenderAsync"
		class="ch.qos.logback.classic.AsyncAppender">
		<includeCallerData>true</includeCallerData>
		<discardingThreshold>0</discardingThreshold>
		<queueSize>2048</queueSize>
		<appender-ref ref="bizAppender" />
	</appender>

	<!-- <logger name="com.alibaba.dubbo"> <level value="INFO"/> </logger> -->
	<logger name="org.apache">
		<level value="INFO" />
		<appender-ref ref="errorAppender" />
		<appender-ref ref="infoAppender" />
	</logger>

	<logger name="org.springframework">
		<level value="INFO" />
		<appender-ref ref="errorAppender" />
		<appender-ref ref="infoAppender" />
	</logger>

	<logger name="com.alibaba.nacos.client.naming">
		<level value="WARN" />
	</logger>

	<logger name="com.netflix">
		<level value="INFO" />
		<appender-ref ref="errorAppender" />
		<appender-ref ref="infoAppender" />
		>
	</logger>
	<logger name="com.taobao.tddl" level="INFO" />

	<!-- 引入日志datasecure end -->

</included>

#### 参与贡献

1.  Fork 本仓库
2.  新建 Feat_xxx 分支
3.  提交代码
4.  新建 Pull Request


#### 特技

1.  使用 Readme\_XXX.md 来支持不同的语言，例如 Readme\_en.md, Readme\_zh.md
2.  Gitee 官方博客 [blog.gitee.com](https://blog.gitee.com)
3.  你可以 [https://gitee.com/explore](https://gitee.com/explore) 这个地址来了解 Gitee 上的优秀开源项目
4.  [GVP](https://gitee.com/gvp) 全称是 Gitee 最有价值开源项目，是综合评定出的优秀开源项目
5.  Gitee 官方提供的使用手册 [https://gitee.com/help](https://gitee.com/help)
6.  Gitee 封面人物是一档用来展示 Gitee 会员风采的栏目 [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/)