refactor: 重构 Chinese2ndGenIDCardNumber

不使用 ValidatableStringRecord，在工厂方法中进行参数校验。

src/main/java/xyz/zhouxy/plusone/commons/model/Chinese2ndGenIDCardNumber.java

@@ -16,9 +16,11 @@
 
 package xyz.zhouxy.plusone.commons.model;
 
+import java.io.Serializable;
 import java.time.LocalDate;
 import java.time.format.DateTimeFormatter;
 import java.util.Map;
+import java.util.Objects;
 import java.util.regex.Matcher;
 
 import javax.annotation.Nullable;
@@ -47,8 +49,11 @@ import xyz.zhouxy.plusone.commons.util.StringTools;
 @ValueObject
 @Immutable
 public class Chinese2ndGenIDCardNumber
-        extends ValidatableStringRecord<Chinese2ndGenIDCardNumber>
-        implements IDCardNumber {
+        implements IDCardNumber, Comparable<Chinese2ndGenIDCardNumber>, Serializable {
+    private static final long serialVersionUID = 5655592250204184210L;
+
+    /** 身份证号码 */
+    private final String value;
 
     /** 省份编码 */
     private final String provinceCode;
@@ -63,49 +68,58 @@ public class Chinese2ndGenIDCardNumber
 
     private static final DateTimeFormatter DATE_FORMATTER = DateTimeFormatter.ofPattern("yyyyMMdd");
 
-    private Chinese2ndGenIDCardNumber(String value) {
-        super(value.toUpperCase(),  PatternConsts.CHINESE_2ND_ID_CARD_NUMBER, () -> "二代居民身份证校验失败：" + value);
-
-        final Matcher matcher = getMatcher();
-
-        final String provinceCodeValue = matcher.group("province");
-        AssertTools.checkArgument(Chinese2ndGenIDCardNumber.PROVINCE_CODES.containsKey(provinceCodeValue));
-
-        final String cityCodeValue = matcher.group("city");
-        final String countyCodeValue = matcher.group("county");
-
-        final Gender genderValue;
-        final LocalDate birthDateValue;
+    private Chinese2ndGenIDCardNumber(String value,
+            String provinceCode, String cityCode, String countyCode,
+            Gender gender, LocalDate birthDate) {
+        this.value = value;
+        this.provinceCode = provinceCode;
+        this.cityCode = cityCode;
+        this.countyCode = countyCode;
+        this.gender = gender;
+        this.birthDate = birthDate;
+    }
 
+    public static Chinese2ndGenIDCardNumber of(final String idCardNumber) {
         try {
+            AssertTools.checkArgument(StringTools.isNotBlank(idCardNumber), "二代居民身份证校验失败：号码为空");
+            final String value = idCardNumber.toUpperCase();
+            final Matcher matcher = PatternConsts.CHINESE_2ND_ID_CARD_NUMBER.matcher(value);
+            AssertTools.checkArgument(matcher.matches(), () -> "二代居民身份证校验失败：" + value);
+
+            final String provinceCode = matcher.group("province");
+            AssertTools.checkArgument(Chinese2ndGenIDCardNumber.PROVINCE_CODES.containsKey(provinceCode));
+
+            final String cityCode = matcher.group("city");
+            final String countyCode = matcher.group("county");
+
             // 出生日期
             final String birthDateStr = matcher.group("birthDate");
-            birthDateValue = LocalDate.parse(birthDateStr, DATE_FORMATTER);
+            final LocalDate birthDate = LocalDate.parse(birthDateStr, DATE_FORMATTER);
 
             // 性别
             final int genderCode = Integer.parseInt(matcher.group("gender"));
-            genderValue = genderCode % 2 == 0 ? Gender.FEMALE : Gender.MALE;
+            final Gender gender = genderCode % 2 == 0 ? Gender.FEMALE : Gender.MALE;
+
+            return new Chinese2ndGenIDCardNumber(value, provinceCode, cityCode, countyCode, gender, birthDate);
+        }
+        catch (IllegalArgumentException e) {
+            throw e;
         }
         catch (Exception e) {
             throw new IllegalArgumentException(e);
         }
-
-        this.provinceCode = provinceCodeValue;
-        this.cityCode = cityCodeValue;
-        this.countyCode = countyCodeValue;
-        this.gender = genderValue;
-        this.birthDate = birthDateValue;
-    }
-
-    public static Chinese2ndGenIDCardNumber of(final String value) {
-        AssertTools.checkArgument(StringTools.isNotBlank(value), "二代居民身份证校验失败：号码为空");
-        return new Chinese2ndGenIDCardNumber(value);
     }
 
     // ================================
     // #region - reader methods
     // ================================
 
+    @Override
+    @ReaderMethod
+    public String value() {
+        return value;
+    }
+
     @ReaderMethod
     public String getProvinceCode() {
         return provinceCode;
@@ -157,13 +171,8 @@ public class Chinese2ndGenIDCardNumber
     // #endregion - reader methods
     // ================================
 
-    /**
-     * 省份代码表
-     */
-    public static final Map<String, String> PROVINCE_CODES;
-
-    static {
-        PROVINCE_CODES = ImmutableMap.<String, String>builder()
+    /** 省份代码表 */
+    public static final Map<String, String> PROVINCE_CODES = ImmutableMap.<String, String>builder()
             .put("11", "北京")
             .put("12", "天津")
             .put("13", "河北")
@@ -201,15 +210,33 @@ public class Chinese2ndGenIDCardNumber
             .put("83", "台湾") // 台湾身份证号码以83开头，但是行政区划为71
             .put("91", "国外")
             .build();
+
+    @SuppressWarnings("null")
+    @Override
+    public int compareTo(Chinese2ndGenIDCardNumber o) {
+        return value.compareTo(o.value);
     }
 
     @Override
     public int hashCode() {
-        return super.hashCode();
+        return Objects.hash(value);
     }
 
     @Override
     public boolean equals(@Nullable Object obj) {
-        return super.equals(obj);
+        if (this == obj) {
+            return true;
         }
+        if (!(obj instanceof Chinese2ndGenIDCardNumber)) {
+            return false;
+        }
+        Chinese2ndGenIDCardNumber other = (Chinese2ndGenIDCardNumber) obj;
+        return Objects.equals(value, other.value);
+    }
+
+    @Override
+    public String toString() {
+        return value();
+    }
+
 }