地区 & IP 库

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

它的数据来自 Administrative-divisions-of-China (opens new window)项目，最终整理到项目的 area.csv (opens new window)文件。每一行的数据，对应 Area (opens new window)对象。代码所示：
> <span style="font-family:楷体">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;
}
</span>

- 具体的使用，可见 AreaUtilsTest (opens new window)测试类。
另外，管理后台提供了 [系统管理 -> 地区管理] 菜单，可以按照树形结构查看地区列表。如下图所示：

![](/media/202408/2024-08-29_160322_390380.png)

## 2. IP
IPUtils 是 IP 工具类，可以查询 IP 对应的城市信息。
它的数据来自 ip2region (opens new window)项目，最终整理到项目的 ip2region.xdb (opens new window)文件。
IPUtils 主要有如下两个方法：
> <span style="font-family:楷体">// 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) {
        // ... 省略具体实现
}
</span>
- 具体的使用，可见 IPUtilsTest 测试类。
另外，管理后台提供了 [系统管理 -> 地区管理] 菜单，也提供了 IP 查询城市的示例。如下图所示：

![](/media/202408/2024-08-29_160438_944782.png)