Ant: The Definitive Guide

Second Edition April 2005
ISBN 978-0-596-00609-9
Seiten 334
EUR34.00, SFR57.90


Weitere Informationen zu diesem Buch

Inhaltsverzeichnis | Index | Probekapitel | Kolophon | Rezensionen |


Index

	
[ Symbols ], [ A ], [ B ], [ C ], [ D ], [ E ], [ F ], [ G ], [ H ], [ I ], [ J ], [ K ], [ L ], [ M ], [ N ], [ O ], [ P ], [ Q ], [ R ], [ S ], [ T ], [ U ], [ V ], [ W ], [ X ], [ Z ],

Symbols[ Top ]
* (asterisk), 38, 48, 58
@ (at sign), 219
\ (backslash), 57
: (colon), 266
$ (dollar sign), 57, 246
! (exclamation point), 194
/ (forward slash), 18, 57, 91, 282
( ) (parentheses), 56
; (semicolon), 266

A[ Top ]
Abbot framework (JUnit extension), 148
absolute paths, 74
AbstractCvsTask class, 260
access attribute (javadoc task), 77
action attribute
      ftp task, 107, 109
      serverdeploy task, 202
actions, conditional, 35
adapter attribute (taskdef task), 258
adaptto attribute (taskdef task), 258
add command (CVS), 152
addBuildFailed-Sound method, 278
addBuildListener method (Project class), 263
addBuildSuccessfulSound method, 278
addedTags attribute
      ejbdoclet task, 223
      webdoclet task, 219
additionalparam attribute (javadoc task), 77
addproperty attribute (input task), 68
address attribute (mail task), 115
addsourcefile attribute (apply task), 179
addTarget method (Project class), 263
addTaskDefinition method (Project class), 263
addText method, 262, 269
admin command (CVS), 152
.aiff format, 278
algorithm attribute (checksum task), 97
all set property, 33
and element (condition task), 34
annotate command (CVS), 152
Ant build files, 67
      absolute path, 74
      Ant view and, 255
      calling tasks in, 68-72
      checksums and, 97
      custom tasks and, 267
      editing, 237
      EJB example, 200
      importing, 72, 74
      projects and, 6
      properties and, 18-23, 42, 211
      reformatting, 247
      running, 144-148
            in Eclipse, 247-253
      scp task example, 190
      servlet example, 221-223
      targets and, 7, 25
      taskdef task example, 259
      tasks and, 8-18
      Tomcat servers and, 188, 194
      .war files and, 184
      writing in Eclipse, 244-247
      XDoclet example, 226-230
      XML declaration and, 6
Ant build process, 4-6
      Anthill and, 119
      controlling, 32
      failure during, 26-28, 268
      scheduling automatic builds, 118-124
      stopping, 36
      testing, 125
Ant build tool
      alternatives to, 1
      debugger support, 28
      editions, 2
      installing, 2
      origins, 2
      process example, 4-6
      running, 23-31
      testing, 4
Ant classpath, 249, 253
Ant editor (Eclipse), 245, 251
Ant Home Entries item (Eclipse), 254
Ant Launcher, 24
ant task, 9, 71
Ant view (Eclipse), 255
ANT_ARGS environment variable, 26
ant.bat file, 26
antcall task, 9, 68-71
antfile attribute (ant task), 71
ant.file property, 22, 74
Anthill build tool, 119-123
ANT_HOME environment variable, 43
      filename length, 3
      installing Ant, 3
      library files and, 31
Antidote IDE, 241
ant.java.version property, 22
antlr task, 11
ANT_OPTS environment variable, 26
ant.project.name property, 22
antrc_post.bat file, 26
AntSoundPlayer class, 278
antstructure task, 9, 206, 213
ant.version property, 23
apachesoap element (ejbdoclet task), 223
append attribute
      apply task, 179
      cvs task, 154
      exec task, 172
      java task, 169
      sshexec task, 113
application attribute (weblogic element), 203
applications
      deploying by copying, 102-106
      moving files, 106
      packaging for deployment, 88-99
      remote deployment
            using FTP, 107-111
            using SSH, 112
            using Telnet, 111
            via email, 114-116
      setting file protections with chmod, 116, 118
apply task, 9, 56, 179-181
appxml attribute (ear task), 201
arg element
      arguments and, 170, 181
      example, 168
      exec task and, 174
      generic element and, 203
      jonas element and, 205
args attribute
      java task, 169
      weblogic element, 232
argument element, 155
ASCII characters, 12
Assert class (JUnit), 128
assertEquals method (JUnit), 128-130, 132
assertFalse method (JUnit), 128
assertions element, 137, 170
Assertions type, 44
assertNotNull method (JUnit), 128, 132
assertNotSame method (JUnit), 128
assertNull method (JUnit), 128, 130
assertSame method (JUnit), 128, 130
assertTrue method (JUnit), 128, 130, 132
asterisk (*), 38, 48, 58
at command (Windows), 116, 118
at sign (@), 219
attrib task, 11
attribute element
      manifest task, 84
      xmlvalidate element and, 207
      xslt/style task and, 217
attributes
      handling for custom tasks, 266-268
      for project elements, 7
      for property elements, 18-22
      for target elements, 8
author attribute (javadoc task), 77
authserver command (CVS), 152
available element (condition task), 34
available task, 9, 33, 37, 178
axisdeploy element (ejbdoclet task), 223
axisundeploy element (ejbdoclet task), 223

B[ Top ]
backslash (\), 57
backups attribute (patch task), 166
basedir attribute
      cab task, 187
      ear task, 201
      jar task, 82
      project element, 7, 23, 72
      tar task, 89
      war task, 185
      xslt/style task, 216
      zip task, 92
BaseExtendSelector class, 284
basejarname attribute (ejbjar task), 231
basename task, 9, 102
bash shell (Unix), 3, 5
batch execution, 179-181
batch testing, 142, 144
batchtest element, 136
batchtest task, 144
bcc element (mail task), 115
bcclist attribute (mail task), 114
begintoken attribute (FilterSet type), 52
binary attribute (ftp task), 110
binary release (Ant), 2
blgenclient task (EJB), 14, 230
boolean data type, 266
bootclasspath attribute
      javac task, 60, 62
      javadoc task, 77
      path type, 45
bootclasspath element
      java task and, 170
      path type and, 45
bootclasspathref attribute
      javac task, 60
      javadoc task, 77
borland element
      ejbdoclet task, 223
      nesting and, 232
bottom attribute (javadoc task), 77
branching (see forking)
breakiterator attribute (javadoc task), 77
brief formatter, 135, 139
build files (see Ant build files)
build numbers, 84, 119
build process (see Ant build process; Java build process)
build property (deploy task), 193
BuildEvent object, 280
BuildException constructor, 269
-buildfile option, 23, 25
buildFinished method, 278
buildnumber task, 9, 84
buildStarted method, 278
build.xml file, 6, 25, 71
bunzip2 task, 9, 92
byline attribute (replaceregexp task), 238
bzip2 task, 9, 91

C[ Top ]
.cab files
      Ant tasks and, 11
      creating, 187
      deploying, 188
cab task, 11, 187
cabarc tool (Microsoft), 187
cabfile attribute (cab task), 187
cache attribute (depend task), 239
carriage returns, fixing, 94-96
casesensitive attribute
      DirSet type, 49
      FileSet type, 47
castormapping element (ejbdoclet task), 223
catalogpath element (xmlcatalog element), 207
cc element (mail task), 115
CCCheckin task, 14
CCCheckout task, 14
cclist attribute (mail task), 114
CCLock task, 14
CCMCheckin task, 16
CCMCheckinTask task, 16
CCMCheckout task, 16
CCMCreateTask task, 16
CCMkattr task, 14
CCMkbl task, 14
CCMkdir task, 14
CCMkelem task, 14
CCMklabel task, 14
CCMklbType task, 14
CCMReconfigure task, 16
CCRmtype task, 14
CCUnCheckout task, 14
CCUnluck task, 14
CCUpdate task, 14
<CDATA> section (XML), 74
chacl command (CVS), 152
change logs, 161-164
char data type, 266
charset attribute
      javadoc task, 77
      mail task, 114
      message element, 116
checkout command (CVS), 152
checksum element (condition task), 34
checksum task, 9, 97
chgrp task, 12
chmod attribute (ftp task), 110
chmod task, 9, 103, 116, 118
Choose Location dialog box (Eclipse), 255
chown command (CVS), 152
chown task, 12
classconstants element (FilterChain type), 54, 56
classes element (war task), 186
classname attribute
      available task, 37
      formatter task, 135
      generic element, 203
      java task, 169
      jonas element, 205
      mapper element, 57
      taskdef task, 258
      xmlvalidate task, 206
