新增 Chinese2ndGenIDCardNumber,由于中国第二代居民身份证号

dev
ZhouXY108 2024-10-12 00:23:03 +08:00
parent 538ad85124
commit ff472384fb
3 changed files with 256 additions and 0 deletions

View File

@ -0,0 +1,153 @@
package xyz.zhouxy.plusone.commons.model;
import java.time.LocalDate;
import java.time.format.DateTimeFormatter;
import java.time.format.DateTimeParseException;
import java.util.Map;
import java.util.regex.Matcher;
import java.util.regex.Pattern;
import com.google.common.base.Strings;
import com.google.common.collect.ImmutableMap;
/**
*
*/
public class Chinese2ndGenIDCardNumber extends IDCardNumber {
private static final long serialVersionUID = 20241011231542L;
/** 省份编码 */
private final String provinceCode;
/** 市级编码 */
private final String cityCode;
/** 县级编码 */
private final String countyCode;
/** 性别 */
private final Gender gender;
/** 出生日期 */
private final LocalDate birthDate;
public static final Pattern PATTERN = Pattern.compile("^(((\\d{2})\\d{2})\\d{2})(\\d{8})\\d{2}(\\d)(\\d|X|x)$");
private static final DateTimeFormatter DATE_FORMATTER = DateTimeFormatter.ofPattern("yyyyMMdd");
private Chinese2ndGenIDCardNumber(String idNumber) {
super(idNumber, PATTERN, "Invalid ID number");
try {
final Matcher matcher = getMatcher();
this.provinceCode = matcher.group(3);
this.cityCode = matcher.group(2);
this.countyCode = matcher.group(1);
// 性别
final String genderStr = matcher.group(5);
final int genderIndex = Integer.parseInt(genderStr);
this.gender = genderIndex % 2 == 0 ? Gender.FEMALE : Gender.MALE;
// 出生日期
final String birthDateStr = matcher.group(4);
this.birthDate = LocalDate.parse(birthDateStr, DATE_FORMATTER);
}
catch (DateTimeParseException e) {
throw new IllegalArgumentException(e);
}
}
public static Chinese2ndGenIDCardNumber of(String idNumber) {
return new Chinese2ndGenIDCardNumber(idNumber);
}
public String getProvinceCode() {
return provinceCode;
}
public String getProvinceName() {
return PROVINCE_CODES.get(this.provinceCode);
}
public String getFullProvinceCode() {
return Strings.padEnd(this.provinceCode, 12, '0');
}
public String getCityCode() {
return cityCode;
}
public String getFullCityCode() {
return Strings.padEnd(this.cityCode, 12, '0');
}
public String getCountyCode() {
return countyCode;
}
public String getFullCountyCode() {
return Strings.padEnd(this.countyCode, 12, '0');
}
@Override
public Gender getGender() {
return gender;
}
@Override
public LocalDate getBirthDate() {
return birthDate;
}
@Override
public int hashCode() {
return super.hashCode();
}
@Override
public boolean equals(Object obj) {
return super.equals(obj);
}
/**
*
*/
public static final Map<String, String> PROVINCE_CODES;
static {
PROVINCE_CODES = ImmutableMap.<String, String>builder()
.put("11", "北京")
.put("12", "天津")
.put("13", "河北")
.put("14", "山西")
.put("15", "内蒙古")
.put("21", "辽宁")
.put("22", "吉林")
.put("23", "黑龙江")
.put("31", "上海")
.put("32", "江苏")
.put("33", "浙江")
.put("34", "安徽")
.put("35", "福建")
.put("36", "江西")
.put("37", "山东")
.put("41", "河南")
.put("42", "湖北")
.put("43", "湖南")
.put("44", "广东")
.put("45", "广西")
.put("46", "海南")
.put("50", "重庆")
.put("51", "四川")
.put("52", "贵州")
.put("53", "云南")
.put("54", "西藏")
.put("61", "陕西")
.put("62", "甘肃")
.put("63", "青海")
.put("64", "宁夏")
.put("65", "新疆")
.put("71", "台湾")
.put("81", "香港")
.put("82", "澳门")
.put("83", "台湾") // 台湾身份证号码以83开头但是行政区划为71
.put("91", "国外")
.build();
}
}

View File

@ -0,0 +1,46 @@
package xyz.zhouxy.plusone.commons.model;
import java.time.LocalDate;
import java.time.Period;
import java.util.function.Supplier;
import java.util.regex.Pattern;
import javax.annotation.Nonnull;
/**
*
*/
public abstract class IDCardNumber extends ValidatableStringRecord {
private static final long serialVersionUID = 20241011231527L;
protected IDCardNumber(@Nonnull String idNumber, @Nonnull Pattern pattern)
throws IllegalArgumentException{
super(idNumber, pattern);
}
protected IDCardNumber(@Nonnull String idNumber, @Nonnull Pattern pattern,
@Nonnull String errorMessage) {
super(idNumber, pattern, errorMessage);
}
protected IDCardNumber(@Nonnull String idNumber, @Nonnull Pattern pattern,
@Nonnull Supplier<String> errorMessage) {
super(idNumber, pattern, errorMessage);
}
/**
*
*/
public abstract Gender getGender();
/**
*
*/
public abstract LocalDate getBirthDate();
/** 计算年龄 */
public final int calculateAge() {
LocalDate now = LocalDate.now();
return Period.between(getBirthDate(), now).getYears();
}
}

View File

@ -0,0 +1,57 @@
package xyz.zhouxy.plusone.commons.model;
import static org.junit.jupiter.api.Assertions.assertEquals;
import static org.junit.jupiter.api.Assertions.assertThrows;
import static org.junit.jupiter.api.Assertions.assertTrue;
import java.time.LocalDate;
import java.time.format.DateTimeParseException;
import java.util.regex.Matcher;
import org.junit.jupiter.api.Test;
import lombok.extern.slf4j.Slf4j;
@Slf4j
public class Chinese2ndGenIDCardNumberTests {
@Test
void testPattern() {
Matcher matcher = Chinese2ndGenIDCardNumber.PATTERN.matcher("11010520000101111X");
assertTrue(matcher.matches());
for (int i = 0; i < matcher.groupCount(); i++) {
log.info("{}: {}", i, matcher.group(i));
}
}
@Test
void test() throws CloneNotSupportedException {
Chinese2ndGenIDCardNumber idCardNumber = Chinese2ndGenIDCardNumber.of("11010520000101111X");
assertEquals("11010520000101111X", idCardNumber.value());
assertEquals(LocalDate.of(2000, 1, 1), idCardNumber.getBirthDate());
assertEquals(Gender.MALE, idCardNumber.getGender());
assertEquals("110105", idCardNumber.getCountyCode());
assertEquals("110105000000", idCardNumber.getFullCountyCode());
assertEquals("1101", idCardNumber.getCityCode());
assertEquals("110100000000", idCardNumber.getFullCityCode());
assertEquals("11", idCardNumber.getProvinceCode());
assertEquals("110000000000", idCardNumber.getFullProvinceCode());
assertEquals("北京", idCardNumber.getProvinceName());
assertThrows(IllegalArgumentException.class,
() -> Chinese2ndGenIDCardNumber.of("1101520000101111"));
assertThrows(IllegalArgumentException.class,
() -> Chinese2ndGenIDCardNumber.of("11010520002101111X"));
try {
Chinese2ndGenIDCardNumber.of("11010520002101111X");
}
catch (IllegalArgumentException e) {
log.error(e.getMessage(), e);
assertTrue(e.getCause() instanceof DateTimeParseException);
}
}
}