FTP

描述

ftp 任务实现了一个基本的 FTP 客户端，可以发送、接收、列出、删除文件以及创建目录。请参见以下内容，了解如何执行每个任务的描述和示例。

注意：此任务依赖于 Apache Ant 分发版中未包含的外部库。有关更多信息，请参见 库依赖项。获取此库的最新版本，以获得 Ant 中的最佳支持。

ftp 任务尝试确定 FTP 服务器上存在的文件系统。支持的服务器类型包括 Unix、NT、OS2、VMS 和 OS400。此外，已配置为以 Unix 样式显示目录的 NT 和 OS400 服务器也得到正确支持。否则，系统将默认使用 Unix 标准。remotedir 必须以 FTP 服务器所需的精确语法指定。如果服务器不支持通常的 Unix 约定，则可以使用 separator 来设置应使用的文件分隔符。

有关如何包含/排除文件以及如何编写模式的信息，请参见有关 基于目录的任务 的部分。

此任务当前不使用由 <setproxy> 任务设置的代理信息，并且无法通过 socks 穿越防火墙。

警告：据报道，ftp 的 get 操作与 newer 属性存在问题。问题可能是由于 ls -l 的格式与 commons-net 预期格式不同，例如，由于 FTP 服务器在目录列表中使用的语言的具体情况。如果您遇到此类问题，请发送一封电子邮件，其中包含来自 FTP 服务器的示例目录列表（在 FTP 提示符下使用 ls -l）。

如果您能够连接但无法上传或下载，请尝试将 passive 属性设置为 true，以使用现有（打开）通道，而不是让服务器尝试建立新的连接。

参数

关于 remotedir 属性的说明

作为嵌套元素指定的参数

fileset

ftp 任务支持任意数量的嵌套 <fileset> 元素，以指定要检索、删除、列出或更改其模式的文件。

fileset 的属性 followsymlinks 在本地 (put) 和远程 (get、chmod、delete、list) 文件集中都受支持。在 Ant 1.6 之前，远程文件集不支持符号链接。为了排除符号链接（保留 Ant 1.5.x 及更早版本的行为），您需要显式地将 followsymlinks 设置为 false。在远程文件集中，不会检查隐藏文件是否为符号链接。目前假设隐藏文件不是符号链接。

发送文件

描述如何发送文件的最佳方法是使用几个示例。

以 anonymous 用户身份登录 ftp.apache.org，并将 htdocs/manual 目录中的所有文件上传到该用户的默认目录。

<ftp server="ftp.apache.org"
     userid="anonymous"
     password="[email protected]">
    <fileset dir="htdocs/manual"/>
</ftp>

以 anonymous 用户身份登录 ftp.apache.org，并将 htdocs/manual 目录中所有新文件或已更改文件上传到相对于 anonymous 用户默认目录的 incoming 目录。

<ftp server="ftp.apache.org"
     remotedir="incoming"
     userid="anonymous"
     password="[email protected]"
     depends="yes">
    <fileset dir="htdocs/manual"/>
</ftp>

以 coder 用户身份登录 ftp.apache.org，端口为 2121，密码为 java1，并将 htdocs/manual 目录中所有新文件或已更改的 HTML 文件上传到 /pub/incoming 目录。文件以文本模式传输。已启用被动模式以从防火墙后发送文件。

<ftp server="ftp.apache.org"
     port="2121"
     remotedir="/pub/incoming"
     userid="coder"
     password="java1"
     passive="yes"
     depends="yes"
     binary="no">
    <fileset dir="htdocs/manual">
        <include name="**/*.html"/>
    </fileset>
</ftp>

以 coder 用户身份登录位于 ftp.hypothetical.india.org 的 Windows 服务器，端口为 2121，密码为 java1，并将 htdocs/manual 目录中所有新文件或已更改的（考虑时区差异）HTML 文件上传到 /pub/incoming 目录。文件以文本模式传输。

<ftp server="ftp.hypothetical.india.org"
     port="2121"
     remotedir="/pub/incoming"
     userid="coder"
     password="java1"
     depends="yes"
     binary="no"
     systemTypeKey="Windows"
     serverTimeZoneConfig="India/Calcutta">
    <fileset dir="htdocs/manual">
        <include name="**/*.html"/>
    </fileset>
</ftp>

以 coder 用户身份登录基于 Windows 的 ftp.nt.org，密码为 java1，并将 htdocs/manual 目录中所有 HTML 文件上传到 c:\uploads 目录。上传每个文件时都会显示进度消息。

<ftp server="ftp.nt.org"
     remotedir="c:\uploads"
     userid="coder"
     password="java1"
     separator="\"
     verbose="yes">
    <fileset dir="htdocs/manual">
        <include name="**/*.html"/>
    </fileset>
</ftp>

获取文件

