public class ResourceUtils
extends java.lang.Object
Modifier and Type | Class and Description |
---|---|
static interface |
ResourceUtils.ResourceSelectorProvider |
Modifier and Type | Field and Description |
---|---|
static java.lang.String |
ISO_8859_1
Name of charset "ISO Latin Alphabet No.
|
Constructor and Description |
---|
ResourceUtils() |
Modifier and Type | Method and Description |
---|---|
static FileResource |
asFileResource(FileProvider fileProvider)
Convenience method to turn any fileProvider into a basic
FileResource with the file's immediate parent as the basedir,
for tasks that need one.
|
static int |
compareContent(Resource r1,
Resource r2,
boolean text)
Compare the content of two Resources.
|
static boolean |
contentEquals(Resource r1,
Resource r2,
boolean text)
Compares the contents of two Resources.
|
static void |
copyResource(Resource source,
Resource dest)
Convenience method to copy content from one Resource to another.
|
static void |
copyResource(Resource source,
Resource dest,
FilterSetCollection filters,
java.util.Vector filterChains,
boolean overwrite,
boolean preserveLastModified,
boolean append,
java.lang.String inputEncoding,
java.lang.String outputEncoding,
Project project)
Convenience method to copy content from one Resource to another
specifying whether token filtering must be used, whether filter chains
must be used, whether newer destination files may be overwritten and
whether the last modified time of
dest file should be made
equal to the last modified time of source . |
static void |
copyResource(Resource source,
Resource dest,
FilterSetCollection filters,
java.util.Vector filterChains,
boolean overwrite,
boolean preserveLastModified,
boolean append,
java.lang.String inputEncoding,
java.lang.String outputEncoding,
Project project,
boolean force)
Convenience method to copy content from one Resource to another
specifying whether token filtering must be used, whether filter chains
must be used, whether newer destination files may be overwritten and
whether the last modified time of
dest file should be made
equal to the last modified time of source . |
static void |
copyResource(Resource source,
Resource dest,
FilterSetCollection filters,
java.util.Vector filterChains,
boolean overwrite,
boolean preserveLastModified,
java.lang.String inputEncoding,
java.lang.String outputEncoding,
Project project)
Convenience method to copy content from one Resource to another
specifying whether token filtering must be used, whether filter chains
must be used, whether newer destination files may be overwritten and
whether the last modified time of
dest file should be made
equal to the last modified time of source . |
static void |
copyResource(Resource source,
Resource dest,
Project project)
Convenience method to copy content from one Resource to another.
|
static Resource[] |
selectOutOfDateSources(ProjectComponent logTo,
Resource[] source,
FileNameMapper mapper,
ResourceFactory targets)
Tells which source files should be reprocessed based on the
last modification date of target files.
|
static Resource[] |
selectOutOfDateSources(ProjectComponent logTo,
Resource[] source,
FileNameMapper mapper,
ResourceFactory targets,
long granularity)
Tells which source files should be reprocessed based on the
last modification date of target files.
|
static ResourceCollection |
selectOutOfDateSources(ProjectComponent logTo,
ResourceCollection source,
FileNameMapper mapper,
ResourceFactory targets,
long granularity)
Tells which sources should be reprocessed based on the
last modification date of targets.
|
static ResourceCollection |
selectSources(ProjectComponent logTo,
ResourceCollection source,
FileNameMapper mapper,
ResourceFactory targets,
ResourceUtils.ResourceSelectorProvider selector)
Tells which sources should be reprocessed because the given
selector selects at least one target.
|
static void |
setLastModified(Touchable t,
long time)
Set the last modified time of an object implementing
org.apache.tools.ant.types.resources.Touchable .
|
public static final java.lang.String ISO_8859_1
public static Resource[] selectOutOfDateSources(ProjectComponent logTo, Resource[] source, FileNameMapper mapper, ResourceFactory targets)
logTo
- where to send (more or less) interesting output.source
- array of resources bearing relative path and last
modification date.mapper
- filename mapper indicating how to find the target
files.targets
- object able to map as a resource a relative path
at destination.public static Resource[] selectOutOfDateSources(ProjectComponent logTo, Resource[] source, FileNameMapper mapper, ResourceFactory targets, long granularity)
logTo
- where to send (more or less) interesting output.source
- array of resources bearing relative path and last
modification date.mapper
- filename mapper indicating how to find the target
files.targets
- object able to map as a resource a relative path
at destination.granularity
- The number of milliseconds leeway to give
before deciding a target is out of date.public static ResourceCollection selectOutOfDateSources(ProjectComponent logTo, ResourceCollection source, FileNameMapper mapper, ResourceFactory targets, long granularity)
logTo
- where to send (more or less) interesting output.source
- ResourceCollection.mapper
- filename mapper indicating how to find the target Resources.targets
- object able to map a relative path as a Resource.granularity
- The number of milliseconds leeway to give
before deciding a target is out of date.public static ResourceCollection selectSources(ProjectComponent logTo, ResourceCollection source, FileNameMapper mapper, ResourceFactory targets, ResourceUtils.ResourceSelectorProvider selector)
logTo
- where to send (more or less) interesting output.source
- ResourceCollection.mapper
- filename mapper indicating how to find the target Resources.targets
- object able to map a relative path as a Resource.selector
- returns a selector that is applied to target
files. If it selects at least one target the source will be
added to the returned collection.public static void copyResource(Resource source, Resource dest) throws java.io.IOException
source
- the Resource to copy from.
Must not be null
.dest
- the Resource to copy to.
Must not be null
.java.io.IOException
- if the copying fails.public static void copyResource(Resource source, Resource dest, Project project) throws java.io.IOException
source
- the Resource to copy from.
Must not be null
.dest
- the Resource to copy to.
Must not be null
.project
- the project instance.java.io.IOException
- if the copying fails.public static void copyResource(Resource source, Resource dest, FilterSetCollection filters, java.util.Vector filterChains, boolean overwrite, boolean preserveLastModified, java.lang.String inputEncoding, java.lang.String outputEncoding, Project project) throws java.io.IOException
dest
file should be made
equal to the last modified time of source
.source
- the Resource to copy from.
Must not be null
.dest
- the Resource to copy to.
Must not be null
.filters
- the collection of filters to apply to this copy.filterChains
- filterChains to apply during the copy.overwrite
- Whether or not the destination Resource should be
overwritten if it already exists.preserveLastModified
- Whether or not the last modified time of
the destination Resource should be set to that
of the source.inputEncoding
- the encoding used to read the files.outputEncoding
- the encoding used to write the files.project
- the project instance.java.io.IOException
- if the copying fails.public static void copyResource(Resource source, Resource dest, FilterSetCollection filters, java.util.Vector filterChains, boolean overwrite, boolean preserveLastModified, boolean append, java.lang.String inputEncoding, java.lang.String outputEncoding, Project project) throws java.io.IOException
dest
file should be made
equal to the last modified time of source
.source
- the Resource to copy from.
Must not be null
.dest
- the Resource to copy to.
Must not be null
.filters
- the collection of filters to apply to this copy.filterChains
- filterChains to apply during the copy.overwrite
- Whether or not the destination Resource should be
overwritten if it already exists.preserveLastModified
- Whether or not the last modified time of
the destination Resource should be set to that
of the source.append
- Whether to append to an Appendable Resource.inputEncoding
- the encoding used to read the files.outputEncoding
- the encoding used to write the files.project
- the project instance.java.io.IOException
- if the copying fails.public static void copyResource(Resource source, Resource dest, FilterSetCollection filters, java.util.Vector filterChains, boolean overwrite, boolean preserveLastModified, boolean append, java.lang.String inputEncoding, java.lang.String outputEncoding, Project project, boolean force) throws java.io.IOException
dest
file should be made
equal to the last modified time of source
.source
- the Resource to copy from.
Must not be null
.dest
- the Resource to copy to.
Must not be null
.filters
- the collection of filters to apply to this copy.filterChains
- filterChains to apply during the copy.overwrite
- Whether or not the destination Resource should be
overwritten if it already exists.preserveLastModified
- Whether or not the last modified time of
the destination Resource should be set to that
of the source.append
- Whether to append to an Appendable Resource.inputEncoding
- the encoding used to read the files.outputEncoding
- the encoding used to write the files.project
- the project instance.force
- whether read-only taret files will be overwrittenjava.io.IOException
- if the copying fails.public static void setLastModified(Touchable t, long time)
t
- the Touchable whose modified time is to be set.time
- the time to which the last modified time is to be set.
if this is -1, the current time is used.public static boolean contentEquals(Resource r1, Resource r2, boolean text) throws java.io.IOException
r1
- the Resource whose content is to be compared.r2
- the other Resource whose content is to be compared.text
- true if the content is to be treated as text and
differences in kind of line break are to be ignored.java.io.IOException
- if the Resources cannot be read.public static int compareContent(Resource r1, Resource r2, boolean text) throws java.io.IOException
r1
- the Resource whose content is to be compared.r2
- the other Resource whose content is to be compared.text
- true if the content is to be treated as text and
differences in kind of line break are to be ignored.java.io.IOException
- if the Resources cannot be read.public static FileResource asFileResource(FileProvider fileProvider)
fileProvider
- input