commons-ftp中ftpClient类的API--.doc资源-CSDN文库

commons-ftp

ftpClient

需积分: 4 78 浏览量 2013-10-14 15:41:58 上传评论收藏 1.78MB DOC 举报

资源推荐

资源详情

资源评论

org.apache.commons.net.ftp

类 FTPClient

 



继承 

 

 

 org.apache.commons.net.ftp.FTPClient

所有已实现的接口：

可配置

直接已知子类：

， 

公共类 FTPClient

延伸的

 

实现了可配置

 封装了所有必要的功能来存储和检索从  服务器上的文件。这

个类负责所有与  服务器交互的底层细节，并提供了便捷的更高层次的接口。

正如来自所有类 ，您必须首先连接到与服务器 



做任何

事之前，最后 



完成后，你完全与服务器交互。然后，你需要检查

的  答复代码，看看是否连接成功。例如：

布尔错误

尝试!

诠释答复

（“"）

#$（“连接到”%服务器%&&'

#$（(#（））

))连接尝试后，你应该检查代码以验证答复

))成功。

答复(#（）

如果（！(#（回复））!

（）

#（“ 服务器拒绝连接。”）

#*（+）

,

))传送文件

$（）

,捕捉（-.* 异常五）!

误差为真

（）

最后,!

如果（（））!

尝试!

（）

,捕捉（-.* 异常雇主组织）!

))什么也不做

,

,

#*（错误 +：？）

,



连接后立即是唯一真正的时候你需要检查答复代码（因为是连接类型为

）。对于所有的  指挥方法的公约就是这样，他们要么返回

一个布尔值或其他值。该方法返回一个布尔从  服务器成功完成答辩，假假

真真的错误条件中的一个或故障而导致的答复。该方法返回一个布尔值返回值

比含有较高水平的  命令，或者为 $，如果产生一个错误条件答复或故障

导致其他数据。如果您要访问的  的确切答复代码导致成功或失败，你必须

