需要說明的是這裡的大陸身份證識別並不是公安局聯網的識別,而是按國標GB 11643進行的驗證,所以其驗證結果只能說符合國標規範,但不能保證該身份證一定真實存在,如果你實際需求是希望身份證一定真實存在,那麼你可以在通過此類庫初步驗證後,再調用第三方(或牛逼的可以直連公安,畢竟所有的第三方其數據來源必定 ...
需要說明的是這裡的大陸身份證識別並不是公安局聯網的識別,而是按國標GB 11643進行的驗證,所以其驗證結果只能說符合國標規範,但不能保證該身份證一定真實存在,如果你實際需求是希望身份證一定真實存在,那麼你可以在通過此類庫初步驗證後,再調用第三方(或牛逼的可以直連公安,畢竟所有的第三方其數據來源必定是公安局)以降低調用成本(公安調用一次兩塊錢,還不是有錢就能調用!!!)
轉到正題,在NumberValidators中,大陸身份證相關的代碼均在NumberValidators.IdentityCards下,具體的驗證實現為:ID18Validator(第二代身份證,長度為18),ID15Validator(第一代身份證,長度為15),而IDValidatorHelper則為所有實現了IIDValidator(身份證識別介面)且完全按照 ID{Length}Validator 格式命名的身份證識別自動適配靜態類(Length為證件號碼長度),除基礎的驗證外,還提供了TryPromotion方法(一代身份證升位成二代身份證)
IIDValidator(身份證識別介面)定義如下
/// <summary> /// 所有號碼驗證類均需實現的基礎介面定義 /// </summary> /// <typeparam name="T"></typeparam> public interface IValidator<out T> where T : ValidationResult, new() { /// <summary> /// 隨機生成一個符合規則的號碼 /// </summary> /// <returns></returns> string GenerateRandomNumber(); /// <summary> /// 驗證號碼是否正確 /// </summary> /// <param name="number"></param> /// <returns></returns> T Validate(string number); } /// <summary> /// 身份證驗證介面 /// </summary> public interface IIDValidator : IValidator<IDValidationResult> { /// <summary> /// 用於驗證的字典數據 /// </summary> IValidationDictionary<int, string> Dictionary { get; set; } /// <summary> /// 生成身份證號碼 /// </summary> /// <param name="areaNumber">行政區劃編號</param> /// <param name="birthDay">出生日期</param> /// <param name="sequenceNumber">順序號</param> /// <returns></returns> string GenerateID(int areaNumber, DateTime birthDay, int sequenceNumber); /// <summary> /// 驗證身份證是否正確 /// </summary> /// <param name="idNumber">待驗證的證件號碼</param> /// <param name="minYear">允許最小年份,預設0</param> /// <param name="validLimit">驗證區域級別,預設AreaValidLimit.Province</param> /// <param name="ignoreCheckBit">是否忽略校驗位驗證,預設false</param> /// <returns>驗證結果</returns> IDValidationResult Validate(string idNumber, ushort minYear = 0, AreaValidLimit validLimit = AreaValidLimit.Province, bool ignoreCheckBit = false); }
驗證結果IDValidationResult定義如下
/// <summary> /// 號碼驗證結果類 /// </summary> public class ValidationResult { /// <summary> /// 驗證結果是否通過 /// </summary> public bool IsValid { get; internal set; } = true; /// <summary> /// 如果驗證不通過,這裡包含驗證失敗的原因 /// </summary> public IList<string> Errors { get; internal set; } = new List<string>(); /// <summary> /// 當前驗證的號碼 /// </summary> public string Number { get; internal set; } /// <summary> /// 添加錯誤信息 /// </summary> /// <param name="errorMsg"></param> /// <param name="parameters"></param> internal void AddErrorMessage(string errorMsg, params object[] parameters) { if (parameters != null && parameters.Length > 0) { errorMsg = string.Format(errorMsg, parameters); } this.Errors.Add(errorMsg); this.IsValid = false; } } /// <summary> /// 身份證驗證結果類 /// </summary> public class IDValidationResult : ValidationResult { /// <summary> /// 身份證號碼長度 /// </summary> public IDLength IDLength { get; internal set; } /// <summary> /// 身份證上的出生日期 /// </summary> public DateTime Birthday { get; internal set; } /// <summary> /// 性別 /// </summary> public Gender Gender { get; internal set; } /// <summary> /// 行政區劃編碼 /// </summary> public int AreaNumber { get; internal set; } /// <summary> /// 身份證頒發行政區域(識別出Depth最深的區域),可通過FullName來獲取完整的區功能變數名稱 /// </summary> public Area RecognizableArea { get; internal set; } /// <summary> /// 出生登記順序號 /// </summary> public int Sequence { get; internal set; } /// <summary> /// 身份證校驗碼 /// </summary> public char CheckBit { get; internal set; } }
可以根據 IsValid 屬性來判斷是否驗證通過(true/false),如果驗證失敗,Errors 屬性則包含了驗證失敗的原因,具體的錯誤原因列表如下
/// <summary> /// 身份證號碼為空 /// </summary> public const string Empty = "身份證號碼為空"; /// <summary> /// 錯誤的身份證號碼 /// </summary> public const string Error = "錯誤的身份證號碼"; /// <summary> /// 無效的出生日期 /// </summary> public const string InvalidBirthday = "無效的出生日期"; /// <summary> /// 出生日期超出允許的年份範圍 /// </summary> public const string BirthdayYearOutOfRange = "出生日期超出允許的年份範圍{0} ~ {1}"; /// <summary> /// 行政區劃識別失敗 /// </summary> public const string InvalidArea = "行政區劃識別失敗"; /// <summary> /// 行政區劃識別度不足 /// </summary> public const string AreaLimitOutOfRange = "行政區劃識別度低於識別級別 {0}"; /// <summary> /// 錯誤的校驗碼 /// </summary> public const string InvalidCheckBit = "錯誤的校驗碼"; /// <summary> /// 無效實現 /// </summary> public const string InvalidImplement = "未能找到或無效的 {0} 位身份證實現"; /// <summary> /// 長度錯誤 /// </summary> public const string LengthOutOfRange = "身份證號碼非 {0} 位";
而驗證通過時,你可以通過通過其它屬性來獲取一些你可能感興趣的信息,比如 Birthday(出生日期)、Gender(性別)、RecognizableArea(識別出的完整區域,你可以通過其FullName獲取完整的行政區功能變數名稱稱,比如 上海市市轄區徐匯區)等等……
在身份證識別中,最困難的地方在於行政區劃數據整理,而早期的行政區劃數據就目前個人而言完全無法獲取,所以目前提供用於驗證的行政區劃數據是基於GBT2260的2013版本,有興趣的可以去http://www.stats.gov.cn/tjsj/tjbz/xzqhdm/查閱(很遺憾,目前該部分已不再開放,直接返回無許可權了,之所以這裡還附上地址,只能說可能以後該部分還會開放吧),一代身份證登記時用的是1984年的版本,而在其之後到現在為止,每年都會有行政區域發生調整,所以如果字典數據不全,用目前預設提供的2013版本字典的話,那麼要想保證驗證的準確性,那麼只能判斷到行政省的級別(目前還沒出現過省級行政區劃的變化調整),當然假設也許有人可以弄到所有的行政區劃字典(廢棄的行政區劃編號不會再納入使用,所以可以保證行政區劃編號永久唯一),或者你希望驗證的身份證僅屬於某些行政區域,那麼可以將新的字典賦給 IIDValidator 的 Dictionary 屬性來達到全區域驗證或特定區域驗證的效果。
上面啰嗦了那麼多都還沒到怎麼使用,其實驗證非常簡單,就一個Validate方法,如果你僅需要驗證二代18位身份證的話,那麼你可以只使用 ID18Validator,同理如果你只需要驗證一代15位身份證也只需要使用ID15Validator(一般不可能會有這種情況,畢竟目前為止一代身份證基本都不被認可,且還在有效期內的應該也為數不多了),當然為了方便使用,你也可以直接使用IDValidatorHelper來進行一個簡單的快速調用(這裡需要說明的是反射創建的具體驗證實例是會被緩存在記憶體中的,所以這裡性能問題基本可以忽略,但這時你就不能通過字典賦值方式來完善或調整驗證結果),所以你可以通過以下幾種方式進行驗證
string id = "32021919900101003X"; var valid = new ID15Validator().Validate(id); valid = new ID18Validator() { //按需對Dictionary賦值 }.Validate(id); valid = IDValidatorHelper.Validate(id);
註意這裡的代碼並沒使用可選參數,你可以按需傳遞相關參數,然後除了上面的驗證,你還可以通過GenerateRandomNumber或GenerateID生成身份證,需要註意的是IDValidatorHelper並不提供生成身份證的功能,所以這裡必須通過ID18Validator或ID15Validator來生成身份證,與GenerateRandomNumber不同,GenerateID方法支持直接傳入行政區劃編號,且驗證規則為10~999999內的數字,需要註意的是此時該行政區劃編號可以不在行政區劃字典範圍內,即此時不會去驗證該編號是否在字典中存在,而GenerateRandomNumber是隨機從行政區劃字典中取一個區縣級區域,簡單的代碼如下
var no = new ID15Validator().GenerateRandomNumber(); no = new ID18Validator().GenerateID(3202, new DateTime(2000, 1, 1), 1);
如果你在實際使用中有發現問題或Bug,可以在此處回覆或至git上建立Issue。