【NumberValidators】大陸身份證驗證

来源:https://www.cnblogs.com/starfd/archive/2018/05/16/9046470.html
-Advertisement-
Play Games

需要說明的是這裡的大陸身份證識別並不是公安局聯網的識別,而是按國標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。


您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • 以上代碼是一個讀取資料庫表的例子。(我用的是mysql,其中pymysql庫,也有用mysqldb庫的) ...
  • circular dependencies in projects' graph ! Projects in cycle are:ProjectImp(Name:FrameWork.Entity,PlatformId:'.NETFramework,Version=v4.6') ProjectlImp ...
  • 面向對象設計(OOD)有助於我們開發出高性能、易擴展以及易復用的程式。其中,OOD有一個重要的思想那就是依賴倒置原則(DIP)。 依賴倒置原則(DIP):一種軟體架構設計的原則(抽象概念) 控制反轉(IoC):一種反轉流、依賴和介面的方式(DIP的具體實現方式) 依賴註入(DI):IoC的一種實現方 ...
  • 介紹 C# 使用 SmtpClient.SendAsync 方法發送郵件失敗,總是返回 Cancelled 的原因以及解決辦法。 ...
  • 項目中經常碰到需要輸出的是json數據,使用JavaScriptSerializer轉換,以前老的方法如下。 JavaScriptSerializer jss = new JavaScriptSerializer(); jss.Serialize(obj); 這樣每次太麻煩了,而且每次有錯誤都會影響 ...
  • SliderView控制項 一、 樣式一 我們要實現上圖中的效果,需要如下的操作: 獲得和設置標簽視圖集合,打開集合編輯器,並點擊“添加”,分別填寫ResourceID屬性(菜單項圖片名稱),Text(菜單項文本),Value(內部值,不在界面上顯示),如圖1、圖 2; 圖 1設置界面1 圖 2設置界 ...
  • 使用.Net Core + NGINX部署到伺服器的時候,如果埠不是使用預設的80埠,在跳轉到登錄頁面時,URL中的埠丟失。 ...
  • 如何啟用功能: 開啟控制器的刷一次功能 下發卡許可權時標記該卡是否使用刷一次(或限次功能) 刷一次的功能表現 在單個控制器上,表現為刷1次後再刷時提示無許可權 啟用了"發送刷一次信號"後,通過網路UDP廣播向其它控制器通知,同組的其它控制器也提示無許可權 斷開023後,在021和023上各可以刷一次 斷開... ...
一周排行
    -Advertisement-
    Play Games
  • 示例項目結構 在 Visual Studio 中創建一個 WinForms 應用程式後,項目結構如下所示: MyWinFormsApp/ │ ├───Properties/ │ └───Settings.settings │ ├───bin/ │ ├───Debug/ │ └───Release/ ...
  • [STAThread] 特性用於需要與 COM 組件交互的應用程式,尤其是依賴單線程模型(如 Windows Forms 應用程式)的組件。在 STA 模式下,線程擁有自己的消息迴圈,這對於處理用戶界面和某些 COM 組件是必要的。 [STAThread] static void Main(stri ...
  • 在WinForm中使用全局異常捕獲處理 在WinForm應用程式中,全局異常捕獲是確保程式穩定性的關鍵。通過在Program類的Main方法中設置全局異常處理,可以有效地捕獲並處理未預見的異常,從而避免程式崩潰。 註冊全局異常事件 [STAThread] static void Main() { / ...
  • 前言 給大家推薦一款開源的 Winform 控制項庫,可以幫助我們開發更加美觀、漂亮的 WinForm 界面。 項目介紹 SunnyUI.NET 是一個基於 .NET Framework 4.0+、.NET 6、.NET 7 和 .NET 8 的 WinForm 開源控制項庫,同時也提供了工具類庫、擴展 ...
  • 說明 該文章是屬於OverallAuth2.0系列文章,每周更新一篇該系列文章(從0到1完成系統開發)。 該系統文章,我會儘量說的非常詳細,做到不管新手、老手都能看懂。 說明:OverallAuth2.0 是一個簡單、易懂、功能強大的許可權+可視化流程管理系統。 有興趣的朋友,請關註我吧(*^▽^*) ...
  • 一、下載安裝 1.下載git 必須先下載並安裝git,再TortoiseGit下載安裝 git安裝參考教程:https://blog.csdn.net/mukes/article/details/115693833 2.TortoiseGit下載與安裝 TortoiseGit,Git客戶端,32/6 ...
  • 前言 在項目開發過程中,理解數據結構和演算法如同掌握蓋房子的秘訣。演算法不僅能幫助我們編寫高效、優質的代碼,還能解決項目中遇到的各種難題。 給大家推薦一個支持C#的開源免費、新手友好的數據結構與演算法入門教程:Hello演算法。 項目介紹 《Hello Algo》是一本開源免費、新手友好的數據結構與演算法入門 ...
  • 1.生成單個Proto.bat內容 @rem Copyright 2016, Google Inc. @rem All rights reserved. @rem @rem Redistribution and use in source and binary forms, with or with ...
  • 一:背景 1. 講故事 前段時間有位朋友找到我,說他的窗體程式在客戶這邊出現了卡死,讓我幫忙看下怎麼回事?dump也生成了,既然有dump了那就上 windbg 分析吧。 二:WinDbg 分析 1. 為什麼會卡死 窗體程式的卡死,入口門檻很低,後續往下分析就不一定了,不管怎麼說先用 !clrsta ...
  • 前言 人工智慧時代,人臉識別技術已成為安全驗證、身份識別和用戶交互的關鍵工具。 給大家推薦一款.NET 開源提供了強大的人臉識別 API,工具不僅易於集成,還具備高效處理能力。 本文將介紹一款如何利用這些API,為我們的項目添加智能識別的亮點。 項目介紹 GitHub 上擁有 1.2k 星標的 C# ...