classpath attribute
      available task, 37
      depend task, 239
      ejbjar task, 231
      generic element, 203
      java task, 169
      javac task, 60, 62
      javadoc task, 77
      jonas element, 205
      jspc task, 199
      junit task, 138
      mapper element, 57
      path type, 45
      property element, 18
      taskdef task, 226, 258
      weblogic element, 203, 232
      xslt/style task, 216
classpath element, 168
      depend task and, 239
      ejbjar task, 231
      java task and, 170
      jonas element and, 205
      nesting, 134
      path type and, 45
      serverdeploy task and, 203
      taskdef task and, 259
      weblogic element and, 233
      xmlcatalog element and, 207
      xslt/style task and, 217
classpathref attribute
      available task, 37
      java task, 169
      javac task, 60
      javadoc task, 77
      jspc task, 199
      mapper element, 57
      property element, 18
      xmlvalidate task, 206
      xslt/style task, 216
classpathref element (jspc task), 199
clearcase task, 150
Clearcase version control system, 13, 150
closure attribute (depend task), 239
cmpversion attribute (ejbjar task), 231
code assist (Eclipse), 245
collapseAttributes attribute (xmlproperty task), 212
colon (:), 266
command attribute
      cvs task, 154, 158, 160
      exec task, 172
      sshexec task, 113
command line
      environment variables and, 44
      options for, 23, 64
commandline element, 155, 160
Commandline object, 275
commit command (CVS), 152
committers, 2
compilearg element, 64
compiler attribute
      compilearg element, 65
      javac task, 60, 65
      jspc task, 199
      weblogic element, 232
compilerclasspath attribute (jspc task), 199
compiling
      documentation and, 74
      JSPs, 196-199
      source code, 60-63
      source files, 63
component attribute (weblogic element), 204
compress attribute
      cab task, 187
      ear task, 201
      jar task, 82
      war task, 185
      zip task, 92
compression attribute
      cvs task, 154
      cvstagdiff task, 164
      tar task, 89, 90
compressionlevel attribute (cvs task), 154
concat task, 9, 53
concatfilter element (FilterChain type), 54
Concurrent Version System (see CVS)
condition task, 9, 33, 111
conditions, 32-36
configParam element
      ejbdoclet task, 223
      webdoclet task, 219
Console view (Eclipse), 247-249
constants, 42, 56
containers, EJB and, 200-205, 223-230
contains element
      condition task, 34
      linecontains filter and, 55
contains selector, 50
containsregexp selector, 50
content assist (Eclipse), 245
Continuous source control servers, 15
Continuus commands, 150
copy task
      deployment and, 102-106
      description, 9
      file filtering, 51
      file sets and, 46
      filterchain element, 53
      mappers and, 56
copydir task, 9
copyfile task, 9
cr attribute (fixcrlf task), 95
createDataType method, 277
createResult method (JUnit), 130
createTask method (Project class), 263, 276
creation date, 98
creation time, 98
crontab utility (Unix), 116, 118
Cruise Control build tool, 123
csc compiler, 187
Csc task, 13
CVS (Concurrent Version System)
      Anthill and, 119
      change logs, 161-164
      changes between versions, 164
      commands, 152
      creating patches, 165
      CVSROOT environment variable and, 156
      logging in and, 153
      servers and, 154-160
      source control and, 151-153
      version data and, 161
cvs task
      checking out modules, 155
      CVS commands and, 152
      CVS servers and, 154
      description, 9, 150
cvschangelog task, 9, 151, 163
cvsclientproperty attribute (cvsversion task), 161
cvspass task, 9, 151
      checking out modules, 155
      logging in with, 153
      updating shared code, 157
cvsroot attribute
      cvs task, 154-156
      cvschangelog task, 163
      cvspass task, 153
      cvstagdiff task, 164
      cvsversion task, 161
CVSROOT environment variable
      CVS servers and, 156
      cvs task and, 154
      cvspass task and, 155
      cvstagdiff task and, 164
      cvsversion task and, 161
      Windows and, 153
cvsrsh attribute
      cvs task, 154
      cvschangelog task, 163
      cvstagdiff task, 164
      cvsversion task, 161
CVS_RSH environment variable, 154, 161, 164
cvsserverproperty attribute (cvsversion task), 161
cvsServerVersion property (cvsversion element), 161
cvstagdiff task, 9, 151, 164
cvsversion task, 9, 161
Cygwin environment, 174

D[ Top ]
-D option, 23, 42
-d option, 23
daemons element (parallel task), 182
dao element (ejbdoclet task), 223
data (see types)
dataobject element (ejbdoclet task), 223
date attribute (cvs task), 154
date selector, 50, 51
datetime attribute (touch task), 99
davidhost attribute (jonas element), 204
davidport attribute (jonas element), 204
Davidson, James Duncan, 2
daysinpast attribute (cvschangelog task), 163
dbUnit framework (JUnit extension), 148
ddcreator task (EJB), 14, 230
debug attribute
      javac task, 61
      weblogic element, 204
-debug option, 23, 28
debuglevel attribute (javac task), 61
default attribute (project element), 7
defaultexcludes attribute
      cab task, 187
      chmod task, 117
      delete task, 100
      ear task, 201
      FileSet type, 47
      fixcrlf task, 95
      jar task, 82
      javadoc task, 77
      tar task, 90
      war task, 186
      xslt/style task, 216
      zip task, 92
defaultexcludes task, 9, 48
defaultInput method (Project class), 263
DefaultLogger class, 280
defaultvalue attribute (input task), 68
delete action (weblogic tool), 203
delete task, 9, 66, 99-101
deletecharacters element (FilterChain type), 54
delimOutput attribute (FilterChain type), 54
deltree task, 9
depend attribute (javac task), 61
depend selector, 50
depend task, 12, 63, 238-240
dependencies
      antcall task and, 68
      depend task, 63
      handling, 238-240
      parallel task and, 182
      recommendations, 71
      tasks and, 16-18
dependency attribute (ejbjar task), 231
depends attribute
      build example, 17
      ftp task, 110
      target element, 8
dependset task, 9
deploy action
      JOnAS servers, 204
      weblogic tool, 203
deploy task, 192
deployment
      by copying, 102-106
      to EJB containers, 200-205
      hot, 202-205
      by moving files, 106
      packaging applications for, 88-99
      preparing for, 99-102
      scheduling automatic builds, 118-124
      scp task, 189-192
      setting file protections, 116, 118
      Tomcat web servers and, 192-196
      using
            email, 114-116
            FTP, 107-111
            SSH, 112
            Telnet, 111
      .war files, 185
      web, 188
deploymentdescriptor element
      ejbdoclet task, 224, 226
      webdoclet task, 219
deprecation attribute (javac task), 61
depth selector, 50
description attribute (target element), 8, 30
Description type, 44
descriptordir attribute (ejbjar task), 231
dest attribute
      apply task, 179, 181
      cvs task, 154
      cvsversion task, 161
      get task, 195
      unjar task, 84
destdir attribute
      depend task, 239
      ejbdoclet task, 223
      ejbjar task, 231
      fixcrlf task, 95
      javac task, 61
      javadoc task, 77
      jspc task, 199
      webdoclet task, 219
      weblogic element, 232
      xslt/style task, 216
destfile attribute
      cvschangelog task, 163
      cvstagdiff task, 164
      ear task, 201
      gzip/bzip2 tasks, 92
      jar task, 82
      patch task, 166
      tar task, 90
      war task, 186
      zip task, 93
-diagnostics option, 23
diff command (CVS), 152, 155, 159
different selector, 50
dir attribute
      ant task, 71
      apply task, 179
      build.xml file and, 71
      chmod task, 117
      custom tasks and, 273
      cvschangelog task, 163
      delete task, 101
      DirSet type, 49
      exec task, 173
      FileList type, 49
      FileSet type, 47
      ftp task, 109
      java task, 169
      junit task, 133
      mkdir task, 102
      patch task, 166
dir command (Windows), 176
directories
      copying to new locations, 102
      creating, 101
      default excludes, 48
      deleting, 99
      dependencies and, 239
      ejbjar task and, 231
      ftp task and, 107
      jspc task and, 199
      manipulating remotely, 99
      modules and, 151
      moving, 106
      scanning, 273
      working with groups of, 48
DirectoryScanner class, 273
dirmode attribute
      tarfileset element, 91
      zipfileset element, 93
dirname task, 9, 102
dirset element
      apply task, 181
      chmod task, 118
