Ant The Definitive Guide phần 8 pdf

buildparser all, boolean, N If specified, the task sets the BUILD_PARSER grammar option to the value of this attribute.. buildtokenmanager all, boolean, N If specified, the task sets the

rename (1.3, 1.4, boolean, N)

If true, indicates that hijacked files should be renamed with a keep extension

Defaults to false

viewpath (1.3, 1.4, String, N)

Specifies the path to the ClearCase view file or directory

The currenttime and preservetime attributes are optional, but you cannot specify both

Content

None

org.apache.tools.ant.taskdefs.optional.dotnet.CSharp

Compiles C# source code Currently works on platforms containing the csc.exe executable,

i.e., various flavors of Windows

Attributes

additionalmodules (1.3, 1.4, String, N)

A semicolon-delimited list of additional modules, which are DLLs containing

metadata This is equivalent to csc's /addmodule parameter

If true, the task includes common assemblies found in NET beta 1, and in links in

mscore.dll Defaults to true

classpath (all, String, N)

The classpath used when running the weblogic.ejb.utils.DDCreator class

defaultexcludes (all, boolean, N)

Determines whether to use default excludes Defaults to true

descriptors (all, String, Y)

The base directory containing text deployment descriptors

dest (all, String, Y)

The destination directory

excludes (all, String, N)

A comma-separated list of file patterns to exclude

excludesfile (all, File, N)

The name of a file containing one exclude pattern per line

includes (all, String, N)

A comma-separated list of file patterns to include

includesfile (all, File, N)

The name of a file containing one include pattern per line

to be removed, because they have a logical dependency on their base class

0,1 nested <classpath> elements (1.4)

The Path element used in place of the classpath and classpathref attributes

0 n nested patternset elements: <exclude> , <include> , <patternset> (1.3, 1.4); <excludesfile> , <includesfile> (1.4)

Used in place of their corresponding attributes, these specify the set of included and excluded source files

org.apache.tools.ant.taskdefs.optional ejb.Ejbc

Executes BEA WebLogic Server's ejbc tool, generating code necessary to deploy EJB

components in that environment This task is designed for WebLogic 4.5.1

Attributes

classpath (all, String, N)

The classpath to use This must include all necessary supporting classes, such as the remote and home interfaces for the bean(s)

defaultexcludes (all, boolean, N)

Determines whether to use default excludes Defaults to true

descriptors (all, String, Y)

A base directory containing serialized deployment descriptors

dest (all, String, Y)

A destination directory for generated classes, stubs, and skeletons

excludes (all, String, N)

A comma-separated list of file patterns to exclude

excludesfile (all, File, N)

The name of a file containing one exclude pattern per line

includes (all, String, N)

A comma-separated list of file patterns to include

includesfile (all, File, N)

The name of a file containing one include pattern per line

keepgenerated (1.3, 1.4, String, N)

If true, keep the generated Java source code Defaults to false Note that this is a String attribute, not a Boolean; legal values are true and false

manifest (all, String, Y)

The name of the manifest file to create

src (all, String, Y)

The base of the source tree, containing home interfaces, remote interfaces, and bean implementation classes

Creates ejb-jar files compatible with EJB 1.1 This task supports a set of generic attributes

and nested elements, along with several vendor-specific nested elements

Attributes

basejarname (all, String, *)

The base name used for generated JAR filenames

basenameterminator (all, String, N)

Used to determine filenames based on deployment descriptor names For instance, suppose this attribute is set to "-" With this value, a deployment descriptor named

Customer-ejb-jar.xml results in a base name of Customer This attribute is only used when basejarname is specified Defaults to "-"

classpath (1.3, 1.4, Path, N)

A classpath used to locate classes that are added to the ejb-jar file

defaultexcludes (all, boolean, N)

Determines whether to use default excludes Defaults to true

descriptordir (all, File, N)

The base of a directory tree containing deployment descriptors Defaults to the value specified by srcdir

destdir (all, File, Y)

A destination directory for generated JAR files Files are placed in subdirectories corresponding to deployment descriptor subdirectories

excludes (all, String, N)

A comma-separated list of file patterns to exclude

excludesfile (all, File, N)

The name of a file containing one exclude pattern per line

flatdestdir (all, boolean, N)

Used instead of destdir when generated JAR files should not be placed into subdirectories

genericjarsuffix (all, String, N)

The name appended to the base name of the deployment descriptor when generating

generic ejb-jar files Defaults to -generic.jar

includes (all, String, N)

A comma-separated list of file patterns to include

includesfile (all, File, N)

The name of a file containing one include pattern per line

The JAR filename is based the last part of a directory containing the deployment

