org.apache.tools.ant.taskdefs

Class Concat

public class Concat extends Task implements ResourceCollection

This class contains the 'concat' task, used to concatenate a series of files into a single stream. The destination of this stream may be the system console, or a file. The following is a sample invocation:
 <concat destfile="${build.dir}/index.xml"
   append="false">

   <fileset dir="${xml.root.dir}"
     includes="*.xml" />

 </concat>
 
Nested Class Summary
static classConcat.TextElement
sub element points to a file or contains text
Constructor Summary
Concat()
Construct a new Concat task.
Method Summary
voidadd(ResourceCollection c)
Add an arbitrary ResourceCollection.
voidaddFilelist(FileList list)
List of files to concatenate.
voidaddFileset(FileSet set)
Set of files to concatenate.
voidaddFilterChain(FilterChain filterChain)
Adds a FilterChain.
voidaddFooter(Concat.TextElement footerToAdd)
Add a footer to the concatenated output
voidaddHeader(Concat.TextElement headerToAdd)
Add a header to the concatenated output
voidaddText(String text)
This method adds text which appears in the 'concat' element.
PathcreatePath()
Path of files to concatenate.
voidexecute()
Execute the concat task.
booleanisFilesystemOnly()
Implement ResourceCollection.
Iteratoriterator()
Implement ResourceCollection.
voidreset()
Reset state to default.
voidsetAppend(boolean append)
Sets the behavior when the destination exists.
voidsetBinary(boolean binary)
Set the binary attribute.
voidsetDest(Resource dest)
Set the resource to write to.
voidsetDestfile(File destinationFile)
Sets the destination file, or uses the console if not specified.
voidsetEncoding(String encoding)
Sets the character encoding
voidsetEol(FixCRLF.CrLf crlf)
Specify the end of line to find and to add if not present at end of each input file.
voidsetFixLastLine(boolean fixLastLine)
Append line.separator to files that do not end with a line.separator, default false.
voidsetForce(boolean force)
Force overwrite existing destination file
voidsetIgnoreEmpty(boolean ignoreEmpty)
Sets the behavior when no source resource files are available.
voidsetOutputEncoding(String outputEncoding)
Sets the character encoding for outputting
voidsetWriter(Writer outputWriter)
Set the output writer.
intsize()
Implement ResourceCollection.

Constructor Detail

Concat

public Concat()
Construct a new Concat task.

Method Detail

add

public void add(ResourceCollection c)
Add an arbitrary ResourceCollection.

Parameters: c the ResourceCollection to add.

Since: Ant 1.7

addFilelist

public void addFilelist(FileList list)
List of files to concatenate.

Parameters: list the list of files

addFileset

public void addFileset(FileSet set)
Set of files to concatenate.

Parameters: set the set of files

addFilterChain

public void addFilterChain(FilterChain filterChain)
Adds a FilterChain.

Parameters: filterChain a filterchain to filter the concatenated input

Since: Ant 1.6

addFooter

public void addFooter(Concat.TextElement footerToAdd)
Add a footer to the concatenated output

Parameters: footerToAdd the footer

Since: Ant 1.6

addHeader

public void addHeader(Concat.TextElement headerToAdd)
Add a header to the concatenated output

Parameters: headerToAdd the header

Since: Ant 1.6

addText

public void addText(String text)
This method adds text which appears in the 'concat' element.

Parameters: text the text to be concated.

createPath

public Path createPath()
Path of files to concatenate.

Returns: the path used for concatenating

Since: Ant 1.6

execute

public void execute()
Execute the concat task.

isFilesystemOnly

public boolean isFilesystemOnly()
Implement ResourceCollection.

Returns: false.

iterator

public Iterator iterator()
Implement ResourceCollection.

Returns: Iterator.

reset

public void reset()
Reset state to default.

setAppend

public void setAppend(boolean append)
Sets the behavior when the destination exists. If set to true the task will append the stream data an Appendable resource; otherwise existing content will be overwritten. Defaults to false.

Parameters: append if true append output.

setBinary

public void setBinary(boolean binary)
Set the binary attribute. If true, concat will concatenate the files byte for byte. This mode does not allow any filtering or other modifications to the input streams. The default value is false.

Parameters: binary if true, enable binary mode.

Since: Ant 1.6.2

setDest

public void setDest(Resource dest)
Set the resource to write to.

Parameters: dest the Resource to write to.

Since: Ant 1.8

setDestfile

public void setDestfile(File destinationFile)
Sets the destination file, or uses the console if not specified.

Parameters: destinationFile the destination file

setEncoding

public void setEncoding(String encoding)
Sets the character encoding

Parameters: encoding the encoding of the input stream and unless outputencoding is set, the outputstream.

setEol

public void setEol(FixCRLF.CrLf crlf)
Specify the end of line to find and to add if not present at end of each input file. This attribute is used in conjunction with fixlastline.

Parameters: crlf the type of new line to add - cr, mac, lf, unix, crlf, or dos

Since: Ant 1.6

setFixLastLine

public void setFixLastLine(boolean fixLastLine)
Append line.separator to files that do not end with a line.separator, default false.

Parameters: fixLastLine if true make sure each input file has new line on the concatenated stream

Since: Ant 1.6

setForce

public void setForce(boolean force)
Force overwrite existing destination file

Parameters: force if true always overwrite, otherwise only overwrite if the output file is older any of the input files.

Since: Ant 1.6

setIgnoreEmpty

public void setIgnoreEmpty(boolean ignoreEmpty)
Sets the behavior when no source resource files are available. If set to false the destination file will always be created. Defaults to true.

Parameters: ignoreEmpty if false honour destinationfile creation.

Since: Ant 1.8.0

setOutputEncoding

public void setOutputEncoding(String outputEncoding)
Sets the character encoding for outputting

Parameters: outputEncoding the encoding for the output file

Since: Ant 1.6

setWriter

public void setWriter(Writer outputWriter)
Set the output writer. This is to allow concat to be used as a nested element.

Parameters: outputWriter the output writer.

Since: Ant 1.6

size

public int size()
Implement ResourceCollection.

Returns: 1.