Apache Ant Tasks 简明教程

Apache Ant Tasks - Java

Description

Java 任务在运行的 JVM 内执行一个 Java 类,或如果使用 fork=true 指明,则分叉到另一个 JVM;

Properties

Sr.No

Attributes & Description

1

Classname 要执行的 Java 类。

2

Jar 要执行的 jar 文件的位置。如果选定此选项,则 fork 必须设置为 true。

3

Module 要解析的初始化或主模块(必须在清单中有一个 Main-Class 条目)。如果选定此选项,则 fork 必须设置为 true。

4

Sourcefile 具有 Java 源代码的“.java”文件或包含 shebang 的文件的位置。将此属性设为运行 Java 单文件源程序,这是 Java 11 中引入的一项功能。如果选定此选项,则 fork 必须设置为 true。

5

Classpath The classpath to use.

6

Classpathref 要使用的类路径,表示为对在其他位置定义的 Path 的引用。

7

Modulepath 指定从哪里查找应用程序模块。模块、模块文件或展开的模块的目录列表。

8

modulepathref 要使用的模块路径,表示为对在其他位置定义的路径的引用。

9

Fork 如果启用,将触发在另一个 JVM 中执行类。

10

Spawn 如果启用,则允许启动一个会比 Ant 存活时间更长的进程。要求 fork 为 true,且与 timeout、input、output、error、result 属性不兼容

11

Sourcefile 具有 Java 源代码的“.java”文件或包含 shebang 的文件的位置。将此属性设为运行 Java 单文件源程序,这是 Java 11 中引入的一项功能。如果选定此选项,则 fork 必须设置为 true。

12

jvm 用于调用 JVM 的命令。此命令由 java.lang.Runtime.exec() 解析。如果 fork 为 false,则忽略此命令。

13

Maxmemory 要分配给分叉的 JVM 的最大内存量,如果 fork 为 false,则忽略。

14

Failonerror 如果命令使用非 0 返回码退出,则停止构建进程。

15

resultproperty 在该命令的返回码应存储在其中的属性的名称。仅当 failonerror 为 false 且 fork 为 true 时才有意义。

16

DIR 调用 JVM 所在的目录,如果 fork 为 false,则忽略。

17

Output 要将输出写入的文件的名称。如果错误流也未重定向到文件或属性,它将显示在此输出中。

18

Error 命令的标准错误应重定向到的文件。

19

logerror 当你想要在 Ant 的日志中查看错误输出并正在将输出重定向到文件/属性时,使用此属性。错误输出将不包含在输出文件/属性中。如果你通过 error 或 errorProperty 属性重定向错误,则此项将不起作用。

20

Append 输出和错误文件应追加还是覆盖。

21

Outputproperty 应在其中存储命令的输出的属性的名称。除非错误流重定向到了一个单独的文件或流中,否则此属性将包含错误输出。

22

Errorproperty 应在其中存储命令的标准错误输出的属性的名称。

23

Input 从其中获取被执行命令的标准输入的文件。此属性与 input 字符串属性互斥。

24

Inputstring 充当被执行命令的输入流的字符串。此属性与 input 属性互斥。

25

Newenvironment 在指定了新的环境变量时不要传播旧环境。

26

Timeout 如果命令未在指定的时间内完成(以毫秒为单位),则停止该命令。强烈建议仅在 fork 为 true 的情况下使用此功能。

27

Clonevm 如果设置为 true,则所有系统属性和分支 JVM 的启动类路径都将与运行 Ant 的 JVM 相同。

28

Discardoutput 输出是否应被完全丢弃。此设置与任意将输出重定向到文件或属性的设置不兼容。如果你将其设置为 true,错误输出也将被丢弃,除非你将错误输出重定向到文件、属性或启用 logError。

29

Discarderror 错误输出是否应被完全丢弃。此设置与将错误输出重定向到文件或属性以及 logError 的任何设置不兼容。

Example

Usage

使用以下内容创建 TestMessage.java −

public class TestMessage {
   public static void main(String[] args) {
      System.out.println("Welcome to tutorialspoint.com");
   }
}

使用以下内容创建 build.xml −

<?xml version="1.0"?>
<project name="TutorialPoint" default="info">
   <target name="info">
      <java classname="TestMessage" classpath="."/>
   </target>
</project>

以上脚本将运行一个 java 类文件以打印输出。

Output

在上述构建文件上运行 Ant 会生成以下输出:

F:\tutorialspoint\ant>ant
Buildfile: F:\tutorialspoint\ant\build.xml

info:
   [java] Welcome to tutorialspoint.com

BUILD SUCCESSFUL
Total time: 0 seconds