descriptor For example, com/oreilly/sales/accounting-ejb-jar.xml becomes sales.jar

descriptor

The JAR filename is based on the deployment descriptor name For example,

com/oreilly/sales/accounting-ejb-jar.xml becomes accounting.jar

basejarname

Only legal when the basejarname attribute is set When it is set, the ejbjar task uses the basejarname attribute value when determining JAR filenames For example, when basejarname is "Book", the resulting JAR is Book.jar

srcdir (all, File, Y)

A directory containing class files comprising the beans

The basejarname attribute is only allowed when naming="basejarname"

0,1 nested <classpath> elements (1.3, 1.4)

Used in place of the classpath attribute

0 n nested <dtd> elements (1.3, 1.4)

Specifies local locations for DTD references in XML files This is useful because loading DTDs from a local file is faster than loading DTDs remotely, and works when disconnected from a network or running behind a firewall This element requires the following two attributes:

location (1.3, 1.4, String, Y)

The local copy of the DTD This is either a filename or a Java resource name

publicid (1.3, 1.4, String, Y)

The public ID of the DTD

0 n nested <support> elements (1.3, 1.4)

fileset elements specifying additional files to include in the generated JAR files When generating multiple JAR files, these support files are added to each one

The ejbar task supports numerous vendor-specific nested elements These account for deployment differences across various EJB servers

0,1 nested <borland> elements (1.4)

Supports Borland Application Server Version 4.5 Generates and compiles stubs and skeletons, creates the JAR file, then verifies its contents Attributes are as follows:

The extra arguments used when verify=true

0,1 nested <iplanet> elements (1.4)

Supports iPlanet Application Server (iAS) Version 6.0 Attributes are as follows:

destdir (1.4, File, Y)

The base directory for generated JAR files

iashome (1.4, File, N)

The home directory for the iAS distribution, used to locate the ejbc utility when it is

not on the path

keepgenerated (1.4, boolean, N)

If true, keep generated Java source files Defaults to false

suffix (1.4, String, N)

Appended to each generated JAR filename Defaults to jar

0,1 nested <jboss> elements (1.4)

Supports the JBoss server Since JBoss supports hot deployment, it does not require

generated stubs and skeletons This task searches for jboss.xml and jaws.xml, adding

them to the generated JAR file One attribute is supported:

destdir (1.4, File, Y)

Base directory for generated JAR files

0,1 nested <weblogic> elements (all)

Supports the weblogic.ejbc compiler The following attributes are supported:

args (all, String, N)

The additional arguments for weblogic.ejbc

classpath (all, Path, N)

The classpath used when running the weblogic.ejbc tool

compiler (all, String, N)

Select a different Java compiler

destdir (all, File, Y)

The base directory for generated JAR files

genericjarsuffix (all, String, N)

The filename suffix used when generating an intermediate, temporary JAR file

Defaults to -generic.jar

keepgenerated (all, boolean, N)

If true, keep generated Java files Defaults to false

keepgeneric (all, boolean, N)

If true, keep the intermediate generic JAR files Defaults to false

suffix (all, String, N)

Appended to each generated JAR filename Defaults to jar

wlclasspath (1.3, 1.4, Path, N)

Use this attribute to avoid a WebLogic 6.0 warning that is issued when home and

remote interfaces for a bean are located on the classpath used to run weblogic.ejbc Set

this attribute to include the standard WebLogic classes, and use the classpathattribute to include bean-related classes

0,1 nested <weblogictoplink> elements (all)

Used when using TOPLink with WebLogic for CMP This task supports all of the

<weblogic> attributes, plus the following additional attributes:

toplinkdescriptor (all, String, Y)

The name of the locally stored TOPLink deployment descriptor file This is relative to the descriptordir attribute of the containing ejbjar task

toplinkdtd (all, String, N)

The location of the TOPLink DTD file A local file path or URL is recommended, but not required Defaults to the DTD found at http://www.objectpeople.com/

action (all, String, N)

The FTP command to execute Legal values are send, put, recv, get, del, delete, list, and mkdir Defaults to send

binary (all, boolean, N)

If true, use binary-mode transfers instead of text-mode Defaults to true

depends (all, boolean, N)

If true, transfer only new or changed files Defaults to false

ignorenoncriticalerrors (1.4, boolean, N)

If true, ignore noncritical error codes sent by some FTP servers Defaults to false

listing (all, File, *)

Name of a file to store output from the list action

newer (all, boolean, N)

An alias for depends

passive (1.3, 1.4, boolean, N)

If true, use passive-mode transfers Defaults to false

password (all, String, Y)

