|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectjava.io.File
railo.commons.io.res.util.FileWrapper
public final class FileWrapper
Field Summary |
---|
Fields inherited from class java.io.File |
---|
pathSeparator, pathSeparatorChar, separator, separatorChar |
Fields inherited from interface railo.commons.io.res.Resource |
---|
ATTRIBUTE_ARCHIVE, ATTRIBUTE_HIDDEN, ATTRIBUTE_SYSTEM |
Method Summary | |
---|---|
boolean |
canRead()
Tests whether the application can read the resource denoted by this abstract pathname. |
boolean |
canWrite()
Tests whether the application can modify the resource denoted by this abstract pathname. |
int |
compareTo(File pathname)
|
void |
copyFrom(Resource res,
boolean append)
copy data of given resource to current |
void |
copyTo(Resource res,
boolean append)
copy current resource data to given resource |
void |
createDirectory(boolean createParentWhenNotExists)
Creates the directory named by this abstract pathname, including any necessary but nonexistent parent directories if flag "createParentWhenNotExists" is set to true. |
void |
createFile(boolean createParentWhenNotExists)
Creates a new, empty file named by this abstract pathname if and only if a file with this name does not yet exist. |
boolean |
createNewFile()
Creates a new, empty file named by this abstract pathname if and only if a file with this name does not yet exist. |
boolean |
delete()
Deletes the resource denoted by this abstract pathname. |
void |
deleteOnExit()
|
boolean |
equals(Object obj)
|
boolean |
exists()
Tests whether the resource denoted by this abstract pathname exists. |
File |
getAbsoluteFile()
|
String |
getAbsolutePath()
Returns the absolute pathname string of this abstract pathname. |
Resource |
getAbsoluteResource()
Returns the absolute form of this abstract pathname. |
boolean |
getAttribute(short attribute)
return value of a specific attribute |
File |
getCanonicalFile()
|
String |
getCanonicalPath()
Returns the canonical pathname string of this abstract pathname. |
Resource |
getCanonicalResource()
Returns the canonical form of this abstract pathname. |
InputStream |
getInputStream()
|
int |
getMode()
|
String |
getName()
Returns the name of the resource denoted by this abstract pathname. |
OutputStream |
getOutputStream()
|
OutputStream |
getOutputStream(boolean append)
|
String |
getParent()
Returns the pathname string of this abstract pathname's parent, or null if this pathname does not name a parent directory. |
File |
getParentFile()
|
Resource |
getParentResource()
Returns the abstract pathname of this abstract pathname's parent, or null if this pathname does not name a parent
directory. |
String |
getPath()
Converts this abstract pathname into a pathname string. |
String |
getReal(String realpath)
returns a resource path that is relative to the current resource |
Resource |
getRealResource(String realpath)
returns a resource that is relative to the current resource |
ResourceProvider |
getResourceProvider()
|
int |
hashCode()
|
boolean |
isAbsolute()
Tests whether this abstract pathname is absolute. |
boolean |
isArchive()
Tests whether the resource named by this abstract pathname is a archive resource. |
boolean |
isDirectory()
Tests whether the resource denoted by this abstract pathname is a directory. |
boolean |
isFile()
Tests whether the file denoted by this abstract pathname is a normal file. |
boolean |
isHidden()
Tests whether the resource named by this abstract pathname is a hidden resource. |
boolean |
isReadable()
Tests whether the application can read the resource denoted by this abstract pathname. |
boolean |
isSystem()
Tests whether the resource named by this abstract pathname is a system resource. |
boolean |
isWriteable()
Tests whether the application can modify the resource denoted by this abstract pathname. |
long |
lastModified()
Returns the time that the resource denoted by this abstract pathname was last modified. |
long |
length()
Returns the length of the resource denoted by this abstract pathname. |
String[] |
list()
Returns an array of strings naming the files and directories in the directory denoted by this abstract pathname. |
String[] |
list(FilenameFilter filter)
|
String[] |
list(ResourceFilter filter)
|
String[] |
list(ResourceNameFilter filter)
Returns an array of strings naming the files and directories in the directory denoted by this abstract pathname that satisfy the specified filter. |
File[] |
listFiles()
|
File[] |
listFiles(FileFilter filter)
|
File[] |
listFiles(FilenameFilter filter)
|
Resource[] |
listResources()
Returns an array of abstract pathnames denoting the files in the directory denoted by this abstract pathname. |
Resource[] |
listResources(ResourceFilter filter)
Returns an array of abstract pathnames denoting the files and directories in the directory denoted by this abstract pathname that satisfy the specified filter. |
Resource[] |
listResources(ResourceNameFilter filter)
Returns an array of abstract pathnames denoting the files and directories in the directory denoted by this abstract pathname that satisfy the specified filter. |
boolean |
mkdir()
Creates the directory named by this abstract pathname. |
boolean |
mkdirs()
Creates the directory named by this abstract pathname, including any necessary but nonexistent parent directories. |
void |
moveTo(Resource dest)
Move/renames the file denoted by this abstract pathname. |
void |
remove(boolean force)
Deletes the resource denoted by this abstract pathname. |
boolean |
renameTo(File dest)
|
boolean |
renameTo(Resource dest)
Move/renames the file denoted by this abstract pathname. |
void |
setArchive(boolean value)
sets archive attribute of the resource |
void |
setAttribute(short attribute,
boolean value)
sets a attribute on the resource if supported otherwise it will ign |
void |
setHidden(boolean value)
sets hidden attribute of the resource |
boolean |
setLastModified(long time)
Sets the last-modified time of the file or directory named by this abstract pathname. |
void |
setMode(int mode)
|
boolean |
setReadable(boolean value)
|
boolean |
setReadOnly()
Marks the file or directory named by this abstract pathname so that only read operations are allowed. |
void |
setSystem(boolean value)
sets system attribute of the resource |
boolean |
setWritable(boolean value)
|
static File |
toFile(Resource res)
|
String |
toString()
|
URI |
toURI()
|
URL |
toURL()
|
Methods inherited from class java.io.File |
---|
canExecute, createTempFile, createTempFile, getFreeSpace, getTotalSpace, getUsableSpace, listRoots, setExecutable, setExecutable, setReadable, setWritable |
Methods inherited from class java.lang.Object |
---|
getClass, notify, notifyAll, wait, wait, wait |
Method Detail |
---|
public boolean canRead()
Resource
canRead
in interface Resource
canRead
in class File
true
if and only if the resource specified by this
abstract pathname exists and can be read by the
application; false
otherwisepublic boolean canWrite()
Resource
canWrite
in interface Resource
canWrite
in class File
true
if and only if the resource system actually
contains a resource denoted by this abstract pathname and
the application is allowed to write to the resource;
false
otherwise.public int compareTo(File pathname)
compareTo
in interface Comparable<File>
compareTo
in class File
public boolean createNewFile()
Resource
createNewFile
in interface Resource
createNewFile
in class File
true
if the named file does not exist and was
successfully created; false
if the named file
already existspublic boolean delete()
Resource
delete
in interface Resource
delete
in class File
public void deleteOnExit()
deleteOnExit
in class File
public boolean equals(Object obj)
equals
in class File
public boolean exists()
Resource
exists
in interface Resource
exists
in class File
true
if and only if the resource denoted
by this abstract pathname exists; false
otherwisepublic File getAbsoluteFile()
getAbsoluteFile
in class File
public String getAbsolutePath()
Resource
If this abstract pathname is already absolute, then the pathname
string is simply returned as if by the
method.
Resource.getPath()
getAbsolutePath
in interface Resource
getAbsolutePath
in class File
public File getCanonicalFile() throws IOException
getCanonicalFile
in class File
IOException
public String getCanonicalPath() throws IOException
Resource
A canonical pathname is both absolute and unique. The precise
definition of canonical form is system-dependent. This method first
converts this pathname to absolute form if necessary, as if by invoking the
Resource.getAbsolutePath()
method, and then maps it to its unique form in a
system-dependent way. This typically involves removing redundant names
such as "." and ".." from the pathname.
Every pathname that denotes an existing file or directory has a unique canonical form. Every pathname that denotes a nonexistent resource also has a unique canonical form. The canonical form of the pathname of a nonexistent file or directory may be different from the canonical form of the same pathname after the resource is created. Similarly, the canonical form of the pathname of an existing resource may be different from the canonical form of the same pathname after the resource is deleted.
getCanonicalPath
in interface Resource
getCanonicalPath
in class File
IOException
- If an I/O error occurs, which is possible because the
construction of the canonical pathname may require
filesystem queriespublic String getName()
Resource
getName
in interface Resource
getName
in class File
public String getParent()
Resource
null
if this pathname does not name a parent directory.
The parent of an abstract pathname consists of the pathname's prefix, if any, and each name in the pathname's name sequence except for the last. If the name sequence is empty then the pathname does not name a parent directory.
getParent
in interface Resource
getParent
in class File
null
if this pathname
does not name a parentpublic File getParentFile()
getParentFile
in class File
public String getPath()
Resource
getPath
in interface Resource
getPath
in class File
public int hashCode()
hashCode
in class File
public boolean isAbsolute()
Resource
isAbsolute
in interface Resource
isAbsolute
in class File
true
if this abstract pathname is absolute,
false
otherwisepublic boolean isDirectory()
Resource
isDirectory
in interface Resource
isDirectory
in class File
true
if and only if the file denoted by this
abstract pathname exists and is a directory;
false
otherwisepublic boolean isFile()
Resource
isFile
in interface Resource
isFile
in class File
true
if and only if the file denoted by this
abstract pathname exists and is a normal file;
false
otherwisepublic boolean isHidden()
Resource
isHidden
in interface Resource
isHidden
in class File
true
if and only if the file denoted by this
abstract pathname is hiddenpublic long lastModified()
Resource
lastModified
in interface Resource
lastModified
in class File
long
value representing the time the file was
last modified, measured in milliseconds since the epoch
(00:00:00 GMT, January 1, 1970), or 0L
if the
file does not exist or if an I/O error occurspublic long length()
Resource
length
in interface Resource
length
in class File
0L
if the resource does not existpublic String[] list()
Resource
If this abstract pathname does not denote a directory, then this
method returns null
. Otherwise an array of strings is
returned, one for each file or directory in the directory. Names
denoting the directory itself and the directory's parent directory are
not included in the result. Each string is a file name rather than a
complete path.
There is no guarantee that the name strings in the resulting array will appear in any specific order; they are not, in particular, guaranteed to appear in alphabetical order.
list
in interface Resource
list
in class File
null
if
this abstract pathname does not denote a directory, or if an
I/O error occurs.public String[] list(FilenameFilter filter)
list
in class File
public File[] listFiles()
listFiles
in class File
public File[] listFiles(FileFilter filter)
listFiles
in class File
public File[] listFiles(FilenameFilter filter)
listFiles
in class File
public boolean mkdir()
Resource
mkdir
in interface Resource
mkdir
in class File
true
if and only if the directory was
created; false
otherwisepublic boolean mkdirs()
Resource
mkdirs
in interface Resource
mkdirs
in class File
true
if and only if the directory was created,
along with all necessary parent directories; false
otherwisepublic boolean renameTo(File dest)
renameTo
in class File
public boolean setLastModified(long time)
Resource
All platforms support file-modification times to the nearest second,
but some provide more precision. The argument will be truncated to fit
the supported precision. If the operation succeeds and no intervening
operations on the file take place, then the next invocation of the
method will return the (possibly
truncated) Resource.lastModified()
time
argument that was passed to this method.
setLastModified
in interface Resource
setLastModified
in class File
time
- The new last-modified time, measured in milliseconds since
the epoch (00:00:00 GMT, January 1, 1970)
true
if and only if the operation succeeded;
false
otherwisepublic boolean setReadOnly()
Resource
setReadOnly
in interface Resource
setReadOnly
in class File
true
if and only if the operation succeeded;
false
otherwisepublic String toString()
toString
in class File
public URI toURI()
toURI
in class File
public URL toURL() throws MalformedURLException
toURL
in class File
MalformedURLException
public void createDirectory(boolean createParentWhenNotExists) throws IOException
Resource
createDirectory
in interface Resource
createParentWhenNotExists
- throws Exception when can't create directory
IOException
public void createFile(boolean createParentWhenNotExists) throws IOException
Resource
createFile
in interface Resource
IOException
- If an I/O error occurredpublic Resource getAbsoluteResource()
Resource
getAbsoluteResource
in interface Resource
public Resource getCanonicalResource() throws IOException
Resource
getCanonicalResource
in interface Resource
IOException
- If an I/O error occurs, which is possible because the
construction of the canonical pathname may require
filesystem queriespublic InputStream getInputStream() throws IOException
getInputStream
in interface Resource
IOException
public int getMode()
getMode
in interface Resource
public OutputStream getOutputStream() throws IOException
getOutputStream
in interface Resource
IOException
public OutputStream getOutputStream(boolean append) throws IOException
getOutputStream
in interface Resource
IOException
public Resource getParentResource()
Resource
null
if this pathname does not name a parent
directory.
The parent of an abstract pathname consists of the pathname's prefix, if any, and each name in the pathname's name sequence except for the last. If the name sequence is empty then the pathname does not name a parent directory.
getParentResource
in interface Resource
null
if this pathname
does not name a parentpublic String getReal(String realpath)
Resource
getReal
in interface Resource
public Resource getRealResource(String realpath)
Resource
getRealResource
in interface Resource
public ResourceProvider getResourceProvider()
getResourceProvider
in interface Resource
public boolean isArchive()
Resource
isArchive
in interface Resource
true
if and only if the file denoted by this
abstract pathname is a archivepublic boolean isReadable()
Resource
isReadable
in interface Resource
true
if and only if the resource specified by this
abstract pathname exists and can be read by the
application; false
otherwisepublic boolean isSystem()
Resource
isSystem
in interface Resource
true
if and only if the file denoted by this
abstract pathname is a system resourcepublic boolean isWriteable()
Resource
isWriteable
in interface Resource
true
if and only if the resource system actually
contains a resource denoted by this abstract pathname and
the application is allowed to write to the resource;
false
otherwise.public String[] list(ResourceNameFilter filter)
Resource
Resource.list()
method, except that the strings in the
returned array must satisfy the filter. If the given
filter
is null
then all names are accepted.
Otherwise, a name satisfies the filter if and only if the value
true
results when the ResourceNameFilter.accept(railo.commons.io.res.Resource, java.lang.String)
method of the filter is invoked on this
abstract pathname and the name of a file or directory in the directory
that it denotes.
list
in interface Resource
filter
- A resourcename filter
filter
. The array will be empty if
the directory is empty or if no names were accepted by the
filter. Returns null
if this abstract pathname
does not denote a directory, or if an I/O error occurs.public String[] list(ResourceFilter filter)
list
in interface Resource
public Resource[] listResources()
Resource
If this abstract pathname does not denote a directory, then this
method returns null
. Otherwise an array of
File
objects is returned, one for each file or directory in
the directory. Therefore if this pathname
is absolute then each resulting pathname is absolute; if this pathname
is relative then each resulting pathname will be relative to the same
directory.
There is no guarantee that the name strings in the resulting array will appear in any specific order; they are not, in particular, guaranteed to appear in alphabetical order.
listResources
in interface Resource
null
if this abstract pathname
does not denote a directory, or if an I/O error occurs.public Resource[] listResources(ResourceFilter filter)
Resource
Resource.listResources()
method, except
that the pathnames in the returned array must satisfy the filter.
If the given filter
is null
then all
pathnames are accepted. Otherwise, a pathname satisfies the filter
if and only if the value true
results when the
ResourceFilter.accept(Resource)
method of
the filter is invoked on the pathname.
listResources
in interface Resource
filter
- A resource filter
null
if this abstract pathname
does not denote a directory, or if an I/O error occurs.public Resource[] listResources(ResourceNameFilter filter)
Resource
Resource.listResources()
method, except
that the pathnames in the returned array must satisfy the filter.
If the given filter
is null
then all
pathnames are accepted. Otherwise, a pathname satisfies the filter
if and only if the value true
results when the
ResourceNameFilter.accept(railo.commons.io.res.Resource, java.lang.String)
method of the filter is
invoked on this abstract pathname and the name of a file or
directory in the directory that it denotes.
listResources
in interface Resource
filter
- A resourcename filter
null
if this abstract pathname
does not denote a directory, or if an I/O error occurs.public void moveTo(Resource dest) throws IOException
Resource
Many aspects of the behavior of this method are inherently platform-dependent: The rename operation might not be able to move a file from one filesystem to another, it might not be atomic, and it might not succeed if a file with the destination abstract pathname already exists.
moveTo
in interface Resource
dest
- The new abstract pathname for the named file
IOException
- throwed when operation not done sucessfullpublic void remove(boolean force) throws IOException
Resource
remove
in interface Resource
IOException
- if the file doesn't exists or can't deletepublic boolean renameTo(Resource dest)
Resource
Many aspects of the behavior of this method are inherently platform-dependent: The rename operation might not be able to move a file from one filesystem to another, it might not be atomic, and it might not succeed if a file with the destination abstract pathname already exists.
renameTo
in interface Resource
dest
- The new abstract pathname for the named file
public void setMode(int mode) throws IOException
setMode
in interface Resource
IOException
public static File toFile(Resource res)
res
-
public void setArchive(boolean value) throws IOException
Resource
setArchive
in interface Resource
IOException
- throwed when no access to change the value or the resource doesn't existspublic void setHidden(boolean value) throws IOException
Resource
setHidden
in interface Resource
IOException
- throwed when no access to change the value or the resource doesn't existspublic void setSystem(boolean value) throws IOException
Resource
setSystem
in interface Resource
IOException
- throwed when no access to change the value or the resource doesn't existspublic boolean getAttribute(short attribute)
Resource
getAttribute
in interface Resource
public void setAttribute(short attribute, boolean value) throws IOException
Resource
setAttribute
in interface Resource
attribute
- wich attrbute (Resource.ATTRIBUTE_*)
IOException
- throwed when no access to change the value,
when attributes are not supported or
the resource doesn't existspublic boolean setReadable(boolean value)
setReadable
in interface Resource
setReadable
in class File
public boolean setWritable(boolean value)
setWritable
in interface Resource
setWritable
in class File
public void copyFrom(Resource res, boolean append) throws IOException
Resource
copyFrom
in interface Resource
IOException
public void copyTo(Resource res, boolean append) throws IOException
Resource
copyTo
in interface Resource
IOException
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |