使用Spring Boot实现居民身份证合法性验证

琴剑飘零西复东2024-07-23 9:01

使用Spring Boot实现居民身份证合法性验证

在现代社会中，身份证号码的合法性验证是很多系统中不可或缺的一部分。身份证号码用于确认个人身份，其格式和校验机制各不相同。本文将介绍如何使用Spring Boot构建一个通用控制器，通过API来验证中国大陆、台湾、澳门和香港居民的身份证号码合法性。

代码概述

本文的核心代码是一个Spring Boot控制器CommonController，它提供了一个API用于验证身份证号码的合法性。以下是该控制器的完整代码：

java 复制代码 
@SuppressWarnings("AlibabaUndefineMagicConstant")
@Tag(name = "通用控制器", description = "通用控制器")
@RestController
@RequestMapping("/common")
public class CommonController {

    @Autowired
    private ICommonService commonService;

    /**
     * 每一位的权重
     */
    private static final int[] WEIGHT = {7, 9, 10, 5, 8, 4, 2, 1, 6, 3, 7, 9, 10, 5, 8, 4, 2};
    /**
     * 校验码对应表
     */
    private static final char[] CHECK_CODE = {'1', '0', 'X', '9', '8', '7', '6', '5', '4', '3', '2'};

    /**
     * 正则表达式匹配澳门身份证号码
     */
    private static final Pattern MACAU_ID_PATTERN = Pattern.compile("[1|5|7][0-9]{6}\\(?[0-9A-Z]\\)?");

    /**
     * 居民身份证合法性验证
     *
     * @param idCard 身份证号码
     * @return ValidationResultModel
     */
    @Operation(summary = "居民身份证合法性验证", description = "居民身份证合法性验证")
    @Parameter(name = "idCard", description = "居民身份证号码", required = true, in = ParameterIn.QUERY)
    @GetMapping("/validateID")
    public ApiResult<ValidationResultModel> validateIdCard(@RequestParam("idCard") String idCard) throws ParseException {
        IDCardType idCardType = determineIdCardType(idCard);
        switch (idCardType) {
            case MAINLAND:
                return validateMainlandId(idCard);
            case TAIWAN:
                return validateTaiwanId(idCard);
            case MACAU:
                return validateMacauId(idCard);
            case HONGKONG:
                return validateHongKongId(idCard);
            default:
                ValidationResultModel invalid = new ValidationResultModel();
                invalid.setValid(false);
                invalid.setMessage("身份证件号码无效，请仔细核对后重新输入！");
                return ApiResult.ok(invalid);
        }
    }

    private IDCardType determineIdCardType(String idCard) {
        if (idCard.matches("[1-9][0-9]{5}(19[0-9]{2}|20[0-9]{2})(0[1-9]|1[0-2])(0[1-9]|[12][0-9]|3[01])[0-9]{3}[0-9Xx]")) {
            return IDCardType.MAINLAND;
        } else if (idCard.matches("[A-Z][0-9]{9}")) {
            return IDCardType.TAIWAN;
        } else if (idCard.matches("[1|5|7][0-9]{6}\\(?[0-9A-Z]\\)?")) {
            return IDCardType.MACAU;
        } else if (idCard.matches("[A-Z]{1,2}[0-9]{6}\\(?[0-9A]\\)?")) {
            return IDCardType.HONGKONG;
        } else {
            return IDCardType.UNKNOWN;
        }
    }

    enum IDCardType {
        MAINLAND,
        TAIWAN,
        MACAU,
        HONGKONG,
        UNKNOWN
    }

    private static char getCheckCode(String idCard17) {
        int sum = 0;
        for (int i = 0; i < 17; i++) {
            sum += (idCard17.charAt(i) - '0') * WEIGHT[i];
        }
        return CHECK_CODE[sum % 11];
    }

    public boolean validateTaiwanId(String id) {
        if (id == null || !id.matches("[A-Z][0-9]{9}")) {
            return false;
        }

        char letter = id.charAt(0);
        int letterValue = LETTER_TO_NUMBER_MAP.get(letter);

        int letter1 = letterValue / 10;
        int letter2 = letterValue % 10;

        int sum = letter1 + letter2 * 9;
        int[] weights = {8, 7, 6, 5, 4, 3, 2, 1};
        for (int i = 0; i < 8; i++) {
            sum += Character.getNumericValue(id.charAt(i + 1)) * weights[i];
        }
        sum += Character.getNumericValue(id.charAt(9));
        return sum % 10 == 0;
    }

    private static final Map<Character, Integer> LETTER_TO_NUMBER_MAP = new HashMap<>();

