de.hybris.ant.taskdefs

Class CopyNoLog

java.lang.Object

Task

de.hybris.ant.taskdefs.CopyNoLog

Deprecated.

since hybris 4.2.2 marked as deprecated. Use the normal ant <copy /> task instead.

@Deprecated
public class CopyNoLog
extends Task

Copies a file or directory to a new file or directory. Files are only copied if the source file is newer than the destination file, or when the destination file does not exist. It is possible to explicitly overwrite existing files.

This implementation is based on Arnout Kuiper's initial design document, the following mailing list discussions, and the copyfile/copydir tasks.

Since:

Ant 1.2

Ant Task:

category="filesystem"

Field Summary

Fields

Modifier and Type	Field and Description
protected Hashtable<File,File>	completeDirMap Deprecated.
protected File	destDir Deprecated.
protected File	destFile Deprecated.
protected Hashtable<String,String[]>	dirCopyMap Deprecated.
protected boolean	failonerror Deprecated.
protected File	file Deprecated.
protected Hashtable<String,String[]>	fileCopyMap Deprecated.
protected Vector<FileSet>	filesets Deprecated.
protected boolean	filtering Deprecated.
protected boolean	flatten Deprecated.
protected boolean	forceOverwrite Deprecated.
protected boolean	includeEmpty Deprecated.
protected Mapper	mapperElement Deprecated.
protected boolean	preserveLastModified Deprecated.
protected int	verbosity Deprecated.

Constructor Summary

Constructors

Constructor and Description
CopyNoLog() Deprecated. Copy task constructor.

Method Summary

Modifier and Type	Method and Description
void	add(FileNameMapper fileNameMapper) Deprecated. A nested filenamemapper
void	addFileset(FileSet set) Deprecated. Adds a set of files to copy.
protected void	buildMap(File fromDir, File toDir, String[] names, FileNameMapper mapper, Hashtable<String,String[]> map) Deprecated. Add to a map of files/directories to copy
FilterChain	createFilterChain() Deprecated. Adds a FilterChain.
FilterSet	createFilterSet() Deprecated. Adds a filterset.
Mapper	createMapper() Deprecated. Defines the mapper to map source to destination files.
protected void	doFileOperations() Deprecated. Actually does the file (and possibly empty directory) copies.
void	execute() Deprecated. Performs the copy operation.
String	getEncoding() Deprecated.
protected FileUtils	getFileUtils() Deprecated.
protected Vector<FilterChain>	getFilterChains() Deprecated. Get the filterchains being applied to this operation.
protected Vector<FilterSet>	getFilterSets() Deprecated. Get the filtersets being applied to this operation.
String	getOutputEncoding() Deprecated.
boolean	getPreserveLastModified() Deprecated. Whether to give the copied files the same last modified time as the original files.
boolean	isEnableMultipleMapping() Deprecated.
protected void	scan(File fromDir, File toDir, String[] files, String[] dirs) Deprecated. Compares source files to destination files to see if they should be copied.
void	setEnableMultipleMappings(boolean enableMultipleMappings) Deprecated. Attribute to handle mappers that return multiple mappings for a given source path.
void	setEncoding(String encoding) Deprecated. Sets the character encoding
void	setFailOnError(boolean failonerror) Deprecated. If false, note errors to the output but keep going.
void	setFile(File file) Deprecated. Sets a single source file to copy.
void	setFiltering(boolean filtering) Deprecated. If true, enables filtering.
void	setFlatten(boolean flatten) Deprecated. When copying directory trees, the files can be "flattened" into a single directory.
void	setGranularity(long granularity) Deprecated. The number of milliseconds leeway to give before deciding a target is out of date.
void	setIncludeEmptyDirs(boolean includeEmpty) Deprecated. Used to copy empty directories.
void	setOutputEncoding(String encoding) Deprecated. Sets the character encoding for output files.
void	setOverwrite(boolean overwrite) Deprecated. Overwrite any existing destination file(s).
void	setPreserveLastModified(boolean preserve) Deprecated. Give the copied files the same last modified time as the original files.
void	setPreserveLastModified(String preserve) Deprecated. setPreserveLastModified(String) has been deprecated and replaced with setPreserveLastModified(boolean) to consistently let the Introspection mechanism work.
void	setTodir(File destDir) Deprecated. Sets the destination directory.
void	setTofile(File destFile) Deprecated. Sets the destination file.
void	setVerbose(boolean verbose) Deprecated. Used to force listing of all names of copied files.
protected void	validateAttributes() Deprecated. Ensure we have a consistent and legal set of attributes, and set any internal flags necessary based on different combinations of attributes.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

