身份证/手机号解析服务-HQY 一个和谐有爱的空间

30

2025
04
09:51:28

身份证/手机号解析服务

简介

本篇文章是

风控系统之数据服务，名单、标签、IP、设备、地理信息、征信等

的扩展。

既然是上篇文章的扩展，自然离不开风控系统的主题。身份证和手机号解析作为风控事件接入的靠前的步骤是重要的数据处理过程，也是相对最简单的处理过程（与IP、GPS解析相比的话）。

Hutool.IdcardUtil

身份证工具-IdcardUtil | Hutool

Hutool

的

IdcardUtil

现在支持大陆15位、18位身份证，港澳台10位身份证。

工具中主要的方法包括：

isValidCard

验证身份证是否合法

convert15To18

身份证15位转18位

getBirthByIdCard

获取生日

getAgeByIdCard

获取年龄

getYearByIdCard

获取生日年

getMonthByIdCard

获取生日月

getDayByIdCard

获取生日天

getGenderByIdCard

获取性别

getProvinceByIdCard

获取省份

此工具中包含了国内身份证的规定和验证说明。基本的身份证解析功能都具备了，缺点就是关于身份证归属地只到省级别。

中国行政区划

身份证的前6位表示省/市/县，

Hutool

也已经说明了，而且将省份及其对应编码放入了静态

Map

中了，可能出于内存和行政区划变动的原因，并没有将市/县囊括在内。

https://www.mca.gov.cn/mzsj/xzqh/2022/202201xzqh.html

GitHub - modood/Administrative-divisions-of-China: 中华人民共和国行政区划：省级（省份）、地级（城市）、县级（区县）、乡级（乡镇街道）、村级（村委会居委会），中国省市区镇村二级三级四级五级联动地址数据。

非常建议通过这个

Github

项目来更新中国行政区划数据，该项目提供了

json

和

csv

格式的数据，而且数据也比较新。

以下是通过内存加载省/市/县的示例，因为到县级别数量也不是很大，就放在内存中吧，快嘛。

使用到了

provinces.csv

、

cities.csv

、

areas.csv

都可以通过

Github

下载。

Java
运行代码
复制代码
/**
 * <a href="https://github.com/modood/Administrative-divisions-of-China">...</a>
 * @author wnhyang
 * @date 2024/4/24
 **/
@Slf4j
public class AdocUtil {
private static final Map<String, Province> PROVINCE_MAP = new HashMap<>(32);
private static final Map<String, City> CITY_MAP = new HashMap<>(512);
private static final Map<String, Area> AREA_MAP = new HashMap<>(4096);
private static final String DONT_KNOW = "未知";
private static final int AREA_CODE_LENGTH = 6;
private AdocUtil() {
}
public static void init() {
long start = System.currentTimeMillis();
try {
List<Province> provinceList = CsvUtil.getReader().read(
ResourceUtil.getUtf8Reader("provinces.csv"), Province.class);
provinceList.forEach(province -> PROVINCE_MAP.put(province.getCode(), province));
List<City> cityList = CsvUtil.getReader().read(
ResourceUtil.getUtf8Reader("cities.csv"), City.class);
cityList.forEach(city -> CITY_MAP.put(city.getCode(), city));
List<Area> areaList = CsvUtil.getReader().read(
ResourceUtil.getUtf8Reader("areas.csv"), Area.class);
areaList.forEach(area -> AREA_MAP.put(area.getCode(), area));
} catch (Exception e) {
throw new RuntimeException(e);
}
log.info("init success, cost:{}ms", System.currentTimeMillis() - start);
}
}