身份证/手机号解析服务

/**
 * <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);
    }

}

手机号的解析

手机号码的归属地可以通过号码的前七位进行判断。前三位如170/150/136等是网络识别号，中间四位是地区编码（归属地），最后四位是用户号码。因此，正确念读手机号的方法是：1xx-xxxx-xxxx。中国大陆地区手机号码格式为：1**####$$$$。星号部分（*）用于区分不同的业务服务提供商，例如移动、联通和电信等。前七位（1**####）可以用来查出手机的归属地。

可参考以下项目。

GitHub - fighting41love/funNLP

GitHub - ls0f/phone: 手机号码归属地库

GitHub - xluohome/phonedata: 手机号码归属地信息库、手机号归属地查询 phone.dat 最后更新：2023年02月

GitHub - fengjiajie/phone-number-geo: 手机号码归属地本地解析(Java)

GitHub - EeeMt/phone-number-geo: 离线查询手机号归属地

GitHub - AfterShip/phone: With a given country and phone number, validate and reformat the mobile phone number to the E.164 standard. The purpose of this is to allow us to send SMS to mobile phones only.

关于开源项目的使用，一般要从代码质量文档、许可证、使用社区活跃度、性能多方面来考虑。

以下是GitHub - EeeMt/phone-number-geo: 离线查询手机号归属地的一个简单示例。

/**
 * @author wnhyang
 * @date 2024/4/26
 **/
@Slf4j
public class PhoneNumberUtil {

    private static final PhoneNumberLookup LOOKUP = new PhoneNumberLookup();

    private static final String DONT_KNOW = "未知";

    private PhoneNumberUtil() {
    }

    public static PhoneNumberInfo lookup(String phoneNumber) {
        return LOOKUP.lookup(phoneNumber).orElseGet(() -> getNotFound(phoneNumber));
    }

    public static PhoneNumberInfo getNotFound(String phoneNumber) {
        return new PhoneNumberInfo(phoneNumber, new Attribution(DONT_KNOW, DONT_KNOW, DONT_KNOW, DONT_KNOW), ISP.UNKNOWN);
    }
}