FileDocCategorySizeDatePackage
TimeComparison.javaAPI DocApache Ant 1.704064Wed Dec 13 06:16:24 GMT 2006org.apache.tools.ant.types

TimeComparison.java

/*
 *  Licensed to the Apache Software Foundation (ASF) under one or more
 *  contributor license agreements.  See the NOTICE file distributed with
 *  this work for additional information regarding copyright ownership.
 *  The ASF 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.apache.tools.ant.types;

import org.apache.tools.ant.BuildException;
import org.apache.tools.ant.util.FileUtils;

/**
 * EnumeratedAttribute for time comparisons.  Accepts values
 * "before", "after", "equal".
 * @since Ant 1.7
 */
public class TimeComparison extends EnumeratedAttribute {
    private static final String[] VALUES
        = new String[] {"before", "after", "equal"};

    private static final FileUtils FILE_UTILS = FileUtils.getFileUtils();

    /** Before Comparison. */
    public static final TimeComparison BEFORE = new TimeComparison("before");

    /** After Comparison. */
    public static final TimeComparison AFTER = new TimeComparison("after");

    /** Equal Comparison. */
    public static final TimeComparison EQUAL = new TimeComparison("equal");

    /**
     * Default constructor.
     */
    public TimeComparison() {
    }

    /**
     * Construct a new TimeComparison with the specified value.
     * @param value the EnumeratedAttribute value.
     */
    public TimeComparison(String value) {
        setValue(value);
    }

    /**
     * Return the possible values.
     * @return String[] of EnumeratedAttribute values.
     */
    public String[] getValues() {
        return VALUES;
    }

    /**
     * Evaluate two times against this TimeComparison.
     * @param t1 the first time to compare.
     * @param t2 the second time to compare.
     * @return true if the comparison result fell within the parameters of this TimeComparison.
     */
    public boolean evaluate(long t1, long t2) {
        return evaluate(t1, t2, FILE_UTILS.getFileTimestampGranularity());
    }

    /**
     * Evaluate two times against this TimeComparison.
     * @param t1 the first time to compare.
     * @param t2 the second time to compare.
     * @param g the timestamp granularity.
     * @return true if the comparison result fell within the parameters of this TimeComparison.
     */
    public boolean evaluate(long t1, long t2, long g) {
        int cmp = getIndex();
        if (cmp == -1) {
            throw new BuildException("TimeComparison value not set.");
        }
        if (cmp == 0) {
            return t1 - g < t2;
        }
        if (cmp == 1) {
            return t1 + g > t2;
        }
        return Math.abs(t1 - t2) <= g;
    }

    /**
     * Compare two times.
     * @param t1 the first time to compare.
     * @param t2 the second time to compare.
     * @return a negative integer, a positive integer, or zero as t1 is
     *         before, after, or equal to t2 accounting for the default granularity.
     */
    public static int compare(long t1, long t2) {
        return compare(t1, t2, FILE_UTILS.getFileTimestampGranularity());
    }

    /**
     * Compare two times.
     * @param t1 the first time to compare.
     * @param t2 the second time to compare.
     * @param g the timestamp granularity.
     * @return a negative integer, a positive integer, or zero as t1 is
     *         before, after, or equal to t2 accounting for the specified granularity.
     */
    public static int compare(long t1, long t2, long g) {
        long diff = t1 - t2;
        long abs = Math.abs(diff);
        return abs > Math.abs(g) ? (int) (diff / abs) : 0;
    }

}