org.jboss.netty.handler.ipfilter.IpSubnet Maven / Gradle / Ivy

Show more of this group Show more artifacts with this name
Show all versions of hadoop-ranger-client-for-impala Show documentation
Tencent Qcloud chdfs hadoop ranger client.
There is a newer version: 3.3.0-4.1
Show newest version
/*
 * Copyright 2012 The Netty Project
 *
 * The Netty Project licenses this file to you under the Apache License,
 * version 2.0 (the "License"); you may not use this file except in compliance
 * with the License. You may obtain a copy of the License at:
 *
 *   http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
 * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
 * License for the specific language governing permissions and limitations
 * under the License.
 */
package org.jboss.netty.handler.ipfilter;

import org.jboss.netty.logging.InternalLogger;
import org.jboss.netty.logging.InternalLoggerFactory;

import java.net.InetAddress;
import java.net.UnknownHostException;

/**
 * This class allows to check if an IP V4 or V6 Address is contained in a subnet.

 * 
 * Supported IP V4 Formats for the Subnets are: 1.1.1.1/255.255.255.255 or 1.1.1.1/32 (CIDR-Notation)
 * and (InetAddress,Mask) where Mask is a integer for CIDR-notation or a String for Standard Mask notation.

 * 

Example1:

 * IpV4Subnet ips = new IpV4Subnet("192.168.1.0/24");

 * System.out.println("Result: "+ ips.contains("192.168.1.123"));

 * System.out.println("Result: "+ ips.contains(inetAddress2));

 * 
Example1 bis:

 * IpV4Subnet ips = new IpV4Subnet(inetAddress, 24);

 * where inetAddress is 192.168.1.0 and inetAddress2 is 192.168.1.123

 * 

Example2:

 * IpV4Subnet ips = new IpV4Subnet("192.168.1.0/255.255.255.0");

 * System.out.println("Result: "+ ips.contains("192.168.1.123"));

 * System.out.println("Result: "+ ips.contains(inetAddress2));

 * 
Example2 bis:

 * IpV4Subnet ips = new IpV4Subnet(inetAddress, "255.255.255.0");

 * where inetAddress is 192.168.1.0 and inetAddress2 is 192.168.1.123

 * 

 * Supported IP V6 Formats for the Subnets are: a:b:c:d:e:f:g:h/NN (CIDR-Notation)
 * or any IPV6 notations (like a:b:c:d::/NN, a:b:c:d:e:f:w.x.y.z/NN)
 * and (InetAddress,Mask) where Mask is a integer for CIDR-notation
 * and (InetAddress,subnet).

 * 

Example1:

 * IpSubnet ips = new IpSubnet("1fff:0:0a88:85a3:0:0:0:0/24");

 * IpSubnet ips = new IpSubnet("1fff:0:0a88:85a3::/24");

 * System.out.println("Result: "+ ips.contains("1fff:0:0a88:85a3:0:0:ac1f:8001"));

 * System.out.println("Result: "+ ips.contains(inetAddress2));

 * 
Example1 bis:

 * IpSubnet ips = new IpSubnet(inetAddress, 24);

 * where inetAddress2 is 1fff:0:0a88:85a3:0:0:ac1f:8001

 */
public class IpSubnet implements IpSet, Comparable {

    private static final InternalLogger logger =
        InternalLoggerFactory.getInstance(IpSubnet.class);

    /** Internal representation */
    private final CIDR cidr;

    /** Create IpSubnet for ALL (used for ALLOW or DENY ALL) */
    public IpSubnet() {
        // ALLOW or DENY ALL
        cidr = null;
    }

    /**
     * Create IpSubnet using the CIDR or normal Notation

     * i.e.:

     * IpSubnet subnet = new IpSubnet("10.10.10.0/24"); or

     * IpSubnet subnet = new IpSubnet("10.10.10.0/255.255.255.0"); or

     * IpSubnet subnet = new IpSubnet("1fff:0:0a88:85a3:0:0:0:0/24");
     *
     * @param netAddress a network address as string.
     */
    public IpSubnet(String netAddress) throws UnknownHostException {
        cidr = CIDR.newCIDR(netAddress);
    }

    /** Create IpSubnet using the CIDR Notation */
    public IpSubnet(InetAddress inetAddress, int cidrNetMask) throws UnknownHostException {
        cidr = CIDR.newCIDR(inetAddress, cidrNetMask);
    }

    /** Create IpSubnet using the normal Notation */
    public IpSubnet(InetAddress inetAddress, String netMask) throws UnknownHostException {
        cidr = CIDR.newCIDR(inetAddress, netMask);
    }

    /**
     * Compares the given IP-Address against the Subnet and returns true if
     * the ip is in the subnet-ip-range and false if not.
     *
     * @param ipAddr an ipaddress
     * @return returns true if the given IP address is inside the currently
     *         set network.
     */
    public boolean contains(String ipAddr) throws UnknownHostException {
        InetAddress inetAddress1 = InetAddress.getByName(ipAddr);
        return contains(inetAddress1);
    }

    /**
     * Compares the given InetAddress against the Subnet and returns true if
     * the ip is in the subnet-ip-range and false if not.
     *
     * @return returns true if the given IP address is inside the currently
     *         set network.
     */
    public boolean contains(InetAddress inetAddress) {
        if (cidr == null) {
            // ANY
            return true;
        }
        return cidr.contains(inetAddress);
    }

    @Override
    public String toString() {
        return cidr.toString();
    }

    @Override
    public boolean equals(Object o) {
        if (!(o instanceof IpSubnet)) {
            return false;
        }
        IpSubnet ipSubnet = (IpSubnet) o;
        return ipSubnet.cidr.equals(cidr);
    }

    @Override
    public int hashCode() {
        return cidr.hashCode();
    }

    /** Compare two IpSubnet */
    public int compareTo(IpSubnet o) {
        return cidr.toString().compareTo(o.cidr.toString());
    }
}