最近项目中需要给用户增加身份证号字段,参考了几位别人的实现。
特点:1、面向对象:把身份证号封装为一个类,解析各个字段、验证有效性都是对象上的实例方法。对比那种公开多个静态方法的工具类的方式,我觉得这种面向对象的方式更自然一些。
2、不可变的。身份证号对象是不可变的,减少使用中的复杂性。
3、不是线程安全的。
001 |
import java.text.SimpleDateFormat; |
002 |
import java.util.Date; |
005 |
* 身份证号码,可以解析身份证号码的各个字段,以及验证身份证号码是否有效<br> |
006 |
* 身份证号码构成:6位地址编码+8位生日+3位顺序码+1位校验码 |
011 |
public class IDCard { |
015 |
private final String cardNumber; |
016 |
// 缓存身份证是否有效,因为验证有效性使用频繁且计算复杂 |
017 |
private Boolean cacheValidateResult = null; |
018 |
// 缓存出生日期,因为出生日期使用频繁且计算复杂 |
019 |
private Date cacheBirthDate = null; |
021 |
public boolean validate() { |
022 |
if (null == cacheValidateResult) { |
023 |
boolean result = true; |
025 |
result = result && (null != cardNumber); |
027 |
result = result && NEW_CARD_NUMBER_LENGTH == cardNumber.length(); |
029 |
for (int i = 0; result && i < NEW_CARD_NUMBER_LENGTH - 1; i++) { |
030 |
char ch = cardNumber.charAt(i); |
031 |
result = result && ch >= '0' && ch <= '9'; |
035 |
&& (calculateVerifyCode(cardNumber) == cardNumber |
036 |
.charAt(NEW_CARD_NUMBER_LENGTH - 1)); |
037 |
// 出生日期不能晚于当前时间,并且不能早于1900年 |
039 |
Date birthDate = this.getBirthDate(); |
040 |
result = result && null != birthDate; |
041 |
result = result && birthDate.before(new Date()); |
042 |
result = result && birthDate.after(MINIMAL_BIRTH_DATE); |
044 |
* 出生日期中的年、月、日必须正确,比如月份范围是[1,12],日期范围是[1,31],还需要校验闰年、大月、小月的情况时, |
047 |
String birthdayPart = this.getBirthDayPart(); |
048 |
String realBirthdayPart = this.createBirthDateParser().format( |
050 |
result = result && (birthdayPart.equals(realBirthdayPart)); |
051 |
} catch (Exception e) { |
054 |
// TODO 完整身份证号码的省市县区检验规则 |
055 |
cacheValidateResult = Boolean.valueOf(result); |
057 |
return cacheValidateResult; |
061 |
* 如果是15位身份证号码,则自动转换为18位 |
065 |
public IDCard(String cardNumber) { |
066 |
if (null != cardNumber) { |
067 |
cardNumber = cardNumber.trim(); |
068 |
if (OLD_CARD_NUMBER_LENGTH == cardNumber.length()) { |
069 |
cardNumber = contertToNewCardNumber(cardNumber); |
072 |
this.cardNumber = cardNumber; |
075 |
public String getCardNumber() { |
079 |
public String getAddressCode() { |
081 |
return this.cardNumber.substring(0, 6); |
084 |
public Date getBirthDate() { |
085 |
if (null == this.cacheBirthDate) { |
087 |
this.cacheBirthDate = this.createBirthDateParser().parse( |
088 |
this.getBirthDayPart()); |
089 |
} catch (Exception e) { |
090 |
throw new RuntimeException("身份证的出生日期无效"); |
093 |
return new Date(this.cacheBirthDate.getTime()); |
096 |
public boolean isMale() { |
097 |
return 1 == this.getGenderCode(); |
100 |
public boolean isFemal() { |
101 |
return false == this.isMale(); |
105 |
* 获取身份证的第17位,奇数为男性,偶数为女性 |
109 |
private int getGenderCode() { |
111 |
char genderCode = this.cardNumber.charAt(NEW_CARD_NUMBER_LENGTH - 2); |
112 |
return (((int) (genderCode - '0')) & 0x1); |
115 |
private String getBirthDayPart() { |
116 |
return this.cardNumber.substring(6, 14); |
119 |
private SimpleDateFormat createBirthDateParser() { |
120 |
return new SimpleDateFormat(BIRTH_DATE_FORMAT); |
123 |
private void checkIfValid() { |
124 |
if (false == this.validate()) { |
125 |
throw new RuntimeException("身份证号码不正确!"); |
130 |
private final static String BIRTH_DATE_FORMAT = "yyyyMMdd"; |
131 |
// 身份证的最小出生日期,1900年1月1日 |
132 |
private final static Date MINIMAL_BIRTH_DATE = new Date(-2209017600000L); |
133 |
private final static int NEW_CARD_NUMBER_LENGTH = 18; |
134 |
private final static int OLD_CARD_NUMBER_LENGTH = 15; |
138 |
private final static char[] VERIFY_CODE = { '1', '0', 'X', '9', '8', '7', |
139 |
'6', '5', '4', '3', '2' }; |
141 |
* 18位身份证中,各个数字的生成校验码时的权值 |
143 |
private final static int[] VERIFY_CODE_WEIGHT = { 7, 9, 10, 5, 8, 4, 2, 1, |
144 |
6, 3, 7, 9, 10, 5, 8, 4, 2 }; |
147 |
* <li>校验码(第十八位数):<br/> |
149 |
* <li>十七位数字本体码加权求和公式 S = Sum(Ai * Wi), i = 0...16 ,先对前17位数字的权求和; |
150 |
* Ai:表示第i位置上的身份证号码数字值 Wi:表示第i位置上的加权因子 Wi: 7 9 10 5 8 4 2 1 6 3 7 9 10 5 8 4 |
152 |
* <li>计算模 Y = mod(S, 11)</li> |
153 |
* <li>通过模得到对应的校验码 Y: 0 1 2 3 4 5 6 7 8 9 10 校验码: 1 0 X 9 8 7 6 5 4 3 2</li> |
159 |
private static char calculateVerifyCode(CharSequence cardNumber) { |
161 |
for (int i = 0; i < NEW_CARD_NUMBER_LENGTH - 1; i++) { |
162 |
char ch = cardNumber.charAt(i); |
163 |
sum += ((int) (ch - '0')) * VERIFY_CODE_WEIGHT[i]; |
165 |
return VERIFY_CODE[sum % 11]; |
169 |
* 把15位身份证号码转换到18位身份证号码<br> |
170 |
* 15位身份证号码与18位身份证号码的区别为:<br> |
171 |
* 1、15位身份证号码中,"出生年份"字段是2位,转换时需要补入"19",表示20世纪<br> |
172 |
* 2、15位身份证无最后一位校验码。18位身份证中,校验码根据根据前17位生成 |
177 |
private static String contertToNewCardNumber(String oldCardNumber) { |
178 |
StringBuilder buf = new StringBuilder(NEW_CARD_NUMBER_LENGTH); |
179 |
buf.append(oldCardNumber.substring(0, 6)); |
181 |
buf.append(oldCardNumber.substring(6)); |
182 |
buf.append(IDCard.calculateVerifyCode(buf)); |
183 |
return buf.toString(); |