package cn.lihu.jh.module.ecg.utils; import java.net.Inet4Address; import java.net.InetAddress; import java.net.NetworkInterface; import java.util.Enumeration; import java.util.LinkedHashSet; import java.util.Set; /** * 访问方 IP 的规范化与校验(供「选择工位模式」使用)。 * *
* # 方式一:JVM 参数(推荐,jarboot/启动脚本里加) * -Djava.net.preferIPv4Stack=true * # 方式二:Tomcat 只绑 IPv4 地址 * server.address=0.0.0.0 + 系统关闭 IPv6,或直接绑本机 IPv4 地址 ** 若上述都不便调整,请确保医生端用服务器的 **IPv4 地址** 访问(不要用 IPv6 地址或域名解析到 IPv6)。 * *
注意:包名用 {@code utils}(小写)—— 模块里已有 {@code cn.lihu.jh.module.ecg.Utils} 这个类, * 若建同名的 {@code Utils} 包会与类名冲突(实测编译报"类与程序包冲突")。 * 另注意 Windows 路径大小写不敏感,删除 {@code Utils} 目录会连带删掉 {@code utils}。
*/ public final class IpUtils { /** 是否只采用 IPv4(现场约定)。改为 false 即可放开 IPv6,无需改动调用方。 */ public static final boolean IPV4_ONLY = true; /** 服务器本机 IPv4 网卡地址的缓存(见 {@link #localIpv4Addresses()}) */ private static volatile SetIPv6 一律返回 false —— 包括回环 {@code ::1} 与真实 IPv6 地址。 * 注意:{@code ::ffff:32.88.65.208} 这类 IPv4-mapped 地址会先被规范化还原成 * {@code 32.88.65.208},因此**仍然可用**(这是 IPv4 客户端在双栈环境下最容易被误判的情况)。
*/ public static boolean isBindableIp(String ip) { String v = normalize(ip); if (v == null || v.isEmpty()) { return false; } if (isLoopback(v) || isUnspecified(v)) { return false; } // 【本次新增】服务器自身地址不作为工位标识:现场若在服务器上(或远程桌面里)访问系统, // 后端看到的"客户端"就是服务器自己,写进 clinic_room.ip 后该工位永远匹配不到医生电脑。 if (isLocalAddress(v)) { return false; } boolean usable = isIpv4(v); if (IPV4_ONLY && isIpv6(v)) { usable = false; // 只采用 IPv4:IPv6 不参与绑定与匹配 } return usable; } /** * 服务器本机所有 IPv4 网卡地址(首次调用后缓存)。 * *取不到网卡信息时返回**空集合**,此时 {@link #isLocalAddress} 恒为 false ——
* 宁可少拦,也不要因为环境取不到网卡就误判所有地址都是服务器的。
*/
public static Set 用途:识别"在服务器上/远程桌面里访问系统"这种访问方式(此时后端看到的客户端就是服务器自己),
* 并给出可操作提示,而不是把它当成医生的本机 IP。
* 注意:回环 {@code 127.0.0.1} 通常也在网卡列表里,但调用方一般先用 {@link #isLoopback} 判定,
* 提示语会更贴切("本机访问")。
*/
public static boolean isLocalAddress(String ip) {
String v = normalize(ip);
return null != v && !v.isEmpty() && localIpv4Addresses().contains(v);
}
/** 该地址是否为 IPv6(规范化之后判断;IPv4-mapped 已还原成 IPv4,不会命中这里) */
public static boolean isIpv6Address(String ip) {
return isIpv6(normalize(ip));
}
/** 回环地址:127.0.0.0/8、::1 */
public static boolean isLoopback(String ip) {
String v = normalize(ip);
if (v == null) {
return false;
}
if (v.startsWith("127.")) {
return true;
}
return "::1".equals(v) || "0:0:0:0:0:0:0:1".equals(v);
}
/** 未指定地址:0.0.0.0、::(含全零写法) */
public static boolean isUnspecified(String ip) {
String v = normalize(ip);
if (v == null) {
return false;
}
if ("0.0.0.0".equals(v) || "::".equals(v)) {
return true;
}
// 0:0:0:0:0:0:0:0
return v.matches("^0(:0){2,7}$");
}
/** IPv4 点分十进制 */
public static boolean isIpv4(String ip) {
String v = normalize(ip);
if (v == null || !v.matches("^(\\d{1,3}\\.){3}\\d{1,3}$")) {
return false;
}
for (String seg : v.split("\\.")) {
int n;
try {
n = Integer.parseInt(seg);
} catch (NumberFormatException e) {
return false;
}
if (n > 255) {
return false;
}
}
return true;
}
/**
* IPv6(含压缩写法)。这里做"结构级"校验:必须是十六进制分段 + 冒号,
* 允许压缩 {@code ::},允许结尾 IPv4-mapped({@code ::ffff:1.2.3.4})。
* 不做严格的全展开校验(工业现场地址形态多,宽松校验更实用)。
*/
public static boolean isIpv6(String ip) {
String v = normalize(ip);
if (v == null || v.isEmpty() || !v.contains(":")) {
return false;
}
if (v.contains(":::")) {
return false;
}
int doubleColon = v.indexOf("::");
if (doubleColon >= 0 && v.indexOf("::", doubleColon + 1) >= 0) {
return false; // 只能出现一次 "::"
}
String body = v.endsWith("::") ? v.substring(0, v.length() - 2) : v;
if (body.isEmpty()) {
return true; // 就是 "::"
}
for (String seg : body.split("::", -1)) {
if (seg.isEmpty()) {
continue;
}
for (String part : seg.split(":", -1)) {
if (part.isEmpty()) {
return false;
}
if (part.contains(".")) {
if (!isIpv4(part)) {
return false;
}
} else if (!part.matches("[0-9a-f]{1,4}")) {
return false;
}
}
}
return true;
}
}