DirSet type, 44, 48, 102
displayname attribute (user element), 164
docencoding attribute (javadoc task), 77
doclet attribute (javadoc task), 77
doclet task (XDoclet), 218
docletpath attribute (javadoc task), 77
docletpathref attribute (javadoc task), 77
doctitle attribute (javadoc task), 78
document element, 6
documentation
      of code, 74-80
      fixing carriage returns in, 94-96
      JUnit, 127
      (see also reports)
dollar sign ($), 57, 246
DSTAMP property (tstamp task), 85
dtd element
      ejbjar task, 231
      xmlcatalog element and, 207
      xmlvalidate task and, 207
DTDs
      antstructure task and, 206
      creating for Ant tasks, 213
      validating with, 209-211
      XMLCatalog and, 207
dump attribute (depend task), 239
duplicate attribute
      ear task, 201
      jar task, 82
      war task, 186
      zip task, 93
duration attribute (success/fail elements), 235

E[ Top ]
-e option, 23
ear task, 9, 201
easerver element (ejbdoclet task), 224
echo task, 9, 277
      creating text files, 98
      JavaScript and, 276
      output and, 28, 56
echoproperties task, 12
Eclipse IDE, 241-244
      Ant versions and, 253, 255
      Ant view and, 255
      running Ant build files, 247-253
      writing Ant build files, 244-247
eclipse.org consortium, 241
edit command (CVS), 152
editors command (CVS), 152
EJB (Enterprise JavaBeans)
      Ant tasks for, 14
      deploying to containers, 200-205
      developing, 230-233
      working with containers, 223-230
ejbc task (EJB), 14, 230
ejbcclass attribute (weblogic element), 232
ejbClassNameSuffix attribute (ejbdoclet task), 223
ejbdoclet task (XDoclet), 218, 223-230
ejbjar task (EJB), 14, 230-233
ejbSpec attribute (ejbdoclet task), 223
elements, nesting, 45, 270-272
-emacs option, 23
email, remote deployment, 114-116
enablemultiplemappings attribute (copy task), 104
encoding attribute
      copy task, 104
      ear task, 201
      fixcrlf task, 95
      jar task, 82
      javac task, 61
      javadoc task, 78
      loadfile task, 41
      mail task, 114
      manifest task, 84
      replaceregexp task, 238
      war task, 186
      zip task, 93
end attribute (cvschangelog task), 163
enddate attribute (cvstagdiff task), 164
end-of-line (EOL) characters, 95
endtag attribute (cvstagdiff task), 165
endtoken attribute (FilterSet type), 52
Enterprise JavaBeans (see EJB)
entitybmp element (ejbdoclet task), 224
entitycmp element (ejbdoclet task), 224
entityfacade element (ejbdoclet task), 224
entitypk element (ejbdoclet task), 224
env element, 134, 170, 174, 181
environment attribute (property element), 18, 43
environment variables
      customizing, 26
      env element and, 170, 174
      forked JVM and, 134
      JDK and, 3
      setting, 251
      setting properties using, 18, 43
eof attribute (fixcrlf task), 95
eol attribute (fixcrlf task), 96
EOL (end-of-line) characters, 95
equals element (condition task), 34
error attribute
      apply task, 179
      cvs task, 154
      exec task, 173
      java task, 169
errorproperty attribute
      apply task, 180
      batchtest element, 136
      exec task, 173
      java task, 169
      junit task, 133, 138
      test task, 136
errors
      brief formatter and, 139
      build process and, 27
      Eclipse and, 246
      external programs and, 175
      Java code and, 170-172
      Java development and, 241
      responding to, 32
      validating XML documents, 209
escapeunicode element (FilterChain type), 54
events
      custom listeners, 278-280
      custom loggers, 280
exclamation point (!), 194
exclude attribute (delete task), 100
exclude element
      cab task and, 188
      depend task and, 239
      DirSet type and, 48
      fileset element and, 47
      FileSet type, 46
      jar task and, 83
      javac task, 62
      PatternSet type and, 50
      support element and, 231
      xslt/style task and, 217
      zip task and, 94
excludedTags attribute
      ejbdoclet task, 223
      webdoclet task, 219
excludepackagenames attribute (javadoc task), 78
excludes attribute
      cab task, 187
      chmod task, 117
      delete task, 101
      DirSet type, 49
      ear task, 201
      FileSet type, 47
      fixcrlf task, 96
      jar task, 82
      javac task, 61
      PatternSet type, 50
      tar task, 90
      war task, 186
      xslt/style task, 216
      zip task, 93
excludes element
      jspc task and, 199
      MatchingTask class, 274
excludesfile attribute
      cab task, 187
      delete task, 100
      DirSet type, 49
      ear task, 201
      FileSet type, 47
      fixcrlf task, 96
      jar task, 82
      javac task, 61
      PatternSet type, 50
      tar task, 90
      war task, 186
      xslt/style task, 216
      zip task, 93
excludesfile element
      DirSet type and, 48
      fileset element and, 47
      FileSet type, 46
      PatternSet type and, 50
exdirs element, 45
exec task, 9, 172-178
      arguments and, 181
      file permissions and, 103
execon task, 9
executable attribute
      apply task, 180
      exec task, 173, 177
      javac task, 61
Execute class, 274
execute method
      Ant tasks and, 257, 260, 262
      Execute class, 275
      nested elements and, 271
      Task class, 261
executeTarget method (Project class), 263
executeTargets method (Project class), 263
executing
      Ant, 24
      batch programs, 179-181
      external programs, 172-178
      Java code, 167-172
      setting order and, 182
exit method (System), 77
expandproperties element (FilterChain type), 54
export command (CVS), 152
expression attribute
      containsregexp selector, 51
      param element, 217
extdirs attribute
      javac task, 61
      javadoc task, 78
      path type, 45
extension attribute
      formatter task, 135
      xslt/style task, 216
external programs
      executing, 172-178
      running, 274
External Tools dialog box (Eclipse), 255

F[ Top ]
-f option, 23, 25
factory element (TraX), 218
fail element (sound task), 234
fail method (JUnit), 130
fail task, 9, 36, 171
failifexecutionfails attribute
      apply task, 180
      exec task, 173, 175
failonany attribute (parallel task), 182
failonerror attribute
      apply task, 180
      copy task, 104
      custom tasks and, 268
      cvs task, 154
      cvschangelog task, 163
      cvstagdiff task, 165
      cvsversion task, 161
      delete task, 101
      exec task, 173, 175
      java task, 169, 171
      javac task, 61
      javadoc task, 78
      jspc task, 199
      loadfile task, 41
      mail task, 114
      scp task, 191
      sshexec task, 113
      tasks and, 27
      xmlvalidate task, 207
failureproperty attribute
      batchtest element, 136
      junit task, 133
      test task, 136
file attribute
      available task, 37
      buildnumber task, 85
      checksum task, 97
      chmod task, 117
      compilearg element, 65
      copy task, 104
      delete task, 101
      echo task, 98
      env element, 174
      FileSet type, 47
      import task, 73
      manifest task, 84
      property element, 18
      property task, 39
      replaceregexp task, 238
      scp task, 191
      taskdef task, 258
      touch task, 99
      xmlproperty task, 212
      xmlvalidate task, 207
file mappers, 44, 56-59
-file option, 23, 25
fileext attribute (checksum task), 97
filelist element (apply task), 181
FileList type, 44, 49, 102, 286
filemode attribute (zipfileset element), 93
filename selector, 46, 50
filepath attribute (available task), 37
files
      checking contents of, 97
      checking modification dates, 38
      comparing, 159, 165
      compressing, 91
      copying
            to local machines, 189
            to new locations, 102
            using filesets, 189
      creating empty, 98
      default excludes, 48
      deleting, 99-101
      filters and, 51, 53
      lists of, 49
      mappers and, 44, 56-59
      moving, 106, 107
      property, 39-43
      retrieving using ftp task, 109
      selecting to compile, 63
      setting creation time/date, 98
      setting protections with chmod, 116, 118
      working with groups of, 46-48
      XML, 211
files attribute
      FileList type, 49
      mail task, 114
fileset element, 46-48
      cab task and, 188
      catalogpath element and, 207
      delete task and, 100
      depend task and, 239
      ejbdoclet task, 224
      junitreport task and, 141
      nesting, 93, 101, 106, 111, 118
      replaceregexp task and, 238
      scp task and, 192
      war task and, 186
      webdoclet task, 219
      xslt/style task and, 217
FileSet type, 44, 46
      attributes, 47
      batch testing and, 144
      cab task and, 188
      chmod task and, 118
      defaultexcludes, 48
      delete task and, 99
      depend task and, 239
      fixcrlf task and, 94
      jar task and, 83
      javac task and, 62
      pathconvert task and, 102
      PatternSet type and, 49
      tar task and, 89
      tarfileset elements and, 90
      zip task and, 94