The login password for the FTP server

port (all, int, N)

The port number Defaults to 21

remotedir (all, String, N)

A directory on the remote server

separator (all, String, N)

The file separator on the FTP server Defaults to "/"

server (all, String, Y)

The URL of the remote server

skipfailedtransfers (1.4, boolean, N)

If true, continue transferring files even if some failures occur Defaults to false

userid (all, String, Y)

The login ID for the FTP server

verbose (all, boolean, N)

If true, operate in verbose mode Defaults to false

The listing attribute is required when action="list"

Content

0 n nested <fileset> elements (all)

Specifies files and directories to include and exclude from transfers

org.apache.tools.ant.taskdefs.optional.IContract

Executes the iContract Design By Contact preprocessor iContract is available at

http://www.reliable-systems.com/tools/ This task uses whatever Java compiler the javactask uses You can specify an alternate Java compiler by setting the build.compilerproperty

Attributes

builddir (1.4, File, N)

The destination for compiled instrumented classes The Ant user manual warns against using the same directory for instrumented and uninstrumented classes, because this breaks dependency checking

updateicontrol (1.4, boolean, N)

If true, update the properties file for iControl in the current directory, or create a new one if necessary Defaults to false

0 n nested patternset elements: <exclude> , <excludesfile> , <include> ,

<includesfile> , and <patternset> (1.4)

Used in place of their corresponding attributes, these specify the set of included and excluded source files

0,1 nested <classpath> elements (1.4)

May be used in place of the classpath and classpathref attributes

Content

0,1 nested <classpath> elements (1.4)

May be used in place of the classpath attribute

buildparser (all, boolean, N)

If specified, the task sets the BUILD_PARSER grammar option to the value of this attribute

buildtokenmanager (all, boolean, N)

If specified, the task sets the BUILD_TOKEN_MANAGER grammar option to the value of this attribute

cachetokens (all, boolean, N)

If specified, the task sets the CACHE_TOKENS grammar option to the value of this attribute

choiceambiguitycheck (all, int, N)

If specified, the task sets the CHOICE_AMBIGUITY_CHECK grammar option to the value

of this attribute

commontokenaction (all, boolean, N)

If specified, the task sets the COMMON_TOKEN_ACTION grammar option to the value of this attribute

debuglookahead (all, boolean, N)

If specified, the task sets the DEBUG_LOOKAHEAD grammar option to the value of this attribute

debugparser (all, boolean, N)

If specified, the task sets the DEBUG_PARSER grammar option to the value of this attribute

debugtokenmanager (all, boolean, N)

If specified, the task sets the DEBUG_TOKEN_MANAGER grammar option to the value of this attribute

errorreporting (all, boolean, N)

If specified, the task sets the ERROR_REPORTING grammar option to the value of this attribute

forcelacheck (all, boolean, N)

If specified, the task sets the FORCE_LA_CHECK grammar option to the value of this attribute

ignorecase (all, boolean, N)

If specified, the task sets the IGNORE_CASE grammar option to the value of this attribute

javacchome (all, File, Y)

The directory containing the JavaCC distribution

javaunicodeescape (all, boolean, N)

If specified, the task sets the JAVA_UNICODE_ESCAPE grammar option to the value of this attribute

lookahead (all, int, N)

If specified, the task sets the LOOKAHEAD grammar option to the value of this attribute

optimizetokenmanager (all, boolean, N)

If specified, the task sets the OPTIMIZE_TOKEN_MANAGER grammar option to the value

of this attribute

otherambiguitycheck (all, int, N)

If specified, the task sets the OTHER_AMBIGUITY_CHECK grammar option to the value of this attribute

outputdirectory (all, File, N)

The destination directory for generated files Defaults to the directory containing the grammar file

sanitycheck (all, boolean, N)

If specified, the task sets the SANITY_CHECK grammar option to the value of this attribute

static (all, boolean, N)

If specified, the task sets the STATIC grammar option to the value of this attribute

target (all, File, Y)

The grammar file to process

unicodeinput (all, boolean, N)

If specified, the task sets the UNICODE_INPUT grammar option to the value of this attribute

usercharstream (all, boolean, N)

If specified, the task sets the USE_CHAR_STREAM grammar option to the value of this attribute

usertokenmanager (all, boolean, N)

If specified, the task sets the USER_TOKEN_MANAGER grammar option to the value of this attribute

Content

None

org.apache.tools.ant.taskdefs.optional.Javah

Executes the javah tool, generating Java Native Interface (JNI) headers from one or more

Java classes This task uses the default Java compiler, unless the build.compiler property

is set to something else, as explained in the javac task description in Chapter 7