com.github.sylphlike.framework.utils.general.IdCardUtil Maven / Gradle / Ivy
package com.github.sylphlike.framework.utils.general;
import com.github.sylphlike.framework.utils.enums.DateEnums;
import com.github.sylphlike.framework.utils.validator.PatternPool;
import com.github.sylphlike.framework.utils.validator.Regular;
import com.github.sylphlike.framework.utils.validator.StrValidator;
import org.apache.commons.lang3.StringUtils;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import java.time.LocalDate;
import java.util.HashMap;
import java.util.Map;
import java.util.Objects;
import java.util.regex.Pattern;
/**
* 身份证相关工具类
* time 10/09/2020 18:19 星期四 (dd/MM/YYYY HH:mm)
*
email [email protected]
* @author Gopal.pan
* @version 1.0.0
*/
public class IdCardUtil {
private static final Logger LOGGER = LoggerFactory.getLogger(IdCardUtil.class);
/**
* 中国公民身份证号码最小长度。
*/
private static final int CHINA_ID_MIN_LENGTH = 15;
/**
* 中国公民身份证号码最大长度。
*/
private static final int CHINA_ID_MAX_LENGTH = 18;
/**
* 每位加权因子
*/
private static final int[] power = {7, 9, 10, 5, 8, 4, 2, 1, 6, 3, 7, 9, 10, 5, 8, 4, 2};
/**
* 省市代码表
*/
private static final Map CITY_CODES = new HashMap<>();
/**
* 台湾身份首字母对应数字
*/
private static final Map TW_FIRST_CODE = new HashMap<>();
/**
* 香港身份首字母对应数字
*/
private static final Map HK_FIRST_CODE = new HashMap<>();
static {
CITY_CODES.put("11", "北京");
CITY_CODES.put("12", "天津");
CITY_CODES.put("13", "河北");
CITY_CODES.put("14", "山西");
CITY_CODES.put("15", "内蒙古");
CITY_CODES.put("21", "辽宁");
CITY_CODES.put("22", "吉林");
CITY_CODES.put("23", "黑龙江");
CITY_CODES.put("31", "上海");
CITY_CODES.put("32", "江苏");
CITY_CODES.put("33", "浙江");
CITY_CODES.put("34", "安徽");
CITY_CODES.put("35", "福建");
CITY_CODES.put("36", "江西");
CITY_CODES.put("37", "山东");
CITY_CODES.put("41", "河南");
CITY_CODES.put("42", "湖北");
CITY_CODES.put("43", "湖南");
CITY_CODES.put("44", "广东");
CITY_CODES.put("45", "广西");
CITY_CODES.put("46", "海南");
CITY_CODES.put("50", "重庆");
CITY_CODES.put("51", "四川");
CITY_CODES.put("52", "贵州");
CITY_CODES.put("53", "云南");
CITY_CODES.put("54", "西藏");
CITY_CODES.put("61", "陕西");
CITY_CODES.put("62", "甘肃");
CITY_CODES.put("63", "青海");
CITY_CODES.put("64", "宁夏");
CITY_CODES.put("65", "新疆");
CITY_CODES.put("71", "台湾");
CITY_CODES.put("81", "香港");
CITY_CODES.put("82", "澳门");
CITY_CODES.put("91", "国外");
TW_FIRST_CODE.put("A", 10);
TW_FIRST_CODE.put("B", 11);
TW_FIRST_CODE.put("C", 12);
TW_FIRST_CODE.put("D", 13);
TW_FIRST_CODE.put("E", 14);
TW_FIRST_CODE.put("F", 15);
TW_FIRST_CODE.put("G", 16);
TW_FIRST_CODE.put("H", 17);
TW_FIRST_CODE.put("J", 18);
TW_FIRST_CODE.put("K", 19);
TW_FIRST_CODE.put("L", 20);
TW_FIRST_CODE.put("M", 21);
TW_FIRST_CODE.put("N", 22);
TW_FIRST_CODE.put("P", 23);
TW_FIRST_CODE.put("Q", 24);
TW_FIRST_CODE.put("R", 25);
TW_FIRST_CODE.put("S", 26);
TW_FIRST_CODE.put("T", 27);
TW_FIRST_CODE.put("U", 28);
TW_FIRST_CODE.put("V", 29);
TW_FIRST_CODE.put("X", 30);
TW_FIRST_CODE.put("Y", 31);
TW_FIRST_CODE.put("W", 32);
TW_FIRST_CODE.put("Z", 33);
TW_FIRST_CODE.put("I", 34);
TW_FIRST_CODE.put("O", 35);
//来自http://shenfenzheng.bajiu.cn/?rid=40
HK_FIRST_CODE.put("A", 1);// 持证人拥有香港居留权
HK_FIRST_CODE.put("B", 2);// 持证人所报称的出生日期或地点自首次登记以后，曾作出更改
HK_FIRST_CODE.put("C", 3);// 持证人登记领证时在香港的居留受到入境事务处处长的限制
HK_FIRST_CODE.put("N", 14);// 持证人所报的姓名自首次登记以后，曾作出更改
HK_FIRST_CODE.put("O", 15);// 持证人报称在香港、澳门及中国以外其他地区或国家出生
HK_FIRST_CODE.put("R", 18);// 持证人拥有香港入境权
HK_FIRST_CODE.put("U", 21);// 持证人登记领证时在香港的居留不受入境事务处处长的限制
HK_FIRST_CODE.put("W", 23);// 持证人报称在澳门地区出生
HK_FIRST_CODE.put("X", 24);// 持证人报称在中国大陆出生
HK_FIRST_CODE.put("Z", 26);// 持证人报称在香港出生
}
/**
* 是否有效身份证号
*
* @param idCard 身份证号，支持18位、15位和港澳台的10位
* @return 是否有效
*/
public static boolean isValidCard(String idCard) {
idCard = idCard.trim();
int length = idCard.length();
switch (length) {
case 18:// 18位身份证
return isValidCard18(idCard);
case 15:// 15位身份证
return isValidCard15(idCard);
case 10: {// 10位身份证，港澳台地区
String[] cardVal = isValidCard10(idCard);
return null != cardVal && "true".equals(cardVal[2]);
}
default:
return false;
}
}
/**
* 判断18位身份证的合法性
*
* 根据〖中华人民共和国国家标准GB11643-1999〗中有关公民身份号码的规定，公民身份号码是特征组合码，由十七位数字本体码和一位数字校验码组成。
* 排列顺序从左至右依次为：六位数字地址码，八位数字出生日期码，三位数字顺序码和一位数字校验码。
* 顺序码: 表示在同一地址码所标识的区域范围内，对同年、同月、同 日出生的人编定的顺序号，顺序码的奇数分配给男性，偶数分配 给女性。
* 第1、2位数字表示：所在省份的代码
* 第3、4位数字表示：所在城市的代码
* 第5、6位数字表示：所在区县的代码
* 第7~14位数字表示：出生年、月、日
* 第15、16位数字表示：所在地的派出所的代码
* 第17位数字表示性别：奇数表示男性，偶数表示女性
* 第18位数字是校检码，用来检验身份证的正确性。校检码可以是0~9的数字，有时也用x表示
* 第十八位数字(校验码)的计算方法为：
* 将前面的身份证号码17位数分别乘以不同的系数。从第一位到第十七位的系数分别为：7 9 10 5 8 4 2 1 6 3 7 9 10 5 8 4 2
* 将这17位数字和系数相乘的结果相加
* 用加出来和除以11，看余数是多少
* 余数只可能有0 1 2 3 4 5 6 7 8 9 10这11个数字。其分别对应的最后一位身份证的号码为1 0 X 9 8 7 6 5 4 3 2
* 通过上面得知如果余数是2，就会在身份证的第18位数字上出现罗马数字的Ⅹ。如果余数是10，身份证的最后一位号码就是2
*
* @param idCard 待验证的身份证
* @return 是否有效的18位身份证
*/
public static boolean isValidCard18(String idCard) {
Pattern citizenId = PatternPool.CITIZEN_ID;
if(citizenId.matcher(idCard).matches()){
if (idCard.length() == 18) {
try {
//校验生日
if (!StrValidator.isBirthday(idCard.substring(6, 14))) {
return false;
}
char[] charArray = idCard.toCharArray();
//前十七位加权因子
int[] idCardWi = {7, 9, 10, 5, 8, 4, 2, 1, 6, 3, 7, 9, 10, 5, 8, 4, 2};
//这是除以11后，可能产生的11位余数对应的验证码
String[] idCardY = {"1", "0", "X", "9", "8", "7", "6", "5", "4", "3", "2"};
int sum = 0;
for (int i = 0; i < idCardWi.length; i++) {
int current = Integer.parseInt(String.valueOf(charArray[i]));
int count = current * idCardWi[i];
sum += count;
}
char idCardLast = charArray[17];
int idCardMod = sum % 11;
if (idCardY[idCardMod].toUpperCase().equals(String.valueOf(idCardLast).toUpperCase())) {
return true;
} else {
LOGGER.info("【framework-utils】身份证验证错误,最后一位验证位应为[{}]",idCardY[idCardMod].toUpperCase());
return false;
}
} catch (Exception e) {
LOGGER.error("【framework-utils】身份证验证异常",e);
return false;
}
}
}
return false;
}
/**
* 验证15位身份编码是否合法
*
* @param idCard 身份编码
* @return 是否合法
*/
public static boolean isValidCard15(String idCard) {
if (CHINA_ID_MIN_LENGTH != idCard.length()) {
return false;
}
if (Regular.isMatch(PatternPool.NUMBERS, idCard)) {
// 省份
String proCode = idCard.substring(0, 2);
if (null == CITY_CODES.get(proCode)) {
return false;
}
//校验生日（两位年份，补充为19XX）
return StrValidator.isBirthday("19" + idCard.substring(6, 12));
} else {
return false;
}
}
/**
* 将15位身份证号码转换为18位
*
* @param idCard 15位身份编码
* @return 18位身份编码
*/
public static String convert15To18(String idCard) {
String retId = "";
String id17 = "";
int sum = 0;
int y = 0;
// 定义数组存放加权因子（weight factor）
int[] wf = { 7, 9, 10, 5, 8, 4, 2, 1, 6, 3, 7, 9, 10, 5, 8, 4, 2 };
// 定义数组存放校验码（check code）
String[] cc = { "1", "0", "X", "9", "8", "7", "6", "5", "4", "3", "2" };
if (idCard.length() != 15) {
return idCard;
}
// 加上两位年19
id17 = idCard.substring(0, 6) + "19" + idCard.substring(6);
// 十七位数字本体码加权求和
for (int i = 0; i < 17; i++) {
sum = sum + Integer.parseInt(id17.substring(i, i + 1)) * wf[i];
}
// 计算模
y = sum % 11;
// 通过模得到对应的校验码 cc[y]
retId = id17 + cc[y];
return retId;
}
/**
* 验证10位身份编码是否合法
*
* [0] - 台湾、澳门、香港 [1] - 性别(男M,女F,未知N) [2] - 是否合法(合法true,不合法false) 若不是身份证件号码则返回null
* @param idCard 身份编码
* @return 身份证信息数组
*
*/
public static String[] isValidCard10(String idCard) {
if (StringUtils.isBlank(idCard)) {
return null;
}
String[] info = new String[3];
String card = idCard.replaceAll("[()]", "");
if (card.length() != 8 && card.length() != 9 && idCard.length() != 10) {
return null;
}
if (idCard.matches("^[a-zA-Z][0-9]{9}$")) { // 台湾
info[0] = "台湾";
char char2 = idCard.charAt(1);
if ('1' == char2) {
info[1] = "M";
} else if ('2' == char2) {
info[1] = "F";
} else {
info[1] = "N";
info[2] = "false";
return info;
}
info[2] = isValidTWCard(idCard) ? "true" : "false";
} else if (idCard.matches("^[157][0-9]{6}\\(?[0-9A-Z]\\)?$")) { // 澳门
info[0] = "澳门";
info[1] = "N";
} else if (idCard.matches("^[A-Z]{1,2}[0-9]{6}\\(?[0-9A]\\)?$")) { // 香港
info[0] = "香港";
info[1] = "N";
info[2] = isValidHKCard(idCard) ? "true" : "false";
} else {
return null;
}
return info;
}
/**
* 验证台湾身份证号码
*
* @param idCard 身份证号码
* @return 验证码是否符合
*/
public static boolean isValidTWCard(String idCard) {
if (StringUtils.isEmpty(idCard)) {
return false;
}
String start = idCard.substring(0, 1);
Integer iStart = TW_FIRST_CODE.get(start);
if (null == iStart) {
return false;
}
String mid = idCard.substring(1, 9);
String end = idCard.substring(9, 10);
int sum = iStart / 10 + (iStart % 10) * 9;
final char[] chars = mid.toCharArray();
int iflag = 8;
for (char c : chars) {
sum += Integer.parseInt(String.valueOf(c)) * iflag;
iflag--;
}
return (sum % 10 == 0 ? 0 : (10 - sum % 10)) == Integer.parseInt(end);
}
/**
* 验证香港身份证号码(存在Bug，部份特殊身份证无法检查)
*
*
身份证前2位为英文字符，如果只出现一个英文字符则表示第一位是空格，对应数字58 前2位英文字符A-Z分别对应数字10-35 最后一位校验码为0-9的数字加上字符"A"，"A"代表10将身份证号码全部转换为数字，分别对应乘9-1相加的总和，整除11则证件号码有效
* @param idCard 身份证号码
* @return 验证码是否符合
*/
public static boolean isValidHKCard(String idCard) {
String card = idCard.replaceAll("[()]", "");
int sum;
if (card.length() == 9) {
sum = (Character.toUpperCase(card.charAt(0)) - 55) * 9 + (Character.toUpperCase(card.charAt(1)) - 55) * 8;
card = card.substring(1, 9);
} else {
sum = 522 + (Character.toUpperCase(card.charAt(0)) - 55) * 8;
}
String start = idCard.substring(0, 1);
Integer iStart = HK_FIRST_CODE.get(start);
if (null == iStart) {
return false;
}
String mid = card.substring(1, 7);
String end = card.substring(7, 8);
char[] chars = mid.toCharArray();
int iflag = 7;
for (char c : chars) {
sum = sum + Integer.parseInt(String.valueOf(c)) * iflag;
iflag--;
}
if ("A".equals(end.toUpperCase())) {
sum += 10;
} else {
sum += Integer.parseInt(end);
}
return sum % 11 == 0;
}
/**
* 根据身份编号获取生日，只支持15或18位身份证号码
*
* @param idCard 身份编号
* @return 生日(yyyyMMdd)
* @see #getBirth(String)
*/
public static String getBirthByIdCard(String idCard) {
return getBirth(idCard);
}
/**
* 根据身份编号获取生日，只支持15或18位身份证号码
*
* @param idCard 身份编号
* @return 生日(yyyyMMdd)
*/
public static String getBirth(String idCard) {
final int len = idCard.length();
if (len < CHINA_ID_MIN_LENGTH) {
return null;
} else if (len == CHINA_ID_MIN_LENGTH) {
idCard = convert15To18(idCard);
}
return Objects.requireNonNull(idCard).substring(6, 14);
}
/**
* 从身份证号码中获取生日日期，只支持15或18位身份证号码
*
* @param idCard 身份证号码
* @return 日期
*/
public static LocalDate getBirthDate(String idCard) {
final String birthByIdCard = getBirthByIdCard(idCard);
return null == birthByIdCard ? null : DateUtils.string2Date(birthByIdCard, DateEnums.yyyyMMdd.getPatterns());
}
/**
* 根据身份编号获取年龄，只支持15或18位身份证号码
*
* @param idCard 身份编号
* @return 年龄
*/
public static int getAgeByIdCard(String idCard) {
return getAgeByIdCard(idCard, LocalDate.now());
}
/**
* 根据身份编号获取指定日期当时的年龄年龄，只支持15或18位身份证号码
*
* @param idCard 身份编号
* @param dateToCompare 以此日期为界，计算年龄。
* @return 年龄
*/
public static int getAgeByIdCard(String idCard, LocalDate dateToCompare) {
String birth = getBirthByIdCard(idCard);
return DateUtils.dateToCompareYear(Objects.requireNonNull(DateUtils.string2Date(birth, DateEnums.yyyyMMdd.getPatterns())),dateToCompare,true);
}
/**
* 根据身份编号获取生日年，只支持15或18位身份证号码
*
* @param idCard 身份编号
* @return 生日(yyyy)
*/
public static Short getYearByIdCard(String idCard) {
final int len = idCard.length();
if (len < CHINA_ID_MIN_LENGTH) {
return null;
} else if (len == CHINA_ID_MIN_LENGTH) {
idCard = convert15To18(idCard);
}
return Short.valueOf(Objects.requireNonNull(idCard).substring(6, 10));
}
/**
* 根据身份编号获取生日月，只支持15或18位身份证号码
*
* @param idCard 身份编号
* @return 生日(MM)
*/
public static Short getMonthByIdCard(String idCard) {
final int len = idCard.length();
if (len < CHINA_ID_MIN_LENGTH) {
return null;
} else if (len == CHINA_ID_MIN_LENGTH) {
idCard = convert15To18(idCard);
}
return Short.valueOf(Objects.requireNonNull(idCard).substring(10, 12));
}
/**
* 根据身份编号获取生日天，只支持15或18位身份证号码
*
* @param idCard 身份编号
* @return 生日(dd)
*/
public static Short getDayByIdCard(String idCard) {
final int len = idCard.length();
if (len < CHINA_ID_MIN_LENGTH) {
return null;
} else if (len == CHINA_ID_MIN_LENGTH) {
idCard = convert15To18(idCard);
}
return Short.valueOf(Objects.requireNonNull(idCard).substring(12, 14));
}
/**
* 根据身份编号获取性别，只支持15或18位身份证号码
*
* @param idCard 身份编号
* @return 性别(1 : 男 ， 0 : 女)
*/
public static int getGenderByIdCard(String idCard) {
final int len = idCard.length();
if (len < CHINA_ID_MIN_LENGTH) {
throw new IllegalArgumentException("ID Card length must be 15 or 18");
}
if (len == CHINA_ID_MIN_LENGTH) {
idCard = convert15To18(idCard);
}
char sCardChar = Objects.requireNonNull(idCard).charAt(16);
return (sCardChar % 2 != 0) ? 1 : 0;
}
/**
* 根据身份编号获取户籍省份，只支持15或18位身份证号码
*
* @param idCard 身份编码
* @return 省级编码。
*/
public static String getProvinceByIdCard(String idCard) {
int len = idCard.length();
if (len == CHINA_ID_MIN_LENGTH || len == CHINA_ID_MAX_LENGTH) {
String sProvinNum = idCard.substring(0, 2);
return CITY_CODES.get(sProvinNum);
}
return null;
}
// ----------------------------------------------------------------------------------- Private method start
/**
* 获得18位身份证校验码
*
* @param code17 18位身份证号中的前17位
* @return 第18位
*/
private static char getCheckCode18(String code17) {
int sum = getPowerSum(code17.toCharArray());
return getCheckCode18(sum);
}
/**
* 将power和值与11取模获得余数进行校验码判断
*
* @param iSum 加权和
* @return 校验位
*/
private static char getCheckCode18(int iSum) {
switch (iSum % 11) {
case 10:
return '2';
case 9:
return '3';
case 8:
return '4';
case 7:
return '5';
case 6:
return '6';
case 5:
return '7';
case 4:
return '8';
case 3:
return '9';
case 2:
return 'x';
case 1:
return '0';
case 0:
return '1';
default:
return ' ';
}
}
/**
* 将身份证的每位和对应位的加权因子相乘之后，再得到和值
*
* @param iArr 身份证号码的数组
* @return 身份证编码
*/
private static int getPowerSum(char[] iArr) {
int iSum = 0;
if (power.length == iArr.length) {
for (int i = 0; i < iArr.length; i++) {
iSum += Integer.parseInt(String.valueOf(iArr[i])) * power[i];
}
}
return iSum;
}
}