filesetmanifest attribute (jar task), 82
filesets, 189, 272-274
filesmatch element (condition task), 34
filesonly attribute
      ear task, 201
      jar task, 82
      war task, 186
      zip task, 93
filter task, 9, 52
FilterChain type, 44, 53-56, 106
filtering attribute (copy task), 104
filterreader element (FilterChain type), 54
FilterReaders, 53-56
filters
      copy task and, 106
      custom, 282-284
      files and, 51, 53
      FileSets as, 49
      text and, 53-56
FilterSet type, 44, 51-53
filtersfile attribute (filter task), 53
filtertrace attribute
      batchtest element, 136
      junit task, 133
      test task, 136
-find option, 23, 25
firewalls, 236
fixcrlf task, 10, 94-96
fixlast attribute (fixcrlf task), 96
flags attribute (replaceregexp task), 238
flatdestdir attribute (ejbjar task), 231
flatten attribute (copy task), 105
flatten mapper, 57
followsymlinks attribute
      DirSet type, 49
      FileSet type, 47
footer attribute (javadoc task), 78
force attribute
      ejbdoclet task, 223
      webdoclet task, 219
      xslt/style task, 216
forceoverwrite attribute (checksum task), 97
fork attribute
      batchtest element, 136
      java task, 169
      javac task, 61
      junit task, 133
      test task, 136
forking
      based on true/false properties, 68
      compiler, 64
      java task and, 167
      JVM, 167, 169
      jvmarg elements and, 134
format attribute
      report task, 141
      taskdef task, 258
Format command (Eclipse), 247, 251
format element (tstamp task), 86
formatter element (junit task), 135, 138
formatter task, 135
formatting
      Ant build files, 247
      test results, 135
forward slash (/), 18, 57, 91, 282
forwardslash attribute (apply task), 180
from attribute
      glob mapper and, 58
      mail task, 115
      mapper element, 57
      regular expressions and, 56, 58
      slashes and, 57
from element (mail task), 115
FTP, remote deployment, 107-111
ftp: schema, 193
ftp task, 12, 102, 107-111, 188
fullpath attribute
      tarfileset element, 91
      zipfileset element, 93, 201

G[ Top ]
generic element (serverdeploy task), 203
genericjarsuffix attribute
      ejbjar task, 231
      weblogic element, 232
genkey task, 10
get task, 10, 102, 193-196
getBaseDir method (Project class), 263
getBuildListeners method (Project class), 263
getDefaultInputStream method (Project class), 263
getDefaultTarget method (Project class), 263
getDescription method
      Project class, 263
      Task class, 261
getElementName method (Project class), 263
getIncludedFiles method (DirectoryScanner class), 273
getLocation method (Task class), 261, 265
getName method
      JUnit framework, 130
      Project class, 263
getOwningTarget method (Task class), 261
getProject method (Task class), 262
getProperties method
      Project class, 263
      System class, 22
getProperty method (Project class), 262, 276
getReference method (Project class), 263
getReferences method (Project class), 263
getRuntimeConfigurableWrapper method (Task class), 261
getTarget method (BuildEvent), 280
getTargets method (Project class), 263
getTask method (BuildEvent), 280
getTaskDefinitions method (Project class), 264
getTaskName method (Task class), 261
getTaskType method (Task class), 261
getUserProperties method (Project class), 264
getUserProperty method (Project class), 264
getWrapper method (Task class), 261
glob mapper, 12, 57
group attribute
      javadoc task, 78
      tarfileset element, 91
Gump build tool, 123
gunzip task, 10, 92
gzip task, 10, 90-92

H[ Top ]
-h option, 23
haltonerror attribute
      batchtest element, 136
      junit task, 134
      test task, 136
haltonfailure attribute
      batchtest element, 136
      junit task, 134, 138
      test task, 136
handleErrorFlush method (Task class), 261
handleErrorOutput method (Task class), 261
handleFlush method (Task class), 261
handleInput method (Task class), 261
handleOutput method (Task class), 261
header attribute (javadoc task), 78
headfilter element (FilterChain type), 54
-help option, 23
helpfile attribute (javadoc task), 78
hibernatedoclet task (XDoclet), 218
history command (CVS), 152
homeinterface element (ejbdoclet task), 224
host attribute (sshexec task), 113
hot deployment, 202-205
hpas element (ejbdoclet task), 224
HTML reports, 165
HtmlUnit framework (JUnit extension), 148
http element (condition task), 34, 111
http: schema, 193
https: schema, 193
HttpUnit framework (JUnit extension), 148
hyphen (-), 25

I[ Top ]
IBM, Eclipse and, 241
icontract task, 12
id attribute
      FilterSet type, 52
      patterns and, 49
      xmlcatalog element, 207
identity mapper, 57
ieplugin attribute (jspc task), 199
if attribute
      batchtest element, 136
      elements and, 47
      elements supporting, 35
      fail task and, 36
      formatter task, 135
      param element, 217
      target element, 8
      test task, 136
if statement (see conditions)
ignoreerrors attribute (get task), 195
ignoreNoncriticalErrors attribute (ftp task), 110
ignoresystemclasses attribute (available task), 37
ignorewhitespace attribute (patch task), 166
ilasm task, 13
ildasm task, 13
image task, 12
imageurl attribute (splash task), 236
import command (CVS), 152
import task, 10, 72, 74
ImportTypelib task, 13
in attribute (xslt/style task), 216
include element
      cab task and, 188
      depend task and, 239
      DirSet type and, 48
      fileset element and, 47
      FileSet type, 46
      filesets and, 272
      jar task and, 83
      javac task, 62
      PatternSet type and, 50
      support element and, 231
      xslt/style task and, 217
      zip task and, 94
includeantruntime attribute
      javac task, 61
      junit task, 134
includeEmptyDirs attribute
      copy task, 105
      delete task, 101
includefilenames attribute (mail task), 115
includeJavaRuntime attribute (javac task), 61
includes attribute
      cab task, 187
      chmod task, 117
      delete task, 100
      DirSet type, 49
      ear task, 201
      FileSet type, 47
      fixcrlf task, 96
      jar task, 83
      javac task, 61
      PatternSet type, 50
      tar task, 90
      war task, 186
      xslt/style task, 216
      zip task, 93
includes element
      jspc task and, 199
      MatchingTask class, 274
includeSemanticAttribute attribute (xmlproperty task), 212
includesfile attribute
      cab task, 187
      delete task, 100
      DirSet type, 49
      ear task, 201
      FileSet type, 47
      fixcrlf task, 96
      jar task, 83
      javac task, 62
      PatternSet type, 50
      tar task, 90
      war task, 186
      xslt/style task, 216
      zip task, 93
includesfile element
      DirSet type and, 48
      fileset element and, 47
      FileSet type, 46
      PatternSet type and, 50
index attribute (jar task), 83
info command (CVS), 152
inheritAll attribute
      ant task, 71
      antcall task, 69
inheritRefs attribute
      ant task, 71
      antcall task, 69
init command (CVS), 152
init method
      Ant tasks and, 262
      Project class, 264
      Task class, 261
initialCR attribute (telnet task), 112
input attribute
      apply task, 180
      exec task, 173
      java task, 169
input task, 10, 66-68, 107
-inputhandler option, 23
inputstring attribute
      apply task, 180
      exec task, 173
      java task, 169
installing
      Ant, 2
      Anthill, 119
int data type, 266
Internet Service Providers (ISPs), 31
IP addresses, 107, 189
iPlanet element, 232
iplanet-ejbc task (EJB), 14, 230
isfalse element (condition task), 34
isInvalid method (Task class), 261
ISPs (Internet Service Providers), 31
isreference element (condition task), 34
isset element (condition task), 34
istrue element (condition task), 34

J[ Top ]
jar attribute (java task), 169
.jar files
      adding, 249
      creating, 81-84
      ejbjar task and, 231-233
      optional tasks and, 11
      running scripts and, 275
      unpacking, 11
jar: schema, 193
jar task, 10
      creating .jar files, 81-83
      ear task and, 201
      jlink task and, 12
      nesting and, 83
      war task and, 184
      zipfileset element and, 201
jarlib-available task, 12
jarlib-manifest task, 12
jarlib-resolve task, 12
jarsign task, 82
Jasper JSP compiler, 196
Java build process
      calling other tasks, 68-72
      compiling code, 60-66
      creating .jar files, 81-84
      documenting code, 74-80
      importing build files, 72, 74
      setting build numbers, 84
      setting timestamps, 85-87
      user input and, 66-68
Java classes
      data types and, 267
      dependencies and, 238, 240
      filters and, 54
      generic element and, 203
      java task and, 167
      recognizing updated, 193
      test element and, 135
