|
|
|
@@ -0,0 +1,211 @@ |
|
|
|
/* |
|
|
|
* Copyright 2006 The Apache Software Foundation |
|
|
|
* |
|
|
|
* Licensed 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.apache.tools.ant.util; |
|
|
|
|
|
|
|
import java.util.StringTokenizer; |
|
|
|
|
|
|
|
/** |
|
|
|
* Utility class to contain version numbers in "Dewey Decimal" |
|
|
|
* syntax. Numbers in the "Dewey Decimal" syntax consist of positive |
|
|
|
* decimal integers separated by periods ".". For example, "2.0" or |
|
|
|
* "1.2.3.4.5.6.7". This allows an extensible number to be used to |
|
|
|
* represent major, minor, micro, etc versions. The version number |
|
|
|
* must begin with a number. |
|
|
|
* |
|
|
|
*/ |
|
|
|
public class DeweyDecimal { |
|
|
|
|
|
|
|
/** Array of components that make up DeweyDecimal */ |
|
|
|
private int[] components; |
|
|
|
|
|
|
|
/** |
|
|
|
* Construct a DeweyDecimal from an array of integer components. |
|
|
|
* |
|
|
|
* @param components an array of integer components. |
|
|
|
*/ |
|
|
|
public DeweyDecimal(final int[] components) { |
|
|
|
this.components = new int[components.length]; |
|
|
|
|
|
|
|
for (int i = 0; i < components.length; i++) { |
|
|
|
this.components[i] = components[i]; |
|
|
|
} |
|
|
|
} |
|
|
|
|
|
|
|
/** |
|
|
|
* Construct a DeweyDecimal from string in DeweyDecimal format. |
|
|
|
* |
|
|
|
* @param string the string in dewey decimal format |
|
|
|
* @exception NumberFormatException if string is malformed |
|
|
|
*/ |
|
|
|
public DeweyDecimal(final String string) |
|
|
|
throws NumberFormatException { |
|
|
|
final StringTokenizer tokenizer = new StringTokenizer(string, ".", true); |
|
|
|
final int size = tokenizer.countTokens(); |
|
|
|
|
|
|
|
components = new int[ (size + 1) / 2 ]; |
|
|
|
|
|
|
|
for (int i = 0; i < components.length; i++) { |
|
|
|
final String component = tokenizer.nextToken(); |
|
|
|
if (component.equals("")) { |
|
|
|
throw new NumberFormatException("Empty component in string"); |
|
|
|
} |
|
|
|
|
|
|
|
components[ i ] = Integer.parseInt(component); |
|
|
|
|
|
|
|
//Strip '.' token |
|
|
|
if (tokenizer.hasMoreTokens()) { |
|
|
|
tokenizer.nextToken(); |
|
|
|
|
|
|
|
//If it ended in a dot, throw an exception |
|
|
|
if (!tokenizer.hasMoreTokens()) { |
|
|
|
throw new NumberFormatException("DeweyDecimal ended in a '.'"); |
|
|
|
} |
|
|
|
} |
|
|
|
} |
|
|
|
} |
|
|
|
|
|
|
|
/** |
|
|
|
* Return number of components in <code>DeweyDecimal</code>. |
|
|
|
* |
|
|
|
* @return the number of components in dewey decimal |
|
|
|
*/ |
|
|
|
public int getSize() { |
|
|
|
return components.length; |
|
|
|
} |
|
|
|
|
|
|
|
/** |
|
|
|
* Return the component at specified index. |
|
|
|
* |
|
|
|
* @param index the index of components |
|
|
|
* @return the value of component at index |
|
|
|
*/ |
|
|
|
public int get(final int index) { |
|
|
|
return components[ index ]; |
|
|
|
} |
|
|
|
|
|
|
|
/** |
|
|
|
* Return <code>true</code> if this <code>DeweyDecimal</code> is |
|
|
|
* equal to the other <code>DeweyDecimal</code>. |
|
|
|
* |
|
|
|
* @param other the other DeweyDecimal |
|
|
|
* @return true if equal to other DeweyDecimal, false otherwise |
|
|
|
*/ |
|
|
|
public boolean isEqual(final DeweyDecimal other) { |
|
|
|
final int max = Math.max(other.components.length, components.length); |
|
|
|
|
|
|
|
for (int i = 0; i < max; i++) { |
|
|
|
final int component1 = (i < components.length) ? components[ i ] : 0; |
|
|
|
final int component2 = (i < other.components.length) ? other.components[ i ] : 0; |
|
|
|
|
|
|
|
if (component2 != component1) { |
|
|
|
return false; |
|
|
|
} |
|
|
|
} |
|
|
|
|
|
|
|
return true; // Exact match |
|
|
|
} |
|
|
|
|
|
|
|
/** |
|
|
|
* Return <code>true</code> if this <code>DeweyDecimal</code> is |
|
|
|
* less than the other <code>DeweyDecimal</code>. |
|
|
|
* |
|
|
|
* @param other the other DeweyDecimal |
|
|
|
* @return true if less than other DeweyDecimal, false otherwise |
|
|
|
*/ |
|
|
|
public boolean isLessThan(final DeweyDecimal other) { |
|
|
|
return !isGreaterThanOrEqual(other); |
|
|
|
} |
|
|
|
|
|
|
|
/** |
|
|
|
* Return <code>true</code> if this <code>DeweyDecimal</code> is |
|
|
|
* less than or equal to the other <code>DeweyDecimal</code>. |
|
|
|
* |
|
|
|
* @param other the other DeweyDecimal |
|
|
|
* @return true if less than or equal to other DeweyDecimal, false otherwise |
|
|
|
*/ |
|
|
|
public boolean isLessThanOrEqual(final DeweyDecimal other) { |
|
|
|
return !isGreaterThan(other); |
|
|
|
} |
|
|
|
|
|
|
|
/** |
|
|
|
* Return <code>true</code> if this <code>DeweyDecimal</code> is |
|
|
|
* greater than the other <code>DeweyDecimal</code>. |
|
|
|
* |
|
|
|
* @param other the other DeweyDecimal |
|
|
|
* @return true if greater than other DeweyDecimal, false otherwise |
|
|
|
*/ |
|
|
|
public boolean isGreaterThan(final DeweyDecimal other) { |
|
|
|
final int max = Math.max(other.components.length, components.length); |
|
|
|
|
|
|
|
for (int i = 0; i < max; i++) { |
|
|
|
final int component1 = (i < components.length) ? components[ i ] : 0; |
|
|
|
final int component2 = (i < other.components.length) ? other.components[ i ] : 0; |
|
|
|
|
|
|
|
if (component2 > component1) { |
|
|
|
return false; |
|
|
|
} |
|
|
|
if (component2 < component1) { |
|
|
|
return true; |
|
|
|
} |
|
|
|
} |
|
|
|
|
|
|
|
return false; // Exact match |
|
|
|
} |
|
|
|
|
|
|
|
/** |
|
|
|
* Return <code>true</code> if this <code>DeweyDecimal</code> is |
|
|
|
* greater than or equal to the other <code>DeweyDecimal</code>. |
|
|
|
* |
|
|
|
* @param other the other DeweyDecimal |
|
|
|
* @return true if greater than or equal to other DeweyDecimal, false otherwise |
|
|
|
*/ |
|
|
|
public boolean isGreaterThanOrEqual(final DeweyDecimal other) { |
|
|
|
final int max = Math.max(other.components.length, components.length); |
|
|
|
|
|
|
|
for (int i = 0; i < max; i++) { |
|
|
|
final int component1 = (i < components.length) ? components[ i ] : 0; |
|
|
|
final int component2 = (i < other.components.length) ? other.components[ i ] : 0; |
|
|
|
|
|
|
|
if (component2 > component1) { |
|
|
|
return false; |
|
|
|
} |
|
|
|
if (component2 < component1) { |
|
|
|
return true; |
|
|
|
} |
|
|
|
} |
|
|
|
|
|
|
|
return true; // Exact match |
|
|
|
} |
|
|
|
|
|
|
|
/** |
|
|
|
* Return string representation of <code>DeweyDecimal</code>. |
|
|
|
* |
|
|
|
* @return the string representation of DeweyDecimal. |
|
|
|
*/ |
|
|
|
public String toString() { |
|
|
|
final StringBuffer sb = new StringBuffer(); |
|
|
|
|
|
|
|
for (int i = 0; i < components.length; i++) { |
|
|
|
if (i != 0) { |
|
|
|
sb.append('.'); |
|
|
|
} |
|
|
|
sb.append(components[ i ]); |
|
|
|
} |
|
|
|
|
|
|
|
return sb.toString(); |
|
|
|
} |
|
|
|
} |
Kevin Jackson