file

protected File file

Deprecated.

destFile

protected File destFile

Deprecated.

destDir

protected File destDir

Deprecated.

filesets

protected Vector<FileSet> filesets

Deprecated.

filtering

protected boolean filtering

Deprecated.

preserveLastModified

protected boolean preserveLastModified

Deprecated.

forceOverwrite

protected boolean forceOverwrite

Deprecated.

flatten

protected boolean flatten

Deprecated.

verbosity

protected int verbosity

Deprecated.

includeEmpty

protected boolean includeEmpty

Deprecated.

failonerror

protected boolean failonerror

Deprecated.

fileCopyMap

protected Hashtable<String,String[]> fileCopyMap

Deprecated.

dirCopyMap

protected Hashtable<String,String[]> dirCopyMap

Deprecated.

completeDirMap

protected Hashtable<File,File> completeDirMap

Deprecated.

mapperElement

protected Mapper mapperElement

Deprecated.

Constructor Detail

CopyNoLog

public CopyNoLog()

Deprecated.

Copy task constructor.

Method Detail

getFileUtils

protected FileUtils getFileUtils()

Deprecated.

Returns:

the fileutils object

setFile

public void setFile(File file)

Deprecated.

Sets a single source file to copy.

Parameters:

file - the file to copy

setTofile

public void setTofile(File destFile)

Deprecated.

Sets the destination file.

Parameters:

destFile - the file to copy to

setTodir

public void setTodir(File destDir)

Deprecated.

Sets the destination directory.

Parameters:

destDir - the destination directory

createFilterChain

public FilterChain createFilterChain()

Deprecated.

Adds a FilterChain.

Returns:

a filter chain object

createFilterSet

public FilterSet createFilterSet()

Deprecated.

Adds a filterset.

Returns:

a filter set object

setPreserveLastModified

@Deprecated
public void setPreserveLastModified(String preserve)

Deprecated. setPreserveLastModified(String) has been deprecated and replaced with setPreserveLastModified(boolean) to consistently let the Introspection mechanism work.

Give the copied files the same last modified time as the original files.

Parameters:

preserve - a boolean string

setPreserveLastModified

public void setPreserveLastModified(boolean preserve)

Deprecated.

Give the copied files the same last modified time as the original files.

Parameters:

preserve - if true perverse the modified time, default is false

getPreserveLastModified

public boolean getPreserveLastModified()

Deprecated.

Whether to give the copied files the same last modified time as the original files.

Returns:

the preserveLastModified attribute

Since:

1.32, Ant 1.5

getFilterSets

protected Vector<FilterSet> getFilterSets()

Deprecated.

Get the filtersets being applied to this operation.

Returns:

a vector of FilterSet objects

getFilterChains

protected Vector<FilterChain> getFilterChains()

Deprecated.

Get the filterchains being applied to this operation.

Returns:

a vector of FilterChain objects

setFiltering

public void setFiltering(boolean filtering)

Deprecated.

If true, enables filtering.

Parameters:

filtering - if true enable filtering, default is false

setOverwrite

public void setOverwrite(boolean overwrite)

Deprecated.

Overwrite any existing destination file(s).

Parameters:

overwrite - if set to true, force overwriting of destination file(s) even if the destination file(s) are younger than the corresponding source file. Default is false.

setFlatten

