用JakartaCommon的net组件来做ftp下载

本文分享了使用 Jakarta Commons Net 中的 FTPClient 实现文件上传下载过程中的经验总结,包括解决文件名中文乱码、传输二进制文件、被动模式传输、断点续传等问题的方法。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

这几天一个同事要在项目里实现用ftp下载文件. 遇到了很多问题. 于是我推荐他用Jakarta-Commons项目中的net组件在实现. 其实之前我也没有实际用过, 稍稍看了一下文档,知道里面有个ftp包能完成相关的操作. 于是我的同事就兴致勃勃的拿去用了. 可用了以后才发现有很多问题, 搞得焦头烂额. 经过我们的努力, 终于把问题都解决了, 下面我把遇到的问题和解决方案写下来, 以备其他想要用common-net包的朋友参考.

首先把代码贴出来:

java 代码

  1. public class ClientTest {
  2. public static void main(String[] args) {
  3. String url = "172.17.1.38";
  4. String user = "test";
  5. String pwd = "test";
  6. FTPClient ftp = new FTPClient();
  7. ftp.setControlEncoding("GBK");
  8. FTPClientConfig conf = new FTPClientConfig(FTPClientConfig.SYST_NT);
  9. conf.setServerLanguageCode("zh");
  10. ftp.configure(conf);
  11. try {
  12. ftp.connect(url);
  13. if (ftp.login(user, pwd)) {
  14. int reply = ftp.getReplyCode();
  15. if (!FTPReply.isPositiveCompletion(reply)) {
  16. ftp.disconnect();
  17. System.out.println("disconnect");
  18. } else {
  19. ftp.enterLocalPassiveMode();
  20. ftp.setFileType(FTP.BINARY_FILE_TYPE);
  21. File dir = new File("down");
  22. if (!dir.exists()) {
  23. dir.mkdirs();
  24. }
  25. String[] names = ftp.listNames();
  26. for (String name : names) {
  27. File file = new File(dir.getPath() + File.separator + name);
  28. if (!file.exists()) {
  29. file.createNewFile();
  30. }
  31. long pos = file.length();
  32. RandomAccessFile raf = new RandomAccessFile(file, "rw");
  33. raf.seek(pos);
  34. ftp.setRestartOffset(pos);
  35. InputStream is = ftp.retrieveFileStream(name);
  36. if (is == null) {
  37. System.out.println("no such file:" + name);
  38. } else {
  39. System.out.println("start getting file:" + name);
  40. int b;
  41. while ((b = is.read()) != -1) {
  42. raf.write(b);
  43. }
  44. if (ftp.getReply() == FTPReply.CODE_226) {
  45. System.out.println("done!");
  46. }
  47. is.close();
  48. }
  49. raf.close();
  50. }
  51. }
  52. ftp.logout();
  53. }
  54. } catch (IOException e) {
  55. e.printStackTrace();
  56. }
  57. }
  58. }


一, 文件名中文乱码问题.
开始知道能用FTPClient的listNames方法得到当前目录下所有文件的列表. 但是发现中文文件名是乱码. 默认情况下FTPClient使用UTF-8字符集作为和服务器通讯的编码集. 而我们的ftp服务器是在中文windowsXP上装的ServU. 所有使用GBK做为通讯编码集. 经过查找api文档, 我看到了setControlEncoding方法, 试了一下,果然好使. 于是这个问题就解决了:
第8行: ftp.setControlEncoding("GBK")
至于conf.setServerLanguageCode("zh")对这个有什么影响,我还没有验证. 但是只有这句是不行的.

二, 传输binary文件, 由于FTPClient默认使用ASCII作为传输模式, 所有不能传输二进制文件. 通过
ftp.setFileType(FTP.BINARY_FILE_TYPE)个可以解决这个问题, 但是要在login以后执行. 因为这个方法要向服务器发送"TYPE I"命令.
开始的时候用的是setFileTransferMode, 不过不好使. 它会执行 MODE I命令, 服务器不接受.

三, 用被动模式传输: enterLocalPassiveMode()这个到不用在login之后执行, 因为它只改变FTPClient实例的内部属性.

四, 断点续传. 心想应该有支持吧, 于是查API结果找到了setRestartOffset()方法, 试了一下,果真好使. 用RandomAccessFile配合使用, 实现起来还是蛮简单的.

五, 只能传一个文件!!
不知道大家有没有遇到这个问题, 传输第一个文件好使, 后面的的retrieveFileStream(name)都是返回null. 这个实在是令人头痛的问题, 难不成要传一个文件重新建立一次连接? 那样也太土了吧. 但是文档里也没有写, 来点狠的,debug它的源码, 看看它究竟做了什么事情. 首先看一下ftp服务器的日志, 发现日志没问题, 过来的命令和reply都是正确的, 但是发现第一个文件以后没有执行RETR命令. 于是跟踪PASV命令的reply代码,发现不是227,而服务器上的日志明明返回的是227. 难道是FTPClient解析Reply出问题了. 进一步跟踪发现了问题, 原来在一个文件传输过程中会产生两个Reply:
150 Opening BINARY mode data connection for a.sql (19890 Bytes).
226 Transfer complete.
而FTPClient自动消费掉一个,于是解析Reply就发生了错位, 下一个命令的会解析266那条. 接下来的命令都不是解析自己的Reply而是前一次命令的. 所有在PASV命令的Reply码就不对了, FTPClient也就不会执行接下来本应该执行RETR命令.
他不消费,我们来消费吧. 于是在文件传输完成以后, 主动调用一次getReply()把接下来的226消费掉. 这样做是可以解决这个暂时的问题, 但不知道在其他的ftp操作上会不会也有类似的情况. FTPClient这点可做的不大好.

对于上面这个问题, 我本来想修改一下FTPClient这个类来彻底解决问题. 结果发现自己也想不出好办法. 最后还是放弃了.

今天才发现,原来FTPClient有个completePendingCommand()方法就是用来干这件事情的!
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值