Class NetUtil

java.lang.Object
com.sure.tool.util.NetUtil

public class NetUtil extends Object
网络工具类,参考 Hutool 的 NetUtil 设计。

English: Network helpers for local addresses, IP checks, port checks and CIDR matching.

Since:
0.1.0
Author:
suretool
  • Method Details

    • getLocalhostStr

      public static String getLocalhostStr()
      获取本机主机名。
      Returns:
      主机名,获取失败返回 null
    • getLocalIpv4

      public static String getLocalIpv4()
      获取本机局域网 IPv4 地址(优先非回环网卡)。
      Returns:
      IPv4 地址,获取失败返回 null
    • getLocalMacAddress

      public static String getLocalMacAddress()
      获取本机 MAC 地址(格式 AA:BB:CC:DD:EE:FF,优先非回环网卡)。
      Returns:
      MAC 地址,获取失败返回 null
    • isInnerIP

      public static boolean isInnerIP(String ip)
      判断 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

      public static long ipv4ToLong(String ip)
      IPv4 地址转 long(大端)。
      Parameters:
      ip - IPv4 地址
      Returns:
      long 表示
      Throws:
      IllegalArgumentException - 非法地址
    • longToIpv4

      public static String longToIpv4(long value)
      long 转 IPv4 地址。
      Parameters:
      value - long 表示
      Returns:
      IPv4 地址
    • isIpv4

      public static boolean isIpv4(String ip)
      校验是否为合法 IPv4 地址。
      Parameters:
      ip - 地址
      Returns:
      是否合法
    • isIpv6

      public static boolean isIpv6(String ip)
      校验是否为合法 IPv6 地址。

      示例:NetUtil.isIpv6("2001:db8::1") -> true; NetUtil.isIpv6("fe80::1%eth0") -> true(含区域索引)。

      Parameters:
      ip - 地址,可为 null
      Returns:
      是否合法
      Since:
      1.19.0
    • isIp

      public static boolean isIp(String ip)
      校验是否为合法 IP 地址(IPv4 或 IPv6)。

      示例:NetUtil.isIp("192.168.1.1") -> true; NetUtil.isIp("::1") -> true。

      Parameters:
      ip - 地址,可为 null
      Returns:
      是否合法
      Since:
      1.19.0
    • isInCidr

      public static boolean isInCidr(String ip, String cidr)
      判断 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 地址,可为 null
      cidr - CIDR 网段(如 192.168.1.0/24),可为 null
      Returns:
      是否在网段内;任一参数非法返回 false
      Since:
      1.19.0
    • localIpv4s

      public static List<String> localIpv4s()
      获取本机全部 IPv4 地址(含回环,按枚举顺序)。

      示例:NetUtil.localIpv4s() 返回形如 [127.0.0.1, 192.168.x.x]。

      Returns:
      IPv4 地址列表(至少含回环地址)
      Since:
      1.19.0
    • getUsableLocalPort

      public static int getUsableLocalPort()
      随机分配一个本机当前可用端口(0-65535)。

      示例:NetUtil.getUsableLocalPort() 返回一个未被占用的端口号。

      Returns:
      可用端口(1-65535);分配失败返回 0
      Since:
      1.19.0