Apache Ant Tasks 简明教程

Apache Ant Tasks - Move

Description

Move 任务将文件移动到新文件或目录中,或将文件集合移动到新目录中。默认情况下,如果目标文件已存在,则会覆盖该文件。当 overwrite 关闭时,只有源文件比目标文件更新时或当目标文件不存在时,才会移动文件。

Properties

Sr.No

Attributes & Description

1

File 要移动的文件或目录。

2

Preservelastmodified 将移动的文件其最后修改时间与原始源文件相同。

3

Tofile 要移动到的文件。

4

Todir 要移动到的目录。

5

Overwrite 即使目标文件较新,也覆盖现有文件。

6

Force Overwrite read-only destination files.

7

Filtering 指示移动过程中是否应执行令牌筛选。

8

Flatten 忽略源目录的目录结构,将所有文件复制到单个目录中,该目录由 todir 属性指定。

9

IncludeEmptyDirs 复制嵌套 FileSet 包含的空目录。

10

Failonerror 如果为 false,则在以下情况下记录一条警告消息,但不要停止构建:要复制的文件不存在,或者嵌套文件集之一指向不存在的目录,或者移动时出现错误。

11

Quiet 如果为 true 且 failonerror 为 false,则以下情况下不要记录警告消息:要复制的文件不存在,或者嵌套文件集之一指向不存在的目录,或者复制时出现错误。

12

Verbose 记录正在移动的文件。

13

Encoding 在过滤复制文件时假定的编码。

14

Outputencoding 写文件时使用的编码。

15

Enablemultiplemappings 如果为 true,则任务将处理给定源路径的所有映射。如果为 false,则任务仅处理第一个文件或目录。此属性仅当存在 mapper 子元素时才相关。

16

Granularity 在判定文件过时之前留有的毫秒数。这有必要,因为并非所有文件系统都支持毫秒级地跟踪最后修改时间。如果源文件和目标文件位于时钟不同步的不同机器上,这可能也有用。

17

performGCOnFailedDelete 如果 Ant 无法删除文件或目录,它将重试一次该操作。如果将此标志设置为 true,它将在重试删除之前执行一次垃圾收集。已知将此标志设置为 true 可以解决 Windows(在此系统上默认为 true)上的一些问题,但对于驻留在 NFS 共享上的目录树也可以解决这些问题。

Example

Usage

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

<?xml version="1.0"?>
<project name="TutorialPoint" default="info">
   <target name="info">
      <move file="message.txt" tofile="message.txt.moved"/>
   </target>
</project>

Output

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

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

info:
   [move] Moving 1 file to F:\tutorialspoint\ant

BUILD SUCCESSFUL
Total time: 0 seconds