目录

地区 & 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) 对象。代码所示:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
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 主要有如下两个方法:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
// 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) {
// ... 省略具体实现
}

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

地区管理

# 2. IP

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

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

IPUtils 主要有如下两个方法:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
// 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) {
// ... 省略具体实现
}

另外,管理后台提供了 [系统管理 -> 地区管理] 菜单,也提供了 IP 查询城市的示例。如下图所示:

IP 查询城市

上次更新: 2023/01/27, 21:56:08

本站由 钟意 使用 Stellar 1.28.1 主题创建。
又拍云 提供CDN加速/云存储服务
vercel 提供托管服务
湘ICP备2023019799号-1
总访问 次 | 本页访问