喀拉喀托火山,印度尼西亞 (? Martin Rietze/Alamy)
概述
ID號(hào)生成器(或:全局唯一ID生成器)是服務(wù)端系統(tǒng)的基礎(chǔ)設(shè)施,而且ID號(hào)這個(gè)東西基本搞后端開發(fā)的程序員天天都要接觸。而關(guān)于ID生成的算法現(xiàn)在業(yè)界首屈一指的當(dāng)屬Snowflake雪花算法。
UidGenerator正是百度開源的一款基于Snowflake雪花算法實(shí)現(xiàn)的高性能唯一ID生成器。在本號(hào)前文中已經(jīng)詳細(xì)使用過UidGenerator,但使用過程還是比較繁雜,還需要自己去引UidGenerator組件的源碼,感覺有點(diǎn)不方便。為此本文基于UidGenerator,再來封裝一套更利于Spring Boot項(xiàng)目使用的ID號(hào)生成組件,命名為id-spring-boot-starter,一看名字就知道是開箱即用的。
用法
- 導(dǎo)入SQL腳本
DROP TABLE IF EXISTS WORKER_NODE;
CREATE TABLE WORKER_NODE
(
ID BIGINT NOT NULL AUTO_INCREMENT COMMENT 'auto increment id',
HOST_NAME VARCHAR(64) NOT NULL COMMENT 'host name',
PORT VARCHAR(64) NOT NULL COMMENT 'port',
TYPE INT NOT NULL COMMENT 'node type: ACTUAL or CONTAINER',
LAUNCH_DATE DATE NOT NULL COMMENT 'launch date',
MODIFIED TIMESTAMP NOT NULL COMMENT 'modified time',
CREATED TIMESTAMP NOT NULL COMMENT 'created time',
PRIMARY KEY(ID)
)
COMMENT='DB WorkerID Assigner for UID Generator',ENGINE = INNODB;
這一步肯定是省不掉,畢竟UidGenerator需要數(shù)據(jù)庫支持
- pom中加入依賴
<dependency>
<groupId>cn.codesheep</groupId>
<artifactId>id-spring-boot-starter</artifactId>
<version>1.0.0</version>
</dependency>
- 配置數(shù)據(jù)庫連接
url: jdbc:mysql://xxx.xxx.xxx.xxx:3306/demo?useUnicode=true&characterEncoding=utf8&autoReconnect=true&useOldAliasMetadataBehavior=true&connectionCollation=utf8mb4_unicode_ci&rewriteBatchedStatements=true&allowMultiQueries=true
username: xxxxxx
password: xxxxxx
還是因?yàn)?code>UidGenerator需要數(shù)據(jù)庫支持
- 修改Spring Boot主類
Spring Boot應(yīng)用主類上加上mybatis注解即可:
@MapperScan({"com.baidu.fsg.uid.worker.dao"})
- 代碼使用方式
@RestController
public class TestController {
@Autowired
private UidGenService uidGenService;
@GetMapping("/uid")
public String genUid() {
return String.valueOf("本次生成的唯一ID號(hào)為:"+uidGenService.getUid());
}
}
怎么樣,用法超級(jí)簡單吧:
- 首先用
Autowired的方式引入UidGenService類; - 直接調(diào)用
UidGenService類的getUid()方法即可獲得一個(gè)Long型的ID號(hào)
- 運(yùn)行效果
運(yùn)行效果
demo源碼在此,需要請(qǐng)自提:
id-spring-boot-starter源碼下載
需要組件id-spring-boot-starter源碼進(jìn)行自定制的,可以去github上自行下載源代碼,地址在此:
幾個(gè)注意點(diǎn):
- 由于
UidGenerator需要數(shù)據(jù)庫支持,因此使用前一定要導(dǎo)數(shù)據(jù)表,并且要配置MapperScan - 需要高度定制
UidGenerator組件詳情的,可以自行修改id-spring-boot-starter內(nèi)部的cached-uid-spring.xml文件,然后重新打jar包 - 由于
ID號(hào)生成一般屬于系統(tǒng)基礎(chǔ)服務(wù),因此可以獨(dú)立成一個(gè)微服務(wù),供其他微服務(wù)調(diào)用