On 04/04/2009, rwins...@apache.org <rwins...@apache.org> wrote:
> Author: rwinston
>  Date: Sat Apr  4 18:46:23 2009
>  New Revision: 761983
>
>  URL: http://svn.apache.org/viewvc?rev=761983&view=rev
>  Log:
>  NET-261 NET-262: Clarify range assumptions and fix range checks
>
>  Modified:
>     
> commons/proper/net/branches/NET_2_0/src/main/java/org/apache/commons/net/util/SubnetUtils.java
>
>  Modified: 
> commons/proper/net/branches/NET_2_0/src/main/java/org/apache/commons/net/util/SubnetUtils.java
>  URL: 
> http://svn.apache.org/viewvc/commons/proper/net/branches/NET_2_0/src/main/java/org/apache/commons/net/util/SubnetUtils.java?rev=761983&r1=761982&r2=761983&view=diff
>  
> ==============================================================================
>  --- 
> commons/proper/net/branches/NET_2_0/src/main/java/org/apache/commons/net/util/SubnetUtils.java
>  (original)
>  +++ 
> commons/proper/net/branches/NET_2_0/src/main/java/org/apache/commons/net/util/SubnetUtils.java
>  Sat Apr  4 18:46:23 2009
>  @@ -69,6 +69,13 @@
>          private int low()           { return network() + 1; }
>          private int high()          { return broadcast() - 1; }
>
>  +        /**
>  +         * Returns true if the parameter <code>address</code> is in the
>  +         * range of usable endpoint addresses for this subnet. This 
> excludes the
>  +         * network and broadcast adresses.
>  +         * @param address A dot-delimited IPv4 address, e.g. "192.168.0.1"
>  +         * @return True if in range, false otherwise
>  +         */
>          public boolean isInRange(String address)    { return 
> isInRange(toInteger(address)); }
>
>          private boolean isInRange(int address)      {
>  @@ -131,10 +138,12 @@
>              address = matchAddress(matcher);
>
>              /* Create a binary netmask from the number of bits specification 
> /x */
>  -            int cidrPart = rangeCheck(Integer.parseInt(matcher.group(5)), 
> 0, NBITS-1);
>  +            int cidrPart = rangeCheck(Integer.parseInt(matcher.group(5)), 
> -1, NBITS-1);
>              for (int j = 0; j < cidrPart; ++j) {
>                  netmask |= (1 << 31-j);
>              }
>  +
>  +            rangeCheck(pop(netmask),0, NBITS);
>
>              /* Calculate base network address */
>              network = (address & netmask);
>  @@ -165,7 +174,7 @@
>      private int matchAddress(Matcher matcher) {
>          int addr = 0;
>          for (int i = 1; i <= 4; ++i) {
>  -            int n = (rangeCheck(Integer.parseInt(matcher.group(i)), 0, 
> 255));
>  +            int n = (rangeCheck(Integer.parseInt(matcher.group(i)), -1, 
> 255));
>              addr |= ((n & 0xff) << 8*(4-i));
>          }
>          return addr;
>  @@ -196,10 +205,12 @@
>      }
>
>      /*
>  -     * Convenience function to check integer boundaries
>  +     * Convenience function to check integer boundaries.
>  +     * Checks if a value x is in the range (begin,end].
>  +     * Returns x if it is in range, throws an exception otherwise.
>       */
>      private int rangeCheck(int value, int begin, int end) {
>  -        if (value > begin && value <= end) // (0,nbits]
>  +        if (value > begin && value <= end) // (begin,end]

Seems to me it would be quite a bit clearer if the check included both
ends of the range.

As it is currently, the code has to pass in -1 in order to allow 0 as a value.

>              return value;
>
>          throw new IllegalArgumentException("Value out of range: [" + value + 
> "]");

This should show the range, e.g.

throw new
IllegalArgumentException("Value [" + value + "] not in range
("+begin+","+end+"]");

>
>
>

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscr...@commons.apache.org
For additional commands, e-mail: dev-h...@commons.apache.org

Reply via email to