refactor!: 重构正则表达式相关代码

- 将正则相关根据移至 regex 包下 - 新增 PatternInfos 记录不同 pattern 的信息 - 新增 Chinese2ndIdCardNumberMatcher 和 LocalDateMatcher 作为日期和二代居民身份证的匹配结果，方便从中获取对应的 group
refactor!: 将 ParsingFailureException 改为受检异常
2025-07-22 14:58:29 +08:00 · 2025-07-22 14:58:04 +08:00 · 2025-07-22 14:58:00 +08:00 · 2025-07-22 14:57:34 +08:00
19 changed files with 1068 additions and 414 deletions
--- a/plusone-commons/pom.xml
+++ b/plusone-commons/pom.xml
@@ -28,7 +28,7 @@
            <dependency>
                <groupId>xyz.zhouxy.plusone</groupId>
                <artifactId>plusone-dependencies</artifactId>
-                <version>1.1.0-RC1</version>
+                <version>${project.version}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/exception/ParsingFailureException.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/exception/ParsingFailureException.java
@@ -38,7 +38,7 @@ import xyz.zhouxy.plusone.commons.exception.MultiTypesException.ExceptionType;
 * @since 1.0.0
 */
 public final class ParsingFailureException
-        extends RuntimeException
+        extends Exception
        implements MultiTypesException<ParsingFailureException, ParsingFailureException.Type> {
    private static final long serialVersionUID = 795996090625132616L;

--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/model/Chinese2ndGenIDCardNumber.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/model/Chinese2ndGenIDCardNumber.java
@@ -33,7 +33,7 @@ import com.google.errorprone.annotations.Immutable;

 import xyz.zhouxy.plusone.commons.annotation.ReaderMethod;
 import xyz.zhouxy.plusone.commons.annotation.ValueObject;
-import xyz.zhouxy.plusone.commons.constant.PatternConsts;
+import xyz.zhouxy.plusone.commons.regex.PatternConsts;
 import xyz.zhouxy.plusone.commons.util.StringTools;

 /**
@@ -44,7 +44,7 @@ import xyz.zhouxy.plusone.commons.util.StringTools;
 *
 * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
 * @since 1.0.0
- * @see xyz.zhouxy.plusone.commons.constant.PatternConsts#CHINESE_2ND_ID_CARD_NUMBER
+ * @see xyz.zhouxy.plusone.commons.regex.PatternConsts#CHINESE_2ND_ID_CARD_NUMBER
 */
@ValueObject
@Immutable
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/regex/AbstractMatcher.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/regex/AbstractMatcher.java
@@ -0,0 +1,38 @@
+/*
+ * Copyright 2025 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package xyz.zhouxy.plusone.commons.regex;
+
+import java.util.regex.Matcher;
+
+public abstract class AbstractMatcher {
+    private final Matcher matcher;
+
+    AbstractMatcher(Matcher matcher) {
+        this.matcher = matcher;
+    }
+
+    public final Matcher matcher() {
+        return this.matcher;
+    }
+
+    public final boolean matches() {
+        return this.matcher.matches();
+    }
+
+    public final String getGroupValue(String groupName) {
+        return this.matcher.group(groupName);
+    }
+}
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/regex/Chinese2ndIdCardNumberMatcher.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/regex/Chinese2ndIdCardNumberMatcher.java
@@ -0,0 +1,60 @@
+/*
+ * Copyright 2025 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package xyz.zhouxy.plusone.commons.regex;
+
+import java.util.regex.Matcher;
+
+import xyz.zhouxy.plusone.commons.model.Gender;
+
+public final class Chinese2ndIdCardNumberMatcher extends AbstractMatcher {
+
+    Chinese2ndIdCardNumberMatcher(Matcher matcher) {
+        super(matcher);
+    }
+
+    public final String getProvince() {
+        return getGroupValue("province");
+    }
+
+    public final String getCity() {
+        return getGroupValue("city");
+    }
+
+    public final String getCounty() {
+        return getGroupValue("county");
+    }
+
+    public final String getBirthDate() {
+        return getGroupValue("birthDate");
+    }
+
+    public final String getOrderCode() {
+        return getGroupValue("orderCode");
+    }
+
+    public final String getGenderCode() {
+        return getGroupValue("gender");
+    }
+
+    public final Gender getGender() {
+        final int genderCode = Integer.parseInt(getGenderCode());
+        return genderCode % 2 == 0 ? Gender.FEMALE : Gender.MALE;
+    }
+
+    public final String getCheckDigit() {
+        return getGroupValue("checkDigit");
+    }
+}
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/regex/LocalDateMatcher.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/regex/LocalDateMatcher.java
@@ -0,0 +1,37 @@
+/*
+ * Copyright 2025 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package xyz.zhouxy.plusone.commons.regex;
+
+import java.util.regex.Matcher;
+
+public final class LocalDateMatcher extends AbstractMatcher {
+
+    LocalDateMatcher(Matcher matcher) {
+        super(matcher);
+    }
+
+    public String getYear() {
+        return getGroupValue("yyyy");
+    }
+
+    public String getMonth() {
+        return getGroupValue("MM");
+    }
+
+    public String getDay() {
+        return getGroupValue("dd");
+    }
+}
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/constant/PatternConsts.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/constant/PatternConsts.java
@@ -14,7 +14,7 @@
 * limitations under the License.
 */

-package xyz.zhouxy.plusone.commons.constant;
+package xyz.zhouxy.plusone.commons.regex;

 import java.util.regex.Pattern;

--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/regex/PatternInfo.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/regex/PatternInfo.java
@@ -0,0 +1,38 @@
+/*
+ * Copyright 2025 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package xyz.zhouxy.plusone.commons.regex;
+
+import java.util.regex.Pattern;
+
+public abstract class PatternInfo<T> {
+    private final String regex;
+    private final Pattern pattern;
+
+    PatternInfo(String regex, Pattern pattern) {
+        this.regex = regex;
+        this.pattern = pattern;
+    }
+
+    public final String regex() {
+        return this.regex;
+    }
+
+    public final Pattern pattern() {
+        return this.pattern;
+    }
+
+    public abstract T matcher(String input);
+}
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/regex/PatternInfos.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/regex/PatternInfos.java
@@ -0,0 +1,114 @@
+/*
+ * Copyright 2025 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package xyz.zhouxy.plusone.commons.regex;
+
+import java.util.regex.Matcher;
+
+public final class PatternInfos {
+
+    // @see RegexConsts#BASIC_ISO_DATE
+    public static final PatternInfo<LocalDateMatcher> BASIC_ISO_DATE = new PatternInfo<LocalDateMatcher>(
+            RegexConsts.BASIC_ISO_DATE,
+            PatternConsts.BASIC_ISO_DATE) {
+        @Override
+        public LocalDateMatcher matcher(String input) {
+            Matcher matcher = pattern().matcher(input);
+            return new LocalDateMatcher(matcher);
+        }
+    };
+
+    // @see RegexConsts#ISO_LOCAL_DATE
+    public static final PatternInfo<LocalDateMatcher> ISO_LOCAL_DATE = new PatternInfo<LocalDateMatcher>(
+            RegexConsts.ISO_LOCAL_DATE,
+            PatternConsts.ISO_LOCAL_DATE) {
+        @Override
+        public LocalDateMatcher matcher(String input) {
+            Matcher matcher = pattern().matcher(input);
+            return new LocalDateMatcher(matcher);
+        }
+    };
+
+    // @see RegexConsts#PASSWORD
+    public static final PatternInfo<Matcher> PASSWORD = new PatternInfo<Matcher>(
+            RegexConsts.PASSWORD,
+            PatternConsts.PASSWORD) {
+        @Override
+        public Matcher matcher(String input) {
+            return pattern().matcher(input);
+        }
+    };
+
+    // @see RegexConsts#CAPTCHA
+    public static final PatternInfo<Matcher> CAPTCHA = new PatternInfo<Matcher>(
+            RegexConsts.CAPTCHA,
+            PatternConsts.CAPTCHA) {
+        @Override
+        public Matcher matcher(String input) {
+            return pattern().matcher(input);
+        }
+    };
+
+    // @see RegexConsts#EMAIL
+    public static final PatternInfo<Matcher> EMAIL = new PatternInfo<Matcher>(
+            RegexConsts.EMAIL,
+            PatternConsts.EMAIL) {
+        @Override
+        public Matcher matcher(String input) {
+            return pattern().matcher(input);
+        }
+    };
+
+    public static final PatternInfo<Matcher> MOBILE_PHONE = new PatternInfo<Matcher>(
+            RegexConsts.MOBILE_PHONE,
+            PatternConsts.MOBILE_PHONE) {
+        @Override
+        public Matcher matcher(String input) {
+            return pattern().matcher(input);
+        }
+    };
+
+    public static final PatternInfo<Matcher> USERNAME = new PatternInfo<Matcher>(
+            RegexConsts.USERNAME,
+            PatternConsts.USERNAME) {
+        @Override
+        public Matcher matcher(String input) {
+            return pattern().matcher(input);
+        }
+    };
+
+    public static final PatternInfo<Matcher> NICKNAME = new PatternInfo<Matcher>(
+            RegexConsts.NICKNAME,
+            PatternConsts.NICKNAME) {
+        @Override
+        public Matcher matcher(String input) {
+            return pattern().matcher(input);
+        }
+    };
+
+    public static final PatternInfo<Chinese2ndIdCardNumberMatcher> CHINESE_2ND_ID_CARD_NUMBER = new PatternInfo<Chinese2ndIdCardNumberMatcher>(
+            RegexConsts.CHINESE_2ND_ID_CARD_NUMBER,
+            PatternConsts.CHINESE_2ND_ID_CARD_NUMBER) {
+        @Override
+        public Chinese2ndIdCardNumberMatcher matcher(String input) {
+            Matcher matcher = pattern().matcher(input);
+            return new Chinese2ndIdCardNumberMatcher(matcher);
+        }
+    };
+
+    private PatternInfos() {
+        throw new IllegalStateException("Utility class");
+    }
+}
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/constant/RegexConsts.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/constant/RegexConsts.java
@@ -14,7 +14,7 @@
 * limitations under the License.
 */

-package xyz.zhouxy.plusone.commons.constant;
+package xyz.zhouxy.plusone.commons.regex;

 /**
 * 正则表达式常量
@@ -41,12 +41,15 @@ public final class RegexConsts {

    public static final String MOBILE_PHONE = "^(13[0-9]|14[01456879]|15[0-35-9]|16[2567]|17[0-8]|18[0-9]|19[0-35-9])\\d{8}$";

-    public static final String USERNAME = "^[\\w-_.@]{4,36}$";
+    public static final String USERNAME = "^[\\w-_]{4,36}$";

    public static final String NICKNAME = "^[\\w-_.@]{4,36}$";

    public static final String CHINESE_2ND_ID_CARD_NUMBER
-            = "^(?<county>(?<city>(?<province>\\d{2})\\d{2})\\d{2})(?<birthDate>\\d{8})\\d{2}(?<gender>\\d)([\\dX])$";
+            = "^(?<county>(?<city>(?<province>\\d{2})\\d{2})\\d{2})"
+            + "(?<birthDate>\\d{8})"
+            + "(?<orderCode>\\d{2}(?<gender>\\d))"
+            + "(?<checkDigit>[\\dX])$";

    private RegexConsts() {
        throw new IllegalStateException("Utility class");
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/constant/package-info.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/constant/package-info.java
@@ -14,16 +14,4 @@
 * limitations under the License.
 */

-/**
- * <h2>常量</h2>
- *
- * <h3>
- * 1. 正则常量
- * </h3>
- * {@link RegexConsts} 包含常见正则表达式；{@link PatternConsts} 包含对应的 {@link Pattern} 对象。
- *
- * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
- */
-package xyz.zhouxy.plusone.commons.constant;
-
-import java.util.regex.Pattern;
+package xyz.zhouxy.plusone.commons.regex;
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/util/DateTimeTools.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/util/DateTimeTools.java
@@ -374,258 +374,6 @@ public class DateTimeTools {
    // #endregion
    // ================================

-    // ================================
-    // #region - toJodaInstant
-    // ================================
-
-    /**
-     * 将 {@link java.time.Instant} 转换为 {@link org.joda.time.Instant}
-     *
-     * @param instant {@link java.time.Instant} 对象
-     * @return {@link org.joda.time.Instant} 对象
-     */
-    public static org.joda.time.Instant toJodaInstant(java.time.Instant instant) {
-        return new org.joda.time.Instant(instant.toEpochMilli());
-    }
-
-    /**
-     * 将 {@link java.time.ZonedDateTime} 转换为 {@link org.joda.time.Instant}
-     *
-     * @param zonedDateTime {@link java.time.ZonedDateTime} 对象
-     * @return {@link org.joda.time.Instant} 对象
-     */
-    public static org.joda.time.Instant toJodaInstant(java.time.ZonedDateTime zonedDateTime) {
-        return toJodaInstant(zonedDateTime.toInstant());
-    }
-
-    /**
-     * 计算指定时区的地区时间，对应的时间戳。结果为 {@link org.joda.time.Instant} 对象
-     *
-     * @param localDateTime {@link java.time.LocalDateTime} 对象
-     * @param zone          时区
-     * @return {@link org.joda.time.Instant} 对象
-     */
-    public static org.joda.time.Instant toJodaInstant(java.time.LocalDateTime localDateTime, java.time.ZoneId zone) {
-        return toJodaInstant(java.time.ZonedDateTime.of(localDateTime, zone));
-    }
-
-    // ================================
-    // #endregion
-    // ================================
-
-    // ================================
-    // #region - toJavaInstant
-    // ================================
-
-    /**
-     * 将 {@link org.joda.time.Instant} 对象转换为 {@link java.time.Instant} 对象
-     *
-     * @param instant {@link org.joda.time.Instant} 对象
-     * @return {@link java.time.Instant} 对象
-     */
-    public static java.time.Instant toJavaInstant(org.joda.time.Instant instant) {
-        return toInstant(instant.getMillis());
-    }
-
-    /**
-     * 将 joda-time 中的 {@link org.joda.time.DateTime} 对象转换为 Java 的
-     * {@link java.time.Instant} 对象
-     *
-     * @param dateTime joda-time 中表示日期时间的 {@link org.joda.time.DateTime} 对象
-     * @return Java 表示时间戳的 {@link java.time.Instant} 对象
-     */
-    public static java.time.Instant toJavaInstant(org.joda.time.DateTime dateTime) {
-        return toInstant(dateTime.getMillis());
-    }
-
-    /**
-     * 将 joda-time 中的 {@link org.joda.time.LocalDateTime} 对象和
-     * {@link org.joda.time.DateTimeZone} 对象
-     * 转换为 Java 中的 {@link java.time.Instant} 对象
-     *
-     * @param localDateTime
-     * @param zone
-     * @return
-     */
-    public static java.time.Instant toJavaInstant(
-            org.joda.time.LocalDateTime localDateTime,
-            org.joda.time.DateTimeZone zone) {
-        return toJavaInstant(localDateTime.toDateTime(zone));
-    }
-
-    // ================================
-    // #endregion
-    // ================================
-
-    // ================================
-    // #region - toJodaDateTime
-    // ================================
-
-    /**
-     * 将 Java 中表示日期时间的 {@link java.time.ZonedDateTime} 对象
-     * 转换为 joda-time 的 {@link org.joda.time.DateTime} 对象
-     *
-     * @param zonedDateTime 日期时间
-     * @return joda-time 中对应的 {@link org.joda.time.DateTime} 对象
-     */
-    public static org.joda.time.DateTime toJodaDateTime(java.time.ZonedDateTime zonedDateTime) {
-        org.joda.time.DateTimeZone zone = org.joda.time.DateTimeZone.forID(zonedDateTime.getZone().getId());
-        return toJodaInstant(zonedDateTime.toInstant()).toDateTime(zone);
-    }
-
-    /**
-     * 将 java.time 中表示日期时间的 {@link java.time.LocalDateTime} 对象和表示时区的
-     * {@link java.time.ZoneId} 对象转换为 joda-time 中对应的 {@link org.joda.time.DateTime}
-     * 对象
-     * 转换为 joda-time 中对应的 {@link org.joda.time.DateTime} 对象
-     *
-     * @param localDateTime 日期时间
-     * @param zone          时区
-     * @return joda-time 中对应的 {@link org.joda.time.DateTime} 对象
-     */
-    public static org.joda.time.DateTime toJodaDateTime(
-            java.time.LocalDateTime localDateTime,
-            java.time.ZoneId zone) {
-        org.joda.time.DateTimeZone dateTimeZone = toJodaZone(zone);
-        return toJodaInstant(ZonedDateTime.of(localDateTime, zone).toInstant()).toDateTime(dateTimeZone);
-    }
-
-    /**
-     * 计算时间戳在指定时区对应的时间，结果使用 {@link org.joda.time.DateTime} 表示
-     *
-     * @param instant java.time 中的时间戳
-     * @param zone    java.time 中的时区
-     * @return joda-time 中带时区的日期时间
-     */
-    public static org.joda.time.DateTime toJodaDateTime(
-            java.time.Instant instant,
-            java.time.ZoneId zone) {
-        org.joda.time.DateTimeZone dateTimeZone = toJodaZone(zone);
-        return toJodaInstant(instant).toDateTime(dateTimeZone);
-    }
-
-    // ================================
-    // #endregion
-    // ================================
-
-    // ================================
-    // #region - toZonedDateTime
-    // ================================
-
-    /**
-     * 将 joda-time 中带时区的日期时间，转换为 java.time 中带时区的日期时间
-     *
-     * @param dateTime joda-time 中带时区的日期时间
-     * @return java.time 中带时区的日期时间
-     */
-    public static java.time.ZonedDateTime toZonedDateTime(org.joda.time.DateTime dateTime) {
-        java.time.ZoneId zone = dateTime.getZone().toTimeZone().toZoneId();
-        return toJavaInstant(dateTime.toInstant()).atZone(zone);
-    }
-
-    /**
-     * 将 joda-time 中的 {@link org.joda.time.LocalDateTime} 和
-     * {@link org.joda.time.DateTimeZone}
-     * 转换为 java.time 中的 {@link java.time.ZonedDateTime}
-     *
-     * @param localDateTime joda-time 中的地区时间
-     * @param dateTimeZone  joda-time 中的时区
-     * @return java.time 中带时区的日期时间
-     */
-    public static java.time.ZonedDateTime toZonedDateTime(
-            org.joda.time.LocalDateTime localDateTime,
-            org.joda.time.DateTimeZone dateTimeZone) {
-        java.time.ZoneId zone = toJavaZone(dateTimeZone);
-        return toJavaInstant(localDateTime, dateTimeZone).atZone(zone);
-    }
-
-    /**
-     * 获取 joda-time 中的 {@link org.joda.time.Instant} 在指定时区的时间，用 Java 8+ 的
-     * {@link java.time.ZonedDateTime} 表示
-     *
-     * @param instant      joda-time 中的时间戳
-     * @param dateTimeZone joda-time 中的时区
-     * @return
-     */
-    public static java.time.ZonedDateTime toZonedDateTime(
-            org.joda.time.Instant instant,
-            org.joda.time.DateTimeZone dateTimeZone) {
-        java.time.ZoneId zone = toJavaZone(dateTimeZone);
-        return toJavaInstant(instant).atZone(zone);
-    }
-
-    // ================================
-    // #endregion
-    // ================================
-
-    // ================================
-    // #region - toJodaLocalDateTime
-    // ================================
-
-    /**
-     * 将 {@link java.time.LocalDateTime} 转换为 {@link org.joda.time.LocalDateTime}
-     *
-     * @param localDateTime Java 8 LocalDateTime
-     * @return joda-time LocalDateTime
-     */
-    public static org.joda.time.LocalDateTime toJodaLocalDateTime(java.time.LocalDateTime localDateTime) {
-        java.time.ZoneId javaZone = java.time.ZoneId.systemDefault();
-        org.joda.time.DateTimeZone jodaZone = toJodaZone(javaZone);
-        return toJodaInstant(localDateTime, javaZone).toDateTime(jodaZone).toLocalDateTime();
-    }
-
-    // ================================
-    // #endregion
-    // ================================
-
-    // ================================
-    // #region - toJavaLocalDateTime
-    // ================================
-
-    /**
-     * 将 {@link org.joda.time.LocalDateTime} 转换为 {@link java.time.LocalDateTime}
-     *
-     * @param localDateTime joda-time LocalDateTime
-     * @return Java 8 LocalDateTime
-     */
-    public static java.time.LocalDateTime toJavaLocalDateTime(org.joda.time.LocalDateTime localDateTime) {
-        org.joda.time.DateTimeZone jodaZone = org.joda.time.DateTimeZone.getDefault();
-        java.time.ZoneId javaZone = toJavaZone(jodaZone);
-        return toJavaInstant(localDateTime, jodaZone).atZone(javaZone).toLocalDateTime();
-    }
-
-    // ================================
-    // #endregion
-    // ================================
-
-    // ================================
-    // #region - ZoneId <--> DateTimeZone
-    // ================================
-
-    /**
-     * 转换 Java API 和 joda-time API 表示时区的对象
-     *
-     * @param jodaZone joda-time API 中表示时区的对象
-     * @return Java API 中表示时区的对象
-     */
-    public static java.time.ZoneId toJavaZone(org.joda.time.DateTimeZone jodaZone) {
-        return jodaZone.toTimeZone().toZoneId();
-    }
-
-    /**
-     * 转换 Java API 和 joda-time API 表示时区的对象
-     *
-     * @param zone Java API 中表示时区的对象
-     * @return joda-time API 中表示时区的对象
-     */
-    public static org.joda.time.DateTimeZone toJodaZone(java.time.ZoneId zone) {
-        return org.joda.time.DateTimeZone.forID(zone.getId());
-    }
-
-    // ================================
-    // #endregion
-    // ================================
-
    // ================================
    // #region - YearQuarter & Quarter
    // ================================
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/util/JodaTimeTools.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/util/JodaTimeTools.java
@@ -0,0 +1,284 @@
+/*
+ * Copyright 2025 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package xyz.zhouxy.plusone.commons.util;
+
+/**
+ * Joda-Time 工具类
+ *
+ * @author <a href="http://zhouxy.xyz:3000/ZhouXY108">ZhouXY</a>
+ */
+public class JodaTimeTools {
+
+    // ================================
+    // #region - toJodaInstant
+    // ================================
+
+    /**
+     * 将 {@link java.time.Instant} 转换为 {@link org.joda.time.Instant}
+     *
+     * @param instant {@link java.time.Instant} 对象
+     * @return {@link org.joda.time.Instant} 对象
+     */
+    public static org.joda.time.Instant toJodaInstant(java.time.Instant instant) {
+        return new org.joda.time.Instant(instant.toEpochMilli());
+    }
+
+    /**
+     * 将 {@link java.time.ZonedDateTime} 转换为 {@link org.joda.time.Instant}
+     *
+     * @param zonedDateTime {@link java.time.ZonedDateTime} 对象
+     * @return {@link org.joda.time.Instant} 对象
+     */
+    public static org.joda.time.Instant toJodaInstant(java.time.ZonedDateTime zonedDateTime) {
+        return toJodaInstant(zonedDateTime.toInstant());
+    }
+
+    /**
+     * 计算指定时区的地区时间，对应的时间戳。结果为 {@link org.joda.time.Instant} 对象
+     *
+     * @param localDateTime {@link java.time.LocalDateTime} 对象
+     * @param zone          时区
+     * @return {@link org.joda.time.Instant} 对象
+     */
+    public static org.joda.time.Instant toJodaInstant(java.time.LocalDateTime localDateTime, java.time.ZoneId zone) {
+        return toJodaInstant(java.time.ZonedDateTime.of(localDateTime, zone));
+    }
+
+    // ================================
+    // #endregion
+    // ================================
+
+    // ================================
+    // #region - toJavaInstant
+    // ================================
+
+    /**
+     * 将 {@link org.joda.time.Instant} 对象转换为 {@link java.time.Instant} 对象
+     *
+     * @param instant {@link org.joda.time.Instant} 对象
+     * @return {@link java.time.Instant} 对象
+     */
+    public static java.time.Instant toJavaInstant(org.joda.time.Instant instant) {
+        return DateTimeTools.toInstant(instant.getMillis());
+    }
+
+    /**
+     * 将 joda-time 中的 {@link org.joda.time.DateTime} 对象转换为 Java 的
+     * {@link java.time.Instant} 对象
+     *
+     * @param dateTime joda-time 中表示日期时间的 {@link org.joda.time.DateTime} 对象
+     * @return Java 表示时间戳的 {@link java.time.Instant} 对象
+     */
+    public static java.time.Instant toJavaInstant(org.joda.time.DateTime dateTime) {
+        return DateTimeTools.toInstant(dateTime.getMillis());
+    }
+
+    /**
+     * 将 joda-time 中的 {@link org.joda.time.LocalDateTime} 对象和
+     * {@link org.joda.time.DateTimeZone} 对象
+     * 转换为 Java 中的 {@link java.time.Instant} 对象
+     *
+     * @param localDateTime
+     * @param zone
+     * @return
+     */
+    public static java.time.Instant toJavaInstant(
+            org.joda.time.LocalDateTime localDateTime,
+            org.joda.time.DateTimeZone zone) {
+        return toJavaInstant(localDateTime.toDateTime(zone));
+    }
+
+    // ================================
+    // #endregion
+    // ================================
+
+    // ================================
+    // #region - toJodaDateTime
+    // ================================
+
+    /**
+     * 将 Java 中表示日期时间的 {@link java.time.ZonedDateTime} 对象
+     * 转换为 joda-time 的 {@link org.joda.time.DateTime} 对象
+     *
+     * @param zonedDateTime 日期时间
+     * @return joda-time 中对应的 {@link org.joda.time.DateTime} 对象
+     */
+    public static org.joda.time.DateTime toJodaDateTime(java.time.ZonedDateTime zonedDateTime) {
+        org.joda.time.DateTimeZone zone = org.joda.time.DateTimeZone.forID(zonedDateTime.getZone().getId());
+        return toJodaInstant(zonedDateTime.toInstant()).toDateTime(zone);
+    }
+
+    /**
+     * 将 java.time 中表示日期时间的 {@link java.time.LocalDateTime} 对象和表示时区的
+     * {@link java.time.ZoneId} 对象转换为 joda-time 中对应的 {@link org.joda.time.DateTime}
+     * 对象
+     * 转换为 joda-time 中对应的 {@link org.joda.time.DateTime} 对象
+     *
+     * @param localDateTime 日期时间
+     * @param zone          时区
+     * @return joda-time 中对应的 {@link org.joda.time.DateTime} 对象
+     */
+    public static org.joda.time.DateTime toJodaDateTime(
+            java.time.LocalDateTime localDateTime,
+            java.time.ZoneId zone) {
+        org.joda.time.DateTimeZone dateTimeZone = toJodaZone(zone);
+        return toJodaInstant(java.time.ZonedDateTime.of(localDateTime, zone).toInstant()).toDateTime(dateTimeZone);
+    }
+
+    /**
+     * 计算时间戳在指定时区对应的时间，结果使用 {@link org.joda.time.DateTime} 表示
+     *
+     * @param instant java.time 中的时间戳
+     * @param zone    java.time 中的时区
+     * @return joda-time 中带时区的日期时间
+     */
+    public static org.joda.time.DateTime toJodaDateTime(
+            java.time.Instant instant,
+            java.time.ZoneId zone) {
+        org.joda.time.DateTimeZone dateTimeZone = toJodaZone(zone);
+        return toJodaInstant(instant).toDateTime(dateTimeZone);
+    }
+
+    // ================================
+    // #endregion
+    // ================================
+
+    // ================================
+    // #region - toZonedDateTime
+    // ================================
+
+    /**
+     * 将 joda-time 中带时区的日期时间，转换为 java.time 中带时区的日期时间
+     *
+     * @param dateTime joda-time 中带时区的日期时间
+     * @return java.time 中带时区的日期时间
+     */
+    public static java.time.ZonedDateTime toZonedDateTime(org.joda.time.DateTime dateTime) {
+        java.time.ZoneId zone = dateTime.getZone().toTimeZone().toZoneId();
+        return toJavaInstant(dateTime.toInstant()).atZone(zone);
+    }
+
+    /**
+     * 将 joda-time 中的 {@link org.joda.time.LocalDateTime} 和
+     * {@link org.joda.time.DateTimeZone}
+     * 转换为 java.time 中的 {@link java.time.ZonedDateTime}
+     *
+     * @param localDateTime joda-time 中的地区时间
+     * @param dateTimeZone  joda-time 中的时区
+     * @return java.time 中带时区的日期时间
+     */
+    public static java.time.ZonedDateTime toZonedDateTime(
+            org.joda.time.LocalDateTime localDateTime,
+            org.joda.time.DateTimeZone dateTimeZone) {
+        java.time.ZoneId zone = toJavaZone(dateTimeZone);
+        return toJavaInstant(localDateTime, dateTimeZone).atZone(zone);
+    }
+
+    /**
+     * 获取 joda-time 中的 {@link org.joda.time.Instant} 在指定时区的时间，用 Java 8+ 的
+     * {@link java.time.ZonedDateTime} 表示
+     *
+     * @param instant      joda-time 中的时间戳
+     * @param dateTimeZone joda-time 中的时区
+     * @return
+     */
+    public static java.time.ZonedDateTime toZonedDateTime(
+            org.joda.time.Instant instant,
+            org.joda.time.DateTimeZone dateTimeZone) {
+        java.time.ZoneId zone = toJavaZone(dateTimeZone);
+        return toJavaInstant(instant).atZone(zone);
+    }
+
+    // ================================
+    // #endregion
+    // ================================
+
+    // ================================
+    // #region - toJodaLocalDateTime
+    // ================================
+
+    /**
+     * 将 {@link java.time.LocalDateTime} 转换为 {@link org.joda.time.LocalDateTime}
+     *
+     * @param localDateTime Java 8 LocalDateTime
+     * @return joda-time LocalDateTime
+     */
+    public static org.joda.time.LocalDateTime toJodaLocalDateTime(java.time.LocalDateTime localDateTime) {
+        java.time.ZoneId javaZone = java.time.ZoneId.systemDefault();
+        org.joda.time.DateTimeZone jodaZone = toJodaZone(javaZone);
+        return toJodaInstant(localDateTime, javaZone).toDateTime(jodaZone).toLocalDateTime();
+    }
+
+    // ================================
+    // #endregion
+    // ================================
+
+    // ================================
+    // #region - toJavaLocalDateTime
+    // ================================
+
+    /**
+     * 将 {@link org.joda.time.LocalDateTime} 转换为 {@link java.time.LocalDateTime}
+     *
+     * @param localDateTime joda-time LocalDateTime
+     * @return Java 8 LocalDateTime
+     */
+    public static java.time.LocalDateTime toJavaLocalDateTime(org.joda.time.LocalDateTime localDateTime) {
+        org.joda.time.DateTimeZone jodaZone = org.joda.time.DateTimeZone.getDefault();
+        java.time.ZoneId javaZone = toJavaZone(jodaZone);
+        return toJavaInstant(localDateTime, jodaZone).atZone(javaZone).toLocalDateTime();
+    }
+
+    // ================================
+    // #endregion
+    // ================================
+
+    // ================================
+    // #region - ZoneId <--> DateTimeZone
+    // ================================
+
+    /**
+     * 转换 Java API 和 joda-time API 表示时区的对象
+     *
+     * @param jodaZone joda-time API 中表示时区的对象
+     * @return Java API 中表示时区的对象
+     */
+    public static java.time.ZoneId toJavaZone(org.joda.time.DateTimeZone jodaZone) {
+        return jodaZone.toTimeZone().toZoneId();
+    }
+
+    /**
+     * 转换 Java API 和 joda-time API 表示时区的对象
+     *
+     * @param zone Java API 中表示时区的对象
+     * @return joda-time API 中表示时区的对象
+     */
+    public static org.joda.time.DateTimeZone toJodaZone(java.time.ZoneId zone) {
+        return org.joda.time.DateTimeZone.forID(zone.getId());
+    }
+
+    // ================================
+    // #endregion
+    // ================================
+
+    /**
+     * 私有构造方法
+     */
+    private JodaTimeTools() {
+        throw new IllegalStateException("Utility class");
+    }
+}
--- a/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/util/StringTools.java
+++ b/plusone-commons/src/main/java/xyz/zhouxy/plusone/commons/util/StringTools.java
@@ -26,7 +26,7 @@ import javax.annotation.Nullable;

 import com.google.common.annotations.Beta;

-import xyz.zhouxy.plusone.commons.constant.PatternConsts;
+import xyz.zhouxy.plusone.commons.regex.PatternConsts;

 /**
 * StringTools
--- a/plusone-commons/src/test/java/xyz/zhouxy/plusone/commons/model/ValidatableStringRecordTests.java
+++ b/plusone-commons/src/test/java/xyz/zhouxy/plusone/commons/model/ValidatableStringRecordTests.java
@@ -31,7 +31,7 @@ import org.slf4j.LoggerFactory;

 import xyz.zhouxy.plusone.commons.annotation.StaticFactoryMethod;
 import xyz.zhouxy.plusone.commons.annotation.ValueObject;
-import xyz.zhouxy.plusone.commons.constant.PatternConsts;
+import xyz.zhouxy.plusone.commons.regex.PatternConsts;

 import java.util.Arrays;
 import java.util.Collections;
--- a/plusone-commons/src/test/java/xyz/zhouxy/plusone/commons/constant/PatternConstsTests.java
+++ b/plusone-commons/src/test/java/xyz/zhouxy/plusone/commons/constant/PatternConstsTests.java
@@ -14,7 +14,7 @@
 * limitations under the License.
 */

-package xyz.zhouxy.plusone.commons.constant;
+package xyz.zhouxy.plusone.commons.regex;

 import static org.junit.jupiter.api.Assertions.*;

--- a/plusone-commons/src/test/java/xyz/zhouxy/plusone/commons/regex/PatternInfosTests.java
+++ b/plusone-commons/src/test/java/xyz/zhouxy/plusone/commons/regex/PatternInfosTests.java
@@ -0,0 +1,259 @@
+/*
+ * Copyright 2024-2025 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package xyz.zhouxy.plusone.commons.regex;
+
+import static org.junit.jupiter.api.Assertions.*;
+
+import java.lang.reflect.Constructor;
+import java.util.Arrays;
+import java.util.regex.Matcher;
+
+import org.junit.jupiter.api.Test;
+import org.junit.jupiter.params.ParameterizedTest;
+import org.junit.jupiter.params.provider.ValueSource;
+
+import lombok.extern.slf4j.Slf4j;
+import xyz.zhouxy.plusone.commons.model.Gender;
+
+@Slf4j
+public //
+class PatternInfosTests {
+
+    // ================================
+    // #region - BASIC_ISO_DATE
+    // ================================
+
+    @Test
+    void testBasicIsoDate_ValidDate() {
+        LocalDateMatcher localDateMatcher = PatternInfos.BASIC_ISO_DATE.matcher("20241229");
+        Matcher matcher = localDateMatcher.matcher();
+        assertTrue(matcher.matches());
+        assertTrue(localDateMatcher.matches());
+
+        assertEquals("2024", localDateMatcher.getYear());
+        assertEquals("12", localDateMatcher.getMonth());
+        assertEquals("29", localDateMatcher.getDay());
+    }
+
+    @ParameterizedTest
+    @ValueSource(strings = {
+        "20231301", // InvalidMonth
+        "20230230", // InvalidDay
+        "20210229", // NonLeapYearFeb29
+    })
+    void testBasicIsoDate_InvalidDate_butMatches(String date) {
+        // 虽然日期有误，但这个正则无法判断。实际工作中，应使用日期时间 API。
+        LocalDateMatcher matcher = PatternInfos.BASIC_ISO_DATE.matcher(date);
+        assertTrue(matcher.matches());
+    }
+
+    @ParameterizedTest
+    @ValueSource(strings = {
+        "2023041", // TooShort
+        "99999999990415", // TooLong
+        "2023-04-15", // NonNumeric
+    })
+    void testBasicIsoDate_InvalidDate_Mismatches(String date) {
+        LocalDateMatcher matcher = PatternInfos.BASIC_ISO_DATE.matcher(date);
+        assertFalse(matcher.matches());
+    }
+
+    // ================================
+    // #endregion - BASIC_ISO_DATE
+    // ================================
+
+    // ================================
+    // #region - ISO_LOCAL_DATE
+    // ================================
+
+    @Test
+    void testIsoLocalDate_ValidDate() {
+        LocalDateMatcher matcher = PatternInfos.ISO_LOCAL_DATE.matcher("2024-12-29");
+        assertTrue(matcher.matches());
+        assertEquals("2024", matcher.getYear());
+        assertEquals("12", matcher.getMonth());
+        assertEquals("29", matcher.getDay());
+
+        // LeapYearFeb29()
+        assertTrue(PatternInfos.ISO_LOCAL_DATE.matcher("2020-02-29").matches());
+
+        // BoundaryMin()
+        assertTrue(PatternInfos.ISO_LOCAL_DATE.matcher("0000-01-01").matches());
+
+        // BoundaryMax()
+        assertTrue(PatternInfos.ISO_LOCAL_DATE.matcher("999999999-12-31").matches());
+    }
+
+    @ParameterizedTest
+    @ValueSource(strings = {
+        "2023-13-01", // InvalidMonth
+        "2023-02-30", // InvalidDay
+        "2021-02-29", // NonLeapYearFeb29
+    })
+    void testIsoLocalDate_InvalidDate_butMatches(String date) {
+        // 虽然日期有误，但这个正则无法判断。实际工作中，应使用日期时间 API。
+        LocalDateMatcher matcher = PatternInfos.ISO_LOCAL_DATE.matcher(date);
+        assertTrue(matcher.matches());
+    }
+
+    @ParameterizedTest
+    @ValueSource(strings = {
+        "2023-04-1", // TooShort
+        "9999999999-04-15", // TooLong
+        "20230415",
+    })
+    void testIsoLocalDate_InvalidDate_Mismatches(String date) {
+        LocalDateMatcher matcher = PatternInfos.ISO_LOCAL_DATE.matcher(date);
+        assertFalse(matcher.matches());
+    }
+
+    // ================================
+    // #endregion - ISO_LOCAL_DATE
+    // ================================
+
+    // ================================
+    // #region - PASSWORD
+    // ================================
+
+    @Test
+    void testPassword_ValidPassword_Matches() {
+        assertTrue(PatternInfos.PASSWORD.matcher("Abc123!@#").matches());
+    }
+
+    @Test
+    void testPassword_InvalidPassword_Mismatches() {
+        assertFalse(PatternInfos.PASSWORD.matcher("Abc123 !@#").matches()); // 带空格
+        assertFalse(PatternInfos.PASSWORD.matcher("Abc123!@# ").matches()); // 带空格
+        assertFalse(PatternInfos.PASSWORD.matcher(" Abc123!@#").matches()); // 带空格
+        assertFalse(PatternInfos.PASSWORD.matcher(" Abc123!@# ").matches()); // 带空格
+        assertFalse(PatternInfos.PASSWORD.matcher("77553366998844113322").matches()); // 纯数字
+        assertFalse(PatternInfos.PASSWORD.matcher("poiujhgbfdsazxcfvghj").matches()); // 纯小写字母
+        assertFalse(PatternInfos.PASSWORD.matcher("POIUJHGBFDSAZXCFVGHJ").matches()); // 纯大写字母
+        assertFalse(PatternInfos.PASSWORD.matcher("!#$%&'*\\+-/=?^`{|}~@()[]\",.;':").matches()); // 纯特殊字符
+        assertFalse(PatternInfos.PASSWORD.matcher("sdfrghbv525842582752").matches()); // 没有小写字母
+        assertFalse(PatternInfos.PASSWORD.matcher("SDFRGHBV525842582752").matches()); // 没有小写字母
+        assertFalse(PatternInfos.PASSWORD.matcher("sdfrghbvSDFRGHBV").matches()); // 没有数字
+        assertFalse(PatternInfos.PASSWORD.matcher("Abc1!").matches()); // 太短
+        assertFalse(PatternInfos.PASSWORD.matcher("Abc1!Abc1!Abc1!Abc1!Abc1!Abc1!Abc1!").matches()); // 太长
+        assertFalse(PatternInfos.PASSWORD.matcher("").matches());
+        assertFalse(PatternInfos.PASSWORD.matcher(" ").matches());
+    }
+
+    // ================================
+    // #endregion - PASSWORD
+    // ================================
+
+    // ================================
+    // #region - EMAIL
+    // ================================
+
+    @Test
+    public void testValidEmails() {
+        assertTrue(PatternInfos.EMAIL.matcher("test@example.com").matches());
+        assertTrue(PatternInfos.EMAIL.matcher("user.name+tag+sorting@example.com").matches());
+        assertTrue(PatternInfos.EMAIL.matcher("user@sub.example.com").matches());
+        assertTrue(PatternInfos.EMAIL.matcher("user@123.123.123.123").matches());
+    }
+
+    @Test
+    public void testInvalidEmails() {
+        assertFalse(PatternInfos.EMAIL.matcher(".username@example.com").matches());
+        assertFalse(PatternInfos.EMAIL.matcher("@missingusername.com").matches());
+        assertFalse(PatternInfos.EMAIL.matcher("plainaddress").matches());
+        assertFalse(PatternInfos.EMAIL.matcher("username..username@example.com").matches());
+        assertFalse(PatternInfos.EMAIL.matcher("username.@example.com").matches());
+        assertFalse(PatternInfos.EMAIL.matcher("username@-example.com").matches());
+        assertFalse(PatternInfos.EMAIL.matcher("username@-example.com").matches());
+        assertFalse(PatternInfos.EMAIL.matcher("username@.com.com").matches());
+        assertFalse(PatternInfos.EMAIL.matcher("username@.com.my").matches());
+        assertFalse(PatternInfos.EMAIL.matcher("username@.com").matches());
+        assertFalse(PatternInfos.EMAIL.matcher("username@com.").matches());
+        assertFalse(PatternInfos.EMAIL.matcher("username@com").matches());
+        assertFalse(PatternInfos.EMAIL.matcher("username@example..com").matches());
+        assertFalse(PatternInfos.EMAIL.matcher("username@example.com-").matches());
+        assertFalse(PatternInfos.EMAIL.matcher("username@example.com.").matches());
+        assertFalse(PatternInfos.EMAIL.matcher("username@example").matches());
+    }
+
+    // ================================
+    // #endregion - EMAIL
+    // ================================
+
+    // ================================
+    // #region - Chinese2ndIdCardNumber
+    // ================================
+
+    @ParameterizedTest
+    @ValueSource(strings = {
+        "44520019900101456X",
+        "44520019900101456x",
+        "445200199001014566",
+    })
+    void testChinese2ndIdCardNumber_ValidChinese2ndIdCardNumber(String value) {
+        Chinese2ndIdCardNumberMatcher chinese2ndIdCardNumberMatcher = PatternInfos.CHINESE_2ND_ID_CARD_NUMBER.matcher(value);
+        Matcher matcher = chinese2ndIdCardNumberMatcher.matcher();
+        assertTrue(matcher.matches());
+        assertEquals("44", chinese2ndIdCardNumberMatcher.getProvince());
+        assertEquals("4452", chinese2ndIdCardNumberMatcher.getCity());
+        assertEquals("445200", chinese2ndIdCardNumberMatcher.getCounty());
+        assertEquals("19900101", chinese2ndIdCardNumberMatcher.getBirthDate());
+        assertEquals("456", chinese2ndIdCardNumberMatcher.getOrderCode());
+        assertEquals("6", chinese2ndIdCardNumberMatcher.getGenderCode());
+        assertEquals(Gender.FEMALE, chinese2ndIdCardNumberMatcher.getGender());
+
+        String checkDigit = value.substring(value.length() - 1);
+        assertEquals(checkDigit, chinese2ndIdCardNumberMatcher.getCheckDigit());
+    }
+
+    @ParameterizedTest
+    @ValueSource(strings = {
+        "4452200199001014566",
+        "44520199001014566",
+        " ",
+        "",
+    })
+    void testChinese2ndIdCardNumber_InvalidChinese2ndIdCardNumber(String value) {
+        assertFalse(PatternInfos.CHINESE_2ND_ID_CARD_NUMBER.matcher(value).matches());
+    }
+
+    // ================================
+    // #endregion - Chinese2ndIdCardNumber
+    // ================================
+
+    // ================================
+    // #region - invoke constructor
+    // ================================
+
+    @Test
+    void test_constructor_isNotAccessible_ThrowsIllegalStateException() {
+        Constructor<?>[] constructors;
+        constructors = PatternInfos.class.getDeclaredConstructors();
+        Arrays.stream(constructors)
+                .forEach(constructor -> {
+                    assertFalse(constructor.isAccessible());
+                    constructor.setAccessible(true);
+                    Throwable cause = assertThrows(Exception.class, constructor::newInstance)
+                            .getCause();
+                    assertInstanceOf(IllegalStateException.class, cause);
+                    assertEquals("Utility class", cause.getMessage());
+                });
+    }
+
+    // ================================
+    // #endregion - invoke constructor
+    // ================================
+}
--- a/plusone-commons/src/test/java/xyz/zhouxy/plusone/commons/util/DateTimeToolsTests.java
+++ b/plusone-commons/src/test/java/xyz/zhouxy/plusone/commons/util/DateTimeToolsTests.java
@@ -277,144 +277,6 @@ class DateTimeToolsTests {
    // #endregion - toLocalDateTime
    // ================================

-    // ================================
-    // #region - toJodaInstant
-    // ================================
-
-    @Test
-    void toJodaInstant_JavaInstant() {
-        assertEquals(JODA_INSTANT_WITH_SYS_ZONE, DateTimeTools.toJodaInstant(INSTANT_WITH_SYS_ZONE));
-        assertEquals(JODA_INSTANT, DateTimeTools.toJodaInstant(INSTANT));
-    }
-
-    @Test
-    void toJodaInstant_ZonedDateTime() {
-        assertEquals(JODA_INSTANT_WITH_SYS_ZONE, DateTimeTools.toJodaInstant(ZONED_DATE_TIME_WITH_SYS_ZONE));
-        assertEquals(JODA_INSTANT, DateTimeTools.toJodaInstant(ZONED_DATE_TIME));
-    }
-
-    @Test
-    void toJodaInstant_LocalDateTimeAndZoneId() {
-        assertEquals(JODA_INSTANT_WITH_SYS_ZONE, DateTimeTools.toJodaInstant(LOCAL_DATE_TIME, SYS_ZONE_ID));
-        assertEquals(JODA_INSTANT, DateTimeTools.toJodaInstant(LOCAL_DATE_TIME, ZONE_ID));
-    }
-
-    // ================================
-    // #endregion - toJodaInstant
-    // ================================
-
-    // ================================
-    // #region - toJavaInstant
-    // ================================
-
-    @Test
-    void toJavaInstant_JodaInstant() {
-        assertEquals(INSTANT_WITH_SYS_ZONE, DateTimeTools.toJavaInstant(JODA_INSTANT_WITH_SYS_ZONE));
-        assertEquals(INSTANT, DateTimeTools.toJavaInstant(JODA_INSTANT));
-    }
-
-    @Test
-    void toJavaInstant_JodaDateTime() {
-        assertEquals(INSTANT_WITH_SYS_ZONE, DateTimeTools.toJavaInstant(JODA_DATE_TIME_WITH_SYS_ZONE));
-        assertEquals(INSTANT, DateTimeTools.toJavaInstant(JODA_DATE_TIME));
-    }
-
-    @Test
-    void toJavaInstant_JodaLocalDateTimeAndJodaDateTimeZone() {
-        assertEquals(INSTANT_WITH_SYS_ZONE, DateTimeTools.toJavaInstant(JODA_LOCAL_DATE_TIME, JODA_SYS_ZONE));
-        assertEquals(INSTANT, DateTimeTools.toJavaInstant(JODA_LOCAL_DATE_TIME, JODA_ZONE));
-    }
-
-    // ================================
-    // #endregion - toJavaInstant
-    // ================================
-
-    // ================================
-    // #region - toJodaDateTime
-    // ================================
-
-    @Test
-    void toJodaDateTime_ZonedDateTime() {
-        assertEquals(JODA_DATE_TIME_WITH_SYS_ZONE, DateTimeTools.toJodaDateTime(ZONED_DATE_TIME_WITH_SYS_ZONE));
-        assertEquals(JODA_DATE_TIME, DateTimeTools.toJodaDateTime(ZONED_DATE_TIME));
-    }
-
-    @Test
-    void toJodaDateTime_LocalDateTimeAndZoneId() {
-        assertEquals(JODA_DATE_TIME_WITH_SYS_ZONE, DateTimeTools.toJodaDateTime(LOCAL_DATE_TIME, SYS_ZONE_ID));
-        assertEquals(JODA_DATE_TIME, DateTimeTools.toJodaDateTime(LOCAL_DATE_TIME, ZONE_ID));
-    }
-
-    @Test
-    void toJodaDateTime_InstantAndZoneId() {
-        assertEquals(JODA_DATE_TIME_WITH_SYS_ZONE, DateTimeTools.toJodaDateTime(INSTANT_WITH_SYS_ZONE, SYS_ZONE_ID));
-        assertEquals(JODA_DATE_TIME, DateTimeTools.toJodaDateTime(INSTANT, ZONE_ID));
-    }
-
-    // ================================
-    // #endregion - toJodaDateTime
-    // ================================
-
-    // ================================
-    // #region - toZonedDateTime
-    // ================================
-
-    @Test
-    void toZonedDateTime_JodaDateTime() {
-        assertEquals(ZONED_DATE_TIME_WITH_SYS_ZONE, DateTimeTools.toZonedDateTime(JODA_DATE_TIME_WITH_SYS_ZONE));
-        assertEquals(ZONED_DATE_TIME, DateTimeTools.toZonedDateTime(JODA_DATE_TIME));
-    }
-
-    @Test
-    void toZonedDateTime_JodaLocalDateTimeAndJodaDateTimeZone() {
-        assertEquals(ZONED_DATE_TIME_WITH_SYS_ZONE, DateTimeTools.toZonedDateTime(JODA_LOCAL_DATE_TIME, JODA_SYS_ZONE));
-        assertEquals(ZONED_DATE_TIME, DateTimeTools.toZonedDateTime(JODA_LOCAL_DATE_TIME, JODA_ZONE));
-    }
-
-    @Test
-    void toZonedDateTime_JodaInstantAndJodaDateTimeZone() {
-        assertEquals(ZONED_DATE_TIME_WITH_SYS_ZONE, DateTimeTools.toZonedDateTime(JODA_INSTANT_WITH_SYS_ZONE, JODA_SYS_ZONE));
-        assertEquals(ZONED_DATE_TIME, DateTimeTools.toZonedDateTime(JODA_INSTANT, JODA_ZONE));
-    }
-
-    // ================================
-    // #endregion - toZonedDateTime
-    // ================================
-
-    // ================================
-    // #region - toJodaLocalDateTime
-    // ================================
-
-    @Test
-    void toJodaLocalDateTime_JavaLocalDateTime() {
-        assertEquals(JODA_LOCAL_DATE_TIME, DateTimeTools.toJodaLocalDateTime(LOCAL_DATE_TIME));
-    }
-
-    @Test
-    void toJavaLocalDateTime_JodaLocalDateTime() {
-        assertEquals(LOCAL_DATE_TIME, DateTimeTools.toJavaLocalDateTime(JODA_LOCAL_DATE_TIME));
-    }
-
-    // ================================
-    // #endregion - toJodaLocalDateTime
-    // ================================
-
-    // ================================
-    // #region - ZoneId <--> DateTimeZone
-    // ================================
-
-    @Test
-    void convertJavaZoneIdAndJodaDateTimeZone() {
-        assertEquals(SYS_ZONE_ID, DateTimeTools.toJavaZone(JODA_SYS_ZONE));
-        assertEquals(ZONE_ID, DateTimeTools.toJavaZone(JODA_ZONE));
-        assertEquals(JODA_SYS_ZONE, DateTimeTools.toJodaZone(SYS_ZONE_ID));
-        assertEquals(JODA_ZONE, DateTimeTools.toJodaZone(ZONE_ID));
-    }
-
-    // ================================
-    // #endregion - ZoneId <--> DateTimeZone
-    // ================================
-
    // ================================
    // #region - YearQuarter & Quarter
    // ================================
--- a/plusone-commons/src/test/java/xyz/zhouxy/plusone/commons/util/JodaTimeToolsTests.java
+++ b/plusone-commons/src/test/java/xyz/zhouxy/plusone/commons/util/JodaTimeToolsTests.java
@@ -0,0 +1,223 @@
+/*
+ * Copyright 2025 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package xyz.zhouxy.plusone.commons.util;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+
+import java.time.Instant;
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.time.LocalTime;
+import java.time.ZoneId;
+import java.time.ZonedDateTime;
+import java.util.Calendar;
+import java.util.Date;
+import java.util.TimeZone;
+
+import org.junit.jupiter.api.Test;
+
+public class JodaTimeToolsTests {
+
+    // Java
+    static final LocalDateTime LOCAL_DATE_TIME = LocalDateTime.of(2024, 12, 29, 12, 58, 30, 333000000);
+    static final LocalDate LOCAL_DATE = LOCAL_DATE_TIME.toLocalDate();
+    static final LocalTime LOCAL_TIME = LOCAL_DATE_TIME.toLocalTime();
+
+    // Java - 2024-12-29 12:58:30.333333333 SystemDefaultZone
+    static final ZoneId SYS_ZONE_ID = ZoneId.systemDefault();
+    static final ZonedDateTime ZONED_DATE_TIME_WITH_SYS_ZONE = LOCAL_DATE_TIME.atZone(SYS_ZONE_ID);
+    static final Instant INSTANT_WITH_SYS_ZONE = ZONED_DATE_TIME_WITH_SYS_ZONE.toInstant();
+    static final long INSTANT_MILLIS = INSTANT_WITH_SYS_ZONE.toEpochMilli();
+
+    static final TimeZone SYS_TIME_ZONE = TimeZone.getDefault();
+    static final Date SYS_DATE = Date.from(INSTANT_WITH_SYS_ZONE);
+    static final Calendar SYS_CALENDAR = Calendar.getInstance(SYS_TIME_ZONE);
+    static {
+        SYS_CALENDAR.setTime(SYS_DATE);
+    }
+
+    // Java - 2024-12-29 12:58:30.333333333 GMT+04:00
+    static final ZoneId ZONE_ID = ZoneId.of("GMT+04:00");
+    static final ZonedDateTime ZONED_DATE_TIME = LOCAL_DATE_TIME.atZone(ZONE_ID);
+    static final Instant INSTANT = ZONED_DATE_TIME.toInstant();
+    static final long MILLIS = INSTANT.toEpochMilli();
+
+    static final TimeZone TIME_ZONE = TimeZone.getTimeZone(ZONE_ID);
+    static final Date DATE = Date.from(INSTANT);
+    static final Calendar CALENDAR = Calendar.getInstance(TIME_ZONE);
+    static {
+        CALENDAR.setTime(DATE);
+    }
+
+    // Joda
+    static final org.joda.time.LocalDateTime JODA_LOCAL_DATE_TIME
+            = new org.joda.time.LocalDateTime(2024, 12, 29, 12, 58, 30, 333);
+    static final org.joda.time.LocalDate JODA_LOCAL_DATE = JODA_LOCAL_DATE_TIME.toLocalDate();
+    static final org.joda.time.LocalTime JODA_LOCAL_TIME = JODA_LOCAL_DATE_TIME.toLocalTime();
+
+    // Joda - 2024-12-29 12:58:30.333 SystemDefaultZone
+    static final org.joda.time.DateTimeZone JODA_SYS_ZONE = org.joda.time.DateTimeZone.getDefault();
+    static final org.joda.time.DateTime JODA_DATE_TIME_WITH_SYS_ZONE = JODA_LOCAL_DATE_TIME.toDateTime(JODA_SYS_ZONE);
+    static final org.joda.time.Instant JODA_INSTANT_WITH_SYS_ZONE = JODA_DATE_TIME_WITH_SYS_ZONE.toInstant();
+    static final long JODA_INSTANT_MILLIS = JODA_INSTANT_WITH_SYS_ZONE.getMillis();
+
+    // Joda - 2024-12-29 12:58:30.333 GMT+04:00
+    static final org.joda.time.DateTimeZone JODA_ZONE = org.joda.time.DateTimeZone.forID("GMT+04:00");
+    static final org.joda.time.DateTime JODA_DATE_TIME = JODA_LOCAL_DATE_TIME.toDateTime(JODA_ZONE);
+    static final org.joda.time.Instant JODA_INSTANT = JODA_DATE_TIME.toInstant();
+    static final long JODA_MILLIS = JODA_INSTANT.getMillis();
+
+
+    // ================================
+    // #region - toJodaInstant
+    // ================================
+
+    @Test
+    void toJodaInstant_JavaInstant() {
+        assertEquals(JODA_INSTANT_WITH_SYS_ZONE, JodaTimeTools.toJodaInstant(INSTANT_WITH_SYS_ZONE));
+        assertEquals(JODA_INSTANT, JodaTimeTools.toJodaInstant(INSTANT));
+    }
+
+    @Test
+    void toJodaInstant_ZonedDateTime() {
+        assertEquals(JODA_INSTANT_WITH_SYS_ZONE, JodaTimeTools.toJodaInstant(ZONED_DATE_TIME_WITH_SYS_ZONE));
+        assertEquals(JODA_INSTANT, JodaTimeTools.toJodaInstant(ZONED_DATE_TIME));
+    }
+
+    @Test
+    void toJodaInstant_LocalDateTimeAndZoneId() {
+        assertEquals(JODA_INSTANT_WITH_SYS_ZONE, JodaTimeTools.toJodaInstant(LOCAL_DATE_TIME, SYS_ZONE_ID));
+        assertEquals(JODA_INSTANT, JodaTimeTools.toJodaInstant(LOCAL_DATE_TIME, ZONE_ID));
+    }
+
+    // ================================
+    // #endregion - toJodaInstant
+    // ================================
+
+    // ================================
+    // #region - toJavaInstant
+    // ================================
+
+    @Test
+    void toJavaInstant_JodaInstant() {
+        assertEquals(INSTANT_WITH_SYS_ZONE, JodaTimeTools.toJavaInstant(JODA_INSTANT_WITH_SYS_ZONE));
+        assertEquals(INSTANT, JodaTimeTools.toJavaInstant(JODA_INSTANT));
+    }
+
+    @Test
+    void toJavaInstant_JodaDateTime() {
+        assertEquals(INSTANT_WITH_SYS_ZONE, JodaTimeTools.toJavaInstant(JODA_DATE_TIME_WITH_SYS_ZONE));
+        assertEquals(INSTANT, JodaTimeTools.toJavaInstant(JODA_DATE_TIME));
+    }
+
+    @Test
+    void toJavaInstant_JodaLocalDateTimeAndJodaDateTimeZone() {
+        assertEquals(INSTANT_WITH_SYS_ZONE, JodaTimeTools.toJavaInstant(JODA_LOCAL_DATE_TIME, JODA_SYS_ZONE));
+        assertEquals(INSTANT, JodaTimeTools.toJavaInstant(JODA_LOCAL_DATE_TIME, JODA_ZONE));
+    }
+
+    // ================================
+    // #endregion - toJavaInstant
+    // ================================
+
+    // ================================
+    // #region - toJodaDateTime
+    // ================================
+
+    @Test
+    void toJodaDateTime_ZonedDateTime() {
+        assertEquals(JODA_DATE_TIME_WITH_SYS_ZONE, JodaTimeTools.toJodaDateTime(ZONED_DATE_TIME_WITH_SYS_ZONE));
+        assertEquals(JODA_DATE_TIME, JodaTimeTools.toJodaDateTime(ZONED_DATE_TIME));
+    }
+
+    @Test
+    void toJodaDateTime_LocalDateTimeAndZoneId() {
+        assertEquals(JODA_DATE_TIME_WITH_SYS_ZONE, JodaTimeTools.toJodaDateTime(LOCAL_DATE_TIME, SYS_ZONE_ID));
+        assertEquals(JODA_DATE_TIME, JodaTimeTools.toJodaDateTime(LOCAL_DATE_TIME, ZONE_ID));
+    }
+
+    @Test
+    void toJodaDateTime_InstantAndZoneId() {
+        assertEquals(JODA_DATE_TIME_WITH_SYS_ZONE, JodaTimeTools.toJodaDateTime(INSTANT_WITH_SYS_ZONE, SYS_ZONE_ID));
+        assertEquals(JODA_DATE_TIME, JodaTimeTools.toJodaDateTime(INSTANT, ZONE_ID));
+    }
+
+    // ================================
+    // #endregion - toJodaDateTime
+    // ================================
+
+    // ================================
+    // #region - toZonedDateTime
+    // ================================
+
+    @Test
+    void toZonedDateTime_JodaDateTime() {
+        assertEquals(ZONED_DATE_TIME_WITH_SYS_ZONE, JodaTimeTools.toZonedDateTime(JODA_DATE_TIME_WITH_SYS_ZONE));
+        assertEquals(ZONED_DATE_TIME, JodaTimeTools.toZonedDateTime(JODA_DATE_TIME));
+    }
+
+    @Test
+    void toZonedDateTime_JodaLocalDateTimeAndJodaDateTimeZone() {
+        assertEquals(ZONED_DATE_TIME_WITH_SYS_ZONE, JodaTimeTools.toZonedDateTime(JODA_LOCAL_DATE_TIME, JODA_SYS_ZONE));
+        assertEquals(ZONED_DATE_TIME, JodaTimeTools.toZonedDateTime(JODA_LOCAL_DATE_TIME, JODA_ZONE));
+    }
+
+    @Test
+    void toZonedDateTime_JodaInstantAndJodaDateTimeZone() {
+        assertEquals(ZONED_DATE_TIME_WITH_SYS_ZONE, JodaTimeTools.toZonedDateTime(JODA_INSTANT_WITH_SYS_ZONE, JODA_SYS_ZONE));
+        assertEquals(ZONED_DATE_TIME, JodaTimeTools.toZonedDateTime(JODA_INSTANT, JODA_ZONE));
+    }
+
+    // ================================
+    // #endregion - toZonedDateTime
+    // ================================
+
+    // ================================
+    // #region - toJodaLocalDateTime
+    // ================================
+
+    @Test
+    void toJodaLocalDateTime_JavaLocalDateTime() {
+        assertEquals(JODA_LOCAL_DATE_TIME, JodaTimeTools.toJodaLocalDateTime(LOCAL_DATE_TIME));
+    }
+
+    @Test
+    void toJavaLocalDateTime_JodaLocalDateTime() {
+        assertEquals(LOCAL_DATE_TIME, JodaTimeTools.toJavaLocalDateTime(JODA_LOCAL_DATE_TIME));
+    }
+
+    // ================================
+    // #endregion - toJodaLocalDateTime
+    // ================================
+
+    // ================================
+    // #region - ZoneId <--> DateTimeZone
+    // ================================
+
+    @Test
+    void convertJavaZoneIdAndJodaDateTimeZone() {
+        assertEquals(SYS_ZONE_ID, JodaTimeTools.toJavaZone(JODA_SYS_ZONE));
+        assertEquals(ZONE_ID, JodaTimeTools.toJavaZone(JODA_ZONE));
+        assertEquals(JODA_SYS_ZONE, JodaTimeTools.toJodaZone(SYS_ZONE_ID));
+        assertEquals(JODA_ZONE, JodaTimeTools.toJodaZone(ZONE_ID));
+    }
+
+    // ================================
+    // #endregion - ZoneId <--> DateTimeZone
+    // ================================
+
+}
Author	SHA1	Message	Date
ZhouXY108	ba3266aaea	refactor!: 重构正则表达式相关代码 - 将正则相关根据移至 regex 包下 - 新增 PatternInfos 记录不同 pattern 的信息 - 新增 Chinese2ndIdCardNumberMatcher 和 LocalDateMatcher 作为日期和二代居民身份证的匹配结果，方便从中获取对应的 group	2025-07-22 14:58:29 +08:00
ZhouXY108	56079c29d8	refactor!: 将 ParsingFailureException 改为受检异常	2025-07-22 14:58:04 +08:00
ZhouXY108	f111b02c21	build: 将 plusone-dependencies 版本更新为项目版本 - 将 plusone-dependencies 的固定版本号替换为 ${project.version} - 该修改确保了依赖版本与项目版本的一致性	2025-07-22 14:58:00 +08:00
ZhouXY108	56fd5f0a6a	refactor!: 将 JodaTime 相关方法从 DateTimeTools 类中提取到新的 JodaTimeTools 类	2025-07-22 14:57:34 +08:00