Java操作FTP实现上传下载功能

目录

FTP简介FTP架构FTP数据连接模式用户认证客户端Vsftp安装与配置启动服务配置文件说明传输模式配置系统用户配置java操作ftp文件服务器

1.引入依赖2.提供接口3.对提供操作ftp接口进行实现4.配置ftp相关参数5.写测试controller

FTP简介

文件传输协议（File Transfer Protocol，FTP）是用于在网络上进行文件传输的一套标准协议，它工作在 OSI 模型的第七层，TCP 模型的第四层， 即应用层， 使用 TCP 传输而不是 UDP， 客户在和服务器建立连接前要经过一个“三次握手”的过程， 保证客户与服务器之间的连接是可靠的， 而且是面向连接， 为数据传输提供可靠保证。
FTP也是一个应用程序，基于不同的操作系统有不同的FTP应用程序，而所有这些应用程序都遵守同一种协议以传输文件。可以使用FTP进行下载和上传。
文件传送协议FTP(File Transfer Protocol)是Internet上使用比较广泛的文件传送协议。FTP提供交互式的访问，允许客户指明文件的类型与格式，并允许文件具有存取权限。FTP屏蔽了各种计算机系统的细节，因此适用于在异构网络中任意计算机间传送文件。它的基本应用就是将文件从一台计算机复制到另一台计算机中。它要存取一个文件，就必须先获得一个本地文件的副本，如果修改文件，也只能对文件的副本进行修改，然后再将修改后的文件副本传回到原节点。
您只要记住几个关键词：交互式、存取权限和副本。
简单文件传送协议TFTP(Trivial File Transfer Protocol)是一个小而易于实现的文件传送协议。TFTP是基于UDP数据报，需要有自己的差错改正措施。TFTP只支持文件传输，不支持交互，没有庞大的命令集。也没有目录列表功能，以及不能对用户进行身份鉴别。但它的代码所占内存较小，不需要硬盘就可以固化TFTP代码，很适合较小的计算机和特殊用途的设备。
您会发现TFTP和FTP一个主要的区别就是它没有交互式，且不进行身份验证。
FTP的客户可以是任意平台
FTP标准端口：

20 数据接口21 指令接口

FTP架构

FTP监听于TCP的21号端口，是一种C/S架构的应用程序。在Linux中常用的服务端软件和客户端软件一般如下表所示：

FTP数据连接模式

FTP有2种数据连接模式：命令连接和数据连接

命令连接：是指文件管理类命令，始终在线的持久性连接，直到用户退出登录为止（可以简单的理解为建立连接）数据连接：是指数据传输，按需创建及关闭的连接（可以简单的理解为传输数据）

数据连接需要关注的点有：
1.数据传输格式

文件传输二进制传输

2.数据传输模式

主动模式：由服务器端创建数据连接被动模式：由客户端创建数据连接

两种数据传输模式的建立过程：
1.主动模式
命令连接（建立连接通道）
Client端以一个1024以上的随机端口（端口号大于1023小于65535）来连接Server端的21号端口
数据连接（传输数据）
Server端以20号端口去连接Client创建命令连接时使用的随机端口+1的端口
示例：
命令连接：Client（9527）–> Server（21），数据连接：Server（20/tcp） --> Client（9527+1）

2.被动模式
命令连接
Client以一个1024以上的随机端口号（端口号大于1023小于65535）来连接Server端的21号端口，命令连接建立完毕后，Server端会告知Client端用于创建数据连接的随机端口号（端口号大于1023小于65535）
数据连接
Client以创建命令连接时使用的随机端口号+1去连服务器端通过命令连接告知自己的一个随机端口号来创建数据连接
示例：
命令连接：Client（9527） --> Server（21），数据连接：Client（9527+1） --> Server（随机端口）
注意：
主动模式存在弊端，因为客户端的端口是随机的，客户端如果开了防火墙，则服务器端去连客户端创建数据连接时可能会被拒绝

用户认证