    static {
        LETTER_TO_NUMBER_MAP.put('A', 10);
        LETTER_TO_NUMBER_MAP.put('B', 11);
        LETTER_TO_NUMBER_MAP.put('C', 12);
        LETTER_TO_NUMBER_MAP.put('D', 13);
        LETTER_TO_NUMBER_MAP.put('E', 14);
        LETTER_TO_NUMBER_MAP.put('F', 15);
        LETTER_TO_NUMBER_MAP.put('G', 16);
        LETTER_TO_NUMBER_MAP.put('H', 17);
        LETTER_TO_NUMBER_MAP.put('J', 18);
        LETTER_TO_NUMBER_MAP.put('K', 19);
        LETTER_TO_NUMBER_MAP.put('L', 20);
        LETTER_TO_NUMBER_MAP.put('M', 21);
        LETTER_TO_NUMBER_MAP.put('N', 22);
        LETTER_TO_NUMBER_MAP.put('P', 23);
        LETTER_TO_NUMBER_MAP.put('Q', 24);
        LETTER_TO_NUMBER_MAP.put('R', 25);
        LETTER_TO_NUMBER_MAP.put('S', 26);
        LETTER_TO_NUMBER_MAP.put('T', 27);
        LETTER_TO_NUMBER_MAP.put('U', 28);
        LETTER_TO_NUMBER_MAP.put('V', 29);
        LETTER_TO_NUMBER_MAP.put('W', 30);
        LETTER_TO_NUMBER_MAP.put('X', 31);
        LETTER_TO_NUMBER_MAP.put('Y', 32);
        LETTER_TO_NUMBER_MAP.put('Z', 33);
    }

    public static boolean validateMacauId(String id) {
        if (id == null || !MACAU_ID_PATTERN.matcher(id).matches()) {
            return false;
        }

        int[] weights = {8, 7, 6, 5, 4, 3, 2, 1};
        int sum = 0;
        for (int i = 0; i < 7; i++) {
            char c = id.charAt(i);
            sum += Character.getNumericValue(c) * weights[i];
        }

        char checkChar = id.charAt(7);
        int checkCode;
        if (checkChar == 'A') {
            checkCode = 10;
        } else {
            checkCode = Character.getNumericValue(checkChar);
        }

        return (sum + checkCode) % 11 == 0;
    }

    public static boolean validateHongKongId(String id) {
        if (id == null || !id.matches("[A-Z]{1,2}[0-9]{6}\\(?[0-9A]\\)?")) {
            return false;
        }
        id = id.replace("(", "").replace(")", "");

        if (id.length() == 8) {
            id = " " + id;
        }

        if (id.length() != 9) {
            return false;
        }

        int[] weights = {9, 8, 7, 6, 5, 4, 3, 2, 1};
        int total = 0;
        for (int i = 0; i < 9; i++) {
            total += charToValue(id.charAt(i)) * weights[i];
        }

        int remainder = total % 11;
        char checkDigit = id.charAt(id.length() - 1);

        if (remainder == 0) {
            return checkDigit == '0';
        } else if (remainder == 1) {
            return Character.toUpperCase(checkDigit) == 'A';
        } else {
            return checkDigit == Character.forDigit(11 - remainder, 10);
        }
    }

    private static int charToValue(char c) {
        if (c == ' ') {
            return 36;
        } else if (Character.isLetter(c)) {
            return Character.toUpperCase(c) - 55;
        } else {
            return Character.getNumericValue(c);
        }
    }
}

功能解析

1. 主要组件

注解
  • @Tag：用于Swagger文档生成，定义了控制器的名称和描述。
  • @RestController：表明该类是一个控制器，并且每个方法都会返回一个对象，这些对象会自动转换为JSON格式。
  • @RequestMapping：定义了基础路径为/common，即所有的请求都以该

路径为前缀。

自动注入
  • @Autowired：自动注入了一个服务接口ICommonService，用于业务逻辑的处理。

2. 常量

身份证校验相关常量
  • WEIGHT：大陆居民身份证每位数字的权重，用于校验码计算。
  • CHECK_CODE：校验码对照表，根据前17位的计算结果获取校验码。
  • MACAU_ID_PATTERN：用于匹配澳门身份证号码的正则表达式。

3. 方法

validateIdCard
  • 接收一个身份证号码，并根据其类型调用相应的校验方法。
  • 校验类型包括大陆、台湾、澳门、香港的身份证号码。
determineIdCardType
  • 根据身份证号码的格式判断其类型（大陆、台湾、澳门、香港、未知）。

4. 身份证校验方法

  • getCheckCode：计算大陆居民身份证前17位的校验码。
  • validateTaiwanId：校验台湾身份证号码是否合法。
  • validateMacauId：校验澳门身份证号码是否合法。
  • validateHongKongId：校验香港身份证号码是否合法。

详细说明

居民身份证合法性验证

大陆身份证

大陆居民身份证号码为18位数字，前17位为出生日期、地区代码等信息，第18位为校验码。校验码根据前17位数字计算得出：

java 复制代码 
private static char getCheckCode(String idCard17) {
    int sum = 0;
    for (int i = 0; i < 17; i++) {
        sum += (idCard17.charAt(i) - '0') * WEIGHT[i];
    }
    return CHECK_CODE[sum % 11];
}
台湾身份证

