比雪花短比UUID可读,这个Java业务流水号工具类有3个方法

简介: 这是一个轻量级单号生成工具类,基于JDK 17+,支持「前缀+日期+递增序列」格式(如`ORD20261013000001`),提供线程安全的单参/双参/三参方法,支持按天计数、自定义位数补零、指定日期补单,适用于订单、退款等需可读性与时序性的内部流水场景。(239字)

📋 目录

一、工具类功能

生成「前缀 + 日期(yyyyMMdd) + 递增序列」的短单号,例如 ORD20261005000001,比雪花 ID 短、比 UUID 可读,序列按天在进程内递增、入口方法加了同步。

二、所需环境

JDK 17或以上

三、方法与调用示例(按需调用)

🔢 方法序号:1

🎯 方法用途:

  • 按系统当天日期出「前缀 + yyyyMMdd + 6 位序列」的业务单号,比雪花 ID 短、比 UUID 可读
  • 内部订单号、退款号这类要看日期和先后顺序的场景用它

🧩 方法定义:public static synchronized String next(String prefix)

🗣️ 入参解释:public static synchronized String next(业务前缀)

📤 返回值解释:String,形如 ORD20261013000001 的单号

💡 边界口径:

  • 序列按天各自计数,某天在本进程首次取号从 1 开始
  • 同一天内所有前缀共用一个计数器,换前缀是跳号而不是重新计数
  • 序列不足 6 位左补零,涨过 6 位后按实际长度输出,不截断
  • 号段只存在内存里,进程重启后当天序列同样从 1 重新开始,只适合单实例、可接受重启重号的内部流水
  • 前缀原样拼接,不做长度与字符集校验,但空白前缀被拒绝

🧪 方法示例:

  • 本进程第一次 next("ORD") 拿到 ORD20261013000001
  • 紧接着再调一次拿到 ORD20261013000002,当天序列往上加
  • 换成 next("PAY") 拿到 PAY20261013000003,同一天所有前缀共用一个计数器
  • next(" ") 抛 业务前缀不能为空

🔢 方法序号:2

🎯 方法用途:

  • 同样按当天日期取号,补零位数由 seqLength 决定
  • 单号字段宽度有限、或者想让序列短一点时用这一版

🧩 方法定义:public static synchronized String next(String prefix, int seqLength)

🗣️ 入参解释:public static synchronized String next(业务前缀, 序列位数)

📤 返回值解释:String,前缀加日期再加指定位数的序列

💡 边界口径:

  • seqLength 只是补零目标,序列涨到比它长时按实际长度输出,不会截断成固定宽度
  • seqLength 给 1 时没有任何补零,直接是实际序列
  • seqLength 小于等于 0 抛 IllegalArgumentException,消息里带上实际值
  • 与单参版共用同一把类锁和同一份号段,两个入口之间也互相递增

🧪 方法示例:

  • next("REFUND", 3) 拿到 REFUND20261013004
  • next("SETTLE", 12) 拿到 SETTLE20261013000000000005,补到 12 位
  • next("MIN", 1) 拿到 MIN202610132,一位都不补
  • next("ORD", 0) 抛 序列位数必须大于0,当前为0
  • next("ORD", -3) 抛 序列位数必须大于0,当前为-3

🔢 方法序号:3

🎯 方法用途:

  • 指定业务日期取号,按历史日期补单、造测试数据时用
  • 时钟回拨或跨零点这类场景不想让号段错挂到另一天上,就用这个显式入口

🧩 方法定义:public static synchronized String next(String prefix, LocalDate date, int seqLength)

🗣️ 入参解释:public static synchronized String next(业务前缀, 业务日期, 序列位数)

📤 返回值解释:String,前缀加指定日期再加该天的序列

💡 边界口径:

  • 每一天有自己的序列,日期前进后那天首次取号从 1 开始
  • 再传回今天会接着当天的序列往上加,既不重发已发出的号,也不被回拨打乱
  • 号段只保留最近 7 天,更早的日期被回收后再取号会从 1 重新计
  • 取日期、读该天序列、写回在同一个临界区里完成,16000 次并发取号也不重号
  • date 传 null 抛 IllegalArgumentException

🧪 方法示例:

  • next("SHIP", today, 6) 拿到 SHIP20261013000006,接在当天序列后面
  • 日期前进一天首取拿到 SHIP20261014000001,那天从零开始
  • 再把日期传回今天拿到 SHIP20261013000007,当天已用过的号不会被重发
  • 8 个线程各取 2000 次去重后拿到 16000 条,没有重号
  • 序列涨到 16008 之后拿 2 位宽度也是 TRADE2026101316008,不截断
  • 连续补 10 天的单再回取最早那天,拿到 ARCH20261004000001,过期号段被回收后从 1 重计
  • next("ORD", null, 6) 抛 业务日期不能为null

四、工具类源码(可直接复制)

📦 源码文件