Ftp的用户认证主要有三种：
1.虚拟用户：仅用于访问某特定服务中的资源
虚拟用户通过ftp访问的资源位置为给虚拟用户指定的映射成为的系统用户的家目录
2.系统用户：可以登录系统的真实用户（出于对安全性的考虑，这种认证很少使用）
系统用户通过ftp访问的资源位置为用户的家目录
3.匿名用户
匿名用户（映射为ftp用户）的共享资源位置是/var/ftp
服务端

/etc/pam.d/vsftpd #vsftpd用户认证配置文件/etc/vsftpd/ #配置文件目录/etc/vsftpd/vsftpd.conf #主配置文件vsftpd常见的配置参数

客户端

lftp工具 支持指定用户名和密码登录

Vsftp安装与配置

在linux环境下，使用最多的FTP服务端软件就是Vsftpd！
安装Vsftpd，运行一下命令需要在root用户下进行！

1. yum install vsftpd 安装
2. yum remove vsftpd 卸载

复制代码

启动服务

启动服务 service vsftpd start 或者 systemctl start vsftpd.service  
重启服务 systemctl restart vsftpd.service
停止服务 systemctl stop vsftpd.service
设置开机自启动  systemctl enable vsftpd.service   

配置文件说明

/etc/vsftpd/vsftpd.conf 这个文件是vsftpd服务的核心配置文件！
我们在修改配置文件的时候，最好先备份一份！
cp /etc/vsftpd/vsftpd.conf /etc/vsftpd/vsftpd.conf.bak
/etc/vsftpd/ftpusers这个文件是禁止使用vsftpd的用户列表文件。记录不允许访问FTP服务器的用户名单，管理员可以把一些对系统安全有威胁的用户账号记录在此文件中，以免用户从FTP登录后获得大于上传下载操作的权利，而对系统造成损坏。
/etc/vsftpd/user_list这个文件禁止或允许使用vsftpd的用户列表文件。这个文件中指定的用户缺省情况（即在/etc/vsftpd/vsftpd.conf中设置userlist_deny=YES）下也不能访问FTP服务器，在设置了userlist_deny=NO时,仅允许user_list中指定的用户访问FTP服务器。
注意配置文件中的值一定不要有空格