Java Development Kit (see JDK)
Java Media Framework, 234
Java Native Interface (JNI), 12
java task, 10, 167-172
      running test cases, 137
      timeouts and, 177
JavaBean Tester tool, 148
javac task, 10
      alternatives, 65
      compiling
            code, 60-63
            JSPs, 196, 198
            source files, 63
      depend task and, 238
      file sets and, 47
      forking compiler, 64
      java task and, 170
      setting command-line options, 64
      src element and, 45
      srcdir attribute, 48
JavaCC compiler, 12
javacc task, 12
JAVACMD environment variable, 26
javadoc task, 10, 74-80
Javadoc wizard (Eclipse), 247
javadoc2 task, 10
javafiles attribute (fixcrlf task), 96
javah task, 12
JAVA_HOME environment variable, 3
java.io.File data type, 266
JavaServer Pages (see JSPs)
JAXP (Sun), 206
jboss element (ejbdoclet task), 224, 232
jbosswebxml element (webdoclet task), 219
JcovMerge task, 12
JcovReport task, 12
JDBCTask class, 260
jdepend task, 12
JDK (Java Development Kit), 3, 215
jdodoclet task (XDoclet), 218
Jemmy (Java library), 148
Jenerator, 148
JFCUnit, 148
JJDoc documentation generator, 12
jjdoc task, 12
JJTree preprocessor, 12
jjtree task, 12
jlink task, 12
jmxdoclet task (XDoclet), 218
JNDI DataSource helper package, 149
JNI (Java Native Interface), 12
JOnAS
      deployment tool, 204
      servers
            ejbdoclet task and, 224
            EJBs and, 230
            hot deployment and, 202
            jonas element and, 204
jonas element
      ejbdoclet task, 224
      nesting, 232
      serverdeploy task, 203, 204-205
JOnAS servers
jonasroot attribute (jonas element), 204
jonaswebxml element (webdoclet task), 219
JPCoverage task, 12
jprobe task, 12
jrun element (ejbdoclet task), 224
jrunwebxml element (webdoclet task), 219
jsharpc task, 13
jspc task, 12, 196-199
JSPs (JavaServer Pages), 192, 196-199
jsptaglib element (webdoclet task), 219
JUnit framework, 127-130
      Ant tasks and, 12
      batch testing, 142, 144
      extending, 148-149
      performing tests, 133-137
      running build file, 144-148
      running test cases, 137-142
      writing tests, 130-133
junit task, 12, 125, 138, 142
      packager mapper and, 58
      performing tests with, 133-137
      testing with, 126
JUnitDoclet, 149
JUnitPerf, 149
junitreport task, 12, 141
JUnitX, 149
JVM
      accessing system properties, 135
      Eclipse and, 247
      forking, 167, 169
      mixed environments and, 174
      passing environment variables to, 134
jvm attribute
      java task, 169
      junit task, 134
jvmarg element
      arguments and, 170
      generic element and, 203
      jonas element and, 205
      nesting and, 134
jvmargs attribute
      java task, 169
      weblogic element, 233
jvmdebuglevel attribute (weblogic element), 233
jWebUnit, 149

K[ Top ]
-k option, 23
keepcompression attribute
      ear task, 202
      jar task, 83
      war task, 186
      zip task, 93
keepgenerated attribute (weblogic element), 233
keepgeneric attribute (weblogic element), 233
-keep-going option, 23
keepRoot attribute (xmlproperty task), 212
key attribute
      env element, 174
      system properties and, 135
keyfile attribute
      scp task, 191
      sshexec task, 113
knownhosts attribute
      scp task, 191
      sshexec task, 113
knownhosts file, 189

L[ Top ]
-l option, 23
language attribute (script task), 276
lenient attribute (xmlvalidate task), 207
lib directory (Ant), 11, 31
lib element (war task), 186
-lib option, 23, 31
libcabinet tool, 187
line attribute
      argument element, 155
      compilearg element, 65
line feed (carriage return), 94-96
linecontains element (FilterChain type), 54
linecontainsregexp element (FilterChain type), 54
link attribute (javadoc task), 78
linkoffline attribute (javadoc task), 78
linksource attribute (javadoc task), 78
Linux environment, 176
list action
      JOnAS servers, 204
      weblogic tool, 203
-listener option, 23
listeners, custom, 278-280
listfiles attribute (javac task), 62
listing attribute (ftp task), 110
loaderRef attribute (taskdef task), 258
loadfile task, 10, 41, 53
loadproperties task, 10, 53, 56
locale attribute
      format task, 87
      javadoc task, 78
Locale class (Java), 87
localhomeinterface element (ejbdoclet task), 224
localinterface element (ejbdoclet task), 224
location attribute
      dtd element, 207
      pathelement element, 45
      property element, 19
log command (CVS), 152
log method
      loggers and, 280
      Project class, 264
      Task class, 261
Log4Unit, 149
logError attribute
      apply task, 180
      exec task, 173
      java task, 169
-logfile option, 30
-logger option, 23
loggers/logging
      custom, 280
      output, 30, 278
logging in, source control and, 153
login command (CVS), 152
logout command (CVS), 152
longfile attribute (tar task), 90
loops attribute (success/fail elements), 235
ls command (CVS), 152, 176
lsacl command (CVS), 152

M[ Top ]
Mac OS environment, 33
macrodef task, 10
mail task, 10, 12, 114-116
mailhost attribute (mail task), 114
MailLogger.failure.notify property, 116
MailLogger.failure.subject property, 116
MailLogger.failure.to property, 116
MailLogger.from property, 116
MailLogger.mailhost property, 116
MailLogger.port property, 116
MailLogger.success.notify property, 116
MailLogger.success.subject property, 116
MailLogger.success.toSpecifies property, 116
mailport attribute (mail task), 115
manifest attribute
      ear task, 202
      jar task, 83
      war task, 186
manifest element (jar task), 83
manifest files, 86
      creating, 81, 84
      default, 185
      jar task and, 83
      plug-in, 247
manifest task, 10, 84
manifestencoding attribute (jar task), 83
mapped attribute (jspc task), 199
mapper element
      attributes, 57
      batch execution and, 181
      copying files and, 103
      nesting, 57, 69, 106
mappers, 44, 56-59
master targets, 16
match attribute (replaceregexp task), 238
MatchingTask class, 260, 273
maudit task, 12
maxmemory attribute
      java task, 169
      javadoc task, 78
      junit task, 134
maxparallel attribute
      apply task, 180
      chmod task, 117
maybeConfigure method (Task class), 261
MD5 checksum, 97
memoryInitialSize attribute (javac task), 62
memoryMaximumSize attribute (javac task), 62
merge mapper, 57
mergeDir attribute
      ejbdoclet task, 223
      webdoclet task, 219
message attribute
      fail task, 36
      input task, 68
      mail task, 115
message element (mail task), 116
messagefile attribute (mail task), 115
messagemimetype attribute (mail task), 115
metainf element
      jar task and, 83
      war task and, 186
Metamata Metrics/WebGain Quality Analyzer, 12
methods
      attributes in custom tasks, 266-268
      Project class and, 262
      Property class, 263-265
      Task class, 261
Microsoft, 3, 15, 151, 187
millis attribute (touch task), 99
mimemail task, 12
mimetype attribute (message element), 116
mkdir task, 10, 20, 99, 101
mmetrics task, 12
mockdoclet task (XDoclet), 218
mode attribute
      manifest task, 84
      tarfileset element, 91
modification dates, files, 38, 39
modification sets, 124
modificationset task, 124
modified selector, 50
modules, 151
      checking out, 155
      updating shared code, 157
move task, 10
      deployment and, 102, 106
      filterchain element, 53
      mappers and, 56
      renamextension task and, 12
MParse compiler (Metamata), 12
mparse task, 12
multithreading tasks, 181
mvcsoft element (ejbdoclet task), 224

N[ Top ]
name attribute
      attribute element, 84, 207
      elements supporting, 47, 115
      factory element, 218
      outproperty element, 218
      param element, 217
      project element, 7, 22
      property element, 19
      section element, 84
      target element, 8
      taskdef task, 258
      test task, 136
