1. 程式人生 > >第三十一章:檔案上傳&下載

第三十一章:檔案上傳&下載

作者:java_wxid

檔案的上傳介紹
檔案的上傳和下載功能是很多系統中非常常見的功能。非常的重要。

檔案的上傳
1、首先需要一個form表單
2、然後在表單內有input type=”file”
3、提交的方式必須是method=”POST”
4、enctype="multipart/form-data"編碼型別必須是多段的表單資料

enctype屬性有兩種值:

當enctype屬性值為application/x-www-form-urlencoded的時候,表單提交的時候,瀏覽器會把所有的表單以name=value&name=value的形式進行拼接,然後做URL編碼操作。
URL編碼操作,就是把非字母數字的字元,比如說中文,轉換成為:%xx%xx的格式內容

javaScript客戶端的URL編解碼:

		<script type="text/javascript">
			var url = "key=中文";
			// 編碼操作
			var encodedURL = encodeURI(url);
// 			alert(encodedURL);
			// 解碼操作
			var decodedURL = decodeURI(encodedURL);
			alert(decodedURL);
		</script>

java中的URL編解碼操作

public class JavaEncodeAndDecode {
	public static void main(String[] args) throws Exception {
		String url = "key=中文";
		// URLEncoder.encode 編碼操作
		String encodedUrl = URLEncoder.encode(url, "UTF-8");
		System.out.println(encodedUrl);
		// 解碼操作
		String decodedUrl = URLDecoder.decode(encodedUrl, "UTF-8");
		System.out.println( decodedUrl );
	}
}

當enctype屬性值為multipart/form-data的時候,表單提交,瀏覽器會把所有表單項的資訊,
以多個段的形式拼接在一起,以二進位制流的形式傳送給伺服器。每個表單項,都會以特定的格式封裝成為一段的資料。

檔案上傳,HTTP協議的說明。
谷歌瀏覽器f12進行檢視:
在這裡插入圖片描述
commons-fileupload.jar 常用API介紹說明
commons-fileupload.jar 需要依賴 commons-io.jar 這個包,所以兩個包我們都要引入。
commons-fileupload-1.2.1.jar
commons-io-1.4.jar

commons-fileupload.jar和commons-io.jar包中,我們常用的類有哪些?

boolean ServletFileUpload.isMultipartContent(HttpServletRequest request);
判斷,你提交過來的資料,是否是多段的上傳資料,如果是返回true,如果資料格式不合法,返回false

public List ServletFileUpload.parseRequest(HttpServletRequest request)
直接把上傳的資料,都解析成為每一個表單項。
每一個表單項由FileItem類表示

boolean FileItem.isFormField()
判斷,是不是普通的表單項。如果是返回true,如果不是返回false

String FileItem.getFieldName()
獲取表單項的name的屬性值

String FileItem.getString()
獲取表單項的值,多用於普通表單項。

String FileItem.getName();
獲取上傳的檔名

void FileItem.write( file );
把上傳的檔案寫到file所指向的位置。

fileupload類庫的使用:

檔案上傳的表單:

<body>
	<form action="http://192.168.10.100:8080/day10/upload" enctype="multipart/form-data" method="post">
		使用者名稱:<input type="text" name="username" /><br/>
		頭像:<input type="file" name="file"/><br/>
		<input type="submit" />
	</form>
</body>

解決上傳程式碼:

public class Upload extends HttpServlet {
	private static final long serialVersionUID = 1L;

	protected void doPost(HttpServletRequest request,
			HttpServletResponse response) throws ServletException, IOException {
		// 判斷,到底接收到的資料,是不是檔案上傳的格式(多段的multipart/form-data)
		if (ServletFileUpload.isMultipartContent(request)) {
			FileItemFactory fileItemFactory = new DiskFileItemFactory();
			// 建立檔案上傳解決的物件
			ServletFileUpload servletFileUpload = new ServletFileUpload(fileItemFactory);
			try {
				// 解析上傳的資料 ====>>>會得到每一個表單項
				// 每個FileItem表示一個表單項
				List<FileItem> fileItems = servletFileUpload.parseRequest(request);
				// 遍歷操作每一個表單項
				for (FileItem fileItem : fileItems) {
					if (fileItem.isFormField()) {
						// 表示這是一個普通表單項
						// 關心name屬性值和value屬性值
						System.out.println("name的屬性值:" + fileItem.getFieldName());
						System.out.println("提交過來的值:" + fileItem.getString());
					} else {
						// 上傳的檔案項
						// 關心name屬性值,和上傳的檔名,以及把上傳的檔案寫到某個硬碟位置 
						System.out.println("name的屬性值:" + fileItem.getFieldName());
						System.out.println("上傳的檔名:" + fileItem.getName());
						fileItem.write(new File("E:\\" + fileItem.getName()));
					}
				}
			} catch (Exception e) {
				e.printStackTrace();
			}
		}
	}
}

檔案下載

下載的常用API說明:

response.getOutputStream();
servletContext.getResourceAsStream();
servletContext.getMimeType();
response.setContentType();

response.setHeader(“Content-Disposition”, “attachment; fileName=1.jpg”);
這個響應頭告訴瀏覽器。這是需要下載的。Content-Disposition是內容-配置,而attachment表示附件,也就是下載的一個檔案。fileName=後面,表示下載的檔名。