1. # Example config file /etc/vsftpd/vsftpd.conf
2. #
3. #
4. # 禁止匿名登录
5. anonymous_enable=NO
6. # 是否允许本地用户(即linux系统中的用户帐号)登录FTP服务器，默认设置为YES允许
7. # 本地用户登录后会进入用户主目录，而匿名用户登录后进入匿名用户的下载目录/var/ftp/pub
8. # 若只允许匿名用户访问，前面加上 #注释掉即可阻止本地用户访问FTP服务器
9. local_enable=YES
10. #
11. # 是否允许本地用户对FTP服务器文件具有写权限，默认设置为YES允许
12. write_enable=YES
13. #
14. # 掩码，本地用户默认掩码为077
15. # 你可以设置本地用户的文件掩码为缺省022，也可根据个人喜好将其设置为其他值
16. local_umask=022
17. #
18. # 是否允许匿名用户上传文件，须将全局的write_enable=YES。默认为YES
19. #anon_upload_enable=YES
20. #
21. #是否允许匿名用户创建新文件夹
22. #anon_mkdir_write_enable=YES
24. # 是否激活目录欢迎信息功能
25. # 当用户用CMD模式首次访问服务器上某个目录时，FTP服务器将显示欢迎信息
26. # 默认情况下，欢迎信息是通过该目录下的.message文件获得的
27. # 此文件保存自定义的欢迎信息，由用户自己建立
28. dirmessage_enable=YES
29. #
30. # 是否让系统自动维护上传和下载的日志文件
31. # 默认情况该日志文件为/var/log/vsftpd.log,也可以通过下面的xferlog_file选项对其进行设定
32. # 默认值为NO
33. xferlog_enable=YES
34. #
35. # 是否设定FTP服务器将启用FTP数据端口的连接请求
36. # ftp-data数据传输，21为连接控制端口
37. connect_from_port_20=YES
38. #
39. # 设定是否允许改变上传文件的属主，与下面一个设定项配合使用
40. # 注意，不推荐使用root用户上传文件
41. #chown_uploads=YES
42. # 设置想要改变的上传文件的属主，如果需要，则输入一个系统用户名
43. # 可以把上传的文件都改成root属主。whoever：任何人
44. #chown_username=whoever
45. #
46. # 设定系统维护记录FTP服务器上传和下载情况的日志文件
47. #xferlog_file=/var/log/xferlog
48. #
49. #如果你想，你可以有一个标准的ftpd xferlog格式的日志文件。
50. #注意默认的日志文件位置是/var/log/xferlog。
51. xferlog_std_format=YES
52. #
53. #您可以更改默认值，以使空闲会话超时。
54. #idle_session_timeout=600
55. #
56. # #您可以更改数据连接超时的默认值。
57. #data_connection_timeout=120
58. #
59. #运行vsftpd需要的非特权系统用户，缺省是nobody
60. #nopriv_user=ftpsecure
61. #
62. # 是否识别异步ABOR请求。
63. # 如果FTP client会下达“async ABOR”这个指令时，这个设定才需要启用
64. # 而一般此设定并不安全，所以通常将其取消
65. #async_abor_enable=YES
66. #
67. # 是否以ASCII方式传输数据。默认情况下，服务器会忽略ASCII方式的请求。
68. # 启用此选项将允许服务器以ASCII方式传输数据
69. # 不过，这样可能会导致由"SIZE /big/file"方式引起的DoS攻击
70. #ascii_upload_enable=YES
71. #ascii_download_enable=YES
73. # 登录FTP服务器时显示的欢迎信息
74. # 如有需要，可在更改目录欢迎信息的目录下创建名为.message的文件，并写入欢迎信息保存后
75. #ftpd_banner=Welcome to blah FTP service.
77. # 黑名单设置。如果很讨厌某些email address，就可以使用此设定来取消他的登录权限
78. # 可以将某些特殊的email address抵挡住。
79. #deny_email_enable=YES
81. # 当上面的deny_email_enable=YES时，可以利用这个设定项来规定哪些邮件地址不可登录vsftpd服务器
82. # 此文件需用户自己创建，一行一个email address即可
83. #banned_email_file=/etc/vsftpd/banned_emails
85. # You may specify an explicit list of local users to chroot() to their home
86. # directory. If chroot_local_user is YES, then this list becomes a list of
87. # users to NOT chroot().
88. # (Warning! chroot'ing can be very dangerous. If using chroot, make sure that
89. # the user does not have write access to the top level directory within the
90. # chroot)
91. chroot_local_user=YES
93. #  允许 chroot 用户具备写权限
94. allow_writeable_chroot=YES
95. #当chroot_list_enable=YES，chroot_local_user=YES时，在/etc/vsftpd.chroot_list文件中列出的用户，可以切换到其他目录；未在文件中列出的用户，不能切换到其他目录。
96. #当chroot_list_enable=YES，chroot_local_user=NO时，在/etc/vsftpd.chroot_list文件中列出的用户，不能切换到其他目录；未在文件中列出的用户，可以切换到其他目录。
97. #当chroot_list_enable=NO，chroot_local_user=YES时，所有的用户均不能切换到其他目录。
98. #当chroot_list_enable=NO，chroot_local_user=NO时，所有的用户均可以切换到其他目录。
99. chroot_list_enable=YES
101. # 被列入此文件的用户，在登录后将不能切换到自己目录以外的其他目录
102. # 从而有利于FTP服务器的安全管理和隐私保护。此文件需自己建立
103. #chroot_list_file=/etc/vsftpd/chroot_list
104. #
105. # 是否允许递归查询。默认为关闭，以防止远程用户造成过量的I/O
106. #ls_recurse_enable=YES
107. #
108. # 是否允许监听。
109. # 如果设置为YES，则vsftpd将以独立模式运行，由vsftpd自己监听和处理IPv4端口的连接请求
110. listen=YES
111. #
112. # 设定是否支持IPV6。如要同时监听IPv4和IPv6端口，
113. # 则必须运行两套vsftpd，采用两套配置文件
114. # 同时确保其中有一个监听选项是被注释掉的
115. # listen_ipv6=NO
117. # 设置是否阻扯user_list文件中的用户登录FTP服务器，默认为YES
118. #userlist_deny=YES/NO
120. # 设置PAM外挂模块提供的认证服务所使用的配置文件名，即/etc/pam.d/vsftpd文件
121. # 此文件中file=/etc/vsftpd/ftpusers字段，说明了PAM模块能抵挡的帐号内容来自文件/etc/vsftpd/ftpusers中
122. pam_service_name=vsftpd
124. # 是否允许ftpusers文件中的用户登录FTP服务器，默认为NO
125. # 若此项设为YES，则user_list文件中的用户允许登录FTP服务器
126. # 而如果同时设置了userlist_deny=YES，则user_list文件中的用户将不允许登录FTP服务器，甚至连输入密码提示信息都没有
127. userlist_enable=YES
128. # 是否使用tcp_wrappers作为主机访问控制方式。
129. # tcp_wrappers可以实现linux系统中网络服务的基于主机地址的访问控制
130. # 在/etc目录中的hosts.allow和hosts.deny两个文件用于设置tcp_wrappers的访问控制
131. # 前者设置允许访问记录，后者设置拒绝访问记录。
132. # 如想限制某些主机对FTP服务器192.168.57.2的匿名访问，编缉/etc/hosts.allow文件，如在下面增加两行命令：
133. # vsftpd:192.168.57.1:DENY 和vsftpd:192.168.57.9:DENY
134. # 表明限制IP为192.168.57.1/192.168.57.9主机访问IP为192.168.57.2的FTP服务器
135. # 此时FTP服务器虽可以PING通，但无法连接
136. tcp_wrappers=YES
138. #开启被动模式
139. pasv_enable=YES
140. # 传输文件的端口范围，如果是云服务器记得开放端口，linux服务器本身也要开放端口
141. pasv_min_port=9000
142. pasv_max_port=9005

