Class NetUtil
java.lang.Object
com.sure.tool.util.NetUtil
网络工具类,参考 Hutool 的
NetUtil 设计。
English: Network helpers for local addresses, IP checks, port checks and CIDR matching.
- Since:
- 0.1.0
- Author:
- suretool
-
Method Summary
Modifier and TypeMethodDescriptionstatic String获取本机主机名。static String获取本机局域网 IPv4 地址(优先非回环网卡)。static String获取本机 MAC 地址(格式AA:BB:CC:DD:EE:FF,优先非回环网卡)。static int随机分配一个本机当前可用端口(0-65535)。static longipv4ToLong(String ip) IPv4 地址转 long(大端)。static boolean判断 IPv4 是否位于 CIDR 网段内(对齐标准 CIDR 语义)。static boolean判断 IP 是否为内网地址(10/172.16-31/192.168/127/169.254/0 段)。static boolean校验是否为合法 IP 地址(IPv4 或 IPv6)。static boolean校验是否为合法 IPv4 地址。static boolean校验是否为合法 IPv6 地址。static booleanisUsableLocalPort(int port) 本机指定端口当前是否可用(可成功绑定)。static booleanisValidPort(int port) 是否为合法端口号(1-65535)。获取本机全部 IPv4 地址(含回环,按枚举顺序)。static StringlongToIpv4(long value) long 转 IPv4 地址。
-
Method Details
-
getLocalhostStr
-
getLocalIpv4
-
getLocalMacAddress
获取本机 MAC 地址(格式AA:BB:CC:DD:EE:FF,优先非回环网卡)。- Returns:
- MAC 地址,获取失败返回
null
-
isInnerIP
判断 IP 是否为内网地址(10/172.16-31/192.168/127/169.254/0 段)。- Parameters:
ip- IP 地址- Returns:
- 是否为内网地址
-
isValidPort
public static boolean isValidPort(int port) 是否为合法端口号(1-65535)。- Parameters:
port- 端口号- Returns:
- 是否合法
-
isUsableLocalPort
public static boolean isUsableLocalPort(int port) 本机指定端口当前是否可用(可成功绑定)。- Parameters:
port- 端口号- Returns:
- 是否可用
-
ipv4ToLong
IPv4 地址转 long(大端)。- Parameters:
ip- IPv4 地址- Returns:
- long 表示
- Throws:
IllegalArgumentException- 非法地址
-
longToIpv4
long 转 IPv4 地址。- Parameters:
value- long 表示- Returns:
- IPv4 地址
-
isIpv4
-
isIpv6
校验是否为合法 IPv6 地址。示例:
NetUtil.isIpv6("2001:db8::1") -> true;NetUtil.isIpv6("fe80::1%eth0") -> true(含区域索引)。- Parameters:
ip- 地址,可为null- Returns:
- 是否合法
- Since:
- 1.19.0
-
isIp
校验是否为合法 IP 地址(IPv4 或 IPv6)。示例:
NetUtil.isIp("192.168.1.1") -> true;NetUtil.isIp("::1") -> true。- Parameters:
ip- 地址,可为null- Returns:
- 是否合法
- Since:
- 1.19.0
-
isInCidr
判断 IPv4 是否位于 CIDR 网段内(对齐标准 CIDR 语义)。示例:
NetUtil.isInCidr("192.168.1.5", "192.168.1.0/24") -> true;NetUtil.isInCidr("10.1.2.3", "192.168.0.0/16") -> false。- Parameters:
ip- IPv4 地址,可为nullcidr- CIDR 网段(如192.168.1.0/24),可为null- Returns:
- 是否在网段内;任一参数非法返回
false - Since:
- 1.19.0
-
localIpv4s
-
getUsableLocalPort
public static int getUsableLocalPort()随机分配一个本机当前可用端口(0-65535)。示例:
NetUtil.getUsableLocalPort()返回一个未被占用的端口号。- Returns:
- 可用端口(1-65535);分配失败返回 0
- Since:
- 1.19.0
-