IP 定位框架 GeoIP2 for Java
一、GeoIP2 简介
GeoIP 官网:https://www.maxmind.com/en/geoip2-services-and-databases
MaxMind 是位于马萨诸塞州的数字地图公司,提供全世界的 IP 地址的位置数据。MaxMind 的定位服务在全球范围内享有盛誉,是应用最广泛的定位服务。其提供 Geoip 和 Geoip2 两个版本的 IP 地址定位服务,并提供开放源代码数据 GeoLite2,GeoLite2 数据库是 GeoIP2 的免费版,其准确率稍低于付费版。
GeoLite2 数据库由几部分组成:GeoLite2 国家库、GeoLite2 城市库和 Geolite2 ASN。他们分别满足不同的功能,GeoLite2 国家库仅能查询 IP 地址所在的国家和洲;GeoLite2 城市库可以查询到 IP 地址所在的国家、地区、城市、经纬度和邮政编码等信息;Geolite2 ASN 用于查询IP地址所属的自治域 AS 或者运营商 ISP。
GeoLite2 离线数据库每月更新一次,可以通过官方网站下载 MaxMind DB 格式的压缩文件。MaxMind 提供支持 7 种编程语言或软件的 API 支持,包括 C#、C、Java、Perl、PHP、Python、Apache(mod_maxminddb)。还有许多第三方 API 支持更多种编程语言或软件。GeoLite2 支持包括英语、汉语、俄语、日语和西班牙语等在内的多种语言。
二、GeoIP2 使用
1、下载离线库
官方下载地址:https://dev.maxmind.com/geoip/geoip2/downloadable/
百度网盘:https://pan.baidu.com/s/1BMirxMxrGN6G6qZwH597Cg 提取码: vxsb
下载文件解压后得到的 GeoLite2-City.mmdb 为 GeoIP2 离线库文件,大概 60M,不算小,可根据情况决定放在项目资源文件中或者服务器上。
2、添加 Maven 依赖
<!-- https://mvnrepository.com/artifact/com.maxmind.geoip2/geoip2 -->
<dependency>
<groupId>com.maxmind.geoip2</groupId>
<artifactId>geoip2</artifactId>
<version>2.13.1</version>
</dependency>
如果 GeoIP2 运行时报错 com.fasterxml.jackson.databind.JsonMappingException:
Exception in thread "main" java.lang.NoSuchMethodError: com.fasterxml.jackson.databind.JsonMappingException.<init>(Ljava/io/Closeable;Ljava/lang/String;)V
因为缺少 jackson.databind 依赖包,引入 jackson 依赖即可解决:
<!-- https://mvnrepository.com/artifact/com.fasterxml.jackson.core/jackson-databind -->
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-databind</artifactId>
<version>2.11.0</version>
</dependency>
3、封装 IP 定位工具类
import com.maxmind.geoip2.DatabaseReader;
import com.maxmind.geoip2.exception.GeoIp2Exception;
import com.maxmind.geoip2.model.CityResponse;
import com.maxmind.geoip2.record.*