复制代码

传输模式配置

开启被动模式：

1. connect_from_port_20=NO(默认为YES) #设置是否允许主动模式
2. pasv_enable=YES(默认为YES) #设置是否允许被动模式
3. pasv_min_port=50000(default:0(use any port))
4. pasv_max_port=60000(default:0(use any port))

复制代码

开启主动模式：

1. connect_from_port_20=YES
2. pasv_enable=NO

复制代码

系统用户配置

linux创建用户：

1. useradd -d /home/ftp/compass -s /sbin/nologin  compass
2. passwd compass

复制代码

为虚拟用户创建家目录

1. mkdir -p /home/ftp/compass

复制代码

设置权限

1. chown -R compass:compass /home/ftp/compass

复制代码

配置selinux允许ftp访问home和外网访问

1. [root@master ~]# setsebool -P allow_ftpd_full_access on
2. [root@master ~]# setsebool -P tftp_home_dir on

复制代码

重启vsftpd服务

1. [root@master ~]# systemctl restart vsftpd

复制代码

无法登录的情况 在/etc/vsftpd/vsftpd.conf配置文件中添加了以下两句

1.     chroot_local_user=YES  #原本就有，取掉注释就好
2.     allow_writeable_chroot=YES   #添加
3.     chown compass:compass -R /home/ftp/compass

复制代码

java操作ftp文件服务器

有时候，我们需要接收用户上传的文件存储到服务器，然后保存起来，下次用户可以直接下载，或者是保存为档案，我这里提供三个方法，一个是上传文件到ftp，还有就是从ftp下载文件，还有就是删除ftp服务器删的文件

1.引入依赖