name property (input task), 107
name=value format, 40
naming attribute (ejbjar task), 231
native2ascii task, 12
nesting
      arg elements, 174
      batchtest element, 136
      catalogpath element and, 207
      checksum task and, 98
      chmod task and, 118
      classpath element, 134
      dependencies and, 17
      DirSet type and, 48
      ejbdoclet task and, 223
      ejbjar task and, 231
      elements, 34, 45, 270-272
      fileset elements, 93, 101, 106, 111, 181
      FilterChain type, 53
      generic element and, 203
      jar task and, 83
      javac task and, 62
      jonas element and, 205
      jspc task and, 199
      mail task and, 115
      mapper element and, 57, 69, 106
      message elements, 116
      param elements, 69
      PatternSet type, 49
      property elements, 72
      propertyset elements, 69, 72
      read elements, 112
      reference elements, 69, 72
      replaceregexp task and, 238
      selectors, 51
      tarfileset elements, 90
      taskdef task and, 259
      text data, 269
      user element, 164
      webdoclet task and, 219
      weblogic element and, 233
      write elements, 112
      xmlcatalog elements and, 207
      xmlvalidate task and, 207
      xslt/style task and, 217
      zipgroupfileset elements, 94
.NET, 13, 187
netrexxc task, 12
New Java Class dialog box (Eclipse), 243
New Project dialog box (Eclipse), 243
newCMP attribute (weblogic element), 233
newenvironment attribute
      apply task, 180
      exec task, 173
      java task, 169
      junit task, 134
newer attribute (ftp task), 110
newline (/n), 94
nodeprecated attribute (javadoc task), 78
nodeprecatedlist attribute (javadoc task), 78
noEJBC attribute (weblogic element), 233
noexec attribute (cvs task), 154
nohelp attribute (javadoc task), 79
noindex attribute (javadoc task), 79
-noinput option, 24
nonavbar attribute (javadoc task), 79
NonStop Kernel (Tandem), 117
noqualifier attribute (javadoc task), 79
not element (condition task), 34
notree attribute (javadoc task), 79
nowarn attribute (javac task), 62

O[ Top ]
oc4j element (ejbdoclet task), 224
offset attribute (format task), 87
old attribute (javadoc task), 79
onerror attribute (taskdef task), 259
open source
      Ant and, 2
      CVS and, 151
      Eclipse and, 241
      JUnit and, 127
      XDoclet and, 206
openejb element (ejbdoclet task), 224
operating systems
      Ant support, 5
      build process and, 6
      determining name, 22
      exec task and, 176
optimize attribute (javac task), 62
optional attribute (import task), 73
options attribute (cab task), 188
or element (condition task), 34
orb attribute (jonas element), 204
originalfile attribute (patch task), 166
orion element (ejbdoclet task), 224
os attribute
      apply task, 180
      exec task, 173, 176
os element (condition task), 34
out attribute (xslt/style task), 216
outfile attribute (test task), 136
Outline view (Eclipse), 245
outproperty element, 218
output
      build process and, 27
      controlling, 28-30
      logging, 30
output attribute
      ant task, 71
      antstructure task, 213
      apply task, 180
      cvs task, 155
      exec task, 173
      java task, 170
      sshexec task, 113
outputdir attribute (weblogic element), 233
outputencoding attribute (copy task), 105
outputproperty attribute
      apply task, 180
      exec task, 173
      java task, 170
      sshexec task, 113
overview attribute (javadoc task), 79
overwrite attribute
      copy task, 105
      move task, 106

P[ Top ]
-p option, 24
P4Add task, 15
P4Change task, 14
P4Counter task, 15
P4Delete task, 15
P4Edit task, 14
P4Fstat task, 15
P4Have task, 14
P4Integrate task, 15
P4Label task, 14
P4Labelsync task, 14
P4Reopen task, 15
P4resolve task, 15
P4Revert task, 15
P4Submit task, 14
P4Sync task, 14
Pack class, 260
package attribute
      cvs task, 155
      cvschangelog task, 163
      cvstagdiff task, 165
      cvsversion task, 161
      javadoc task, 79
      jspc task, 199
Package Explorer (Eclipse)
      build.xml file and, 245, 247
      creating
            build files, 244
            projects, 243
package mapper, 57
packagelist attribute (javadoc task), 79
packagenames attribute (javadoc task), 79
packageSubstitution element
      ejbdoclet task, 224
      webdoclet task, 219
packaging applications/deployment, 88-99
parallel attribute
      apply task, 180
      chmod task, 117
parallel task, 10, 181
param element
      nesting, 69
      xslt/style task and, 217
parentheses [( )], 56
parser attribute (xmlvalidate task), 208
passfile attribute
      cvs task, 155
      cvschangelog task, 163
      cvspass task, 154
      cvstagdiff task, 165
      cvsversion task, 161
passive attribute (ftp task), 110
passphrase attribute
      scp task, 191
      sshexec task, 113
passwd command (CVS), 152
password attribute
      cvspass task, 154
      ftp task, 110
      generic element, 203
      get task, 195
      mail task, 115
      scp task, 189, 191
      sshexec task, 113
      telnet task, 112
      weblogic element, 204
password property (input task), 107
passwords, 153, 191
patch task, 10, 160, 165
patchfile attribute (patch task), 166
path attribute
      compilearg element, 65
      env element, 174
PATH environment variable, 3
path type, 44, 102
pathconvert task, 10, 102
pathelement element
      catalogpath element and, 207
      location attribute, 45
      nesting and, 45
path-like structures, 45
      core Ant types, 44
      javac task and, 62
      junit task and, 134
paths
      absolute, 74
      converting references to, 102
      exec task and, 174
      nested elements and, 45
pattern attribute (format task), 87
patterns, 49
      DirSet type attributes and, 49
      fixcrlf task and, 96
      glob mapper and, 58
      replaceregexp task and, 236-238
      selectors and, 50
patternset element
      cab task and, 188
      conditional actions, 35
      depend task and, 239
      DirSet type and, 48
      fileset element and, 47
      jar task and, 83
      javac task, 62
      xslt/style task and, 217
      zip task and, 94
PatternSet type, 44, 49
Perforce, Ant tasks for, 14
perforce task, 151
perform method (Task class), 261
perm attribute (chmod task), 117
permissions
      setting with chmod, 116
      tarfileset type and, 90
      Unix and, 103, 191
permissions element, 137, 170
Permissions type, 44
plain formatter, 135, 138
plug-in manifest files, 247
pollInterval attribute (parallel task), 182
port attribute
      cvs task, 155
      cvschangelog task, 163
      cvstagdiff task, 165
      cvsversion task, 161
      ftp task, 110
      scp task, 191
      sshexec task, 113
      telnet task, 112
portletdoclet task (XDoclet), 218
pramati element (ejbdoclet task), 224
prefix attribute
      property element, 19
      tarfileset element, 91
      tstamp task, 86
      xmlproperty task, 212
      zipfileset element, 94, 201
prefixlines element (FilterChain type), 54, 56
present selector, 51
preservelastmodified attribute
      copy task, 105
      ftp task, 111
preserveLeadingSlashes attribute (tarfileset element), 91
presetdef task, 10
printsummary attribute (junit task), 134
private attribute (javadoc task), 79
Problems view (Eclipse), 248
processor attribute (xslt/style task), 217
Project class, 263, 276
project element, 7, 72
<project> tags, 73
-projecthelp option, 24, 30
projects, 6
      accessing in code, 262-266
      creating, 243
      modules and, 151
      setting classpath, 249
properties, 18
      accessing in code, 262-266
      built-in, 22
      conditional actions, 35-36
      declaring outside targets, 19
      loading from XML files, 211-212
      loading text files, 41
      name=value format, 40
      overriding, 41-43
      passing with ant task, 72
      setting
            conditions, 32-35
            values, 250
            with environment variables, 43
            with tasks, 37
      stopping builds, 36
      text strings and, 40
      values as tooltips, 247
      (see also types)
property attribute
      available task, 37
      checksum task, 97
      condition task, 33
      format task, 87
      loadfile task, 41
      update task, 39
Property class, 263-265
property element
      attributes, 18-22
      environment variables, 18, 43
      nesting, 72
property files, 39-43
property task, 10, 39
      declaring properties, 19
      param elements and, 69
-propertyfile option, 24, 39
propertyfile task, 12, 40
propertyref element, 69
propertyset element, 69, 72
PropertySet type, 44
protected attribute (javadoc task), 79
provider attribute (checksum task), 97
public attribute (javadoc task), 79
publicId attribute (dtd element), 207
pvcs task, 12, 151

Q[ Top ]
-q option, 24
quiet attribute
      cvs task, 155
      cvstagdiff task, 165
      delete task, 101
      patch task, 166
-quiet option, 24, 28

R[ Top ]
rannotate command (CVS), 152
rdiff command (CVS), 152, 160, 165
read element (telnet task), 112
readbuffersize attribute (checksum task), 97
reallyquiet attribute (cvs task), 155
rebuild attribute (weblogic element), 233
reconfigure method (Task class), 262
record task, 10
reference element, 69, 72
refid attribute
      FilterSet type, 52
      path element, 45
      property element, 19
      reference element, 69
      xmlcatalog element, 207
