Ipv4Util (hutool 5.8.36 API)

java.lang.Object
- cn.hutool.core.net.Ipv4Util

```
public class Ipv4Util
extends Object
```
IPV4地址工具类
pr自：https://gitee.com/loolly/hutool/pulls/161

Since:

5.4.1

Author:

ZhuKun

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`IP_MASK_MAX` 最大掩码位
`static String`	`IP_MASK_SPLIT_MARK` IP与掩码的分割符
`static String`	`IP_SPLIT_MARK` IP段的分割符
`static String`	`LOCAL_IP`

Constructor Summary

Constructors
Constructor and Description

Ipv4Util()

Constructors
Constructor and Description
`Ipv4Util()`

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static int`	`countByIpRange(String fromIp, String toIp)` 计算IP区间有多少个IP
`static int`	`countByMaskBit(int maskBit, boolean isAll)` 计算子网大小
`static String`	`formatIpBlock(String ip, String mask)` 格式化IP段
`static Long`	`getBeginIpLong(String ip, int maskBit)` 根据 ip/掩码位计算IP段的起始IP（Long型）
`static String`	`getBeginIpStr(String ip, int maskBit)` 根据 ip/掩码位计算IP段的起始IP（字符串型）方法别名：inet_ntoa
`static Long`	`getEndIpLong(String ip, int maskBit)` 根据 ip/掩码位计算IP段的终止IP（Long型）注：此接口返回负数，请使用转成字符串后再转Long型
`static String`	`getEndIpStr(String ip, int maskBit)` 根据 ip/掩码位计算IP段的终止IP（字符串型）
`static int`	`getMaskBitByMask(String mask)` 根据子网掩码转换为掩码位
`static String`	`getMaskByIpRange(String fromIp, String toIp)` 根据开始IP与结束IP计算掩码
`static String`	`getMaskByMaskBit(int maskBit)` 根据掩码位获取掩码
`static long`	`ipv4ToLong(String strIP)` 根据ip地址(xxx.xxx.xxx.xxx)计算出long型的数据方法别名：inet_aton
`static long`	`ipv4ToLong(String strIP, long defaultValue)` 根据ip地址(xxx.xxx.xxx.xxx)计算出long型的数据, 如果格式不正确返回 defaultValue
`static boolean`	`isInnerIP(String ipAddress)` 判定是否为内网IPv4 私有IP： A类 10.0.0.0-10.255.255.255 B类 172.16.0.0-172.31.255.255 C类 192.168.0.0-192.168.255.255 当然，还有127这个网段是环回地址
`static boolean`	`isMaskBitValid(int maskBit)` 判断掩码位是否合法
`static boolean`	`isMaskValid(String mask)` 判断掩码是否合法
`static List<String>`	`list(String ipRange, boolean isAll)` 智能转换IP地址集合
`static List<String>`	`list(String ip, int maskBit, boolean isAll)` 根据IP地址、子网掩码获取IP地址区间
`static List<String>`	`list(String ipFrom, String ipTo)` 得到IP地址区间
`static String`	`longToIpv4(long longIP)` 根据long值获取ip v4地址：xx.xx.xx.xx
`static boolean`	`matches(String wildcard, String ipAddress)` 检测指定 IP 地址是否匹配通配符 wildcard

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - LOCAL_IP
```
public static final String LOCAL_IP
```
    See Also:
    
    Constant Field Values
  - IP_SPLIT_MARK
```
public static final String IP_SPLIT_MARK
```
    IP段的分割符
    
    See Also:
    
    Constant Field Values
  - IP_MASK_SPLIT_MARK
```
public static final String IP_MASK_SPLIT_MARK
```
    IP与掩码的分割符
    
    See Also:
    
    Constant Field Values
  - IP_MASK_MAX
```
public static final int IP_MASK_MAX
```
    最大掩码位
    
    See Also:
    
    Constant Field Values
- Constructor Detail
  - Ipv4Util
```
public Ipv4Util()
```
- Method Detail
  - formatIpBlock
```
public static String formatIpBlock(String ip,
                                   String mask)
```
    格式化IP段
    
    Parameters:
    
    ip - IP地址
    
    mask - 掩码
    
    Returns:
    
    返回xxx.xxx.xxx.xxx/mask的格式
  - list
```
public static List<String> list(String ipRange,
                                boolean isAll)
```
    智能转换IP地址集合
    
    Parameters:
    
    ipRange - IP段，支持X.X.X.X-X.X.X.X或X.X.X.X/X
    
    isAll - true:全量地址，false:可用地址；仅在ipRange为X.X.X.X/X时才生效
    
    Returns:
    
    IP集
  - list
```
public static List<String> list(String ip,
                                int maskBit,
                                boolean isAll)
```
    根据IP地址、子网掩码获取IP地址区间
    
    Parameters:
    
    ip - IP地址
    
    maskBit - 掩码位，例如24、32
    
    isAll - true:全量地址，false:可用地址
    
    Returns:
    
    区间地址
  - list
```
public static List<String> list(String ipFrom,
                                String ipTo)
```
    得到IP地址区间
    
    Parameters:
    
    ipFrom - 开始IP
    
    ipTo - 结束IP
    
    Returns:
    
    区间地址
  - longToIpv4
```
public static String longToIpv4(long longIP)
```
    根据long值获取ip v4地址：xx.xx.xx.xx
    
    Parameters:
    
    longIP - IP的long表示形式
    
    Returns:
    
    IP V4 地址
  - ipv4ToLong
```
public static long ipv4ToLong(String strIP)
```
    根据ip地址(xxx.xxx.xxx.xxx)计算出long型的数据方法别名：inet_aton
    
    Parameters:
    
    strIP - IP V4 地址
    
    Returns:
    
    long值
  - ipv4ToLong
```
public static long ipv4ToLong(String strIP,
                              long defaultValue)