1.        <!--    ftp上传下载-->
2.         <dependency>
3.             <groupId>commons-net</groupId>
4.             <artifactId>commons-net</artifactId>
5.             <version>3.7</version>
6.         </dependency>

复制代码

2.提供接口

1. import javax.servlet.http.HttpServletResponse;
2. import java.io.InputStream;
3. import java.io.OutputStream;
5. /**
6. * ftp文件服务器操作接口
7. *
8. * @author compass
9. * @date 2022/10/19 15:00
10. * @since 1.0.0
11. **/
12. public interface FtpService {
14.     /**
15.      * 上传文件到ftp
16.      *
17.      * @param inputStream 输入流
18.      * @param fileName    新的文件名，包含拓展名
19.      * @param filePath    保存路径
20.      * @return
21.      * @author compass
22.      */
23.     Boolean uploadFile(InputStream inputStream, String fileName, String filePath);
25.     /**
26.      * 下载ftp文件，直接转到输出流
27.      * @author compass
28.      * @param ftpFilePath
29.      * @author compass
30.      */
31.     byte[] downloadFileBytes(String ftpFilePath, HttpServletResponse response);
33.     /**
34.      * 删除ftp文件
35.      * @author compass
36.      * @param ftpFilePath ftp下文件路径，根目录开始
37.      * @return
38.      */
39.     Boolean deleteFile(String ftpFilePath);
40. }

复制代码

3.对提供操作ftp接口进行实现