public void setFlatten(boolean flatten)

Deprecated.

When copying directory trees, the files can be "flattened" into a single directory. If there are multiple files with the same name in the source directory tree, only the first file will be copied into the "flattened" directory, unless the forceoverwrite attribute is true.

Parameters:

flatten - if true flatten the destination directory. Default is false.

setVerbose

public void setVerbose(boolean verbose)

Deprecated.

Used to force listing of all names of copied files.

Parameters:

verbose - output the names of copied files. Default is false.

setIncludeEmptyDirs

public void setIncludeEmptyDirs(boolean includeEmpty)

Deprecated.

Used to copy empty directories.

Parameters:

includeEmpty - if true copy empty directories. Default is true.

setEnableMultipleMappings

public void setEnableMultipleMappings(boolean enableMultipleMappings)

Deprecated.

Attribute to handle mappers that return multiple mappings for a given source path.

Parameters:

enableMultipleMappings - If true the task will copy to all the mappings for a given source path, if false, only the first file or directory is processed. By default, this setting is false to provide backward compatibility with earlier releases.

Since:

1.6

isEnableMultipleMapping

public boolean isEnableMultipleMapping()

Deprecated.

Returns:

the value of the enableMultipleMapping attribute

setFailOnError

public void setFailOnError(boolean failonerror)

Deprecated.

If false, note errors to the output but keep going.

Parameters:

failonerror - true or false

addFileset

public void addFileset(FileSet set)

Deprecated.

Adds a set of files to copy.

Parameters:

set - a set of files to copy

createMapper

public Mapper createMapper()
                    throws BuildException

Deprecated.

Defines the mapper to map source to destination files.

Returns:

a mapper to be configured

Throws:

BuildException - if more than one mapper is defined

add

public void add(FileNameMapper fileNameMapper)

Deprecated.

A nested filenamemapper

Parameters:

fileNameMapper - the mapper to add

Since:

Ant 1.6.3

setEncoding

public void setEncoding(String encoding)

Deprecated.

Sets the character encoding

Parameters:

encoding - the character encoding

Since:

1.32, Ant 1.5

getEncoding

public String getEncoding()

Deprecated.

Returns:

the character encoding, null if not set.

Since:

1.32, Ant 1.5

setOutputEncoding

public void setOutputEncoding(String encoding)

Deprecated.

Sets the character encoding for output files.

Parameters:

encoding - the character encoding

Since:

Ant 1.6

getOutputEncoding

public String getOutputEncoding()

Deprecated.

Returns:

the character encoding for output files, null if not set.

Since:

Ant 1.6

setGranularity

public void setGranularity(long granularity)

Deprecated.

The number of milliseconds leeway to give before deciding a target is out of date.

Default is 0 milliseconds, or 2 seconds on DOS systems.

Since:

Ant 1.6.2

execute

public void execute()
             throws BuildException

Deprecated.

Performs the copy operation.

Throws:

BuildException - if an error occurs

validateAttributes

protected void validateAttributes()
                           throws BuildException

Deprecated.

Ensure we have a consistent and legal set of attributes, and set any internal flags necessary based on different combinations of attributes.

Throws:

BuildException - if an error occurs

scan

protected void scan(File fromDir,
                    File toDir,
                    String[] files,
                    String[] dirs)

Deprecated.

Compares source files to destination files to see if they should be copied.

Parameters:

fromDir - The source directory

toDir - The destination directory

files - A list of files to copy

dirs - A list of directories to copy

buildMap

protected void buildMap(File fromDir,
                        File toDir,
                        String[] names,
                        FileNameMapper mapper,
                        Hashtable<String,String[]> map)

Deprecated.

Add to a map of files/directories to copy

Parameters:

fromDir - the source directory

toDir - the destination directory

names - a list of filenames

mapper - a FileNameMapper value

map - a map of source file to array of destination files

doFileOperations

protected void doFileOperations()

Deprecated.

Actually does the file (and possibly empty directory) copies. This is a good method for subclasses to override.