Ant The Definitive Guide phần 9 docx

Ant: The Definitive Guide 253 exitprompt (1.4, String, N,) Controls when the console prompt displays "Press Enter to close this window." Legal values are always, never, and error. Defaults to never. finalsnapshot (1.4, String, N) Configures the type of snapshot to take when the program ends. Legal values are none, coverage, and all. Defaults to coverage. home (1.4, File, Y) The directory in which JProbe is installed. inputfile (1.4, File, N) A JProbe Coverage parameter file. If specified, all other attributes are ignored. javaexe (1.4, File, N) The path to the java executable. Only used when vm="java2". recordfromstart (1.4, Enum, N) Configures the analysis performed when the program starts. Legal values are none, coverage, and all. Defaults to coverage. seedname (1.4, String, N) The base name for temporary snapshot files. If this attribute is foo, files are named foo.jpc, foo1.jpc, foo2.jpc, etc. Defaults to snapshot. snapshotdir (1.4, File, N) The destination directory for snapshots. Defaults to the project base directory. tracknatives (1.4, boolean, N) If true, the task tracks native methods. Defaults to false. vm (1.4, Enum, N) Specifies the JVM for the task to run. Legal values are jdk117, jdk118, and java2. warnlevel (1.4, int, N) Specifies the warning level, ranging from 0 3. Defaults to 0, which yields the least amount of warnings. Ant: The Definitive Guide 254 workingdir (1.4, File, N) The working directory for the JVM. Content 0 n nested <arg> elements (1.4) The command-line application arguments as described in Chapter 4. 0,1 nested <classpath> elements (1.4) The path element specifying the classpath. 0 n nested <jvmarg> elements (1.4) The command-line JVM arguments as described in Chapter 4. 0,1 nested <filters> elements (1.4) Defines JProbe filters for classes and methods. For example: <filters> <include class="com.oreilly.*" method="*"/> <exclude class="com.oreilly.test.*" method="*"/> </filters> This supports one attribute: defaultexclude (1.4, boolean, N) If true, exclude all classes and methods. Defaults to true. <filters> supports the following nested elements: 0 n nested <include> elements (1.4) Defines which classes and methods are included. The following attributes are supported: class (1.4, String, N) A regular expression specifying which classes to include or exclude. enabled (1.4, boolean, N) If true, this element is enabled. Defaults to true. Ant: The Definitive Guide 255 method (1.4, String, N) A regular expression specifying which methods to include or exclude. 0 n nested <exclude> elements (1.4) Defines which classes and methods are excluded. The following attributes are supported: class (1.4, String, N) A regular expression specifying which classes to include or exclude. enabled (1.4, boolean, N) If true, this element is enabled. Defaults to true. method (1.4, String, N) A regular expression specifying which methods to include or exclude. 0,1 nested <socket> elements (1.4) Defines the host and port number for remote viewing. Attributes are as follows: host (1.4, String, N) The host to connect to. Defaults to localhost. port (1.4, int, N) The port number. Defaults to 4444. 0,1 nested <triggers> elements (1.4) Defines JProbe triggers, which are actions to take when certain events occur. The following nested elements are supported: 0 n nested <method> elements (1.4) Each defines a new trigger. The following attributes are supported: action (1.4, String, Y) The action to perform. Must be one of clear, exit, pause, resume, snapshot, or suspend. Ant: The Definitive Guide 256 event (1.4, String, Y) The event that triggers the action. Must be either enter or exit. name (1.4, String, Y) The name of the method(s) as a simple regular expression. An example would be com.oreilly.util.DateUtil.getCurrentTime. param (1.4, String, N) The optional parameter appended to the end of the -jp_trigger flag. jpcovmerge 1.4 org.apache.tools.ant.taskdefs.optional.sitraka.CovMerge Merges several JProbe Coverage snapshots into one. Attributes home (1.4, File, Y) The directory in which JProbe is installed. tofile (1.4, File, Y) The output filename. verbose (1.4, boolean, N) If true, operate in verbose mode. Defaults to false. Content 1 n nested <fileset> elements (1.4) fileset elements defining the list of snapshots to merge. jpcovreport 1.4 org.apache.tools.ant.taskdefs.optional.sitraka.CovReport Generates a printable report of a JProbe Coverage snapshot. Ant: The Definitive Guide 257 Attributes filters (1.4, String, N) A comma-delimited list of filters, each formatted like <package>.class:?, in which ? can be I for Include, or E for Exclude. format (1.4, Enum, N) The format of the report. Legal values are xml, html, or text. Defaults to html. home (1.4, File, Y) The directory in which JProbe is installed. includesource (1.4, boolean, N) If true, include source code in the report. Only applies when format="xml" and type="verydetailed". Defaults to true. percent (1.4, int, N) The threshold for printing methods, ranging from 0 100. Defaults to 100. snapshot (1.4, File, Y) The name of the snapshot to report on. tofile (1.4, File, Y) The name of the report to generate. type (1.4, Enum, N) The type of report to generate. Legal values are executive, summary, detailed, and verydetailed. Defaults to detailed. Content 0 n nested <sourcepath> elements (1.4) The Path elements specifying where source files are found. 0,1 nested <reference> elements (1.4) Applicable only when format="xml". Specifies additional classes to check for coverage information. <reference> elements can contain the following content: Ant: The Definitive Guide 258 0,1 nested <classpath> elements (1.4) The Path element defining where to find classes. 0,1 nested <filters> elements (1.4) The syntax of <filters> is defined under the jpcoverage task. junit all org.apache.tools.ant.taskdefs.optional.junit.JUnitTask Executes unit tests using the JUnit testing framework. This task requires JUnit 3.0 or later, available at http://www.junit.org/. Attributes dir (all, File, N) The working directory for the JVM. Used only when fork=true. errorproperty (1.4, String, N) A property to set when a test error occurs. failureproperty (1.4, String, N) A property to set when a test failure occurs. fork (all, boolean, N) If true, fork a new JVM for the tests. Defaults to false. haltonerror (all, boolean, N) If true, stop the build if a test error occurs. Defaults to false. haltonfailure (all, boolean, N) If true, stop the build if a test failure occurs. Defaults to false. jvm (all, String, N) The command used to invoke the JVM. Defaults to java. Used only when fork=true. maxmemory (all, String, N) The maximum amount of memory used when fork=true. Ant: The Definitive Guide 259 printsummary (all, Enum, N) Configures how statistics are printed for each test case. Legal values are on, off, and withOutAndErr. withOutAndErr is the same as on, except the test output is also written to both standard output and standard error. Defaults to off. timeout (all, int, N) The maximum number of milliseconds to wait for an individual test before timing out. Used only when fork=true. Content 0 n nested <batchtest> elements (all) Defines a collection of tests based on naming conventions. The following attributes are supported: errorproperty (1.4, String, N) Overrides the errorproperty attribute specified in junit. Defaults to false. failureproperty (1.4, String, N) Overrides the failureproperty attribute specified in junit. fork (all, boolean, N) Overrides the fork attribute specified in junit. Defaults to false. haltonerror (all, boolean, N) Overrides the haltonerror attribute specified in junit. Defaults to false. haltonfailure (all, boolean, N) Overrides the haltonfailure attribute specified in junit. Defaults to false. if (all, String, N) Specifies a property. Tests are only run if the specified property is set. todir (1.3, 1.4, String, N) The destination directory for reports. unless (all, String, N) Specifies a property. Tests are run unless the specified property is set. Ant: The Definitive Guide 260 0,1 nested <classpath> elements (all) The path element used when running tests. 0 n nested <formatter> elements (all) Configures how test results are written out. The following attributes are supported: type (all, Enum, *) Specifies which predefined formatter to use. Legal values are xml, plain, and brief. classname (all, String, *) A custom formatter class. extension (all, String, *) The output filename extension. Works in conjunction with the outfile attribute of <test>. usefile (all, boolean, N) If true, the task sends output to a file. The filename is determined by the test name, or is specified by the outfile attribute of the <test> element. Defaults to true. Exactly one of type or classname must be specified. extension is required if classname is specified. 0 n nested <jvmarg> elements (all) The command-line arguments as described in Chapter 4. Only valid when fork=true. 0 n nested <sysproperty> elements (1.3, 1.4) The environment variables as described in Chapter 4. 0 n nested <test> elements. (all) Each defines a single test. The following attributes are supported: errorproperty (1.4, String, N) Overrides the errorproperty attribute specified in junit. Defaults to false. failureproperty (1.4, String, N) Overrides the failureproperty attribute specified in junit. Ant: The Definitive Guide 261 fork (all, boolean, N) Overrides the fork attribute specified in junit. Defaults to false. haltonerror (all, boolean, N) Overrides the haltonerror attribute specified in junit. Defaults to false. haltonfailure (all, boolean, N) Overrides the haltonfailure attribute specified in junit. Defaults to false. if (all, String, N) Specifies a property. Tests are run only if the specified property is set. name (all, String, Y) The name of the test class. outfile (all, String, N) The base name for test result. The extension specified by <formatter> is appended to this. Defaults to TEST-, followed by the value of the name attribute. todir (1.3, 1.4, File, N) The destination directory for reports. unless (all, String, N) Specifies a property. Tests are run unless the specified property is set. junitreport 1.3, 1.4 org.apache.tools.ant.taskdefs.optional.junit.XMLResultAggregator Creates a formatted report based on several XML files from the junit task. This task applies an XSLT stylesheet. Apache's Xalan XSLT Processor (http://xml.apache.org/) is required. 5 Attributes todir (1.3, 1.4, File, N) The destination directory for the XML file. 5 Xalan 1.2.2 is supported, but Xalan 2.x is recommended. Ant: The Definitive Guide 262 tofile (1.3, 1.4, String, N) The destination XML filename. Individual XML files from the junit task are aggregated into this file. Defaults to TESTS-TestSuites.xml. Content 0 n nested <fileset> elements (1.3, 1.4) fileset elements selecting XML reports to merge together into the file specified by tofile. These are the output files from the junit task. 0 n nested <report> elements (1.3, 1.4) Each specifies how an XSLT transformation is performed in order to generate a formatted report. The following attributes are supported: todir (1.3, 1.4, File, N) The destination directory for transformation results. Defaults to the current directory. styledir (1.3, 1.4, File, N) The directory containing junit-frames.xsl and junit-noframes.xsl. If unspecified, the task loads the files from the Ant optional tasks JAR file. format (1.3, 1.4, Enum, N) Selects which of the stylesheets to use. Legal values are frames or noframes. Defaults to frames. maudit 1.4 org.apache.tools.ant.taskdefs.optional.metamata.MAudit Executes the WebGain Quality Analyzer to analyze Java source code for programming errors. This task is based on Metamata Audit, which was purchased by WebGain in October 2000. On January 3, 2002, WebGain Quality Analyzer was integrated into WebGain Studio, and is no longer offered as a standalone product. For more information, refer to http://www.webgain.com/. Attributes fix (1.4, boolean, N) If true, automatically fix certain types of errors. Defaults to false. [...]... N) The maximum memory available to the JVM metamatahome (1.4, File, Y) The directory containing the WebGain Quality Analyzer distribution tofile (1.4, File, Y) The destination XML file for the metrics report Content 0,1 nested elements (1.4) The path element specifying the classpath 0 n nested elements (1.4) The fileset elements specifying source files to analyze 265 Ant: The Definitive. .. 1.4, String, N) Specifies the p4 -c option Defaults to the value of the p4.client property, if set description (1.3, 1.4, String, N) The comment for the changelist Defaults to AutoSubmit By Ant port (1.3, 1.4, String, N) Specifies the p4 -p option Defaults to the value of the p4.port property, if set user (1.3, 1.4, String, N) Specifies the p4 -u option Defaults to the value of the p4.user property, if... attribute, the task prints the value of the counter to standard output port (1.3, 1.4, String, N) Specifies the p4 -p option Defaults to the value of the p4.port property, if set property (1.4, String, *) The property to set with the retrieved counter value user (1.3, 1.4, String, N) Specifies the p4 -u option Defaults to the value of the p4.user property, if set value (1.4, int, *) When specified, set the. .. (1.3, 1.4, String, N) Specifies the p4 -p option Defaults to the value of the p4.port property, if set user (1.3, 1.4, String, N) Specifies the p4 -u option Defaults to the value of the p4.user property, if set 277 Ant: The Definitive Guide view (1.3, 1.4, String, N) The client, branch, or label view this command operates on Content None p4sync 1.3, 1.4 org.apache.tools .ant. taskdefs.optional.perforce.P4Sync... org.apache.tools .ant. taskdefs.optional.perforce.P4Have Lists Perforce files in the current client view Attributes client (1.3, 1.4, String, N) Specifies the p4 -c option Defaults to the value of the p4.client property, if set port (1.3, 1.4, String, N) Specifies the p4 -p option Defaults to the value of the p4.port property, if set user (1.3, 1.4, String, N) Specifies the p4 -u option Defaults to the value of the. .. command operates on Content None 275 Ant: The Definitive Guide p4reopen 1.4 org.apache.tools .ant. taskdefs.optional.perforce.P4Reopen Moves files between Perforce changelists Attributes client (1.3, 1.4, String, N) Specifies the p4 -c option Defaults to the value of the p4.client property, if set port (1.3, 1.4, String, N) Specifies the p4 -p option Defaults to the value of the p4.port property, if set tochange... The Definitive Guide client (1.3, 1.4, String, N) Specifies the p4 -c option Defaults to the value of the p4.client property, if set port (1.3, 1.4, String, N) Specifies the p4 -p option Defaults to the value of the p4.port property, if set revertonlyunchanged (1.4, boolean, N) If true, revert only unchanged files Defaults to false user (1.3, 1.4, String, N) Specifies the p4 -u option Defaults to the. .. String, N) The client, branch, or label view this command operates on Content None p4counter 1.4 org.apache.tools .ant. taskdefs.optional.perforce.P4Counter Gets and sets a Perforce counter value 272 Ant: The Definitive Guide Attributes client (1.3, 1.4, String, N) Specifies the p4 -c option Defaults to the value of the p4.client property, if set name (1.4, String, Y) The counter name If this is the only... Specifies the p4 -p option Defaults to the value of the p4.port property, if set user (1.3, 1.4, String, N) Specifies the p4 -u option Defaults to the value of the p4.user property, if set view (1.3, 1.4, String, N) The client, branch, or label view this command operates on Content None 6 A Boolean attribute makes more sense in this case Ant optional tasks are not as consistent as the core tasks 278 Ant: The. .. http://java.sun.com/products/java-media/sound/ Attributes None 283 Ant: The Definitive Guide Content 0,1 nested elements (1.3, 1.4) Defines the sound to play when the build fails 0,1 nested elements (1.3, 1.4) Defines the sound to play when the build succeeds Both nested elements are implemented by the same class, supporting the following attributes: source (1.3, 1.4, File, Y) The name of a sound file to play If . or suspend. Ant: The Definitive Guide 256 event (1.4, String, Y) The event that triggers the action. Must be either enter or exit. name (1.4, String, Y) The name of the method(s) as. as the binary rather than NetRexx types. Defaults to false. Ant: The Definitive Guide 2 69 classpath (all, String, N) The classpath used for compilation. comments (all, boolean, N) The. The command used to invoke the JVM. Defaults to java. Used only when fork=true. maxmemory (all, String, N) The maximum amount of memory used when fork=true. Ant: The Definitive Guide 259