1. /**
2. * @author compass
3. * @date 2022-10-19
4. * @since 1.0
5. **/
7. import java.io.*;
9. import compass.token.pocket.com.common.AjaxResult;
10. import compass.token.pocket.com.entity.FtpInstanceEntity;
11. import compass.token.pocket.com.service.FtpService;
12. import compass.token.pocket.com.utils.ResponseUtil;
13. import lombok.extern.slf4j.Slf4j;
14. import org.apache.commons.lang3.StringUtils;
15. import org.apache.commons.net.ftp.FTP;
16. import org.apache.commons.net.ftp.FTPClient;
17. import org.apache.commons.net.ftp.FTPReply;
18. import org.springframework.stereotype.Service;
20. import javax.annotation.Resource;
21. import javax.servlet.http.HttpServletResponse;
23. @Slf4j
24. @Service
25. public class FtpServiceImpl implements FtpService {
27.     @Resource
28.     FtpInstanceEntity ftpInstanceEntity;
30.     /**
31.      * 上传文件到ftp
32.      *
33.      * @param inputStream 输入流
34.      * @param fileName    新的文件名，包含拓展名
35.      * @param filePath    保存路径
36.      * @return
37.      * @author compass
38.      */
39.     @Override
40.     public Boolean uploadFile(InputStream inputStream, String fileName, String filePath) {
41.         // 定义保存结果
42.         boolean isSuccess = false;
43.         // 初始化连接
44.         FTPClient ftp = connectFtpServer();
45.         if (ftp != null) {
46.             try {
47.                 // 设置文件传输模式为二进制，可以保证传输的内容不会被改变
48.                 ftp.setFileType(FTP.BINARY_FILE_TYPE);
49.                 //注：上传文件都为0字节，设置为被动模式即可
50.                 ftp.enterLocalPassiveMode();
51.                 // 跳转到指定路径，逐级跳转，不存在的话就创建再进入
52.                 toPathOrCreateDir(ftp, filePath);
53.                 // 上传文件 参数：上传后的文件名，输入流,,返回Boolean类型，上传成功返回true
54.                 isSuccess = ftp.storeFile(fileName, inputStream);
55.                 // 关闭输入流
56.                 inputStream.close();
57.                 // 退出ftp
58.                 ftp.logout();
59.             } catch (IOException e) {
60.                 log.error(e.toString());
61.             } finally {
62.                 if (ftp.isConnected()) {
63.                     try {
64.                         // 断开ftp的连接
65.                         ftp.disconnect();
66.                     } catch (IOException ioe) {
67.                         log.error(ioe.toString());
68.                     }
69.                 }
70.             }
71.         }
72.         return isSuccess;
73.     }
75.     /**
76.      * 下载ftp文件，直接转到输出流
77.      *
78.      * @param ftpFilePath
79.      * @author compass
80.      */
81.     @Override
82.     public byte[] downloadFileBytes(String ftpFilePath , HttpServletResponse response) {
83.         FTPClient ftp = connectFtpServer();
84.         try {
85.             ByteArrayOutputStream stream = new ByteArrayOutputStream();
86.             ftp.setFileType(FTPClient.BINARY_FILE_TYPE);
87.             ftp.enterLocalPassiveMode();
88.             boolean retrieveFile = ftp.retrieveFile(ftpFilePath, stream);
89.             if (!retrieveFile){
90.                 throw new RuntimeException("FTP文件下载失败");
91.             }
92.             ftp.logout();
93.             return stream.toByteArray();
94.         } catch (Exception e) {
95.             log.error("FTP文件下载失败！" + e.toString());
96.             ResponseUtil.response(response,AjaxResult.businessError(e.getMessage(), "-1"));
97.             throw new RuntimeException(e.getMessage());
98.         } finally {
99.             if (ftp.isConnected()) {
100.                 try {
101.                     ftp.disconnect();
102.                 } catch (IOException ioe) {
103.                     log.error(ioe.toString());
104.                 }
105.             }
107.         }
108.     }
110.     /**
111.      * 删除ftp文件
112.      * @param ftpFilePath 文件路径
113.      * @return java.lang.Boolean
114.      * @author compass
115.      * @date 2022/10/19 18:35
116.      * @since 1.0.0
117.      **/
118.     @Override
119.     public Boolean deleteFile(String ftpFilePath ) {
120.         FTPClient ftp = connectFtpServer();
121.         boolean result = false;
122.         try {
123.             result = ftp.deleteFile(ftpFilePath);
124.             ftp.logout();
125.             return result;
126.         } catch (Exception e) {
127.             log.error("FTP文件删除失败！" + e.toString());
128.         } finally {
129.             if (ftp.isConnected()) {
130.                 try {
131.                     ftp.disconnect();
132.                 } catch (IOException ioe) {
133.                     log.error(ioe.toString());
134.                 }
135.             }
136.         }
137.         return result;
138.     }
140.     /**
141.      * 创建FTPClient对象
142.      *
143.      * @return org.apache.commons.net.ftp.FTPClient
144.      * @author compass
145.      * @date 2022/10/19 18:35
146.      * @since 1.0.0
147.      **/
148.     private FTPClient connectFtpServer() {
149.         // 创建FTPClient对象（对于连接ftp服务器，以及上传和上传都必须要用到一个对象）
150.         FTPClient ftpClient = new FTPClient();
151.         // 设置连接超时时间
152.         ftpClient.setConnectTimeout(1000 * 10);
153.         // 设置ftp字符集
154.         ftpClient.setControlEncoding("utf-8");
155.         // 设置被动模式，文件传输端口设置,否则文件上传不成功，也不报错
156.         ftpClient.enterLocalPassiveMode();
157.         try {
158.             // 定义返回的状态码
159.             int replyCode;
160.             // 连接ftp(当前项目所部署的服务器和ftp服务器之间可以相互通讯，表示连接成功)
161.             ftpClient.connect(ftpInstanceEntity.getHost());
162.             // 输入账号和密码进行登录
163.             ftpClient.login(ftpInstanceEntity.getUsername(), ftpInstanceEntity.getPassword());
164.             // 接受状态码(如果成功，返回230，如果失败返回503)
165.             replyCode = ftpClient.getReplyCode();
166.             // 根据状态码检测ftp的连接，调用isPositiveCompletion(reply)-->如果连接成功返回true，否则返回false
167.             if (!FTPReply.isPositiveCompletion(replyCode)) {
168.                 log.info("connect ftp {} failed", ftpInstanceEntity.getHost());
169.                 // 说明连接失败，需要断开连接
170.                 ftpClient.disconnect();
171.                 throw new RuntimeException(String.format("connect ftp %s failed", ftpInstanceEntity.getHost()));
172.             }
173.             log.info("连接状态码:" + replyCode);
174.         } catch (IOException e) {
175.             log.error("connect fail:" + e.toString());
176.             throw new RuntimeException(String.format("connect ftp %s error", ftpInstanceEntity.getHost()));
177.         }
178.         return ftpClient;
179.     }
181.     /**
182.      * 跳转到指定路径 不存在就创建
183.      *
184.      * @param ftp      操作ftp对象
185.      * @param filePath 文件路径
186.      * @return void
187.      * @author compass
188.      * @date 2022/10/19 15:05
189.      * @since 1.0.0
190.      **/
191.     private void toPathOrCreateDir(FTPClient ftp, String filePath) throws IOException {
192.         String[] dirs = filePath.split("/");
193.         for (String dir : dirs) {
194.             if (StringUtils.isEmpty(dir)) {
195.                 continue;
196.             }
197.             if (!ftp.changeWorkingDirectory(dir)) {
198.                 ftp.makeDirectory(dir);
199.                 ftp.changeWorkingDirectory(dir);
200.             }
201.         }
202.     }
204. }

