ip2region地址定位

1、简介

https://github.com/lionsoul2014/ip2region

https://github.com/lionsoul2014/ip2region/tree/master/binding/java

ip2region - 是一个离线IP地址定位库和IP定位数据管理框架，10微秒级别的查询效率，提供了众多主流编程语言的 xdb 数据生成和查询客户端实现。

2、Ip2region 特性

1、IP 数据管理框架

xdb 支持亿级别的 IP 数据段行数，默认的 region 信息都固定了格式：国家|区域|省份|城市|ISP，缺省的地域信息默认是0。 region 信息支持完全自定义，例如：你可以在 region 中追加特定业务需求的数据，例如：GPS信息/国际统一地域信息编码/邮编等。也就是你完全可以使用 ip2region 来管理你自己的 IP 定位数据。

2、数据去重和压缩

xdb 格式生成程序会自动去重和压缩部分数据，默认的全部 IP 数据，生成的 ip2region.xdb 数据库是 11MiB，随着数据的详细度增加数据库的大小也慢慢增大。

3、极速查询响应

即使是完全基于 xdb 文件的查询，单次查询响应时间在十微秒级别，可通过如下两种方式开启内存加速查询：

1. vIndex 索引缓存 ：使用固定的 512KiB 的内存空间缓存 vector index 数据，减少一次 IO 磁盘操作，保持平均查询效率稳定在10-20微秒之间。

2. xdb 整个文件缓存：将整个 xdb 文件全部加载到内存，内存占用等同于 xdb 文件大小，无磁盘 IO 操作，保持微秒级别的查询效率。

3、使用

依赖

<dependency>
    <groupId>org.lionsoul</groupId>
    <artifactId>ip2region</artifactId>
    <version>2.7.0</version>
</dependency>

新建Ip2RegionUtil.java

package com.example.learning.ip2region;

import org.lionsoul.ip2region.xdb.Searcher;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.stereotype.Component;

import java.io.IOException;
import java.util.Objects;

/**
 * @ClassName Ip2RegionUtil
 * @Description:
 * @Author: zpeng
 * @CreateDate: 2024/4/7 3:21
 */
@Component
public class Ip2RegionUtil {
    public static final Logger log = LoggerFactory.getLogger(Ip2RegionUtil.class);

    /**
     * 将整个库进行缓存到内存，基于这个库创建查询对象来实现基于文件的查询
     * 获取Searcher
     */
    private Searcher getSearcher() throws IOException {
        //获取地址下的库数据
        byte[] bytes = Searcher.loadContentFromFile("D:\\IdeaProjects\\learning\\src\\main\\resources\\ip2region.xdb");
        return Searcher.newWithBuffer(bytes);
    }

    /**
     * 根据ip地址直接返回国家、省、城市信息
     *
     * @param ip ip
     * @return 返回地址
     */
    public String changeIpToAddress(String ip) {
        //获取searcher
        Searcher searcher = null;
        try {
            searcher = getSearcher();
            return searcher.search(ip);
        } catch (Exception e) {
            log.error(String.format("ip转地址报错:%s", e.getMessage()));
            e.printStackTrace();
            return "";
        } finally {
            try {
                if (Objects.nonNull(searcher)) {
                    searcher.close();
                }
            } catch (Exception e) {
                e.printStackTrace();
            }
        }
    }
}

复制xdb文件到项目中

https://github.com/lionsoul2014/ip2region/tree/master/data

新建controller

package com.example.learning.ip2region;

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;

import java.util.function.Consumer;

/**
 * @ClassName Ip2regionController
 * @Description:
 * @Author: zpeng
 * @CreateDate: 2024/4/7 3:30
 */
@RestController
@RequestMapping("/ip2region")
public class Ip2regionController {
    @Autowired
    private Ip2RegionUtil regionUtil;

    @GetMapping("/hello")
    public String hello() {
        String address = regionUtil.changeIpToAddress("111.27.76.231");
        System.out.println(address);

        Consumer<String> con = (x) -> System.out.println(regionUtil.changeIpToAddress(x));
        con.accept("111.27.76.231");

        return "hello";
    }
}

测试

http://localhost:8080/ip2region/hello

中国|0|吉林省|长春市|移动
中国|0|北京|北京市|阿里云