台湾身份证号码为10位，第一位为字母，表示地区，后9位为数字。校验时需要将字母转换为对应的数字，并根据特定权重计算总和：

java 复制代码 
public boolean validateTaiwanId(String id) {
    if (id == null || !id.matches("[A-Z][0-9]{9}")) {
        return false;
    }

    char letter = id.charAt(0);
    int letterValue = LETTER_TO_NUMBER_MAP.get(letter);

    int letter1 = letterValue / 10;
    int letter2 = letterValue % 10;

    int sum = letter1 + letter2 * 9;
    int[] weights = {8, 7, 6, 5, 4, 3, 2, 1};
    for (int i = 0; i < 8; i++) {
        sum += Character.getNumericValue(id.charAt(i + 1)) * weights[i];
    }
    sum += Character.getNumericValue(id.charAt(9));
    return sum % 10 == 0;
}
澳门身份证

澳门身份证号码为9位，前7位为数字，第8位为校验码。需要根据特定权重计算校验码：

java 复制代码 
public static boolean validateMacauId(String id) {
    if (id == null || !MACAU_ID_PATTERN.matcher(id).matches()) {
        return false;
    }

    int[] weights = {8, 7, 6, 5, 4, 3, 2, 1};
    int sum = 0;
    for (int i = 0; i < 7; i++) {
        char c = id.charAt(i);
        sum += Character.getNumericValue(c) * weights[i];
    }

    char checkChar = id.charAt(7);
    int checkCode;
    if (checkChar == 'A') {
        checkCode = 10;
    } else {
        checkCode = Character.getNumericValue(checkChar);
    }

    return (sum + checkCode) % 11 == 0;
}
香港身份证

香港身份证号码由8或9位组成，前1-2位为字母，后6位为数字，最后一位为校验码。需要根据特定权重计算校验码：

java 复制代码 
public static boolean validateHongKongId(String id) {
    if (id == null || !id.matches("[A-Z]{1,2}[0-9]{6}\\(?[0-9A]\\)?")) {
        return false;
    }
    id = id.replace("(", "").replace(")", "");

    if (id.length() == 8) {
        id = " " + id;
    }

    if (id.length() != 9) {
        return false;
    }

    int[] weights = {9, 8, 7, 6, 5, 4, 3, 2, 1};
    int total = 0;
    for (int i = 0; i < 9; i++) {
        total += charToValue(id.charAt(i)) * weights[i];
    }

    int remainder = total % 11;
    char checkDigit = id.charAt(id.length() - 1);

    if (remainder == 0) {
        return checkDigit == '0';
    } else if (remainder == 1) {
        return Character.toUpperCase(checkDigit) == 'A';
    } else {
        return checkDigit == Character.forDigit(11 - remainder, 10);
    }
}

总结

本文介绍了如何使用Spring Boot构建一个通用控制器，通过API来验证中国大陆、台湾、澳门和香港居民的身份证号码合法性。通过具体的代码示例，详细解释了不同地区身份证号码的校验逻辑。希望这篇文章对您在实际开发中有所帮助。

相关推荐
李小白665 分钟前
Spring MVC(上)
java·spring·mvc
GoodStudyAndDayDayUp18 分钟前
IDEA能够从mapper跳转到xml的插件
xml·java·intellij-idea
蓝天星空27 分钟前
Python调用open ai接口
人工智能·python
jasmine s36 分钟前
Pandas
开发语言·python
郭wes代码36 分钟前
Cmd命令大全（万字详细版）
python·算法·小程序
装不满的克莱因瓶1 小时前
【Redis经典面试题六】Redis的持久化机制是怎样的？
java·数据库·redis·持久化·aof·rdb
leaf_leaves_leaf1 小时前
win11用一条命令给anaconda环境安装GPU版本pytorch，并检查是否为GPU版本
人工智能·pytorch·python
n北斗1 小时前
常用类晨考day15
java
夜雨飘零11 小时前
基于Pytorch实现的说话人日志（说话人分离）
人工智能·pytorch·python·声纹识别·说话人分离·说话人日志
骇客野人1 小时前
【JAVA】JAVA接口公共返回体ResponseData封装
java·开发语言
热门推荐
01〔AI 绘画〕Stable Diffusion 之 解决绘制多人或面部很小的人物时面部崩坏问题 篇02YOLOv8训练好模型后，追加轮数继续训练、或者提前终止训练，缩减训练轮数03玄机平台应急响应—webshell查杀04机器人编程怎么入门？05HCIA-datacom数通题库和录播视频资料06Docker 夺命连环 15 问07SQL 主从数据库实时备份08校验 GPT-4 真实性的三个经典问题：快速区分 GPT-3.5 与 GPT-4，并提供免费测试网站09(欧拉)openEuler系统添加网卡文件配置流程、(欧拉)openEuler系统手动配置ipv6地址流程、(欧拉)openEuler系统网络管理说明10VSCode插件 —— Cody AI （免费AI助手！）