复制代码

4.配置ftp相关参数

在配置文件中配置连接ftp服务器的配置

1. ftp:
2.   #ftp服务器的地址
3.   host: 127.0.0.1
4.   #ftp服务器的端口号（连接端口号）
5.   port: 21
6.   #ftp的用户名
7.   username: compass
8.   #ftp的密码
9.   password: 6317738ef8324199a24602308f3a9a18
10.   #ftp上传的根目录
11.   basePath: /home/ftp/compass
12.   #回显地址
13.   httpPath: ftp://127.0.0.1

复制代码

然后将配置文件的内容读取到一个bean里面

1. import lombok.Data;
2. import org.springframework.boot.context.properties.ConfigurationProperties;
3. import org.springframework.context.annotation.Configuration;
5. @Data
6. @Configuration
7. @ConfigurationProperties(prefix = "ftp")
8. public class FtpInstanceEntity {
9.     /**
10.      * ftp服务器的地址
11.      */
12.     private String host;
13.     /**
14.      * ftp服务器的端口号（连接端口号）
15.      */
16.     private String port;
17.     /**
18.      * ftp的用户名
19.      */
20.     private String username;
21.     /**
22.      * ftp的密码
23.      */
24.     private String password;
25.     /**
26.      * ftp上传的根目录
27.      */
28.     private String basePath;
29.     /**
30.      * 回显地址
31.      */
32.     private String httpPath;
34. }

复制代码

5.写测试controller

