diff --git a/hutool-core/src/main/java/cn/hutool/core/net/Ipv4Pool.java b/hutool-core/src/main/java/cn/hutool/core/net/Ipv4Pool.java new file mode 100644 index 000000000..409f01452 --- /dev/null +++ b/hutool-core/src/main/java/cn/hutool/core/net/Ipv4Pool.java @@ -0,0 +1,440 @@ +package cn.hutool.core.net; + +/** + * Ip相关常量 + *

+ * 

+ * 为了方便处理作出以下特别说明，若后续因此收到影响或有更好处理方式需要及时调整：
+ * 1、此处定义的`最小值`、`最大值`并非实际ip可分配的最小值、最大值。而是正常地址格式所能表示的最小值、最大值。
+ * 2、比如：1.0.0.0这种保留地址，我们仍然认为属于A类网。
+ * 3、类似于127.0.0.1这种本地回环地址，我们仍然认为数据C类网。
+ *
+ * + * @author aoshiguchen + * @author emptypoint + * @since 6.0.0 + */ +public interface Ipv4Pool { + + /** + * IP段的分割符 + */ + String IP_SPLIT_MARK = "-"; + + /** + * IP与掩码的分割符 + */ + String IP_MASK_SPLIT_MARK = "/"; + + /** + * localhost默认解析的ip地址 + */ + String LOCAL_IP = "127.0.0.1"; + /** + * localhost默认解析的ip地址的数值形式 + */ + long LOCAL_IP_NUM = Ipv4Util.ipv4ToLong(LOCAL_IP); + + /** + * Ipv4地址最小值字符串形式 + */ + String IPV4_STR_MIN = "0.0.0.0"; + /** + * Ipv4最小值数值形式 + */ + long IPV4_NUM_MIN = Ipv4Util.ipv4ToLong(IPV4_STR_MIN); + + /** + * Ipv4地址最大值字符串形式 + */ + String IPV4_STR_MAX = "255.255.255.255"; + /** + * Ipv4最大值数值形式 + */ + long IPV4_NUM_MAX = 0xffffffffL; + + /** + * Ipv4未使用地址最小值字符串形式 + */ + String IPV4_UNUSED_STR_MIN = "0.0.0.0"; + /** + * Ipv4未使用地址最小值数值形式 + */ + long IPV4_UNUSED_NUM_MIN = Ipv4Util.ipv4ToLong(IPV4_UNUSED_STR_MIN); + + /** + * Ipv4未使用地址最大值字符串形式 + */ + String IPV4_UNUSED_STR_MAX = "0.255.255.255"; + /** + * Ipv4未使用地址最大值数值形式 + */ + long IPV4_UNUSED_NUM_MAX = Ipv4Util.ipv4ToLong(IPV4_UNUSED_STR_MAX); + + // region 子网掩码常量 + // ================================================== 子网掩码常量 ================================================== + /** + * Ipv4最小掩码位 + */ + int IPV4_MASK_BIT_MIN = 0; + + /** + * Ipv4有意义的最小掩码位 + */ + int IPV4_MASK_BIT_VALID_MIN = 1; + /** + * Ipv4有意义的最小掩码字符串 + */ + String IPV4_MASK_VALID_MIN = MaskBit.get(IPV4_MASK_BIT_VALID_MIN); + + /** + * Ipv4最大掩码位 + */ + int IPV4_MASK_BIT_MAX = 32; + /** + * Ipv4最大掩码字符串 + */ + String IPV4_MASK_MAX = MaskBit.get(IPV4_MASK_BIT_MAX); + // endregion + + // region 本地回环地址常量 + // ================================================== 本地回环地址常量 ================================================ + /** + * Ipv4 本地回环地址最小值字符串形式 + */ + String IPV4_LOOPBACK_STR_MIN = "127.0.0.0"; + /** + * Ipv4 本地回环地址最小值数值形式 + */ + long IPV4_LOOPBACK_NUM_MIN = Ipv4Util.ipv4ToLong(IPV4_LOOPBACK_STR_MIN); + /** + * Ipv4 本地回环地址最大值字符串形式 + */ + String IPV4_LOOPBACK_STR_MAX = "127.255.255.255"; + /** + * Ipv4 本地回环地址最大值数值形式 + */ + long IPV4_LOOPBACK_NUM_MAX = Ipv4Util.ipv4ToLong(IPV4_LOOPBACK_STR_MAX); + // endregion + + // region A类地址常量 + // ================================================== A类地址常量 ================================================== + /** + * Ipv4 A类地址最小值字符串形式 + */ + String IPV4_A_STR_MIN = "0.0.0.0"; + /** + * Ipv4 A类地址最小值数值形式 + */ + long IPV4_A_NUM_MIN = Ipv4Util.ipv4ToLong(IPV4_A_STR_MIN); + + /** + * Ipv4 A类地址最大值字符串形式 + */ + String IPV4_A_STR_MAX = "127.255.255.255"; + /** + * Ipv4 A类地址最大值数值形式 + */ + long IPV4_A_NUM_MAX = Ipv4Util.ipv4ToLong(IPV4_A_STR_MAX); + + /** + * Ipv4 A类地址第一个公网网段最小值字符串形式 + */ + String IPV4_A_PUBLIC_1_STR_MIN = "1.0.0.0"; + /** + * Ipv4 A类地址第一个公网网段最小值数值形式 + */ + long IPV4_A_PUBLIC_1_NUM_MIN = Ipv4Util.ipv4ToLong(IPV4_A_PUBLIC_1_STR_MIN); + + /** + * Ipv4 A类地址第一个公网网段最大值字符串形式 + */ + String IPV4_A_PUBLIC_1_STR_MAX = "9.255.255.255"; + /** + * Ipv4 A类地址第一个公网网段最大值数值形式 + */ + long IPV4_A_PUBLIC_1_NUM_MAX = Ipv4Util.ipv4ToLong(IPV4_A_PUBLIC_1_STR_MAX); + + /** + * Ipv4 A类地址私网网段最小值字符串形式 + */ + String IPV4_A_PRIVATE_STR_MIN = "10.0.0.0"; + /** + * Ipv4 A类地址私网网段最小值数值形式 + */ + long IPV4_A_PRIVATE_NUM_MIN = Ipv4Util.ipv4ToLong(IPV4_A_PRIVATE_STR_MIN); + + /** + * Ipv4 A类地址私网网段最大值字符串形式 + */ + String IPV4_A_PRIVATE_STR_MAX = "10.255.255.255"; + /** + * Ipv4 A类地址私网网段最大值数值形式 + */ + long IPV4_A_PRIVATE_NUM_MAX = Ipv4Util.ipv4ToLong(IPV4_A_PRIVATE_STR_MAX); + + /** + * Ipv4 A类地址第二个公网网段最小值字符串形式 + */ + String IPV4_A_PUBLIC_2_STR_MIN = "11.0.0.0"; + /** + * Ipv4 A类地址第二个公网网段最小值数值形式 + */ + long IPV4_A_PUBLIC_2_NUM_MIN = Ipv4Util.ipv4ToLong(IPV4_A_PUBLIC_2_STR_MIN); + + /** + * Ipv4 A类地址第二个公网网段最大值字符串形式 + */ + String IPV4_A_PUBLIC_2_STR_MAX = "126.255.255.255"; + /** + * Ipv4 A类地址第二个公网网段最大值数值形式 + */ + long IPV4_A_PUBLIC_2_NUM_MAX = Ipv4Util.ipv4ToLong(IPV4_A_PUBLIC_2_STR_MAX); + // endregion + + // region B类地址常量 + // ================================================== B类地址常量 ================================================== + /** + * Ipv4 B类地址最小值字符串形式 + */ + String IPV4_B_STR_MIN = "128.0.0.0"; + /** + * Ipv4 B类地址最小值数值形式 + */ + long IPV4_B_NUM_MIN = Ipv4Util.ipv4ToLong(IPV4_B_STR_MIN); + + /** + * Ipv4 B类地址最大值字符串形式 + */ + String IPV4_B_STR_MAX = "191.255.255.255"; + /** + * Ipv4 B类地址最大值数值形式 + */ + long IPV4_B_NUM_MAX = Ipv4Util.ipv4ToLong(IPV4_B_STR_MAX); + + /** + * Ipv4 B类地址第一个公网网段最小值字符串形式 + */ + String IPV4_B_PUBLIC_1_STR_MIN = "128.0.0.0"; + /** + * Ipv4 B类地址第一个公网网段最小值数值形式 + */ + long IPV4_B_PUBLIC_1_NUM_MIN = Ipv4Util.ipv4ToLong(IPV4_B_PUBLIC_1_STR_MIN); + + /** + * Ipv4 B类地址第一个公网网段最大值字符串形式 + */ + String IPV4_B_PUBLIC_1_STR_MAX = "172.15.255.255"; + /** + * Ipv4 B类地址第一个公网网段最大值数值形式 + */ + long IPV4_B_PUBLIC_1_NUM_MAX = Ipv4Util.ipv4ToLong(IPV4_B_PUBLIC_1_STR_MAX); + + /** + * Ipv4 B类地址私网网段最小值字符串形式 + */ + String IPV4_B_PRIVATE_STR_MIN = "172.16.0.0"; + /** + * Ipv4 B类地址私网网段最小值数值形式 + */ + long IPV4_B_PRIVATE_NUM_MIN = Ipv4Util.ipv4ToLong(IPV4_B_PRIVATE_STR_MIN); + + /** + * Ipv4 B类地址私网网段最大值字符串形式 + */ + String IPV4_B_PRIVATE_STR_MAX = "172.31.255.255"; + /** + * Ipv4 B类地址私网网段最大值数值形式 + */ + long IPV4_B_PRIVATE_NUM_MAX = Ipv4Util.ipv4ToLong(IPV4_B_PRIVATE_STR_MAX); + + /** + * Ipv4 B类地址第二个公网网段最小值字符串形式 + */ + String IPV4_B_PUBLIC_2_STR_MIN = "172.32.0.0"; + /** + * Ipv4 B类地址第二个公网网段最小值数值形式 + */ + long IPV4_B_PUBLIC_2_NUM_MIN = Ipv4Util.ipv4ToLong(IPV4_B_PUBLIC_2_STR_MIN); + + /** + * Ipv4 B类地址第二个公网网段最大值字符串形式 + */ + String IPV4_B_PUBLIC_2_STR_MAX = "191.255.255.255"; + /** + * Ipv4 B类地址第二个公网网段最大值数值形式 + */ + long IPV4_B_PUBLIC_2_NUM_MAX = Ipv4Util.ipv4ToLong(IPV4_B_PUBLIC_2_STR_MAX); + // endregion + + // region C类地址常量 + // ================================================== C类地址常量 ================================================== + /** + * Ipv4 C类地址最小值字符串形式 + */ + String IPV4_C_STR_MIN = "192.0.0.0"; + /** + * Ipv4 C类地址最小值数值形式 + */ + long IPV4_C_NUM_MIN = Ipv4Util.ipv4ToLong(IPV4_C_STR_MIN); + + /** + * Ipv4 C类地址最大值字符串形式 + */ + String IPV4_C_STR_MAX = "223.255.255.255"; + /** + * Ipv4 C类地址最大值数值形式 + */ + long IPV4_C_NUM_MAX = Ipv4Util.ipv4ToLong(IPV4_C_STR_MAX); + + /** + * Ipv4 C类地址第一个公网网段最小值字符串形式 + */ + String IPV4_C_PUBLIC_1_STR_MIN = "192.0.0.0"; + /** + * Ipv4 C类地址第一个公网网段最小值数值形式 + */ + long IPV4_C_PUBLIC_1_NUM_MIN = Ipv4Util.ipv4ToLong(IPV4_C_PUBLIC_1_STR_MIN); + + /** + * Ipv4 C类地址第一个公网网段最大值字符串形式 + */ + String IPV4_C_PUBLIC_1_STR_MAX = "192.167.255.255"; + /** + * Ipv4 C类地址第一个公网网段最大值数值形式 + */ + long IPV4_C_PUBLIC_1_NUM_MAX = Ipv4Util.ipv4ToLong(IPV4_C_PUBLIC_1_STR_MAX); + + /** + * Ipv4 C类地址私网网段最小值字符串形式 + */ + String IPV4_C_PRIVATE_STR_MIN = "192.168.0.0"; + /** + * Ipv4 C类地址私网网段最小值数值形式 + */ + long IPV4_C_PRIVATE_NUM_MIN = Ipv4Util.ipv4ToLong(IPV4_C_PRIVATE_STR_MIN); + + /** + * Ipv4 C类地址私网网段最大值字符串形式 + */ + String IPV4_C_PRIVATE_STR_MAX = "192.168.255.255"; + /** + * Ipv4 C类地址私网网段最大值数值形式 + */ + long IPV4_C_PRIVATE_NUM_MAX = Ipv4Util.ipv4ToLong(IPV4_C_PRIVATE_STR_MAX); + + /** + * Ipv4 C类地址第二个公网网段最小值字符串形式 + */ + String IPV4_C_PUBLIC_2_STR_MIN = "192.169.0.0"; + /** + * Ipv4 C类地址第二个公网网段最小值数值形式 + */ + long IPV4_C_PUBLIC_2_NUM_MIN = Ipv4Util.ipv4ToLong(IPV4_C_PUBLIC_2_STR_MIN); + + /** + * Ipv4 C类地址第二个公网网段最大值字符串形式 + */ + String IPV4_C_PUBLIC_2_STR_MAX = "223.255.255.255"; + /** + * Ipv4 C类地址第二个公网网段最大值数值形式 + */ + long IPV4_C_PUBLIC_2_NUM_MAX = Ipv4Util.ipv4ToLong(IPV4_C_PUBLIC_2_STR_MAX); + // endregion + + // region D类地址常量 + // ================================================== D类地址常量 ================================================== + /** + * Ipv4 D类地址最小值字符串形式 + */ + String IPV4_D_STR_MIN = "224.0.0.0"; + /** + * Ipv4 D类地址最小值数值形式 + */ + long IPV4_D_NUM_MIN = Ipv4Util.ipv4ToLong(IPV4_D_STR_MIN); + + /** + * Ipv4 D类地址最大值字符串形式 + */ + String IPV4_D_STR_MAX = "239.255.255.255"; + /** + * Ipv4 D类地址最大值数值形式 + */ + long IPV4_D_NUM_MAX = Ipv4Util.ipv4ToLong(IPV4_D_STR_MAX); + + /** + * Ipv4 D类地址专用网段(用于广播)最小值字符串形式 + */ + String IPV4_D_DEDICATED_STR_MIN = "224.0.0.0"; + /** + * Ipv4 D类地址专用网段(用于广播)最小值数值形式 + */ + long IPV4_D_DEDICATED_NUM_MIN = Ipv4Util.ipv4ToLong(IPV4_D_DEDICATED_STR_MIN); + + /** + * Ipv4 D类地址专用网段(用于广播)最大值字符串形式 + */ + String IPV4_D_DEDICATED_STR_MAX = "224.0.0.255"; + /** + * Ipv4 D类地址专用网段(用于广播)最大值数值形式 + */ + long IPV4_D_DEDICATED_NUM_MAX = Ipv4Util.ipv4ToLong(IPV4_D_DEDICATED_STR_MAX); + + /** + * Ipv4 D类地址公用网段(用于组播)最小值字符串形式 + */ + String IPV4_D_PUBLIC_STR_MIN = "224.0.1.0"; + /** + * Ipv4 D类地址公用网段(用于组播)最小值数值形式 + */ + long IPV4_D_PUBLIC_NUM_MIN = Ipv4Util.ipv4ToLong(IPV4_D_PUBLIC_STR_MIN); + + /** + * Ipv4 D类地址公用网段(用于组播)最大值字符串形式 + */ + String IPV4_D_PUBLIC_STR_MAX = "238.255.255.255"; + /** + * Ipv4 D类地址公用网段(用于组播)最大值数值形式 + */ + long IPV4_D_PUBLIC_NUM_MAX = Ipv4Util.ipv4ToLong(IPV4_D_PUBLIC_STR_MAX); + + /** + * Ipv4 D类地址私用网段(用于测试)最小值字符串形式 + */ + String IPV4_D_PRIVATE_STR_MIN = "239.0.0.0"; + /** + * Ipv4 D类地址私用网段(用于测试)最小值数值形式 + */ + long IPV4_D_PRIVATE_NUM_MIN = Ipv4Util.ipv4ToLong(IPV4_D_PRIVATE_STR_MIN); + + /** + * Ipv4 D类地址私用网段(用于测试)最大值字符串形式 + */ + String IPV4_D_PRIVATE_STR_MAX = "239.255.255.255"; + /** + * Ipv4 D类地址私用网段(用于测试)最大值数值形式 + */ + long IPV4_D_PRIVATE_NUM_MAX = Ipv4Util.ipv4ToLong(IPV4_D_PRIVATE_STR_MAX); + // endregion + + // region E类地址常量 + // ================================================== E类地址常量 ================================================== + /** + * Ipv4 E类地址最小值字符串形式 + */ + String IPV4_E_STR_MIN = "240.0.0.0"; + /** + * Ipv4 E类地址最小值数值形式 + */ + long IPV4_E_NUM_MIN = Ipv4Util.ipv4ToLong(IPV4_E_STR_MIN); + + /** + * Ipv4 E类地址最大值字符串形式 + */ + String IPV4_E_STR_MAX = "255.255.255.255"; + /** + * Ipv4 E类地址最大值数值形式 + */ + long IPV4_E_NUM_MAX = Ipv4Util.ipv4ToLong(IPV4_E_STR_MAX); + // endregion +} diff --git a/hutool-core/src/main/java/cn/hutool/core/net/Ipv4Util.java b/hutool-core/src/main/java/cn/hutool/core/net/Ipv4Util.java index 617a3b0ed..ac992a443 100755 --- a/hutool-core/src/main/java/cn/hutool/core/net/Ipv4Util.java +++ b/hutool-core/src/main/java/cn/hutool/core/net/Ipv4Util.java @@ -29,64 +29,10 @@ import java.util.regex.Matcher; * * @author ZhuKun * @author emptypoint + * @author aoshiguchen * @since 5.4.1 */ -public class Ipv4Util { - - /** - * 本地IP：127.0.0.1 - */ - public static final String LOCAL_IP = "127.0.0.1"; - - /** - * IP段的分割符 - */ - public static final String IP_SPLIT_MARK = "-"; - - /** - * IP与掩码的分割符 - */ - public static final String IP_MASK_SPLIT_MARK = StrUtil.SLASH; - - /** - * 最大掩码位 - */ - public static final int IP_MASK_MAX = 32; - - /** - * 最小掩码位 - */ - public static final int IP_MASK_MIN = 1; - - /** - * A类私有地址的最小值 - */ - public static final long A_INNER_IP_LONG_BEGIN = ipv4ToLong("10.0.0.0"); - - /** - * A类私有地址的最大值 - */ - public static final long A_INNER_IP_LONG_END = ipv4ToLong("10.255.255.255"); - - /** - * B类私有地址的最小值 - */ - public static final long B_INNER_IP_LONG_BEGIN = ipv4ToLong("172.16.0.0"); - - /** - * B类私有地址的最大值 - */ - public static final long B_INNER_IP_LONG_END = ipv4ToLong("172.31.255.255"); - - /** - * C类私有地址的最小值 - */ - public static final long C_INNER_IP_LONG_BEGIN = ipv4ToLong("192.168.0.0"); - - /** - * C类私有地址的最大值 - */ - public static final long C_INNER_IP_LONG_END = ipv4ToLong("192.168.255.255"); +public class Ipv4Util implements Ipv4Pool { /** * 根据 ip地址 和 掩码地址 获得 CIDR格式字符串 @@ -135,7 +81,7 @@ public class Ipv4Util { return new ArrayList<>(0); } - if (maskBit == IP_MASK_MAX) { + if (maskBit == IPV4_MASK_BIT_MAX) { final List list = new ArrayList<>(isAll ? 1 : 0); if (isAll) { list.add(ip); @@ -311,25 +257,26 @@ public class Ipv4Util { /** * 获取 子网内的 地址总数 * - * @param maskBit 掩码位，取值范围：[2, {@link #IP_MASK_MAX}] + * @param maskBit 掩码位，取值范围：({@link Ipv4Pool#IPV4_MASK_BIT_VALID_MIN}, {@link Ipv4Pool#IPV4_MASK_BIT_MAX}] * @param isAll true:全量地址，false:可用地址 * @return 子网内地址总数 */ public static int countByMaskBit(final int maskBit, final boolean isAll) { - assertMaskBitValid(maskBit); + Assert.isTrue(maskBit > IPV4_MASK_BIT_VALID_MIN && maskBit <= IPV4_MASK_BIT_MAX, + "Not support mask bit: {}", maskBit); //如果掩码位等于32，则可用地址为0 - if (maskBit == 32 && false == isAll) { + if (maskBit == IPV4_MASK_BIT_MAX && false == isAll) { return 0; } - final int count = 1 << (32 - maskBit); + final int count = 1 << (IPV4_MASK_BIT_MAX - maskBit); return isAll ? count : count - 2; } /** * 根据 掩码位 获取 掩码地址 * - * @param maskBit 掩码位，如：24，取值范围：[{@link #IP_MASK_MIN}, {@link #IP_MASK_MAX}] + * @param maskBit 掩码位，如：24，取值范围：[{@link Ipv4Pool#IPV4_MASK_BIT_VALID_MIN}, {@link Ipv4Pool#IPV4_MASK_BIT_MAX}] * @return 掩码地址，点分十进制，如:255.255.255.0 */ public static String getMaskByMaskBit(final int maskBit) { @@ -400,11 +347,11 @@ public class Ipv4Util { /** * 判断掩码位是否合法 * - * @param maskBit 掩码位，有效范围：[{@link #IP_MASK_MIN}, {@link #IP_MASK_MAX}] + * @param maskBit 掩码位，有效范围：[{@link Ipv4Pool#IPV4_MASK_BIT_VALID_MIN}, {@link Ipv4Pool#IPV4_MASK_BIT_MAX}] * @return true：掩码位合法；false：掩码位不合法 */ public static boolean isMaskBitValid(final int maskBit) { - return maskBit >= IP_MASK_MIN && maskBit <= IP_MASK_MAX; + return maskBit >= IPV4_MASK_BIT_VALID_MIN && maskBit <= IPV4_MASK_BIT_MAX; } /** @@ -422,13 +369,88 @@ public class Ipv4Util { * @since 5.7.18 */ public static boolean isInnerIP(final String ipAddress) { - final long ipNum = ipv4ToLong(ipAddress); - return isBetween(ipNum, A_INNER_IP_LONG_BEGIN, A_INNER_IP_LONG_END) - || isBetween(ipNum, B_INNER_IP_LONG_BEGIN, B_INNER_IP_LONG_END) - || isBetween(ipNum, C_INNER_IP_LONG_BEGIN, C_INNER_IP_LONG_END) - || LOCAL_IP.equals(ipAddress); + return isInnerIP(ipv4ToLong(ipAddress)); } + /** + * 是否为内网地址 + * + * @param ipNum IP地址数值形式 + * @return 是否为内网IP + * @see #isInnerIP(String) + * @since 6.0.0 + */ + public static boolean isInnerIP(final long ipNum) { + return isBetween(ipNum, IPV4_A_PRIVATE_NUM_MIN, IPV4_A_PRIVATE_NUM_MAX) + || isBetween(ipNum, IPV4_B_PRIVATE_NUM_MIN, IPV4_B_PRIVATE_NUM_MAX) + || isBetween(ipNum, IPV4_C_PRIVATE_NUM_MIN, IPV4_C_PRIVATE_NUM_MAX) + || LOCAL_IP_NUM == ipNum; + } + + /** + * 是否为公网地址 + *

+ * 公网IP： + * 

+	 * A类 1.0.0.0-9.255.255.255，11.0.0.0-126.255.255.255
+	 * B类 128.0.0.0-172.15.255.255，172.32.0.0-191.255.255.255
+	 * C类 192.0.0.0-192.167.255.255，192.169.0.0-223.255.255.255
+	 *
+ * + * @param ipAddress IP地址，点分十进制 + * @return 是否为公网IP + * @since 6.0.0 + */ + public static boolean isPublicIP(final String ipAddress) { + return isPublicIP(ipv4ToLong(ipAddress)); + } + + /** + * 是否为公网地址 + * + * @param ipNum IP地址数值形式 + * @return 是否为公网IP + * @see #isPublicIP(String) + * @since 6.0.0 + */ + public static boolean isPublicIP(final long ipNum) { + return isBetween(ipNum, IPV4_A_PUBLIC_1_NUM_MIN, IPV4_A_PUBLIC_1_NUM_MAX) + || isBetween(ipNum, IPV4_A_PUBLIC_2_NUM_MIN, IPV4_A_PUBLIC_2_NUM_MAX) + || isBetween(ipNum, IPV4_B_PUBLIC_1_NUM_MIN, IPV4_B_PUBLIC_1_NUM_MAX) + || isBetween(ipNum, IPV4_B_PUBLIC_2_NUM_MIN, IPV4_B_PUBLIC_2_NUM_MAX) + || isBetween(ipNum, IPV4_C_PUBLIC_1_NUM_MIN, IPV4_C_PUBLIC_1_NUM_MAX) + || isBetween(ipNum, IPV4_C_PUBLIC_2_NUM_MIN, IPV4_C_PUBLIC_2_NUM_MAX); + } + + /** + * 获取ip(Long类型)指定部分的十进制值，即，{@literal X.X.X.X }形式中每个部分的值 + *

例如，ip为{@literal 0xC0A802FA}，第1部分的值为： + *

+ * + * @param ip ip地址，Long类型 + * @param position 指定位置，取值范围：[1,4] + * @return ip地址指定部分的十进制值 + * @since 6.0.0 + */ + public static int getPartOfIpLong(final long ip, final int position) { + switch (position) { + case 1: + return ((int) ip >> 24) & 0xFF; + case 2: + return ((int) ip >> 16) & 0xFF; + case 3: + return ((int) ip >> 8) & 0xFF; + case 4: + return ((int) ip) & 0xFF; + default: + throw new IllegalArgumentException("Illegal position of ip Long: " + position); + } + } //-------------------------------------------------------------------------------- Private method start /** @@ -446,7 +468,7 @@ public class Ipv4Util { } // int的最高位无法直接使用，转为Long if (addr < 0) { - return 0xffffffffL & addr; + return IPV4_NUM_MAX & addr; } return addr; } @@ -464,42 +486,12 @@ public class Ipv4Util { } /** - * 校验 掩码位数，合法范围为：[1,32]，不合法则抛出异常 + * 校验 掩码位数，合法范围为：[{@link Ipv4Pool#IPV4_MASK_BIT_VALID_MIN}, {@link Ipv4Pool#IPV4_MASK_BIT_MAX}]，不合法则抛出异常 * * @param maskBit 掩码位数 */ private static void assertMaskBitValid(final int maskBit) { Assert.isTrue(isMaskBitValid(maskBit), "Invalid maskBit：{}", maskBit); } - - /** - * 获取ip(Long类型)指定部分的十进制值，即，{@literal X.X.X.X }形式中每个部分的值 - *

例如，ip为{@literal 0xC0A802FA}，第1部分的值为： - *

- *

- * - * @param ip ip地址，Long类型 - * @param position 指定位置，取值范围：[1,4] - * @return ip地址指定部分的十进制值 - */ - private static int getPartOfIpLong(final long ip, final int position) { - switch (position) { - case 1: - return ((int) ip >> 24) & 0xFF; - case 2: - return ((int) ip >> 16) & 0xFF; - case 3: - return ((int) ip >> 8) & 0xFF; - case 4: - return ((int) ip) & 0xFF; - default: - throw new IllegalArgumentException("Illegal position of ip Long: " + position); - } - } //-------------------------------------------------------------------------------- Private method end } diff --git a/hutool-core/src/test/java/cn/hutool/core/net/Ipv4UtilTest.java b/hutool-core/src/test/java/cn/hutool/core/net/Ipv4UtilTest.java index 97497d5b4..f866bd13a 100644 --- a/hutool-core/src/test/java/cn/hutool/core/net/Ipv4UtilTest.java +++ b/hutool-core/src/test/java/cn/hutool/core/net/Ipv4UtilTest.java @@ -148,10 +148,31 @@ public class Ipv4UtilTest { ); } - private static void testLongToIp(final String ip){ + private static void testLongToIp(final String ip) { final long ipLong = Ipv4Util.ipv4ToLong(ip); final String ipv4 = Ipv4Util.longToIpv4(ipLong); Assert.assertEquals(ip, ipv4); } + @Test + public void isInnerTest() { + Assert.assertTrue(Ipv4Util.isInnerIP(Ipv4Util.LOCAL_IP)); + Assert.assertTrue(Ipv4Util.isInnerIP("192.168.5.12")); + Assert.assertTrue(Ipv4Util.isInnerIP("172.20.10.1")); + + Assert.assertFalse(Ipv4Util.isInnerIP("180.10.2.5")); + Assert.assertFalse(Ipv4Util.isInnerIP("192.160.10.3")); + } + + @Test + public void isPublicTest() { + Assert.assertTrue(Ipv4Util.isPublicIP("180.10.2.5")); + Assert.assertTrue(Ipv4Util.isPublicIP("192.160.10.3")); + + Assert.assertFalse(Ipv4Util.isPublicIP(Ipv4Util.LOCAL_IP)); + Assert.assertFalse(Ipv4Util.isPublicIP("192.168.5.12")); + Assert.assertFalse(Ipv4Util.isPublicIP("127.0.0.1")); + Assert.assertFalse(Ipv4Util.isPublicIP("172.20.10.1")); + } + }