/*
 * This file is subject to the licence found in LICENCE.TXT in the root directory of the project.
 * Copyright Jayasoft 2005 - All rights reserved
 * 
 * #SNAPSHOT#
 */
package fr.jayasoft.ivy.repository;

public interface Resource {
    public String getName();
    public long getLastModified();
    public long getContentLength();
    public boolean exists();
}

@@ -214,138 +214,2200 @@
 %0D%0A%0D%0A
-public interface Resource %7B%0D%0A    public String getName();%0D%0A    public long getLastModified();%0D%0A    public long getContentLength();
+/**%0D%0A * Represents a resource in an Ivy %7B@link Repository%7D.%0D%0A * %0D%0A * The resource interface allows one to obtain the following information about a resource:%0D%0A * %3Cul%3E%0D%0A *   %3Cli%3Eresource name/identifier in repository syntax%3C/li%3E%0D%0A *   %3Cli%3Edate the resource was last modified.%3C/li%3E%0D%0A *   %3Cli%3Esize of the resource in bytes.%3C/li%3E%0D%0A *   %3Cli%3Eif the resource is available.%3C/li%3E%0D%0A *%3C/ul%3E%0D%0A *%3C/p%3E%0D%0A *%3Ch4%3EImplementation Notes%3C/h4%3E%0D%0A *   In implementing the interface you need to ensure the following behaviors:%0D%0A *   %3Cul%3E%0D%0A *     %3Cli%3EAll of the methods specified in the interface fail by returning an empty value%0D%0A *         (%3Ccode%3Efalse%3C/code%3E, %3Ccode%3E0%3C/code%3E, %3Ccode%3E%22%22%3C/code%3E). In other words, the specified interface %0D%0A *         methods should not throw RuntimeExceptions.%0D%0A *     %3C/li%3E%0D%0A *     %3Cli%3EFailure conditions should be logged using the%0D%0A *     %7B@link fr.jayasoft.ivy.util.Message#verbose%7D method.%0D%0A *     %3C/li%3E%0D%0A *     %3Cli%3EFailure of one of the interface's specified methods results in all other interface specified%0D%0A *     methods returning an empty value  (%3Ccode%3Efalse%3C/code%3E, %3Ccode%3E0%3C/code%3E, %3Ccode%3E%22%22%3C/code%3E).%3C/li%3E%0D%0A *   %3C/ul%3E%0D%0A *   %3C/p%3E%0D%0A */%0D%0A%0D%0Apublic interface Resource %7B%0D%0A%09/**%0D%0A%09 * Get the name of the resource.%0D%0A%09 * %0D%0A%09 * @return the repositorie's assigned resource name/identifier.%0D%0A%09 */%0D%0A    public String getName();%0D%0A    %0D%0A    /**%0D%0A     * Get the date the resource was last modified%0D%0A     * %0D%0A     * @return A %3Ccode%3Elong%3C/code%3E value representing the time the file was%0D%0A     *          last modified, measured in milliseconds since the epoch%0D%0A     *          (00:00:00 GMT, January 1, 1970), or %3Ccode%3E0L%3C/code%3E if the%0D%0A     *          file does not exist or if an I/O error occurs.%0D%0A     */%0D%0A    public long getLastModified();%0D%0A    %0D%0A    /**%0D%0A     * Get the resource size%0D%0A     * %0D%0A     * @return a %3Ccode%3Elong%3C/code%3E value representing the size of the resource in bytes.%0D%0A     */%0D%0A    public long getContentLength();%0D%0A    %0D%0A    /**%0D%0A     * Determine if the resource is available.%0D%0A     * %3C/p%3E%0D%0A     * Note that this method only checks for availability, not for actual existence.%0D%0A     * %0D%0A     * @return %3Ccode%3Eboolean%3C/code%3E value indicating if the resource is available.%0D%0A     */
 %0D%0A  

update javadoc (thanks to Stephen Nesbitt) (IVY-136)