1. package compass.token.pocket.com.controller;
3. import cn.hutool.core.date.DateUtil;
4. import cn.hutool.core.util.IdUtil;
5. import compass.token.pocket.com.common.AjaxResult;
6. import compass.token.pocket.com.entity.FtpInstanceEntity;
7. import compass.token.pocket.com.service.FtpService;
8. import compass.token.pocket.com.utils.FileUtils;
9. import compass.token.pocket.com.utils.ResponseUtil;
10. import lombok.extern.slf4j.Slf4j;
11. import org.apache.commons.io.FilenameUtils;
12. import org.apache.commons.lang3.StringUtils;
13. import org.springframework.web.bind.annotation.*;
14. import org.springframework.web.multipart.MultipartFile;
16. import javax.annotation.Resource;
17. import javax.servlet.ServletOutputStream;
18. import javax.servlet.http.HttpServletRequest;
19. import javax.servlet.http.HttpServletResponse;
20. import java.io.*;
21. import java.net.URLEncoder;
22. import java.util.Date;
23. import java.util.HashMap;
24. import java.util.Map;
26. /**
27. * 文件测试控制器
28. * @author compass
29. * @date 2022/10/27 22:41
30. * @since 1.0.0
31. **/
32. @Slf4j
33. @RestController
34. @RequestMapping("/fileTestController")
35. public class FileTestController {
37.     @Resource
38.     private FtpService ftpService;
40.     @Resource
41.     FtpInstanceEntity ftpInstanceEntity;
43.     /**
44.      * ftp服务器文件上传
45.      * @param file 需要上传的文件
46.      * @return compass.token.pocket.com.common.AjaxResult<java.lang.String>
47.      * @author compass
48.      * @date 2022/10/19 14:51
49.      * @since 1.0.0
50.      **/
51.     @PostMapping(value = "/pdfUpload")
52.     public AjaxResult<String> pdfUpload(@RequestParam("file") MultipartFile file) {
53.         try {
54.             String fileDir = DateUtil.format(new Date(), "yyyy-MM-dd");
55.             boolean upload = ftpService.uploadFile(file.getInputStream(), file.getOriginalFilename(), fileDir);
56.             if (upload) {
57.                 String savePath = ftpInstanceEntity.getBasePath() + "/" + fileDir + "/" + file.getOriginalFilename();
58.                 return AjaxResult.success("上传成功", savePath);
59.             } else {
60.                 return new AjaxResult<>("file upload error");
61.             }
62.         } catch (IOException e) {
63.             e.printStackTrace();
64.         }
65.         return new AjaxResult<>("file upload error");
66.     }
68.     /**
69.      * ftp服务器文件下载
70.      * @param ftpPath 需要下载的文件路径
71.      * @return compass.token.pocket.com.common.AjaxResult<java.lang.String>
72.      * @author compass
73.      * @date 2022/10/19 14:51
74.      * @since 1.0.0
75.      **/
76.     @GetMapping(value = "/pdfDownload", produces = "application/octet-stream")
77.     public void downloadFile(@RequestParam("ftpPath") String ftpPath, HttpServletRequest request, HttpServletResponse response) {
78.         String userAgent = request.getHeader("User-Agent");
79.         String fileName = ftpPath.substring(ftpPath.lastIndexOf('/') + 1);
80.         try {
81.             if (userAgent.contains("MSIE") || userAgent.contains("Trident")) {
82.                 //IE浏览器处理
83.                 fileName = URLEncoder.encode(fileName, "UTF-8");
84.             } else {
85.                 // 非IE浏览器的处理：
86.                 fileName = new String(fileName.getBytes("UTF-8"), "ISO-8859-1");
87.             }
88.             response.setHeader("Content-Disposition", "attachment; filename=" + fileName);
89.             response.setContentType("application/octet-stream; charset=UTF-8");
90.             byte[] bytes = ftpService.downloadFileBytes( ftpPath,response);
91.             ServletOutputStream outputStream = response.getOutputStream();
92.             outputStream.write(bytes);
93.             outputStream.flush();
95.         } catch (Exception e) {
96.             e.printStackTrace();
97.         }
98.     }
100.     /**
101.      * ftp服务器文件删除
102.      * @param ftpPath 需要删除的文件路径
103.      * @return compass.token.pocket.com.common.AjaxResult<java.lang.Boolean>
104.      * @author compass
105.      * @date 2022/10/19 14:51
106.      * @since 1.0.0
107.      **/
108.     @PostMapping("ftpDeleteFile")
109.     public AjaxResult<Boolean> ftpDeleteFile(@RequestParam("ftpPath") String ftpPath){
110.         Boolean isSuccess = ftpService.deleteFile(ftpPath);
111.         if (isSuccess){
112.              return  AjaxResult.success("删除成功", true);
113.         }else {
114.             return  AjaxResult.businessError("删除失败", false);
115.         }
117.     }
119. }

复制代码

到这里操作ftp文件服务器的基本操作差不多结束了，讲的不是特别详细，但是基本来说，够用，如果遇到不能解决的问题请自行百度。
以上就是Java操作FTP实现上传下载功能的详细内容，更多关于Java FTP上传下载的资料请关注中国红客联盟其它相关文章！