网站的分类有哪些晋中市住房保障和城乡建设局网站

一、简介

• 这是一个超高性能唯一ID生成工具，支持docker一键部署，提供API接入功能
• 支持高性能生成Snowflake ID、Sonyflake ID、UUID v1、UUID v4、XID、KSUID以及自定义ID的服务
• 可以用来生成订单编号、学号、高标准唯一标识、有序ID等等
• 开源地址参考：GitHub - luler/hello_id: 高性能生成snowflake id、sonyflake id、uuid v1、uuid v4、xid、ksuid以及自定义ID的服务

二、安装部署

• 提前准备好docker、docker-compose环境（这里不再赘述）
• 新增docker-compose.yml文件，配置内容如下，需要设置正确的MySQL连接配置：

  version: "3"
  services:hello_id:image: ccr.ccs.tencentyun.com/luler/hello_idprivileged: truerestart: alwaysenvironment:- ADMIN_NAME=admin      #管理员账号- ADMIN_PASSWORD=admin  #管理员登录密码- JWT_SECRET=FYDE7x5A   #页面访问token加密秘钥，自定义一个复杂的- DB_NAME=hello_id  #数据库名称，提前创建好- DB_HOST=10.10.11.195 #数据库ip地址- DB_PORT=3306- DB_USERNAME=root- DB_PASSWORD=rootports:- 2023:3000volumes:- ./runtime:/app/runtime

• 在文件下执行启动命令

  docker-compose up -d

三、使用示例

1. 自带后台管理页面

• 后台页面地址：http://127.0.0.1:2023 ，默认登录账号：admin，密码：admin

  

• 登录之后，新增一个自定义ID

  

• 在页面上测试生成一个ID，如下

  

2. 使用服务提供的API示例

2.1 使用API之前，需要在后台增加一个授权码，用于API调用授权

2.2 API使用示例

• postman调用生成自定义ID示例

2.3 更多接口文档信息

2.3.1 生成雪花id（基于时间、机器id、随机数生成，有序，整数类型）

接口: /api/snowflake
方法：GET
请求参数：

字段	是否必填	类型	描述
workerId	否	int	机器ID，取值范围0-1023，默认0
length	否	int	获取ID数量，默认1，最大500
authKey	是	string	授权码

返回示例：

{"code": 200,"data": {"ids": ["1711927875550052352"],"type": "snowflake","workerId": 0},"message": "创建成功"
}

2.3.2 生成sonyflake id（snowflake的改进版本，可用时间更长，有序，整数类型）

接口: /api/sonyflake
方法：GET
请求参数：

字段	是否必填	类型	描述
length	否	int	获取ID数量，默认1，最大500
authKey	是	string	授权码

返回示例：

{"code": 200,"data": {"ids": ["482279196769390593"],"type": "sonyflake"},"message": "创建成功"
}

2.3.3 生成uuid V1 （根据时间、Mac地址等信息生成，有时间顺序）

接口: /api/uuid1

方法：GET

请求参数：

字段	是否必填	类型	描述
length	否	int	获取ID数量，默认1，最大500
authKey	是	string	授权码

返回示例：

{"code": 200,"data": {"ids": ["c9973b96-67db-11ee-89f2-00ff0c3e16f1"],"type": "uuid1"},"message": "创建成功"
}

2.3.4 生成uuid V4 （完全随机生成，无序）

接口: /api/uuid4

方法：GET

请求参数：

字段	是否必填	类型	描述
length	否	int	获取ID数量，默认1，最大500
authKey	是	string	授权码

返回示例：

{"code": 200,"data": {"ids": ["f26cb76e-574b-4797-949e-85f449c77ee3"],"type": "uuid4"},"message": "创建成功"
}

2.3.5 生成xid（基于时间戳、随机数生成，有序）

接口: /api/xid

方法：GET

请求参数：

字段	是否必填	类型	描述
length	否	int	获取ID数量，默认1，最大500
authKey	是	string	授权码

返回示例：

{"code": 200,"data": {"ids": ["ckj09svfe3qiv1150kr0"],"type": "xid"},"message": "创建成功"
}

2.3.6 生成ksuid（基于时间戳、随机数生成，随机数比xid更大，唯一性更好，有序）

接口: /api/ksuid

方法：GET

请求参数：

字段	是否必填	类型	描述
length	否	int	获取ID数量，默认1，最大500
authKey	是	string	授权码

返回示例：

{"code": 200,"data": {"ids": ["2Wb9ZXX2OWPOpubXAKRLwQGn7cP"],"type": "ksuid"},"message": "创建成功"
}

2.3.7 生成自定义ID（简单定制化，原子有序）

接口: /api/getId

方法：GET

请求参数：

字段	是否必填	类型	描述
type	是	string	ID标识
length	否	int	获取ID数量，默认1，最大500
authKey	是	string	授权码

返回示例：

{"code": 200,"data": ["20230930000000114.go"],"message": "获取成功"
}

四、总结

• 该工具可以提供高性能的ID生成服务，特别是自定义ID，配置灵活，使用简单，基本是纯内存生成唯一有序ID，可以集群部署无限扩展性能
• 开发必备组件，在很多需要ID生成的业务系统中，都有用武之地

临时演示试用地址： 我这个咩应用