完成上面的兩個步驟,下載檔案是沒問題了。但是如果我們要下載的檔案是中文名的話。你會發現,下載無法正確顯示出正確的中文名。
原因是在響應頭中,不能包含有中文字元,只能包含ASCII碼。

附件中文名亂碼問題解決方案:
方案一:URLEncoder解決 IE 和谷歌瀏覽器的 附件中文名問題。
如果客戶端瀏覽器是IE瀏覽器 或者 是谷歌瀏覽器。我們需要使用URLEncoder類先對中文名進行UTF-8的編碼操作。
因為IE瀏覽器和谷歌瀏覽器收到含有編碼後的字串後會以UTF-8字符集進行解碼顯示。

		// 把中文名進行UTF-8編碼操作。
		String str = "attachment; fileName=" + URLEncoder.encode("中文.jpg", "UTF-8");
		// 然後把編碼後的字串設定到響應頭中
		response.setHeader("Content-Disposition", str);

方案二:BASE64編解碼 解決 火狐瀏覽器的附件中文名問題
如果客戶端瀏覽器是火狐瀏覽器。 那麼我們需要對中文名進行BASE64的編碼操作。

這時候需要把請求頭Content-Disposition: attachment; filename=中文名
編碼成為:Content-Disposition: attachment; filename==?charset?B?xxxxx?=

=?charset?B?xxxxx?= 現在我們對這段內容進行一下說明。
=? :表示編碼的開始
charset :表示你使用什麼字符集
B :表示使用BASE64編碼
xxxx :是base64編碼後的內容
?= :表示編碼的結束

BASE64編解碼操作:

@Test
public void test() throws Exception {
	String url = "中文.jpg";
	// 建立一個base64編碼器物件
	BASE64Encoder base64Encoder = new BASE64Encoder();
	// base64Encoder.encode執行base64編碼操作
	String base64EncodedString = base64Encoder.encode(url.getBytes("UTF-8"));
	System.out.println(base64EncodedString);
	// 解碼
	BASE64Decoder base64Decoder = new BASE64Decoder();
	// base64解碼操作
	byte[] buffer = base64Decoder.decodeBuffer(base64EncodedString);
	System.out.println( new String(buffer, "UTF-8") );
}

因為火狐使用的是BASE64的編解碼方式還原響應中的漢字。所以需要使用BASE64Encoder類進行編碼操作。

// 使用下面的格式進行BASE64編碼後
String str = "attachment; fileName=" + "=?utf-8?B?"
		+ new BASE64Encoder().encode("中文.jpg".getBytes("utf-8")) + "?=";
// 設定到響應頭中
response.setHeader("Content-Disposition", str);

那麼我們如何解決上面兩種不同編解碼方式呢。我們只需要通過判斷請求頭中User-Agent這個請求頭攜帶過來的瀏覽器資訊即可判斷出是什麼瀏覽器。

如下:

String ua = request.getHeader("User-Agent");
// 判斷是否是火狐瀏覽器
if (ua.contains("Firefox")) {
	// 使用下面的格式進行BASE64編碼後
	String str = "attachment; fileName=" + "=?utf-8?B?"
			+ new BASE64Encoder().encode("中文.jpg".getBytes("utf-8")) + "?=";
	// 設定到響應頭中
	response.setHeader("Content-Disposition", str);
} else {
	// 把中文名進行UTF-8編碼操作。
	String str = "attachment; fileName=" + URLEncoder.encode("中文.jpg", "UTF-8");
	// 然後把編碼後的字串設定到響應頭中
	response.setHeader("Content-Disposition", str);
}

案例程式碼:

public class Download extends HttpServlet {
	private static final long serialVersionUID = 1L;

	protected void doGet(HttpServletRequest request,
			HttpServletResponse response) throws ServletException, IOException {
		String path = "/imgs/d.jpg";
		ServletContext servletContext = getServletContext();
		// getMimeType 獲取檔案的資料型別
		String type = servletContext.getMimeType(path);
		System.out.println(type);
		// 要設定返回的資料型別
		response.setContentType(type);

		/**
		 * 通過判斷請求頭User-Agent判斷是不是火狐瀏覽器,還是其他瀏覽器
		 */
		if (request.getHeader("User-Agent").contains("Firefox")) {
			// 火狐瀏覽器
			response.setHeader(
					"Content-Disposition",
					"attachment; filename==?UTF-8?B?"
							+ new BASE64Encoder().encode("中文.jpg"
									.getBytes("UTF-8")) + "?=");
		} else {
			// 如果是谷歌瀏覽器,或IE瀏覽器,需要使用URL編碼處理
			// 設定響應頭 告訴瀏覽器,你收到資料,要當成下載處理。
			// attachment 表示附件
			// fileName表示下載的檔名
			response.setHeader("Content-Disposition", "attachment; filename="
					+ URLEncoder.encode("中文.jpg", "UTF-8"));
		}

		// 1 想辦法讀取需要下載的檔案
		// 斜槓打頭,表示到http://ip:prot/工程名/ 對映到程式碼的webContent目錄
		InputStream stream = servletContext.getResourceAsStream(path);
		// 2 通過位元組的響應輸出流,輸出給客戶端
		ServletOutputStream outputStream = response.getOutputStream();
		// copy方法 把輸入流的內容都讀取然後寫到輸出流中
		IOUtils.copy(stream, outputStream);
		// 關流釋放 資源
		stream.close();
		outputStream.close();
	}
}

專案文字替換
頁面內替換文字:Ctrl+F
專案中所有文字替換
在這裡插入圖片描述