调用 (#



后，成功或失败。

 的默认设置是它使用 /--0-1.02.，

330(-30.40(5/， (./50(/3.(056. 和

-1.0(77(.。唯一的文件直接支持的类型是

/--0-1.02. 和 8-3/(20-1.02.。因为至少有 9 种不同

的 .86- 编码，我们还选择了不提供直接支持的 .86-。为了转移

.86- 和其他不支持的文件类型，你必须创建自己的过滤 -$ 和

$$ 和总结他们周围的流退回或由  方法所需。 

 使用 3/--



过滤器流提供 /-- 文件透明处理。我们会考虑把

.86- 码的支持，如果有足够的需求。

330(-30.40(5/， (./50(/3.(056. 和

-1.0(77(. 是唯一支持的格式，传输模式和文件结构。

由于在不同平台上插座处理可以显着差异，在  自动发出一个新的端

口（或 .(）命令之前，每次传输要求的服务器连接到客户端的数据端口。

这将确保相同的 :;，7* 和 5 平台无故障的行为。此外，

它解除不必发出端口（或 .(）命令自己和与平台有关问题的程序员。

此外，为了安全起见，所有的数据连接到客户端进行验证，以确保他们打算从

党（主机和端口）起源。如果一个数据连接是由党发起的一个意外，该命令将

关闭套接字并抛出一个 -.* 异常。您可以禁用此行为

(<=.>'

你应该记住，在  服务器可以选择过早关闭连接，如果客户已超过给定的时

间较长时期（通常为 ? 秒）闲置。将检测的  类  服务器连接

过早关闭，当它收到 (#.(<-.030/</-1/81.



响应命令。一旦

这种情况发生时， 类方法遇到的答复将抛出一个

.*。 .* 是

一个子类 -.*，因此不必分别被捕获，但如果你要抓住它分开，它的

 块必须出现在更一般的 -.* 块。当你遇到一个

.*，必须断开与连接 >'妥善清理，

系统资源使用 。在断开，你可以检查代码和文本的最后答复与

(#， (#



和 (#。您可能会避免服

务器断开，而客户端闲置的空操作指令通过定期发送到服务器。

它不是单独列出每个方法，我们在这里提到的每个方法与服务器通信，并抛出

一个 -.* 异常也可引发 5(#.*，这是

一个 -.* 异常子类。将抛出一个

5(#.* 答复时，从服务器收到的偏离足够的协议

规范，它不能在一个有用的方式解释尽管试图尽可能宽松。

上市 /- 的两个例子的目录列表分页和无页数的范例，如下：

无页数（全名单）访问，使用分析器可经自动检测：

;（）

（服务器）

（用户名，密码）

@A文件=B套件（目录）



分页访问，使用分析器无法访问的自动检测。在应该从

.# 派生 1

第一个参数定义的类：

;（）

（服务器）

（用户名，密码）

1. 引擎

1（“;2$;"，目录）

而（3*（））!

@A文件3*（CD） ))E页面大小”你想要

))做你想做这些文件，显示它们，等

))昂贵  不创建对象，直到需要。

,



分页访问，使用分析器可经自动检测：

;（） 
（服务器） 
（用户名，密码） 
1.1（目录） 
而（3*（））!
@A文件3*（CD） ))E页面大小”你想要
))做你想做这些文件，显示它们，等
))昂贵  不创建对象，直到需要。
,

有关使用服务器上的目录清单  例子 
 使用英语以外的语言 
 使用日期格式“以外的美国英语”标准 55####
 在不同的时区，你需要在蚁群依赖检查准确的时间戳 
见 =。 
作者： 
丹尼尔楼 ，罗里温斯顿 
另见： 
， .*， .#
， .##， 
6$.##， =， 
5(#.*
 字段摘要 


ACTIVE_LOCAL_DATA_CONNECTION_MODE
一个常量指示期待的  会话之间发生的所有传输客户端（本地）和
服务器，该服务器应该连接到客户端的数据端口来启动数据传输。 


ACTIVE_REMOTE_DATA_CONNECTION_MODE
一个常量指示期待的  会话的所有转让发生在两个远程服务器，而
客户端连接到要连接到其他服务器的数据端口发起数据传输服务器。 


PASSIVE_LOCAL_DATA_CONNECTION_MODE
一个常量指示期待的  会话之间发生的所有传输客户端（本地）和
服务器，服务器在被动模式时，要求客户端连接到服务器的数据端口
来启动传输。 


PASSIVE_REMOTE_DATA_CONNECTION_MODE
一个常量指示期待的  会话的所有转让发生在两个远程服务器，而

客户端连接到处于被动模式，要求其他服务器连接到第一个服务器的
数据端口发起数据传输服务器。 
 org.apache.commons.net.ftp 类从继承的字段。 的   
    
FTP    
0$0F0.F0-$0F
0$$0F0;(#F0#F0#1F
0#F/--0-1.02.F8-3/(20-1.02.F
81G0(/3.(056.F/((-/H.03(10.40(5/F
5(..60(/3.(056.F6./7103(10.36-3HF
6./7106//0(F6./710(F.86-0-1.02.F
-1.0(77(.F1/10-1.02.F330(-30.40(5/F
/H.0(77(.F(.(60(77(.F
(./50(/3.(056.F5$F
.13.0.40(5/
 org.apache.commons.net 类从继承的字段。 SocketClient 
0$0F0$0F0$$0F0#0F
00F0#0F0$0F$F
3./--0.1
 构造方法摘要 
FTPClient>'
默认  构造。 
 方法摘要 
_connectAction_>'
启动控制连接，并得到初步答复。 
 _openDataConnection_>F
'
建立一个与  服务器的数据连接，如果返回的成功连
接的 。 
abort>'
中止正在进行的传输。 
allocate>#'
保留一字节的下一个文件传输服务器数量。 
allocate>#FI'
储备空间，为下一个文件传输服务器。 
appendFile>F-$'