```
    根据ip地址(xxx.xxx.xxx.xxx)计算出long型的数据, 如果格式不正确返回 defaultValue
    
    Parameters:
    
    strIP - IP V4 地址
    
    defaultValue - 默认值
    
    Returns:
    
    long值
  - getBeginIpStr
```
public static String getBeginIpStr(String ip,
                                   int maskBit)
```
    根据 ip/掩码位计算IP段的起始IP（字符串型）方法别名：inet_ntoa
    
    Parameters:
    
    ip - 给定的IP，如218.240.38.69
    
    maskBit - 给定的掩码位，如30
    
    Returns:
    
    起始IP的字符串表示
  - getBeginIpLong
```
public static Long getBeginIpLong(String ip,
                                  int maskBit)
```
    根据 ip/掩码位计算IP段的起始IP（Long型）
    
    Parameters:
    
    ip - 给定的IP，如218.240.38.69
    
    maskBit - 给定的掩码位，如30
    
    Returns:
    
    起始IP的长整型表示
  - getEndIpStr
```
public static String getEndIpStr(String ip,
                                 int maskBit)
```
    根据 ip/掩码位计算IP段的终止IP（字符串型）
    
    Parameters:
    
    ip - 给定的IP，如218.240.38.69
    
    maskBit - 给定的掩码位，如30
    
    Returns:
    
    终止IP的字符串表示
  - getMaskBitByMask
```
public static int getMaskBitByMask(String mask)
```
    根据子网掩码转换为掩码位
    
    Parameters:
    
    mask - 掩码的点分十进制表示，例如 255.255.255.0
    
    Returns:
    
    掩码位，例如 24
    
    Throws:
    
    IllegalArgumentException - 子网掩码非法
  - countByMaskBit
```
public static int countByMaskBit(int maskBit,
                                 boolean isAll)
```
    计算子网大小
    
    Parameters:
    
    maskBit - 掩码位
    
    isAll - true:全量地址，false:可用地址
    
    Returns:
    
    地址总数
  - getMaskByMaskBit
```
public static String getMaskByMaskBit(int maskBit)
```
    根据掩码位获取掩码
    
    Parameters:
    
    maskBit - 掩码位
    
    Returns:
    
    掩码
  - getMaskByIpRange
```
public static String getMaskByIpRange(String fromIp,
                                      String toIp)
```
    根据开始IP与结束IP计算掩码
    
    Parameters:
    
    fromIp - 开始IP
    
    toIp - 结束IP
    
    Returns:
    
    掩码x.x.x.x
  - countByIpRange
```
public static int countByIpRange(String fromIp,
                                 String toIp)
```
    计算IP区间有多少个IP
    
    Parameters:
    
    fromIp - 开始IP
    
    toIp - 结束IP
    
    Returns:
    
    IP数量
  - isMaskValid
```
public static boolean isMaskValid(String mask)
```
    判断掩码是否合法
    
    Parameters:
    
    mask - 掩码的点分十进制表示，例如 255.255.255.0
    
    Returns:
    
    true：掩码合法；false：掩码不合法
  - isMaskBitValid
```
public static boolean isMaskBitValid(int maskBit)
```
    判断掩码位是否合法
    
    Parameters:
    
    maskBit - 掩码位，例如 24
    
    Returns:
    
    true：掩码位合法；false：掩码位不合法
  - isInnerIP
```
public static boolean isInnerIP(String ipAddress)
```
    判定是否为内网IPv4
    私有IP：
```
 A类 10.0.0.0-10.255.255.255
 B类 172.16.0.0-172.31.255.255
 C类 192.168.0.0-192.168.255.255
 
```
    当然，还有127这个网段是环回地址
    Parameters:
    
    ipAddress - IP地址
    
    Returns:
    
    是否为内网IP
    
    Since:
    
    5.7.18
  - matches
```
public static boolean matches(String wildcard,
                              String ipAddress)
```
    检测指定 IP 地址是否匹配通配符 wildcard
    
    Parameters:
    
    wildcard - 通配符，如 192.168.*.1
    
    ipAddress - 待检测的 IP 地址
    
    Returns:
    
    是否匹配
  - getEndIpLong
```
public static Long getEndIpLong(String ip,
                                int maskBit)
```
    根据 ip/掩码位计算IP段的终止IP（Long型）注：此接口返回负数，请使用转成字符串后再转Long型
    
    Parameters:
    
    ip - 给定的IP，如218.240.38.69
    
    maskBit - 给定的掩码位，如30
    
    Returns:
    
    终止IP的长整型表示

Class Ipv4Util

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

LOCAL_IP

IP_SPLIT_MARK

IP_MASK_SPLIT_MARK

IP_MASK_MAX

Constructor Detail

Ipv4Util

Method Detail

formatIpBlock

list

list

list

longToIpv4

ipv4ToLong

ipv4ToLong

getBeginIpStr

getBeginIpLong

getEndIpStr

getMaskBitByMask

countByMaskBit

getMaskByMaskBit

getMaskByIpRange

countByIpRange

isMaskValid

isMaskBitValid

isInnerIP

matches

getEndIpLong