📋 目录
一、工具类功能
判断字符串是不是合法的 IPv4 或 IPv6 字面量,并把 IPv6 归一化展开成完整小写形式,纯字符判断不触发 DNS,不认 CIDR 前缀与端口写法。
二、所需环境
JDK 17或以上
三、方法与调用示例(按需调用)
🔢 方法序号:1
🎯 方法用途:
- 判一个字符串是不是合法 IP 字面量,IPv4 与 IPv6 任一族通过就算通过
- 白名单校验、接口入参兜底的第一道判断用它,纯本地字符匹配,不触发 DNS,结果也不随网络状态变化
🧩 方法定义:public static boolean isValidIp(String ip)
🗣️ 入参解释:public static boolean isValidIp(待校验字符串)
📤 返回值解释:boolean,IPv4 或 IPv6 只要有一族结构合法就是 true
💡 边界口径:
- 内部就是先判 IPv4 再判 IPv6,两族的文法互斥,不会同时通过
null、空串、垃圾输入一律返回false,不抛异常- 只看字面量合不合法,端口与 CIDR 前缀都不解析,也不判断私有、链路本地这类地址属性
🧪 方法示例:
isValidIp("203.0.113.7")按 IPv4 通过,拿到trueisValidIp("2001:db8::1")按 IPv6 通过,拿到trueisValidIp("fe80::1%eth0")带接口名的链路本地地址同样合法,拿到trueisValidIp("::1")回环缩写合法,拿到trueisValidIp("1:2:3:4:5:6:1.2.3.4")末两组内嵌 IPv4 的写法合法,拿到trueisValidIp("1.2.3.4/24")带子网前缀不认,拿到falseisValidIp("1.2.3.4:8080")带端口不认,拿到falseisValidIp(null)拿到falseisValidIp("not-an-ip")垃圾输入同样拿到false,不抛异常
🔢 方法序号:2
🎯 方法用途:
- 单独判 IPv4:必须恰好 4 段,每段 0 到 255,并且不允许前导零
- 配置项、请求头里只收 IPv4 的场合用它,免得 IPv6 混进白名单
🧩 方法定义:public static boolean isValidIpv4(String ip)
🗣️ 入参解释:public static boolean isValidIpv4(待校验字符串)
📤 返回值解释:boolean,四段全部通过十进制段校验才 true
💡 边界口径:
- 前导零会被
inet_aton一类解析器按八进制读,同一串字符在操作系统和 JVM 里可能读出不同地址,01.2.3.4、010.0.0.1因此一律拒绝,单字符0合法 - 超过 15 个字符直接返回
false,不进逐段解析 - 段内的空格、加号等字符落在
0|[1-9]\d{0,2}之外,256 这类越界值由上界判断挡住 - IPv4 不支持区域标识,也不接受
/24这种前缀写法
🧪 方法示例:
isValidIpv4("255.255.255.255")拿到trueisValidIpv4("01.2.3.4")前导零歧义,拿到falseisValidIpv4("010.0.0.1")同理被拒,拿到falseisValidIpv4("0.0.0.0")单字符 0 合法,拿到trueisValidIpv4("1.2.3.4.5")段数不是 4,拿到falseisValidIpv4("256.1.1.1")取值越界,拿到falseisValidIpv4(" 1.2.3.4")段首带空格,拿到false
🔢 方法序号:3
🎯 方法用途:
- 单独判 IPv6,支持
::压缩、末尾内嵌 IPv4 和末尾的%区域标识 - 需要把 IPv6 白名单条目卡死结构时用,压缩写法和完整写法都能认
🧩 方法定义:public static boolean isValidIpv6(String ip)
🗣️ 入参解释:public static boolean isValidIpv6(待校验字符串)
📤 返回值解释:boolean,分组数与冒号位置都合规才 true
💡 边界口径:
- 首尾只允许成对的
::,:1:2:3:4:5:6:7:8、1:2:3:4:5:6:7:8:、::::与两处压缩一律非法 - 没有压缩时必须正好 8 组;有压缩时显式分组之和要少于 8 组,也就是
::至少代表一组零 - 内嵌 IPv4 只能出现在最后且占 2 组,
::1.2.3.4:5拒绝 - 地址本体上限 45 字符,
%后面的接口名不计入这个长度,整个入参另有 256 字符的宽松上限 - 整个串只允许一个
%,后面必须是非空且不含空白与控制字符的片段,fe80::1%非法
🧪 方法示例:
isValidIpv6(":1:2:3:4:5:6:7:8")开头单冒号,拿到falseisValidIpv6("1:2:3:4:5:6:7:8:")结尾单冒号,拿到falseisValidIpv6("::::")三个以上连续冒号,拿到falseisValidIpv6("1:2::3::4")两处压缩,拿到falseisValidIpv6("1:2:3:4:5:6:7::8")显式分组已满 8 组,::无零可代表,拿到falseisValidIpv6("1:2:3:4:5:6::8")少一组就合法,拿到trueisValidIpv6("::1.2.3.4:5")内嵌 IPv4 不在最后,拿到falseisValidIpv6("2001:0db8:85a3:0000:0000:0000:0000:8a2e%wlan01")接口名不计入长度上限,拿到trueisValidIpv6("fe80::1%")百分号后面为空,拿到falseisValidIpv6("fe80::1%eth%0")出现两个百分号,拿到false
🔢 方法序号:4
🎯 方法用途:
- 把合法的 IPv6 展开成不带
::压缩、不含区域标识的小写完整形式 - 日志归一与地址比对用它,
2001:DB8::1和2001:0db8:0:0:0:0:0:1展开后是同一个字符串,可以直接equals
🧩 方法定义:public static String expandIpv6(String ip)
🗣️ 入参解释:public static String expandIpv6(待展开字符串)
📤 返回值解释:String,8 组 4 位小写十六进制、冒号分隔的完整地址;入参不是合法 IPv6 时为 null
💡 边界口径:
- 先过一遍 IPv6 校验,非法就直接返回
null,不抛异常 - 每组补齐到 4 位、整体转小写,压缩位置按缺几组补几个
0000 - 内嵌 IPv4 会换算成高低位两个分组,
192.0.2.1落成c000:0201 - 带区域标识的先去掉
%及其后的接口名,展开结果里不再保留 - 展开结果本身仍是合法 IPv6,再展开一次不会变化
🧪 方法示例:
expandIpv6("2001:DB8::1")拿到2001:0db8:0000:0000:0000:0000:0000:0001expandIpv6("2001:0DB8:0:0:0:0:0:1")与压缩写法归一到同一个字符串,拿到2001:0db8:0000:0000:0000:0000:0000:0001expandIpv6("::")压缩全零也还原成 8 组,拿到0000:0000:0000:0000:0000:0000:0000:0000expandIpv6("::ffff:192.0.2.1")内嵌 IPv4 换成高低位分组,拿到0000:0000:0000:0000:0000:ffff:c000:0201expandIpv6("fe80::1%eth0")去掉接口名后展开,拿到fe80:0000:0000:0000:0000:0000:0000:0001expandIpv6("1:2:3:4:5:6:7:8:9")非法入参,拿到null- 把
expandIpv6("2001:DB8::1")的输出再喂回expandIpv6比一次,拿到true
四、工具类源码(可直接复制)
📦 源码文件