当前位置：首页 > news >正文

地区 IP 库

news 2025/8/22 16:44:16

地区 & IP 库

yudao-spring-boot-starter-biz-ip (opens new window)业务组件，提供地区 & IP 库的封装。

#1. 地区

AreaUtils (opens new window)是地区工具类，可以查询中国的省、市、区县，也可以查询国外的国家。

它的数据来自 Administrative-divisions-of-China (opens new window)项目，最终整理到项目的 area.csv (opens new window)文件。每一行的数据，对应 Area (opens new window)对象。代码所示：

public class Area {/*** 编号*/private Integer id;/*** 名字*/private String name;/*** 类型** 枚举 {@link AreaTypeEnum}* 1 - 国家* 2 - 省份* 3 - 城市* 4 - 地区, 例如说县、镇、区等*/private Integer type;/*** 父节点*/private Area parent;/*** 子节点*/private List<Area> children;}

AreaUtils 主要有如下两个方法：

// AreaUtils.java/*** 获得指定编号对应的区域** @param id 区域编号* @return 区域*/
public static Area getArea(Integer id) {// ... 省略具体实现
}/*** 格式化区域** 例如说：*      1. id = “静安区”时：上海 上海市 静安区*      2. id = “上海市”时：上海 上海市*      3. id = “上海”时：上海*      4. id = “美国”时：美国* 当区域在中国时，默认不显示中国** @param id 区域编号* @param separator 分隔符* @return 格式化后的区域*/
public static String format(Integer id, String separator) {// ... 省略具体实现
}

具体的使用，可见 AreaUtilsTest (opens new window)测试类。

另外，管理后台提供了 [系统管理 -> 地区管理] 菜单，可以按照树形结构查看地区列表。如下图所示：

地区管理

后端代码，对应 AreaController (opens new window)的 /admin-api/system/area/tree 接口
前端代码，对应 system/area/index.vue (opens new window)界面

#2. IP

IPUtils (opens new window)是 IP 工具类，可以查询 IP 对应的城市信息。

它的数据来自 ip2region (opens new window)项目，最终整理到项目的 ip2region.xdb (opens new window)文件。

IPUtils 主要有如下两个方法：

// IPUtils.java
/*** 查询 IP 对应的地区编号** @param ip IP 地址，格式为 127.0.0.1* @return 地区id*/
public static Integer getAreaId(String ip) {// ... 省略具体实现
}/*** 查询 IP 对应的地区** @param ip IP 地址，格式为 127.0.0.1* @return 地区*/
public static Area getArea(String ip) {// ... 省略具体实现
}