regexp element, 238
regexp mapper, 56-58
regular expressions
      from attribute and, 56
      mappers and, 57
      substituting text, 236-238
relative attribute (apply task), 180
release command (CVS), 152
reload task, 192
reloading attribute (junit task), 134
reloadstylesheet attribute (xslt/style task), 217
remotedir attribute (ftp task), 109, 111
remotefacade element (ejbdoclet task), 224
remoteinterface element (ejbdoclet task), 224
remove command (CVS), 152
rename task, 10
renameextensions task, 12
replace attribute (replaceregexp task), 238
replace task, 10, 53
replaceProperties method (Project class), 264, 270
replaceregexp task, 13, 236-238
replacetokens element (FilterChain type), 54
replyto attribute (mail task), 115
replyto element (mail task), 115
report element, 141
reports
      brief formatter, 139
      change logs, 161-164
      cvstagdiff task and, 164
      junitreport task and, 141
      plain formatter, 138
      XML formatter, 140
repositories, 151
resin-ejb-xml element (ejbdoclet task), 224
resin-web-xml element (webdoclet task), 219
resolveExecutable attribute
      apply task, 180
      exec task, 173
resolveFile method (Project class), 264
resource attribute
      available task, 38
      property element, 19
      taskdef task, 259
resultproperty attribute
      apply task, 180
      exec task, 173, 175
      java task, 170
return codes, 170-172, 175
reverse attribute (patch task), 166
rexec task, 13
rlog command (CVS), 152
rmic task, 10
rootDirectory attribute (xmlproperty task), 212
rpm task, 13
rtag command (CVS), 153
run method (JUnit), 130
runBare method (JUnit), 130

S[ Top ]
-s option, 23
SAX Parser, 207
SAX2 parser, 206
scanincludeddirectories attribute (xslt/style task), 217
Schema Unit Test (SUT), 149
schema, validating with, 208
scp command (Unix), 191
scp task, 13, 112, 189-192
Scripdef task, 13
script task, 13, 275-278
section element (manifest task), 84
selector element (fileset element), 47
selectors, 50, 51, 284
Selectors type, 44
semanticAttributes attribute (xmlproperty task), 212
semicolon (;), 266
separator attribute (ftp task), 111
sequential task, 10, 182
serialwarn attribute (javadoc task), 79
server attribute
      ftp task, 107, 111
      generic element, 203
      jonas element, 205
      telnet task, 112
      weblogic element, 204
server command (CVS), 153
serverdeploy task, 13, 202-205
servlets, 188, 192-195, 221-223
session element (ejbdoclet task), 224
setBaseDir method (Project class), 264
setDefault method (Project class), 264
setDefaultInputStream method (Project class), 264
setDescription method
      Project class, 264
      Task class, 262
setInheritedProperty method (Project class), 264
setKeepGoingMode method (Project class), 264
setLocation method (Task class), 262
setName method
      JUnit framework, 130
      Project class, 264
setNewProperty method (Project class), 264
setOwningTarget method (Task class), 262
setProjectReference method (Project class), 264
setProperty method (Project class), 264
setproxy task, 13, 236
setRuntimeConfigurableWrapper method (Task class), 262
setTaskName method (Task class), 262
setTaskType method (Task class), 262
setUp method (JUnit), 130, 133
setUserProperty method (Project class), 265
setValue method
      Commandline object, 275
      EnumeratedAttribute class, 267
shell commands, 177, 178
short data type, 266
showduration attribute (splash task), 236
showoutput attribute (junit task), 134
signjar task, 10
SimpleDateFormat class (Java), 86, 87
size selector, 51
skipemptyfilesets attribute (apply task), 181
skipFailedTransfers attribute (ftp task), 111
sleep task, 10, 109, 205
SMTP servers, 114, 115
socket element (condition task), 34, 111
Soscheckin task, 16
Soscheckout task, 16
Sosget task, 16
Soslabel task, 16
sound task, 13, 234, 235
source attribute
      javac task, 62
      javadoc task, 79
      serverdeploy task, 202
      success/fail elements, 235
source code
      accessing projects/properties in, 262-266
      checking out, 119
      compiling, 60-63
      patches to, 165
source control (see CVS)
source release (Ant), 2
sourcefiles attribute (javadoc task), 80
SourceOffsite (SourceGear), 16
sourceoffsite task, 151
sourcepath attribute
      javac task, 62
      javadoc task, 80
      path type, 45
sourcepath element, 45
sourcepathref attribute
      javac task, 62
      javadoc task, 80
spaces, 95, 153, 237
spawn attribute
      apply task, 181
      exec task, 173
      java task, 170
splash screens, 13, 235
splash task, 13, 235
splitindex attribute (javadoc task), 80
sql task, 10
SQLUnit, 149
src attribute
      get task, 195
      gzip/bzip2 tasks, 92
      message element, 116
      script task, 276
      unjar task, 84
      zipfileset element, 94, 202
src element, 45
srcdir attribute
      depend task, 239
      ejbjar task, 231
      fixcrlf task, 96
      javac task, 48, 62
      jspc task, 199
      path type, 45
srcfile attribute
      example, 38
      loadfile task, 41
      purpose, 38
      update task, 39
srcfile element, 181
SSH protocol, 112, 189
sshexec task, 13, 112
ssl attribute (mail task), 115
start attribute (cvschangelog task), 163
startdate attribute (cvstagdiff task), 165
StarTeam, 15, 151
starteam task, 151
starttag attribute (cvstagdiff task), 165
status command (CVS), 153
STCheckin task, 15
STCheckout task, 15
STLabel task, 15
STList task, 15
stripjavacomments element (FilterChain type), 54
striplinebreaks element (FilterChain type), 54
striplinecomments element (FilterChain type), 54
strutsconfigxml element (webdoclet task), 219
strutsform element (ejbdoclet task), 224
strutsvalidationxml element (webdoclet task), 219
style attribute (xslt/style task), 217
style task, 11, 206, 214-218
stylebook task, 13
styledir attribute (report task), 141
stylesheetfile attribute (javadoc task), 80
subant task, 10
subject attribute (mail task), 115
subroutine calls, 71
substitution element (replaceregexp task), 238
subTask element
      ejbdoclet task, 224
      webdoclet task, 219
success element (sound task), 234
suffix attribute (weblogic element), 233
sunone element (ejbdoclet task), 224
support element (ejbjar task), 231
SUT (Schema Unit Test), 149
symlink task, 13
sync task, 10
syntax checking, 246
sysproperty element
      junit task, 135
      purpose, 170
      weblogic element and, 233
syspropertyset element, 137, 170
System.err, 278, 280
System.out, 278, 280

T[ Top ]
tab attribute (fixcrlf task), 96
tablength attribute (fixcrlf task), 96
tabs, manipulating, 95
tabstospaces element (FilterChain type), 54
tag attribute
      cvs task, 155
      cvschangelog task, 164
tag command (CVS), 153
tailfilter element (FilterChain type), 54
tar task, 10, 89-91
tarfileset element (tar task), 90
target attribute
      ant task, 71
      antcall task, 69
      javac task, 62
target element, 8, 30, 35
targetfile attribute
      update task, 39
      uptodate task, 38
targetfile element, 181
targets, 7
      Ant view and, 255
      antcall task and, 68
      build example, 16-18
      build files and, 25, 71
      declaring properties and, 19
      DirSet type and, 48
      FileSet type and, 46
      hyphens and, 25
      master, 16
      running
            multiple, 25
            test cases, 137
targetStarted method, 278
Task class, 260-262
taskdef element, 192
taskdef task, 10
      attributes, 258
      creating tasks, 257
      ejbdoclet task and, 226
      target element and, 19
      webdoclet task and, 220
tasks, 8
      adding, 252
      built-in, 8-11
      calling other, 68-72
      creating custom, 257-260
      creating DTDs for, 213
      declaring outside targets, 19
      dependent, 16-18
      DirSet type and, 48
      failonerror attribute, 27
      FileSet type and, 46
      grouping, 7
      handling attributes, 266-268
      implicit file sets, 47
      life cycle of, 262
      multithreading, 181
      optional, 11-16
      property-setting, 32-38
      setting execution order, 182
      third-party, 16
      as wrappers, 274
      (see also types)
tearDown method (JUnit), 130, 133
telnet task, 13, 111
tempdir attribute
      javac task, 62
      junit task, 134