从 FTP 服务器获取文件的工作方式与发送文件非常相似。唯一的区别是嵌套的文件集使用 remotedir 属性作为 FTP 服务器上文件的基目录，使用 dir 属性作为放置文件的本地目录。FTP 站点上的文件结构将保留在本地机器上。

以 anonymous 用户身份登录 ftp.apache.org，并递归地将该用户默认目录中的所有 .html 文件下载到本地机器上的 htdocs/manual 目录。

<ftp action="get"
     server="ftp.apache.org"
     userid="anonymous"
     password="[email protected]">
    <fileset dir="htdocs/manual">
        <include name="**/*.html"/>
    </fileset>
</ftp>

如果 apache.org 曾经切换到使用新的全数字格式的时间戳的 Unix FTP 服务器，则此版本将变得必要。它将完成与前一个示例相同的功能，但能够成功处理数字时间戳。这里不需要 systemTypeKey，但它有助于澄清正在发生的事情。

<ftp action="get"
     server="ftp.apache.org"
     userid="anonymous"
     password="[email protected]"
     systemTypeKey="UNIX"
     defaultDateFormatConfig="yyyy-MM-dd HH:mm">
    <fileset dir="htdocs/manual">
        <include name="**/*.html"/>
    </fileset>
</ftp>

以 anonymous 用户身份登录位于 ftp.hypothetical.fr 的 UNIX FTP 服务器，该服务器以标准欧洲格式使用法语名称显示日期，并递归地将该用户默认目录中的所有 .html 文件下载到本地机器上的 htdocs/manual 目录。

<ftp action="get"
     server="ftp.hypthetical.fr"
     userid="anonymous"
     password="[email protected]"
     defaultDateFormatConfig="d MMM yyyy"
     recentDateFormatConfig="d MMM HH:mm"
     serverLanguageCodeConfig="fr">
    <fileset dir="htdocs/manual">
        <include name="**/*.html"/>
    </fileset>
</ftp>

删除文件

您可能已经猜到，您可以使用嵌套的文件集元素来选择要从远程 FTP 服务器中删除的文件。同样，文件集相对于远程目录，而不是本地目录。实际上，文件集的 dir 属性将完全被忽略。

以 anonymous 用户身份登录 ftp.apache.org，并尝试从该用户的默认目录中删除所有 *.tmp 文件。如果您没有删除文件的权限，则会抛出 BuildException。

<ftp action="del"
     server="ftp.apache.org"
     userid="anonymous"
     password="[email protected]">
    <fileset>
        <include name="**/*.tmp"/>
    </fileset>
</ftp>

列出文件

在 data/ftp.listing 中获取 FTP 服务器上相对于 anonymous 用户默认目录的所有文件的列表。列表以 FTP 服务器通常列出文件的任何格式显示。

<ftp action="list"
     server="ftp.apache.org"
     userid="anonymous"
     password="[email protected]"
     listing="data/ftp.listing">
    <fileset>
        <include name="**"/>
    </fileset>
</ftp>

创建目录

请注意，使用 mkdir 操作时，要创建的目录是使用 remotedir 属性指定的。

在默认根目录下创建目录 some/remote/dir。与所有其他操作一样，目录分隔符字符必须根据 FTP 服务器的要求正确设置。

<ftp action="mkdir"
     server="ftp.apache.org"
     userid="anonymous"
     password="[email protected]"
     remotedir="some/remote/dir"/>

删除目录

此操作使用嵌套的文件集元素来选择要从远程 FTP 服务器中删除的目录。文件集相对于远程目录，而不是本地目录。文件集的 dir 属性将完全被忽略。要删除的目录必须为空，或者仅包含其他也已通过文件集模式选择要删除的目录，否则将抛出 BuildException。此外，如果您没有删除目录的权限，则会抛出 BuildException。

以 anonymous 用户身份登录 ftp.apache.org，并尝试删除 /somedir/dira 目录和从 /somedir/dirb 开始并包括该目录的所有目录树。删除 /somedir/dirb 树时，任务从叶子开始向上移动到根，因此当它尝试删除目录时，它可以确保该目录下的所有目录都已删除。显然，树中的所有文件都必须已删除。

<ftp action="rmdir"
     server="ftp.apache.org"
     userid="anonymous"
     password="[email protected]"
     remotedir="/somedir" >
    <fileset>
        <include name="dira"/>
        <include name="dirb/**"/>
    </fileset>
</ftp>

例如，假设您要删除 /somedir 中的所有内容，因此首先使用 action=delete 调用 <ftp> 任务，然后使用 action=rmdir 调用该任务，在两种情况下都指定 remotedir=/somedir，并且

<fileset>
    <include name="**"/>
</fileset>

remotedir 参数中指定的目录永远不会被选中以进行删除，因此如果您需要删除它，请在 remotedir 参数中指定其父目录，并在 <fileset> 模式中包含它，例如 somedir/**。