社会信用代码工具 - CreditCodeUtil

简介

法人和其他组织的统一社会信用代码相当于组织的“身份证号”，用于唯一标识一个法人实体或组织机构。社会信用代码由18位字符组成，包含登记管理部门代码、机构类别代码、行政区划码、主体标识码和校验码五个部分。

CreditCodeUtil 提供了统一社会信用代码的校验和随机生成功能，确保代码的合法性和格式正确性。

1. 社会信用代码的结构

1. 第一部分：登记管理部门代码，1位（数字或大写英文字母）。
2. 第二部分：机构类别代码，1位（数字或大写英文字母）。
3. 第三部分：登记管理机关行政区划码，6位（数字）。
4. 第四部分：主体标识码（组织机构代码），9位（数字或大写英文字母）。
5. 第五部分：校验码，1位（数字或大写英文字母）。

2. isCreditCode 方法

isCreditCode 方法用于校验给定的社会信用代码是否符合标准格式。它通过校验18位代码的结构、校验码是否正确，判断代码是否合法。

示例：校验社会信用代码

import cn.hutool.core.util.CreditCodeUtil;

public class CreditCodeUtilExample {
    public static void main(String[] args) {
        // 测试统一社会信用代码
        String testCreditCode = "91310110666007217T";

        // 校验社会信用代码是否合法
        boolean isValid = CreditCodeUtil.isCreditCode(testCreditCode);
        System.out.println("社会信用代码是否合法: " + isValid); // 结果：true
    }
}

• isCreditCode(String code)：校验统一社会信用代码是否合法。
  • code：要校验的社会信用代码。
  • 返回值：true 如果代码合法，false 如果代码不合法。

作用： 确保社会信用代码的格式和校验码正确，用于注册、验证等场景。

实际开发场景： 在系统中录入或查询组织机构信息时，可以使用此方法进行代码合法性校验，避免输入或存储无效的信用代码。

3. randomCreditCode 方法

randomCreditCode 方法用于生成一个随机且合法的社会信用代码，适用于测试环境或需要模拟信用代码的场景。

示例：随机生成社会信用代码

import cn.hutool.core.util.CreditCodeUtil;

public class CreditCodeUtilExample {
    public static void main(String[] args) {
        // 随机生成一个合法的社会信用代码
        String randomCode = CreditCodeUtil.randomCreditCode();
        System.out.println("随机生成的社会信用代码: " + randomCode);
    }
}

• randomCreditCode()：生成一个随机的合法社会信用代码。
  • 返回值：生成的社会信用代码字符串。

作用： 在测试或模拟环境下，生成随机的合法信用代码，确保数据完整性和合法性。

实际开发场景： 在进行系统测试、数据模拟时，可以使用此方法生成随机信用代码，便于测试数据的生成和验证。

4. 常见应用场景

1. 信用代码校验：在用户输入或导入数据时，快速判断社会信用代码是否符合国家标准，避免错误信息录入数据库。
2. 测试数据生成：在开发和测试过程中，生成随机的信用代码，用于验证系统处理逻辑或生成模拟数据。

总结

CreditCodeUtil 是一个专门用于处理法人和其他组织的统一社会信用代码的工具类，提供了代码合法性校验和随机生成的便捷方法。无论是在生产环境中进行数据校验，还是在测试环境中生成模拟数据，该工具类都能帮助开发者更高效地完成相关工作。