fix: 业务编号追加随机位并加唯一约束
This commit is contained in:
@@ -2,36 +2,51 @@ package com.guo.learningprogresstracker.utils;
|
||||
|
||||
import lombok.RequiredArgsConstructor;
|
||||
|
||||
import java.security.SecureRandom;
|
||||
import java.text.SimpleDateFormat;
|
||||
import java.util.Date;
|
||||
|
||||
/**
|
||||
* 用于生成编码的工具
|
||||
* <p>编码格式:{@code PREFIX-yyyyMMdd-<6 位毫秒片段><6 位随机数>}。</p>
|
||||
* <p>此前只用「毫秒时间戳对 1_000_000 取模」的 6 位片段,同一毫秒内会生成完全相同的编码,
|
||||
* 且该片段每 16.7 分钟就会重复一轮;现在追加 6 位随机数把撞号概率降到 1e-6 量级,
|
||||
* 最终防线是数据库唯一索引(见迁移 {@code V20261009_3})。</p>
|
||||
*/
|
||||
@RequiredArgsConstructor
|
||||
public class GenerateNumTool {
|
||||
private static int getNextSequence() {
|
||||
long timestamp = System.currentTimeMillis();
|
||||
return (int) (timestamp % 1_000_000);
|
||||
|
||||
/** 毫秒片段取值范围:保持既有编码的可读形态 */
|
||||
private static final int MILLIS_SEQUENCE_BOUND = 1_000_000;
|
||||
|
||||
/** 随机位取值范围:6 位 */
|
||||
private static final int RANDOM_BOUND = 1_000_000;
|
||||
|
||||
private static final SecureRandom RANDOM = new SecureRandom();
|
||||
|
||||
private static long getNextSequence() {
|
||||
return System.currentTimeMillis() % MILLIS_SEQUENCE_BOUND;
|
||||
}
|
||||
|
||||
/**
|
||||
* 生成以prefix开头separator分割的编码
|
||||
* 例如:PREFIX—20240711-423468
|
||||
* @param prefix
|
||||
* @param separator
|
||||
* @return
|
||||
* 生成以 prefix 开头、separator 分割的编码
|
||||
* 例如:PREFIX-20240711-423468123905
|
||||
*/
|
||||
public static String generateNum(String prefix, String separator) {
|
||||
String currentDate = new SimpleDateFormat("yyyyMMdd").format(new Date());
|
||||
int sequence = getNextSequence();
|
||||
return prefix + separator + currentDate + separator + sequence;
|
||||
return prefix + separator + currentDate + separator + randomSuffix();
|
||||
}
|
||||
|
||||
public static String generateNum(String prefix) {
|
||||
String separator = "-";
|
||||
String currentDate = new SimpleDateFormat("yyyyMMdd").format(new Date());
|
||||
int sequence = getNextSequence();
|
||||
return prefix + separator + currentDate + separator + sequence;
|
||||
return generateNum(prefix, "-");
|
||||
}
|
||||
|
||||
/**
|
||||
* 编码后缀:6 位毫秒片段 + 6 位随机数,固定 12 位,便于阅读与排序。
|
||||
*/
|
||||
private static String randomSuffix() {
|
||||
long sequence = getNextSequence();
|
||||
int random = RANDOM.nextInt(RANDOM_BOUND);
|
||||
return String.format("%06d%06d", sequence, random);
|
||||
}
|
||||
}
|
||||
|
||||
@@ -0,0 +1,12 @@
|
||||
-- 业务编号唯一约束(数据-03)。
|
||||
-- 编号生成已改为「6 位毫秒片段 + 6 位随机数」(GenerateNumTool),唯一索引是最终防线:
|
||||
-- 撞号时按编号取单条记录会抛多行异常,属于数据正确性问题。
|
||||
-- 说明:索引以 created_by 打头(多租户,编号只需在租户内唯一)。
|
||||
-- 注意:若历史数据中已存在重复编号,本迁移会失败 —— 这是有意为之:需要人工确认后再处理,
|
||||
-- 而不是静默跳过约束。
|
||||
|
||||
ALTER TABLE tasks
|
||||
ADD CONSTRAINT uk_tasks_created_by_task_num UNIQUE (created_by, task_num);
|
||||
|
||||
ALTER TABLE study_sessions
|
||||
ADD CONSTRAINT uk_study_sessions_created_by_session_num UNIQUE (created_by, session_num);
|
||||
@@ -4,7 +4,10 @@ import org.junit.jupiter.api.Test;
|
||||
|
||||
import java.time.LocalDate;
|
||||
import java.time.format.DateTimeFormatter;
|
||||
import java.util.HashSet;
|
||||
import java.util.Set;
|
||||
|
||||
import static org.junit.jupiter.api.Assertions.assertEquals;
|
||||
import static org.junit.jupiter.api.Assertions.assertTrue;
|
||||
|
||||
class GenerateNumToolTest {
|
||||
@@ -14,14 +17,23 @@ class GenerateNumToolTest {
|
||||
String today = LocalDate.now().format(DateTimeFormatter.BASIC_ISO_DATE);
|
||||
String code = GenerateNumTool.generateNum("ORD");
|
||||
assertTrue(code.startsWith("ORD-" + today + "-"), "实际值: " + code);
|
||||
// 序列为毫秒时间戳对 1_000_000 取模,最多 6 位数字
|
||||
assertTrue(code.matches("ORD-" + today + "-\\d{1,6}"), "实际值: " + code);
|
||||
// 后缀 = 6 位毫秒片段 + 6 位随机数
|
||||
assertTrue(code.matches("ORD-" + today + "-\\d{12}"), "实际值: " + code);
|
||||
}
|
||||
|
||||
@Test
|
||||
void generateNum_customSeparator_prefixDateSequence() {
|
||||
String today = LocalDate.now().format(DateTimeFormatter.BASIC_ISO_DATE);
|
||||
String code = GenerateNumTool.generateNum("BIZ", "_");
|
||||
assertTrue(code.matches("BIZ_" + today + "_\\d{1,6}"), "实际值: " + code);
|
||||
assertTrue(code.matches("BIZ_" + today + "_\\d{12}"), "实际值: " + code);
|
||||
}
|
||||
|
||||
@Test
|
||||
void generateNum_burstGeneration_shouldNotCollide() {
|
||||
Set<String> codes = new HashSet<>();
|
||||
for (int i = 0; i < 300; i++) {
|
||||
codes.add(GenerateNumTool.generateNum("TASK"));
|
||||
}
|
||||
assertEquals(300, codes.size(), "连续快速生成不应撞号(数据-03)");
|
||||
}
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user