來自 | ITDragon龍
鏈接 | cnblogs.com/itdragon/p/7864916.html
本章內容通過Nginx 和 FTP 搭建圖片服務器。在學習本章內容前,請確保您的linux 系統已經安裝了Nginx 和 Vsftpd。
Nginx 安裝
http://www.cnblogs.com/itdragon/p/7850985.html
Vsftpd 安裝
http://www.cnblogs.com/itdragon/p/7857649.html
本章知識點
效果圖:

需求:實現圖片的上傳和批量上傳
技術:Nginx,Vsftpd,Spring,SpringMVC,KindEditor,centos
說明:本章節內容主要是實現圖片的上傳功能。使用 KindEditer 是為了更好的演示圖片的上傳,回顯,批量效果。后臺代碼與KindEditer沒有直接關系,放心閱讀。另外源碼中有Mybatis的jar,不用理會,本章內容用不到,是為后續內容做準備!
源碼:見文章底部
場景:用戶將圖片上傳到 Tomcat 服務器上,再由 tomcat 服務器通過FTP上傳到 Nginx 服務器上。
項目結構:
單元測試
首先要攻破核心技術。通過單元測試實現圖片上傳的功能。
public class PictureFTPTest {// 測試 ftp 上傳圖片功能@Testpublic void testFtpClient throws Exception {// 1. 創建一個FtpClient對象FTPClient ftpClient = new FTPClient;// 2. 創建 ftp 連接ftpClient.connect("192.168.0.11", 21);// 3. 登錄 ftp 服務器ftpClient.login("ftpuser", "root");// 4. 讀取本地文件FileInputStream inputStream = new FileInputStream(new File("F:\hello.png"));// 5. 設置上傳的路徑ftpClient.changeWorkingDirectory("/usr/local/nginx/html/images");// 6. 修改上傳文件的格式為二進制ftpClient.setFileType(FTP.BINARY_FILE_TYPE);// 7. 服務器存儲文件,第一個參數是存儲在服務器的文件名,第二個參數是文件流ftpClient.storeFile("hello.jpg", inputStream);// 8. 關閉連接ftpClient.logout;}}
說明:這里的ip地址,端口,ftp用戶名,密碼,本地文件路徑,以及Nginx服務器圖片路徑等,這些字符串參數都要根據自己實際設置的來填寫的。如果你的Nginx和Vsftpd安裝是按照我提供的鏈接來做的。那你只需要改ip地址即可。
Maven 的Web 項目
搭建Maven的Web 項目,之前有寫過。這里就不過多描述。
項目核心配置文件
首先是 Maven 的核心文件 pom.xml,添加下列對應版本的依賴即可,可前去https://mvnrepository.com/tags/maven 查找依賴。
<junit.version>4.12</junit.version><spring.version>4.1.3.RELEASE</spring.version><mybatis.version>3.2.8</mybatis.version><mybatis.spring.version>1.2.2</mybatis.spring.version><mybatis.paginator.version>1.2.15</mybatis.paginator.version><MySQL.version>5.1.6</mysql.version><slf4j.version>1.6.4</slf4j.version><jackson.version>2.4.2</jackson.version><druid.version>1.0.9</druid.version><httpclient.version>4.3.5</httpclient.version><jstl.version>1.2</jstl.version><servlet-api.version>2.5</servlet-api.version><jsp-api.version>2.0</jsp-api.version><joda-time.version>2.5</joda-time.version><commons-lang3.version>3.3.2</commons-lang3.version><commons-io.version>1.3.2</commons-io.version><commons-net.version>3.3</commons-net.version><pagehelper.version>3.4.2</pagehelper.version><jsqlparser.version>0.9.1</jsqlparser.version><commons-fileupload.version>1.3.1</commons-fileupload.version><jedis.version>2.7.2</jedis.version><solrj.version>4.10.3</solrj.version>
說明:和文件上傳有直接關系的是:
<dependency><groupId>commons-fileupload</groupId><artifactId>commons-fileupload</artifactId></dependency>
然后是 Web 項目的核心文件 web.xml
<?xml version="1.0" encoding="UTF-8"?><web-App xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xmlns="http://JAVA.sun.com/xml/ns/javaee" xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"id="taotao" version="2.5"><display-name>pictrue-service</display-name><!-- 加載spring容器 --><context-param><param-name>contextConfigLocation</param-name><param-value>classpath:spring/applicationContext-*.xml</param-value></context-param><listener><listener-class>org.springframework.web.context.ContextLoaderListener</listener-class></listener><!-- 解決post亂碼 --><filter><filter-name>CharacterEncodingFilter</filter-name><filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class><init-param><param-name>encoding</param-name><param-value>utf-8</param-value></init-param></filter><filter-mapping><filter-name>CharacterEncodingFilter</filter-name><url-pattern>/*</url-pattern></filter-mapping><!-- springmvc的前端控制器 --><servlet><servlet-name>pictrue-service</servlet-name><servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class><init-param><param-name>contextConfigLocation</param-name><param-value>classpath:spring/springmvc.xml</param-value></init-param><load-on-startup>1</load-on-startup></servlet><servlet-mapping><servlet-name>pictrue-service</servlet-name><url-pattern>/</url-pattern></servlet-mapping></web-app>
再是 SpringMVC 配置文件 springmvc.xml,需要添加文件上傳解析器
<!-- 定義文件上傳解析器 --><bean id="multipartResolver"class="org.springframework.web.multipart.commons.CommonsMultipartResolver"><!-- 設定默認編碼 --><property name="defaultEncoding" value="UTF-8"></property><!-- 設定文件上傳的最大值5MB,5*1024*1024 --><property name="maxUploadSize" value="5242880"></property></bean>
最后是 Ftp 配置文件 resource.properties
FTP_ADDRESS=192.168.0.11FTP_PORT=21FTP_USERNAME=ftpuserFTP_PASSword=rootFTP_BASE_PATH=/usr/local/nginx/html/imagesIMAGE_BASE_URL=http://192.168.0.11/images
Service 層
上傳圖片的接口 PictureService.java
/*** 上傳,批量上傳接口* @param uploadFile* @return*/Map uploadPicture(MultipartFile uploadFile);}
上傳圖片接口實現類 PictureServiceImpl.java
@Service@SuppressWarnings({"rawtypes", "unchecked"})public class PictureServiceImpl implements PictureService {// 通過 Spring4 的 Value注解,獲取配置文件中的屬性值@Value("${FTP_ADDRESS}")private String FTP_ADDRESS; // ftp 服務器ip地址@Value("${FTP_PORT}")private Integer FTP_PORT; // ftp 服務器port,默認是21@Value("${FTP_USERNAME}")private String FTP_USERNAME; // ftp 服務器用戶名@Value("${FTP_PASSWORD}")private String FTP_PASSWORD; // ftp 服務器密碼@Value("${FTP_BASE_PATH}")private String FTP_BASE_PATH; // ftp 服務器存儲圖片的絕對路徑@Value("${IMAGE_BASE_URL}")private String IMAGE_BASE_URL; // ftp 服務器外網訪問圖片路徑@Overridepublic Map uploadPicture(MultipartFile uploadFile) {Map resultMap = new HashMap<>;try {// 1. 取原始文件名String oldName = uploadFile.getOriginalFilename;// 2. ftp 服務器的文件名String newName = oldName;//圖片上傳boolean result = uploadFile(FTP_ADDRESS, FTP_PORT, FTP_USERNAME, FTP_PASSWORD,uploadFile.getInputStream, FTP_BASE_PATH, newName);//返回結果if(!result) {resultMap.put("error", 1);resultMap.put("message", "upload Fail");return resultMap;}resultMap.put("error", 0);resultMap.put("url", IMAGE_BASE_URL + "/" + newName);return resultMap;} catch (Exception e) {e.printStackTrace;resultMap.put("error", 1);resultMap.put("message", "upload Fail");return resultMap;}}/*** ftp 上傳圖片方法* @param ip ftp 服務器ip地址* @param port ftp 服務器port,默認是21* @param account ftp 服務器用戶名* @param passwd ftp 服務器密碼* @param inputStream 文件流* @param workingDir ftp 服務器存儲圖片的絕對路徑* @param fileName 上傳到ftp 服務器文件名* @throws Exception**/public boolean uploadFile(String ip, Integer port, String account, String passwd,InputStream inputStream, String workingDir, String fileName) throws Exception{boolean result = false;// 1. 創建一個FtpClient對象FTPClient ftpClient = new FTPClient;try {// 2. 創建 ftp 連接ftpClient.connect(ip, port);// 3. 登錄 ftp 服務器ftpClient.login(account, passwd);int reply = ftpClient.getReplyCode; // 獲取連接ftp 狀態返回值System.out.println("code : " + reply);if (!FTPReply.isPositiveCompletion(reply)) {ftpClient.disconnect; // 如果返回狀態不再 200 ~ 300 則認為連接失敗return result;}// 4. 讀取本地文件// FileInputStream inputStream = new FileInputStream(new File("F:\hello.png"));// 5. 設置上傳的路徑ftpClient.changeWorkingDirectory(workingDir);// 6. 修改上傳文件的格式為二進制ftpClient.setFileType(FTP.BINARY_FILE_TYPE);// 7. 服務器存儲文件,第一個參數是存儲在服務器的文件名,第二個參數是文件流if (!ftpClient.storeFile(fileName, inputStream)) {return result;}// 8. 關閉連接inputStream.close;ftpClient.logout;result = true;} catch (Exception e) {e.printStackTrace;}finally {// FIXME 聽說,項目里面最好少用try catch 捕獲異常,這樣會導致Spring的事務回滾出問題???難道之前寫的代碼都是假代碼!!!if (ftpClient.isConnected) {try {ftpClient.disconnect;} catch (IOException ioe) {}}}return result;}}
說明:
-
@Value 注解是Spring4 中提供的,@Value("${XXX}")
-
返回值是一個Map,并且key有error,url,message。這是根據KindEditer的語法要求來的。詳情見鏈接。http://kindeditor.net/docs/upload.html
Controller 層
負責頁面跳轉的 PageController.java
@Controllerpublic class PageController {/*** 打開首頁*/@RequestMapping("/")public String showIndex {return "index";}@RequestMapping("/{page}")public String showpage(@PathVariable String page) {System.out.println("page : " + page);return page;}}
負責圖片上傳的 PictureController.java
@RestControllerpublic class PictureController {@Autowiredprivate PictureService pictureService;@RequestMapping("pic/upload")public String pictureUpload(@RequestParam(value = "fileUpload") MultipartFile uploadFile) {String json = "";try {Map result = pictureService.uploadPicture(uploadFile);// 瀏覽器擅長處理json格式的字符串,為了減少因為瀏覽器內核不同導致的bug,建議用jsonjson = new ObjectMapper.writeValueAsString(result);} catch (JsonProcessingException e) {e.printStackTrace;}return json;}}
說明:
-
@RestController 也是Spring4 提供的,是 @Controller + @ResponseBody 的組合注解。
-
Controller層的返回值是一個json格式的字符串。是考慮到瀏覽器對json解析兼容性比較好。
Views視圖層
負責上傳圖片的視圖頁面:
<form action="pic/upload" method="post" enctype="multipart/form-data"><input type="file" name="fileUpload" /><input type="submit" value="上傳文件" /></form><hr /><h3>借用KindEditor富文本編輯器實現批量上傳圖片</h3><textarea id="kindEditorDesc" style="width:800px;height:300px;visibility:hidden;"></textarea><script type="text/JavaScript">$(function{//初始化富文本編輯器KindEditor.create("#kindEditorDesc", {// name值,必須和Controller 的參數對應,不然會提示 400 的錯誤filePostName : "fileUpload",// action值,uploadJson : '/pic/upload',// 設置上傳類型,分別為image、flash、media、filedir : "image"});});</script>
說明:視圖分為兩個部分,第一個部分是為了測試上傳圖片功能的form表單。第二個部分是為了更好的體驗上傳,批量上傳,回顯功能的KindEditer 富文本編輯器。
總結
-
Nginx 搭建服務器的思維
-
Java實現 Ftp上傳圖片的功能
-
KindEditer 上傳圖片的功能
源碼:https://github.com/ITDragonBlog/daydayup/tree/master/Nginx
Nginx 搭建圖片服務器到這里就結束了,有什么不足的地方,請賜教。如果覺得不錯,可以點個贊哦!
如果喜歡本篇文章,歡迎轉發、點贊。關注訂閱號「Web項目聚集地」,回復「全棧」即可獲取 2019 年最新 Java、Python、前端學習視頻資源。






