org.apache.tools.ant.types
Class Resource
java.lang.Object
org.apache.tools.ant.types.Resource
- Cloneable, Comparable
public class Resource
extends java.lang.Object
implements Cloneable, Comparable
Describes a File or a ZipEntry.
This class is meant to be used by classes needing to record path
and date/time information about a file, a zip entry or some similar
resource (URL, archive in a version control repository, ...).
Resource() - Default constructor.
|
Resource(String name) - Only sets the name.
|
Resource(String name, boolean exists, long lastmodified) - Sets the name, lastmodified flag, and exists flag.
|
Resource(String name, boolean exists, long lastmodified, boolean directory) - Sets the name, lastmodified flag, exists flag, and directory flag.
|
Resource(String name, boolean exists, long lastmodified, boolean directory, long size) - Sets the name, lastmodified flag, exists flag, directory flag, and size.
|
Object | clone() - Clone this Resource.
|
int | compareTo(Object other) - Delegates to a comparison of names.
|
long | getLastModified() - Tells the modification time in milliseconds since 01.01.1970 .
|
String | getName() - Name attribute will contain the path of a file relative to the
root directory of its fileset or the recorded path of a zip
entry.
|
long | getSize() - Get the size of this Resource.
|
boolean | isDirectory() - Tells if the resource is a directory.
|
boolean | isExists() - The exists attribute tells whether a file exists.
|
void | setDirectory(boolean directory) - Set the directory attribute.
|
void | setExists(boolean exists) - Set the exists attribute.
|
void | setLastModified(long lastmodified) - Set the last modification attribute.
|
void | setName(String name) - Set the name of this Resource.
|
void | setSize(long size) - Set the size of this Resource.
|
UNKNOWN_SIZE
public static final long UNKNOWN_SIZE
Constant unknown size
Resource
public Resource()
Default constructor.
Resource
public Resource(String name)
Only sets the name.
This is a dummy, used for not existing resources.
name
- relative path of the resource. Expects
"/" to be used as the directory separator.
Resource
public Resource(String name,
boolean exists,
long lastmodified)
Sets the name, lastmodified flag, and exists flag.
name
- relative path of the resource. Expects
"/" to be used as the directory separator.exists
- if true, this resource exists.lastmodified
- the last modification time of this resource.
Resource
public Resource(String name,
boolean exists,
long lastmodified,
boolean directory)
Sets the name, lastmodified flag, exists flag, and directory flag.
name
- relative path of the resource. Expects
"/" to be used as the directory separator.exists
- if true the resource existslastmodified
- the last modification time of the resourcedirectory
- if true, this resource is a directory
Resource
public Resource(String name,
boolean exists,
long lastmodified,
boolean directory,
long size)
Sets the name, lastmodified flag, exists flag, directory flag, and size.
name
- relative path of the resource. Expects
"/" to be used as the directory separator.exists
- if true the resource existslastmodified
- the last modification time of the resourcedirectory
- if true, this resource is a directorysize
- the size of this resource.
clone
public Object clone()
Clone this Resource.
compareTo
public int compareTo(Object other)
Delegates to a comparison of names.
other
- the object to compare to.
- a negative integer, zero, or a positive integer as this Resource
is less than, equal to, or greater than the specified Resource.
getLastModified
public long getLastModified()
Tells the modification time in milliseconds since 01.01.1970 .
- 0 if the resource does not exist to mirror the behavior
of
File
.
getName
public String getName()
Name attribute will contain the path of a file relative to the
root directory of its fileset or the recorded path of a zip
entry.
example for a file with fullpath /var/opt/adm/resource.txt
in a file set with root dir /var/opt it will be
adm/resource.txt.
"/" will be used as the directory separator.
- the name of this resource.
getSize
public long getSize()
Get the size of this Resource.
- the size, as a long, 0 if the Resource does not exist (for
compatibility with java.io.File), or UNKNOWN_SIZE if not known.
isDirectory
public boolean isDirectory()
Tells if the resource is a directory.
- boolean flag indicating if the resource is a directory.
isExists
public boolean isExists()
The exists attribute tells whether a file exists.
- true if this resource exists.
setDirectory
public void setDirectory(boolean directory)
Set the directory attribute.
directory
- if true, this resource is a directory.
setExists
public void setExists(boolean exists)
Set the exists attribute.
exists
- if true, this resource exists.
setLastModified
public void setLastModified(long lastmodified)
Set the last modification attribute.
lastmodified
- the modification time in milliseconds since 01.01.1970.
setName
public void setName(String name)
Set the name of this Resource.
name
- relative path of the resource. Expects
"/" to be used as the directory separator.
setSize
public void setSize(long size)
Set the size of this Resource.
size
- the size, as a long.
Copyright B) 2000-2008 Apache Software Foundation. All Rights Reserved.