# uniqueid-generator

**Repository Path**: lqclf/uniqueid-generator

## Basic Information

- **Project Name**: uniqueid-generator
- **Description**: 基于MySQL版的唯一自增id生成器，适用于springboot2
- **Primary Language**: Java
- **License**: MPL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2021-04-02
- **Last Updated**: 2026-05-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 全局唯一ID生成, MySQL

## README

描述：Java1.8以上，基于MySQL版的唯一自增id生成器，适用于springboot2

## 一、配置方式

1. 创建sequence.properties文件

   在src/main/resources目录下创建sequence.properties，与application.properties同级目录

2. 配置sequence.properties文件

   **创建单个自增序列ID**

   ​	例：配置序列ID  “demoId”

   ​	（1）配置序列ID名

   ```properties
   #自增序号名配置
   sequenceID.name=demoId
   ```

   ​	（2）配置序列ID属性

   ```properties
   #设置初始值
   sequenceID.name.currentValue.demoId=0
   #设置每次增长值
   sequenceID.name.increment.demoId=1
   ```

   **创建多个自增序列ID**

   ​	例：配置序列ID  “demoId1”，“demoId2”

   ​	（1）配置序列ID名

   ```properties
   #自增序号名配置
   sequenceID.name=demoId1,demoId2
   ```

   ​	（2）配置序列ID属性

   ```properties
   #设置demoId1初始值
   sequenceID.name.currentValue.demoId1=0
   #设置demoId1每次增长值
   sequenceID.name.increment.demoId1=1
   #设置demoId2初始值
   sequenceID.name.currentValue.demoId2=0
   #设置demoId2每次增长值
   sequenceID.name.increment.demoId2=1
   ```

3. 配置启动类

   在启动类Application.java中配置以下两个注解

   ```java
   @MapperScan("com.eric.*")     //扫描dao层（必须配置，不然无法找到mapper.xml文件）
   @ComponentScan({"com.eric.*"})
   ```

   

4. 配置application.properties或者application.yml文件

   application.properties配置：

   ```properties
   #增加自己的数据库配置
   
   #----spring-boot整合mybatis  classpath*处的*不能少，否则不能扫描到jar包里面的mapper文件----
   mybatis.mapper-locations=classpath*:/config/sqlmap/*Mapper.xml
   
   #Springboot中默认的静态资源路径有：classpath:/resources/，如果不配置就无法找到sequence.properties文件
   spring.resources.static-locations=classpath:/resources/
   ```

   application.yml配置：

   ```yaml
   #增加自己的数据库配置
   
   #----spring-boot整合mybatis  classpath*处的*不能少，否则不能扫描到jar包里面的mapper文件----
   mybatis:
       mapper-locations：classpath*:/config/sqlmap/*Mapper.xml
   
   #Springboot中默认的静态资源路径有：classpath:/resources/，如果不配置就无法找到sequence.properties文件
   spring:
       resources:
       static-locations：classpath:/resources/
   ```

   

   ## 二、使用教程

1. 使用cmd命令打包

   ​		进入项目uniqueid-generator文件夹，依次执行命令mvn clean，mvn install，执行完两条命令后，uniqueid-generator-1.0.0-SNAPSHOT.jar就自动导入到本地maven库中

   ​		如果已经下载了jar包，也可直接将jar包导入到项目中

2. pom文件引入

   ```xml
    <!-- 导入uniqueid-generator依赖 -->
    <dependency>
    	<groupId>com.eric</groupId>
    	<artifactId>uniqueid-generator</artifactId>
    	<version>1.0.0-SNAPSHOT</version>
    </dependency>
   ```

3. 使用

   ```java
   SequenceIdUtils sequenceId = new SequenceIdUtils();//创建一个sequenceIdUtils对象
   String seqDepartId = sequenceId.createNextId(8, "demoId1");//生成一个8位自增序列id
   ```