【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
  • 移動開發(一):使用.NET MAUI開發第一個安卓APP 對於工作多年的C#程式員來說,近來想嘗試開發一款安卓APP,考慮了很久最終選擇使用.NET MAUI這個微軟官方的框架來嘗試體驗開發安卓APP,畢竟是使用Visual Studio開發工具,使用起來也比較的順手,結合微軟官方的教程進行了安卓 ...
  • 前言 QuestPDF 是一個開源 .NET 庫,用於生成 PDF 文檔。使用了C# Fluent API方式可簡化開發、減少錯誤並提高工作效率。利用它可以輕鬆生成 PDF 報告、發票、導出文件等。 項目介紹 QuestPDF 是一個革命性的開源 .NET 庫,它徹底改變了我們生成 PDF 文檔的方 ...
  • 項目地址 項目後端地址: https://github.com/ZyPLJ/ZYTteeHole 項目前端頁面地址: ZyPLJ/TreeHoleVue (github.com) https://github.com/ZyPLJ/TreeHoleVue 目前項目測試訪問地址: http://tree ...
  • 話不多說,直接開乾 一.下載 1.官方鏈接下載: https://www.microsoft.com/zh-cn/sql-server/sql-server-downloads 2.在下載目錄中找到下麵這個小的安裝包 SQL2022-SSEI-Dev.exe,運行開始下載SQL server; 二. ...
  • 前言 隨著物聯網(IoT)技術的迅猛發展,MQTT(消息隊列遙測傳輸)協議憑藉其輕量級和高效性,已成為眾多物聯網應用的首選通信標準。 MQTTnet 作為一個高性能的 .NET 開源庫,為 .NET 平臺上的 MQTT 客戶端與伺服器開發提供了強大的支持。 本文將全面介紹 MQTTnet 的核心功能 ...
  • Serilog支持多種接收器用於日誌存儲,增強器用於添加屬性,LogContext管理動態屬性,支持多種輸出格式包括純文本、JSON及ExpressionTemplate。還提供了自定義格式化選項,適用於不同需求。 ...
  • 目錄簡介獲取 HTML 文檔解析 HTML 文檔測試參考文章 簡介 動態內容網站使用 JavaScript 腳本動態檢索和渲染數據,爬取信息時需要模擬瀏覽器行為,否則獲取到的源碼基本是空的。 本文使用的爬取步驟如下: 使用 Selenium 獲取渲染後的 HTML 文檔 使用 HtmlAgility ...
  • 1.前言 什麼是熱更新 游戲或者軟體更新時,無需重新下載客戶端進行安裝,而是在應用程式啟動的情況下,在內部進行資源或者代碼更新 Unity目前常用熱更新解決方案 HybridCLR,Xlua,ILRuntime等 Unity目前常用資源管理解決方案 AssetBundles,Addressable, ...
  • 本文章主要是在C# ASP.NET Core Web API框架實現向手機發送驗證碼簡訊功能。這裡我選擇是一個互億無線簡訊驗證碼平臺,其實像阿裡雲,騰訊雲上面也可以。 首先我們先去 互億無線 https://www.ihuyi.com/api/sms.html 去註冊一個賬號 註冊完成賬號後,它會送 ...
  • 通過以下方式可以高效,並保證數據同步的可靠性 1.API設計 使用RESTful設計,確保API端點明確,並使用適當的HTTP方法(如POST用於創建,PUT用於更新)。 設計清晰的請求和響應模型,以確保客戶端能夠理解預期格式。 2.數據驗證 在伺服器端進行嚴格的數據驗證,確保接收到的數據符合預期格 ...