相关文章
|
20天前
|
Java
两个时间差多久?这个Java时间差值工具类2个方法搞定
这是一个基于Java 17+的高精度时间差计算工具类,支持`ChronoUnit`与`TimeUnit`双接口,严格区分日历语义(年/月/日)与时长语义(时/分/秒/纳秒),自动处理边界、溢出及空值异常,返回`long`型结果,开箱即用。
|
20天前
|
XML 定位技术 数据库
站点地图工程:百万级 URL 的生成、分片与结构校验
本文详解百万级Sitemap生成的工程实践:从协议限制作业分片、URL精准筛选、流式批处理,到XML转义、lastmod校准、多层校验与安全发布,兼顾准确性、稳定性与可维护性。
|
20天前
|
人工智能 弹性计算 双11
2026阿里云双十一大促产品福利,轻量、ECS、GPU、百炼 Token Plan 配置价格及特惠选购指南
阿里云双十一是每年面向新老客户集中放 阿里云轻量应用服务器、阿里云ECS云服务器、阿里云GPU云服务器、阿里云百炼大模型服务平台 券、放价的一次年度大促,2026年的主战场覆盖 阿里云轻量应用服务器、阿里云ECS云服务器、阿里云GPU云服务器、阿里云百炼大模型服务平台 等主力产品。今年的双十一以“智惠就在11.11,AI就用阿里云”为主题,活动周期持续至11月30日,延续了“先定负载、再选机型、最后在活动窗口内下单”的理性购物理念,优惠从单纯的“首年低价”升级为“新购、续费、升级全链路可核算”。
284 0
|
20天前
|
弹性计算 人工智能 小程序
最新阿里云服务器一年多少钱(轻量/ECS/GPU):一年、1个月与小时费用清单,计费拆解与选型指南
本文详解2026年阿里云三类服务器价格:轻量应用服务器(38元/年起,含带宽云盘)、ECS(99元/年起,按配置+带宽+云盘计费)、GPU实例(T4约1.55万元/年,A100达8万元/年),涵盖年付、月付、按量付费及附加成本对比,助您按场景选型省钱。
292 0
|
20天前
|
人工智能 API Apache
Qwen3.8抢先体验!大家要心理准备了,最新版发布并开源了?
2026年8月,阿里通义千问Qwen3.8系列全线开源,涵盖2.4万亿参数旗舰Max、27B轻量版、Flash高效模型及Flash-Next预览版。支持本地部署、多模态与长上下文,Apache 2.0(27B)与分层商用许可并行,标志国产大模型迈入“可下载、可部署、可商用”新阶段。(239字)
1056 0
|
14天前
|
人工智能 API Apache
Qwen3.8抢先体验!大家要心理准备了,最新版发布并开源了?
2026年11月,阿里通义千问Qwen3.8系列全面开源,涵盖2.4万亿参数旗舰版、27B多模态主力模型及高效Flash版本,支持本地部署与商用(部分需授权),标志国产大模型迈入“旗舰可下载、落地可执行”新阶段。(239字)
634 0
|
1月前
|
人工智能 自然语言处理 监控
阿里云百炼是什么?百炼AI模型平台支持哪些计费方式?免费Tokens领取、Token Plan及Coding Plan计费说明
阿里云百炼是面向企业与开发者的AI大模型一站式服务平台,支持通义千问、DeepSeek、Kimi等多模态模型。新用户可免费领取超7000万Tokens(每模型100万),并提供TokenPlan、CodingPlan等灵活订阅方案,助力高效、低成本使用AI能力。
|
1月前
|
监控 安全 网络安全
等保 2.0 到底是个啥?开发者版人话解读
等保 2.0 是标准版本号不是安全级别,很多人连这都搞混。本文用人话拆解等保定级备案五步流程、二级三级测评周期、云上责任共担最容易踩的坑,再给出测评机构最爱抠分的五个技术自查项:日志留存、弱口令、安全审计、边界防护、集中管控。测评前先模拟考,返工费能省一大笔。
330 2
|
2月前
|
Dubbo Java 应用服务中间件
Dubbo 还是 Spring Cloud?从架构本质到落地选型
本文深度对比Spring Cloud与Dubbo两大微服务治理体系:前者基于HTTP REST,强调跨语言兼容与灵活组装;后者依托强契约RPC,专注内网高性能调用。从连接模型、协议设计、序列化、线程模型到调用链路,六层拆解RPC高性能本质,提出“对外REST求兼容、对内RPC求性能”的企业级分层架构实践。(239字)
393 8
|
2月前
|
安全 API Python
JEV 玩贪吃蛇:每秒 3 步,模型到底判断了什么?
本文展示用JEV框架让模型玩贪吃蛇:每秒3步,将局面转为四向选择题,输出方向概率。本地Laya实现,不调远程API;程序预计算安全与路径特征,模型仅对标签化选项做判断。附JEV教学Skill供延伸实践。(239字)

热门文章

最新文章