最近项目中需要给用户增加身份证号字段,参考了几位别人的实现。
特点: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(); |