tempfile task, 10, 98
test cases, 130, 133, 137-142
test element, 135
test suites, 142
test task, 13, 136
TestCase class (JUnit), 128, 130
TestCases method (JUnit), 130
testEquals method (JUnit), 130
testNotNull method (JUnit), 130
TestRunner class (JUnit), 137
tests/testing
      Ant, 4
      build process, 125
      criteria, 33
      formatting results, 135
      in batches, 136, 137, 142, 144
      junit task and, 126
      performing, 133-137
      running test cases, 137-142
      writing, 130-133
TestSuite class (JUnit), 142
testTrue method (JUnit), 130
text data
      as attribute values, 266
      filtering, 53-56, 106
      loading, 41
      nesting, 269-270
      os attribute and, 174
      properties, 40
      replaceregexp task and, 236-238
threadCount attribute (parallel task), 182
threadsPerProcessor attribute (parallel task), 182
timediffauto attribute (ftp task), 111
timediffmillis attribute (ftp task), 111
timeout attribute
      apply task, 181
      exec task, 174, 177
      java task, 170
      junit task, 134
      parallel task, 182
      sshexec task, 113
      telnet task, 112
timeouts, handling, 177
timestamp property (format element), 86
timestamps, 84-87
timezone attribute (format task), 87
TimeZone class (Java), 87
to attribute
      glob mapper and, 58
      mapper element, 57
      regular expressions and, 58
      slashes and, 57
to element (mail task), 115
TODAY property (tstamp task), 85
todir attribute
      batchtest element, 136
      checksum task, 98
      copy task, 105
      junitreport task, 141
      report task, 141
      scp task, 192
      test task, 136
tofile attribute
      copy task, 105
      junitreport task, 141
token attribute (filter task), 53
tokenfilter element (FilterChain type), 54
tokens, 51
tolist attribute (mail task), 115
Tomcat web servers
      Anthill and, 119
      deploying to, 192-196
      Jasper JSP compiler, 196
      .war files and, 188
tooltips, 247
torefid attribute (reference element), 69
toString method (JUnit), 130
totalproperty attribute (checksum task), 98
touch task, 98
translate task, 13
translatePath method (Project class), 265
TraX processor, 218
true/false tests, 33, 68
trust attribute
      scp task, 189, 192
      sshexec task, 113
TSTAMP property (tstamp task), 85
tstamp task, 11, 85-87
type attribute
      apply task, 181
      available task, 38
      chmod task, 117
      formatter task, 135
      mapper element, 57
type selector, 51
typedef task, 11, 19
types
      adding, 252
      core, 44
      creating, 286-289
      file filters, 51, 53
      filtering/modifying text, 53-56
      lists of files, 49
      mappers as, 56-59
      path-like structures, 45
      selectors as, 50
      with groups of directories, 48
      with groups of files, 46-48
      with patterns, 49
      (see also properties)

U[ Top ]
umask attribute (ftp task), 111
UMASK permissions (Unix), 103, 191
undeploy action
      JOnAS servers, 204
      weblogic tool, 203
undeploy task, 192
unedit command (CVS), 153
Unicode characters, 6, 54
unit attribute (format task), 87
Unix environment
      build process, 5, 21
      chmod task and, 117
      crontab utility, 116, 118
      end-of-line characters, 94
      exec task and, 174
      executing shell commands, 177
      file permissions and, 103
      installing Ant, 3
      MAC OS and, 33
      permissions and, 191
      scheduling automatic builds, 118
      verbose build, 28
unjar task, 11, 84
unless attribute
      batchtest element, 136
      elements supporting, 35, 47
      fail task and, 36
      formatter task, 135
      param element, 217
      target element, 8
      test task, 136
Unpack class, 260
unpackage mapper, 57, 59
untar task, 11, 91
unwar task, 11
unzip task, 11, 94
update action
      JOnAS servers, 204
      weblogic tool, 203
update attribute
      ear task, 202
      jar task, 83
      war task, 186
      zip task, 93
update command (CVS), 153, 157
uptodate element (condition task), 34
uptodate task, 11
      attributes for, 39
      file modification dates and, 38
      mappers and, 56
      package mapper and, 58
uri attribute (taskdef task), 259
uribase attribute (jspc task), 199
uriroot attribute (jspc task), 199
url attribute
      property element, 19
      property task, 39
URL schemas, 193
use attribute (javadoc task), 80
useexternalfile attribute (javadoc task), 80
usefile attribute
      formatter element, 135
      formatter task, 135
user attribute (mail task), 115
user element, 164
userid attribute
      ftp task, 111
      telnet task, 112
      user element, 164
username attribute
      generic element, 203
      get task, 195
      sshexec task, 113
      tarfileset element, 91
      weblogic element, 204
usernames, 191
usersfile attribute (cvschangelog task), 164
usetimestamp attribute (get task), 196
utilobject element (ejbdoclet task), 224

V[ Top ]
-v option, 24
vajexport task, 13
vajimport task, 13
vajload task, 13
validargs attribute (input task), 68
validate attribute (xmlproperty task), 212
value attribute
      argument element, 155
      attribute element, 84, 207
      available task, 38
      compilearg element, 65
      condition task, 33
      env element, 174
      filter task, 53
      outproperty element, 218
      property element, 19
      property task, 40
      setting property values, 37
      system properties and, 135
      update task, 39
valueobject element (ejbdoclet task), 224
vbc task, 13
verbose attribute
      apply task, 181
      cab task, 188
      chmod task, 117
      copy task, 105
      delete task, 101
      ejbdoclet task, 223
      ftp task, 111
      get task, 196
      javac task, 62
      javadoc task, 80
      jspc task, 199
      webdoclet task, 219
-verbose option, 24, 28-30
verifyproperty attribute (checksum task), 98
version attribute (javadoc task), 80
version command (CVS), 153
-version option, 24
Visual Source Safe (Microsoft), 15, 151
vmlauncher attribute
      apply task, 181
      exec task, 174
Vssadd task, 15
Vsscheckin task, 15
Vsscheckout task, 15
Vsscp task, 15
Vsscreate task, 15
vssget task, 15
Vsshistory task, 15
Vsslabel task, 15

W[ Top ]
waitfor task, 11, 109, 205
war task, 11, 184-186
warfile attribute (war task), 186
warn attribute (xmlvalidate task), 207
watch command (CVS), 153
watchers command (CVS), 153
.wav format, 278
web applications
      compiling JSPs, 196-199
      creating CAB files, 187
      creating WAR archives, 184-186
      EJB containers and, 200-205
      scp task and, 189-192
      simple web deployment, 188
      Tomcat servers and, 192-196
      XDoclet and, 218-223
webdoclet task (XDoclet), 218-223
webinc attribute (jspc task), 199
webinf element (war task), 186
weblogic element, 203, 224, 232
WebLogic servers, 14, 202, 204, 230, 233
weblogic.deploy deployment tool, 203
weblogicwebxml element (webdoclet task), 219
websphere element, 224, 232
webspherewebxml element (webdoclet task), 219
webworkactiondocs element (webdoclet task), 219
webworkactionsxml element (webdoclet task), 219
webworkconfigproperties element (webdoclet task), 219
webxml attribute
      jspc task, 199
      war task, 186
whenempty attribute
      jar task, 83
      zip task, 93
whichresource task, 11
wildcards, 38, 57
Windows environment
      at command, 116, 118
      build process, 5, 22
      CVS servers, 151
      EOL characters and, 95
      exec task and, 174, 176, 177
      executing shell commands, 177
      filename lengths, 3
      installing Ant, 3
      scheduling automatic builds, 118
      spaces in username, 153
      verbose build, 29
windowtitle attribute (javadoc task), 80
wlclasspath attribute (weblogic element), 233
wlclasspath element (weblogic element), 233
wljspc task, 13
wlrun task (EJB), 14, 182, 230
wlstop task (EJB), 14, 230
write element, 112
WsdlToDotNet task, 13

X[ Top ]
Xalan processor, 215, 217
XDoclet, 206
XML
      documents, 6, 141, 206-211
      files, 211
      formatter, 135, 140
      transforming, 214-218
xmlcatalog element, 207, 217
XMLCatalog type, 44
xmlproperty task, 11, 206, 211
xmlvalidate task, 13, 206-211
XSLT, 165, 214-218
xslt task, 11, 206, 214-218

Z[ Top ]
zip task, 92-94
      description, 11
      jlink task and, 12
      .war files and, 185
      zipfileset element and, 201
zipfile attribute
      gzip/bzip2 tasks, 92
      zip task, 93
zipfileset element
      attributes, 93
      ear task and, 202
      war task and, 186
      zip task and, 93
ZipFileSet type, 44
zipgroupfileset element, 94

	

Zurück zu Ant: The Definitive Guide


Themen

Buchreihen

Special Interest

International Sites

O'Reilly China O'Reilly France O'Reilly USA O'Reilly Japan O'Reilly Taiwan