From bb2ddfc34a2127f3f3bc1120b0d6b0a76fbd115d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E6=9D=A8=E9=BB=84=E6=9E=97?= Date: Wed, 30 Nov 2022 14:48:18 +0800 Subject: [PATCH] =?UTF-8?q?=E6=96=B0=E5=A2=9E=20=E6=A0=BC=E5=BC=8F?= =?UTF-8?q?=E5=8C=96=E6=97=B6=EF=BC=8C=E5=8F=AF=E4=BB=A5=E4=BC=A0=E5=85=A5?= =?UTF-8?q?=E5=B9=B4=E3=80=81=E6=9C=88=E3=80=81=E6=97=A5?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 92 ++++++++++++++----- pom.xml | 2 +- .../yanghuanglin/seq/generator/Generator.java | 20 ++++ .../generator/impl/SequencesGenerator.java | 14 ++- 4 files changed, 100 insertions(+), 28 deletions(-) diff --git a/README.md b/README.md index 60969b9..c6eb27f 100644 --- a/README.md +++ b/README.md @@ -8,7 +8,7 @@ 使用方法： -+ 在项目中放置jar包的地方把seq-1.7.2.jar、seq-1.7.2-sources.jar、seq-1.7.2-pom.xml复制过去 ++ 在项目中放置jar包的地方把seq-1.9.2.jar、seq-1.9.2-sources.jar、seq-1.9.2-pom.xml复制过去 + 在pom.xml中增加以下内容，然后执行maven命令：mvn clean ```xml @@ -18,7 +18,7 @@ com.yanghuanglin seq - 1.7.2 + 1.9.2 @@ -50,13 +50,13 @@ - ${project.basedir}/lib/seq-1.7.2.jar - ${project.basedir}/lib/seq-1.7.2-pom.xml - ${project.basedir}/lib/seq-1.7.2-sources.jar + ${project.basedir}/lib/seq-1.9.2.jar + ${project.basedir}/lib/seq-1.9.2-pom.xml + ${project.basedir}/lib/seq-1.9.2-sources.jar default com.yanghuanglin seq - 1.7.2 + 1.9.2 jar true @@ -304,6 +304,14 @@ import com.yanghuanglin.seq.po.SequencesUnused; import java.util.Date; public interface Generator { + /** + * 判断格式定义中是否有序号 + * + * @param pattern 格式 + * @return 是否包含序号 + */ + boolean containSeq(String pattern); + /** * 根据传入的key和type生成可用的序号对象。 *

@@ -312,9 +320,15 @@ public interface Generator { * 如果根据key和默认的{@link GeneratorConfig#getType()}在{@link Sequences}中找到了记录，且在{@link SequencesUnused}也找到了记录，说明该组合生成的序号有部分未使用，返回的是{@link SequencesUnused}中找到的seq最小的序号对象。同时会将{@link SequencesUnused}中找到的seq最小的记录删除，然后写入到{@link SequencesUnlock}中。 *

* - * @param key 数据字典中的编码 + * @param key 数据字典中的编码 + * @param withOutSeq 序号对象不包含序号，其值通过{@link #containSeq(String)}来判断 * @return 可用的序号对象 */ + Sequences generate(String key, Boolean withOutSeq); + + /** + * 同 {@link #generate(String, Boolean)}，第二个参数默认为false + */ Sequences generate(String key); /** @@ -325,26 +339,38 @@ public interface Generator { * 如果根据key和type在{@link Sequences}中找到了记录，且在{@link SequencesUnused}也找到了记录，说明该组合生成的序号有部分未使用，返回的是{@link SequencesUnused}中找到的seq最小的序号对象。同时会将{@link SequencesUnused}中找到的seq最小的记录删除，然后写入到{@link SequencesUnlock}中。 *

* - * @param key 数据字典中的编码 - * @param type 序号类型 + * @param key 数据字典中的编码 + * @param type 序号类型 + * @param withOutSeq 序号对象不包含序号，其值通过{@link #containSeq(String)}来判断 * @return 可用的序号对象 */ + Sequences generate(String key, String type, Boolean withOutSeq); + + /** + * 同{@link #generate(String, String, Boolean)}，第三个参数默认为false + */ Sequences generate(String key, String type); /** - * 返回根据{@link #generate(String, String)}得到的序号对象，补零后的序号字符串 + * 返回根据{@link #generate(String, String, Boolean)}得到的序号对象，补零后的序号字符串 *

* 如生成的为3，而minLength为5，则返回的是00003 * - * @param key 数据字典中的编码 - * @param type 序号类型 - * @param minLength 序号数字最小长度 + * @param key 数据字典中的编码 + * @param type 序号类型 + * @param minLength 序号数字最小长度 + * @param withOutSeq 序号对象不包含序号，其值通过{@link #containSeq(String)}来判断 * @return 补零后的字符串 */ + String generate(String key, String type, Integer minLength, Boolean withOutSeq); + + /** + * 同{@link #generate(String, String, Integer, Boolean)}，第四个参数默认为false + */ String generate(String key, String type, Integer minLength); /** - * 将{@link #generate(String, String)}得到的序号对象格式化为补零后的序号字符串，其最小长度通过{@link BaseConfig#getMinLength()}设定。实际上只会用到{@link Sequences#getSeq()}属性 + * 将{@link #generate(String, String, Boolean)}得到的序号对象格式化为补零后的序号字符串，其最小长度通过{@link BaseConfig#getMinLength()}设定。实际上只会用到{@link Sequences#getSeq()}属性 *

* pattern支持：{@link FormatPlaceholder#YEAR}(当前年份)、{@link FormatPlaceholder#MONTH}}(当前月份)、{@link FormatPlaceholder#DAY}}(当前日期)、{@link FormatPlaceholder#SEQ}}(生成的字符串序号)几个枚举值通过{@link FormatPlaceholder#getPlaceholder()}得到的字符串 * @@ -355,7 +381,7 @@ public interface Generator { String format(Sequences sequences, String pattern); /** - * 将{@link #generate(String, String)}得到的序号对象格式化为补零后的序号字符串。实际上只会用到{@link Sequences#getSeq()}属性 + * 将{@link #generate(String, String, Boolean)}得到的序号对象格式化为补零后的序号字符串。实际上只会用到{@link Sequences#getSeq()}属性 *

* pattern支持：{@link FormatPlaceholder#YEAR}(当前年份)、{@link FormatPlaceholder#MONTH}}(当前月份)、{@link FormatPlaceholder#DAY}}(当前日期)、{@link FormatPlaceholder#SEQ}}(生成的字符串序号)几个枚举值通过{@link FormatPlaceholder#getPlaceholder()}得到的字符串 * @@ -430,6 +456,26 @@ public interface Generator { */ String format(Long seq, String start, Integer minLength, String pattern); + /** + * 将生成的序号对象格式化为指定格式 + *

+ * pattern支持：{@link FormatPlaceholder#YEAR}(当前年份)、{@link FormatPlaceholder#MONTH}}(当前月份)、{@link FormatPlaceholder#DAY}}(当前日期)、{@link FormatPlaceholder#SEQ}}(生成的字符串序号)几个枚举值通过{@link FormatPlaceholder#getPlaceholder()}得到的字符串 + *

+ * seq为1,start为6，minLength为4，pattern为#year##month##day##seq#，则会格式化为2022013060001。此序号含义如下： + *

+ * 序号格式：[年][月][日][固定6开头][序号1，最小位数为4位，不足4位则补零] + * + * @param seq 需要格式化的序号 + * @param start 序号格式化后以什么字符串开头 + * @param minLength 序号最小长度，不足的会补零 + * @param pattern 序号格式 + * @param year 格式化时使用的年 + * @param month 格式化时使用的月 + * @param day 格式化时使用的日 + * @return 格式化后的序号字符串 + */ + String format(Long seq, String start, Integer minLength, String pattern, Integer year, Integer month, Integer day); + /** * 将已格式化的序号解析为序号对象 *

@@ -452,7 +498,7 @@ public interface Generator { /** * 锁定指定序号，在序号生成后，调用该序号的逻辑完成后需要执行此方法 *

- * 如办理案件时，先调用{@link #generate(String, String)}或者{@link #generate(String, String, Integer)}生成了序号，之后对案件进行了入库，如果入库完毕，则将该序号锁定，说明这个序号已被使用 + * 如办理案件时，先调用{@link #generate(String, String, Boolean)}或者{@link #generate(String, String, Integer, Boolean)}生成了序号，之后对案件进行了入库，如果入库完毕，则将该序号锁定，说明这个序号已被使用 *

* 注意，此处的锁定非数据库中锁定，而是{@link SequencesUnused}和{@link SequencesUnlock}中均不存在key、type、seq相同的记录视为锁定。因此此处实际是把这两个表中的记录均删除了 * @@ -477,7 +523,7 @@ public interface Generator { *

* {@link SequencesUnlock}中未通过{@link #lock(Sequences)}方法锁定的序号会一直存在，调用此方法会将里面的所有序号都移动到{@link SequencesUnused}中，下次生成序号时优先从{@link SequencesUnused}获取。 */ - void release(); + boolean release(); /** * 释放指定时间段内未使用的序号 @@ -487,7 +533,7 @@ public interface Generator { * @param begin 开始时间 * @param end 结束时间 */ - void release(Date begin, Date end); + boolean release(Date begin, Date end); /** * 释放从开始时间开始，到现在时间之间未使用的序号。结束时间为方法执行时的时间 @@ -508,7 +554,7 @@ public interface Generator { * * @param sequences 需要释放的序号。一般是一个通过{@link Sequences#setKey(String)}、{@link Sequences#setType(String)}、{@link Sequences#setSeq(Long)}三方法一起手动构建或通过{@link Sequences#Sequences(String, String, Long)}构造方法构建的实例对象 */ - void release(Sequences sequences); + boolean release(Sequences sequences); /** * 忽略{@link Sequences#getSeq()}来释放指定序号。一般用于业务对象删除后，对应序号需要回收使用时。 @@ -518,17 +564,17 @@ public interface Generator { * @param sequences 需要释放的序号。一般是一个通过{@link Sequences#setKey(String)}、{@link Sequences#setType(String)}、{@link Sequences#setSeq(Long)}三方法一起手动构建或通过{@link Sequences#Sequences(String, String, Long)}构造方法构建的实例对象 * @param ignoreSeq 是否忽略序号 */ - void release(Sequences sequences, boolean ignoreSeq); + boolean release(Sequences sequences, boolean ignoreSeq); /** * 清空所有闲置序号和未锁定序号 */ - void clear(); + boolean clear(); /** * 清空指定时间段内闲置序号和未锁定序号 */ - void clear(Date begin, Date end); + boolean clear(Date begin, Date end); /** * 清空从开始时间到限制时间之间闲置序号和未锁定序号，结束时间为方法执行时的时间 @@ -544,6 +590,4 @@ public interface Generator { */ void clearBefore(Date end); } - - ``` \ No newline at end of file diff --git a/pom.xml b/pom.xml index 3dd4899..c968a3c 100644 --- a/pom.xml +++ b/pom.xml @@ -4,7 +4,7 @@ 4.0.0 com.yanghuanglin seq - 1.8.2 + 1.9.2 seq seq diff --git a/src/main/java/com/yanghuanglin/seq/generator/Generator.java b/src/main/java/com/yanghuanglin/seq/generator/Generator.java index d4c9887..0f5bf53 100644 --- a/src/main/java/com/yanghuanglin/seq/generator/Generator.java +++ b/src/main/java/com/yanghuanglin/seq/generator/Generator.java @@ -162,6 +162,26 @@ public interface Generator { */ String format(Long seq, String start, Integer minLength, String pattern); + /** + * 将生成的序号对象格式化为指定格式 + *

+ * pattern支持：{@link FormatPlaceholder#YEAR}(当前年份)、{@link FormatPlaceholder#MONTH}}(当前月份)、{@link FormatPlaceholder#DAY}}(当前日期)、{@link FormatPlaceholder#SEQ}}(生成的字符串序号)几个枚举值通过{@link FormatPlaceholder#getPlaceholder()}得到的字符串 + *

+ * seq为1,start为6，minLength为4，pattern为#year##month##day##seq#，则会格式化为2022013060001。此序号含义如下： + *

+ * 序号格式：[年][月][日][固定6开头][序号1，最小位数为4位，不足4位则补零] + * + * @param seq 需要格式化的序号 + * @param start 序号格式化后以什么字符串开头 + * @param minLength 序号最小长度，不足的会补零 + * @param pattern 序号格式 + * @param year 格式化时使用的年 + * @param month 格式化时使用的月 + * @param day 格式化时使用的日 + * @return 格式化后的序号字符串 + */ + String format(Long seq, String start, Integer minLength, String pattern, Integer year, Integer month, Integer day); + /** * 将已格式化的序号解析为序号对象 *

diff --git a/src/main/java/com/yanghuanglin/seq/generator/impl/SequencesGenerator.java b/src/main/java/com/yanghuanglin/seq/generator/impl/SequencesGenerator.java index b0c7004..b843613 100644 --- a/src/main/java/com/yanghuanglin/seq/generator/impl/SequencesGenerator.java +++ b/src/main/java/com/yanghuanglin/seq/generator/impl/SequencesGenerator.java @@ -176,13 +176,21 @@ public class SequencesGenerator implements Generator { @Override public String format(Long seq, String start, Integer minLength, String pattern) { + return format(seq, start, minLength, pattern, null, null, null); + } + + @Override + public String format(Long seq, String start, Integer minLength, String pattern, Integer year, Integer month, Integer day) { if (start == null) start = ""; String seqString = start + new Sequences(seq).format(minLength); Calendar calendar = Calendar.getInstance(); - int year = calendar.get(Calendar.YEAR); - int month = calendar.get(Calendar.MONTH) + 1; - int day = calendar.get(Calendar.DAY_OF_MONTH); + if (year == null) + year = calendar.get(Calendar.YEAR); + if (month == null) + month = calendar.get(Calendar.MONTH) + 1; + if (day == null) + day = calendar.get(Calendar.DAY_OF_MONTH); pattern = pattern.replaceAll(YEAR.getPlaceholder(), String.valueOf(year)); pattern = pattern.replaceAll(MONTH.getPlaceholder(), monthZeroFilling ? String.format("%02d", month) : String.valueOf(month)); pattern = pattern.replaceAll(DAY.getPlaceholder(), dayZeroFilling ? String.format("%02d", day) : String.valueOf(day));