HttpServletResponse

Web服務器收到客戶端的http請求,會針對每一次請求,分別創建一個用於代表請求的request對象、和代表響應的response對象。
request和response對象即然代表請求和響應,那我們要獲取客戶機提交過來的數據,只需要找request對象就行了。要向客戶機輸出數據,只需要找response對象就行了。

一、HttpServletResponse對象介紹

  

  HttpServletResponse對象代表服務器的響應。這個對象中封裝了向客戶端發送數據、發送響應頭,發送響應狀態碼的方法。查看HttpServletResponse的API,可以看到這些相關的方法。

1.1、負責向客戶端(瀏覽器)發送數據的相關方法

  

1.2、負責向客戶端(瀏覽器)發送響應頭的相關方法

  

  

1.3、負責向客戶端(瀏覽器)發送響應狀態碼的相關方法

  

1.4、響應狀態碼的常量

  HttpServletResponse定義了很多狀態碼的常量(具體可以查看Servlet的API),當需要向客戶端發送響應狀態碼時,可以使用這些常量,避免了直接寫數字,常見的狀態碼對應的常量:

  狀態碼404對應的常量

  

  狀態碼200對應的常量

  

  狀態碼500對應的常量

  

二、HttpServletResponse對象常見應用

 2.1、使用OutputStream流向客戶端瀏覽器輸出中文數據

使用OutputStream流輸出中文注意問題:

  在服務器端,數據是以哪個碼錶輸出的,那麼就要控制客戶端瀏覽器以相應的碼錶打開,比如:outputStream.write("中國".getBytes("UTF-8"));使用OutputStream流向客戶端瀏覽器輸出中文,以UTF-8的編碼進行輸出,此時就要控制客戶端瀏覽器以UTF-8的編碼打開,否則顯示的時候就會出現中文亂碼,那麼在服務器端如何控制客戶端瀏覽器以以UTF-8的編碼顯示數據呢?可以通過設置響應頭控制瀏覽器的行爲,例如:response.setHeader("content-type", "text/html;charset=UTF-8");通過設置響應頭控制瀏覽器以UTF-8的編碼顯示數據。

範例:使用OutputStream流向客戶端瀏覽器輸出"中國"這兩個漢字

複製代碼
 1 package gacl.response.study;
 2 
 3 import java.io.IOException;
 4 import java.io.OutputStream;
 5 import javax.servlet.ServletException;
 6 import javax.servlet.http.HttpServlet;
 7 import javax.servlet.http.HttpServletRequest;
 8 import javax.servlet.http.HttpServletResponse;
 9 
10 public class ResponseDemo01 extends HttpServlet {
11 
12     private static final long serialVersionUID = 4312868947607181532L;
13 
14     public void doGet(HttpServletRequest request, HttpServletResponse response)
15             throws ServletException, IOException {
16         outputChineseByOutputStream(response);//使用OutputStream流輸出中文
17     }
18     
19     /**
20      * 使用OutputStream流輸出中文
21      * @param request
22      * @param response
23      * @throws IOException 
24      */
25     public void outputChineseByOutputStream(HttpServletResponse response) throws IOException{
26         /**使用OutputStream輸出中文注意問題:
27          * 在服務器端,數據是以哪個碼錶輸出的,那麼就要控制客戶端瀏覽器以相應的碼錶打開,
28          * 比如:outputStream.write("中國".getBytes("UTF-8"));//使用OutputStream流向客戶端瀏覽器輸出中文,以UTF-8的編碼進行輸出
29          * 此時就要控制客戶端瀏覽器以UTF-8的編碼打開,否則顯示的時候就會出現中文亂碼,那麼在服務器端如何控制客戶端瀏覽器以以UTF-8的編碼顯示數據呢?
30          * 可以通過設置響應頭控制瀏覽器的行爲,例如:
31          * response.setHeader("content-type", "text/html;charset=UTF-8");//通過設置響應頭控制瀏覽器以UTF-8的編碼顯示數據
32          */
33         String data = "中國";
34         OutputStream outputStream = response.getOutputStream();//獲取OutputStream輸出流
35         response.setHeader("content-type", "text/html;charset=UTF-8");//通過設置響應頭控制瀏覽器以UTF-8的編碼顯示數據,如果不加這句話,那麼瀏覽器顯示的將是亂碼
36         /**
37          * data.getBytes()是一個將字符轉換成字節數組的過程,這個過程中一定會去查碼錶,
38          * 如果是中文的操作系統環境,默認就是查找查GB2312的碼錶,
39          * 將字符轉換成字節數組的過程就是將中文字符轉換成GB2312的碼錶上對應的數字
40          * 比如: "中"在GB2312的碼錶上對應的數字是98
41          *         "國"在GB2312的碼錶上對應的數字是99
42          */
43         /**
44          * getBytes()方法如果不帶參數,那麼就會根據操作系統的語言環境來選擇轉換碼錶,如果是中文操作系統,那麼就使用GB2312的碼錶
45          */
46         byte[] dataByteArr = data.getBytes("UTF-8");//將字符轉換成字節數組,指定以UTF-8編碼進行轉換
47         outputStream.write(dataByteArr);//使用OutputStream流向客戶端輸出字節數組
48     }
49 
50     public void doPost(HttpServletRequest request, HttpServletResponse response)
51             throws ServletException, IOException {
52         doGet(request, response);
53     }
54 
55 }
複製代碼

 運行結果如下:

  

  客戶端瀏覽器接收到數據後,就按照響應頭上設置的字符編碼來解析數據,如下所示:

  

2.2、使用PrintWriter流向客戶端瀏覽器輸出中文數據

使用PrintWriter流輸出中文注意問題:

  在獲取PrintWriter輸出流之前首先使用"response.setCharacterEncoding(charset)"設置字符以什麼樣的編碼輸出到瀏覽器,如:response.setCharacterEncoding("UTF-8");設置將字符以"UTF-8"編碼輸出到客戶端瀏覽器,然後再使用response.getWriter();獲取PrintWriter輸出流,這兩個步驟不能顛倒,如下:

1 response.setCharacterEncoding("UTF-8");//設置將字符以"UTF-8"編碼輸出到客戶端瀏覽器
2 /**
3 * PrintWriter out = response.getWriter();這句代碼必須放在response.setCharacterEncoding("UTF-8");之後
4 * 否則response.setCharacterEncoding("UTF-8")這行代碼的設置將無效,瀏覽器顯示的時候還是亂碼
5 */
6 PrintWriter out = response.getWriter();//獲取PrintWriter輸出流

  然後再使用response.setHeader("content-type", "text/html;charset=字符編碼");設置響應頭,控制瀏覽器以指定的字符編碼編碼進行顯示,例如:

1 //通過設置響應頭控制瀏覽器以UTF-8的編碼顯示數據,如果不加這句話,那麼瀏覽器顯示的將是亂碼
2 response.setHeader("content-type", "text/html;charset=UTF-8");

  除了可以使用response.setHeader("content-type", "text/html;charset=字符編碼");設置響應頭來控制瀏覽器以指定的字符編碼編碼進行顯示這種方式之外,還可以用如下的方式來模擬響應頭的作用

1 /**
2 * 多學一招:使用HTML語言裏面的<meta>標籤來控制瀏覽器行爲,模擬通過設置響應頭控制瀏覽器行爲
3  *response.getWriter().write("<meta http-equiv='content-type' content='text/html;charset=UTF-8'/>");
4 * 等同於response.setHeader("content-type", "text/html;charset=UTF-8");
5 */
6 response.getWriter().write("<meta http-equiv='content-type' content='text/html;charset=UTF-8'/>");

範例:使用PrintWriter流向客戶端瀏覽器輸出"中國"這兩個漢字

複製代碼
 1 package gacl.response.study;
 2 
 3 import java.io.IOException;
 4 import java.io.OutputStream;
 5 import java.io.PrintWriter;
 6 import javax.servlet.ServletException;
 7 import javax.servlet.http.HttpServlet;
 8 import javax.servlet.http.HttpServletRequest;
 9 import javax.servlet.http.HttpServletResponse;
10 
11 public class ResponseDemo01 extends HttpServlet {
12 
13     private static final long serialVersionUID = 4312868947607181532L;
14 
15     public void doGet(HttpServletRequest request, HttpServletResponse response)
16             throws ServletException, IOException {
17         outputChineseByPrintWriter(response);//使用PrintWriter流輸出中文
18     }
19 
20     /**
21      * 使用PrintWriter流輸出中文
22      * @param request
23      * @param response
24      * @throws IOException 
25      */
26     public void outputChineseByPrintWriter(HttpServletResponse response) throws IOException{
27         String data = "中國";
28         
29         //通過設置響應頭控制瀏覽器以UTF-8的編碼顯示數據,如果不加這句話,那麼瀏覽器顯示的將是亂碼
30         //response.setHeader("content-type", "text/html;charset=UTF-8");
31         
32         response.setCharacterEncoding("UTF-8");//設置將字符以"UTF-8"編碼輸出到客戶端瀏覽器
33         /**
34          * PrintWriter out = response.getWriter();這句代碼必須放在response.setCharacterEncoding("UTF-8");之後
35          * 否則response.setCharacterEncoding("UTF-8")這行代碼的設置將無效,瀏覽器顯示的時候還是亂碼
36          */
37         PrintWriter out = response.getWriter();//獲取PrintWriter輸出流
38         /**
39          * 多學一招:使用HTML語言裏面的<meta>標籤來控制瀏覽器行爲,模擬通過設置響應頭控制瀏覽器行爲
40          * out.write("<meta http-equiv='content-type' content='text/html;charset=UTF-8'/>");
41          * 等同於response.setHeader("content-type", "text/html;charset=UTF-8");
42          */
43         out.write("<meta http-equiv='content-type' content='text/html;charset=UTF-8'/>");
44         out.write(data);//使用PrintWriter流向客戶端輸出字符
45     }
46     
47     public void doPost(HttpServletRequest request, HttpServletResponse response)
48             throws ServletException, IOException {
49         doGet(request, response);
50     }
51 }
複製代碼

   當需要向瀏覽器輸出字符數據時,使用PrintWriter比較方便,省去了將字符轉換成字節數組那一步。

2.3、使用OutputStream或者PrintWriter向客戶端瀏覽器輸出數字

比如有如下的代碼:

複製代碼
 1 package gacl.response.study;
 2 
 3 import java.io.IOException;
 4 import java.io.OutputStream;
 5 import java.io.PrintWriter;
 6 
 7 import javax.servlet.ServletException;
 8 import javax.servlet.http.HttpServlet;
 9 import javax.servlet.http.HttpServletRequest;
10 import javax.servlet.http.HttpServletResponse;
11 
12 public class ResponseDemo01 extends HttpServlet {
13 
14     private static final long serialVersionUID = 4312868947607181532L;
15 
16     public void doGet(HttpServletRequest request, HttpServletResponse response)
17             throws ServletException, IOException {
18         
19         outputOneByOutputStream(response);//使用OutputStream輸出1到客戶端瀏覽器
20         
21     }
22 
23     /**
24      * 使用OutputStream流輸出數字1
25      * @param request
26      * @param response
27      * @throws IOException 
28      */
29     public void outputOneByOutputStream(HttpServletResponse response) throws IOException{
30         response.setHeader("content-type", "text/html;charset=UTF-8");
31         OutputStream outputStream = response.getOutputStream();
32         outputStream.write("使用OutputStream流輸出數字1:".getBytes("UTF-8"));
33         outputStream.write(1);
34     }
35     
36 }
複製代碼

  運行上面代碼顯示的結果如下:

  

  運行的結果和我們想象中的不一樣,數字1沒有輸出來,下面我們修改一下上面的outputOneByOutputStream方法的代碼,修改後的代碼如下:

複製代碼
 1     /**
 2      * 使用OutputStream流輸出數字1
 3      * @param request
 4      * @param response
 5      * @throws IOException 
 6      */
 7     public void outputOneByOutputStream(HttpServletResponse response) throws IOException{
 8         response.setHeader("content-type", "text/html;charset=UTF-8");
 9         OutputStream outputStream = response.getOutputStream();
10         outputStream.write("使用OutputStream流輸出數字1:".getBytes("UTF-8"));
11         //outputStream.write(1);
12         outputStream.write((1+"").getBytes());
13     }
複製代碼

  1+""這一步是將數字1和一個空字符串相加,這樣處理之後,數字1就變成了字符串1了,然後再將字符串1轉換成字節數組使用OutputStream進行輸出,此時看到的結果如下:

  

  這次可以看到輸出來的1了,這說明了一個問題:在開發過程中,如果希望服務器輸出什麼瀏覽器就能看到什麼,那麼在服務器端都要以字符串的形式進行輸出

  如果使用PrintWriter流輸出數字,那麼也要先將數字轉換成字符串後再輸出,如下:

複製代碼
 1     /**
 2      * 使用PrintWriter流輸出數字1
 3      * @param request
 4      * @param response
 5      * @throws IOException 
 6      */
 7     public void outputOneByPrintWriter(HttpServletResponse response) throws IOException{
 8         response.setHeader("content-type", "text/html;charset=UTF-8");
 9         response.setCharacterEncoding("UTF-8");
10         PrintWriter out = response.getWriter();//獲取PrintWriter輸出流
11         out.write("使用PrintWriter流輸出數字1:");
12         out.write(1+"");
13     }
複製代碼

 2.4、文件下載

  文件下載功能是web開發中經常使用到的功能,使用HttpServletResponse對象就可以實現文件的下載

文件下載功能的實現思路:

  1.獲取要下載的文件的絕對路徑

  2.獲取要下載的文件名

  3.設置content-disposition響應頭控制瀏覽器以下載的形式打開文件

  4.獲取要下載的文件輸入流

  5.創建數據緩衝區

  6.通過response對象獲取OutputStream流

  7.將FileInputStream流寫入到buffer緩衝區

  8.使用OutputStream將緩衝區的數據輸出到客戶端瀏覽器

範例:使用Response實現文件下載

複製代碼
 1 package gacl.response.study;
 2 import java.io.FileInputStream;
 3 import java.io.FileNotFoundException;
 4 import java.io.FileReader;
 5 import java.io.IOException;
 6 import java.io.InputStream;
 7 import java.io.OutputStream;
 8 import java.io.PrintWriter;
 9 import java.net.URLEncoder;
10 import javax.servlet.ServletException;
11 import javax.servlet.http.HttpServlet;
12 import javax.servlet.http.HttpServletRequest;
13 import javax.servlet.http.HttpServletResponse;
14 /**
15  * @author gacl
16  * 文件下載
17  */
18 public class ResponseDemo02 extends HttpServlet {
19 
20     public void doGet(HttpServletRequest request, HttpServletResponse response)
21             throws ServletException, IOException {
22         downloadFileByOutputStream(response);//下載文件,通過OutputStream流
23     }
24 
25     /**
26      * 下載文件,通過OutputStream流
27      * @param response
28      * @throws FileNotFoundException
29      * @throws IOException
30      */
31     private void downloadFileByOutputStream(HttpServletResponse response)
32             throws FileNotFoundException, IOException {
33         //1.獲取要下載的文件的絕對路徑
34         String realPath = this.getServletContext().getRealPath("/download/1.JPG");
35         //2.獲取要下載的文件名
36         String fileName = realPath.substring(realPath.lastIndexOf("\\")+1);
37         //3.設置content-disposition響應頭控制瀏覽器以下載的形式打開文件
38         response.setHeader("content-disposition", "attachment;filename="+fileName);
39         //4.獲取要下載的文件輸入流
40         InputStream in = new FileInputStream(realPath);
41         int len = 0;
42         //5.創建數據緩衝區
43         byte[] buffer = new byte[1024];
44         //6.通過response對象獲取OutputStream流
45         OutputStream out = response.getOutputStream();
46         //7.將FileInputStream流寫入到buffer緩衝區
47         while ((len = in.read(buffer)) > 0) {
48         //8.使用OutputStream將緩衝區的數據輸出到客戶端瀏覽器
49             out.write(buffer,0,len);
50         }
51         in.close();
52     }
53 
54     public void doPost(HttpServletRequest request, HttpServletResponse response)
55             throws ServletException, IOException {
56         doGet(request, response);
57     }
58 }
複製代碼

運行結果如下所示:

  

 範例:使用Response實現中文文件下載

  下載中文文件時,需要注意的地方就是中文文件名要使用URLEncoder.encode方法進行編碼(URLEncoder.encode(fileName, "字符編碼")),否則會出現文件名亂碼。

複製代碼
 1 package gacl.response.study;
 2 import java.io.FileInputStream;
 3 import java.io.FileNotFoundException;
 4 import java.io.FileReader;
 5 import java.io.IOException;
 6 import java.io.InputStream;
 7 import java.io.OutputStream;
 8 import java.io.PrintWriter;
 9 import java.net.URLEncoder;
10 import javax.servlet.ServletException;
11 import javax.servlet.http.HttpServlet;
12 import javax.servlet.http.HttpServletRequest;
13 import javax.servlet.http.HttpServletResponse;
14 /**
15  * @author gacl
16  * 文件下載
17  */
18 public class ResponseDemo02 extends HttpServlet {
19 
20     public void doGet(HttpServletRequest request, HttpServletResponse response)
21             throws ServletException, IOException {
22         downloadChineseFileByOutputStream(response);//下載中文文件
23     }
24 
25     /**
26      * 下載中文文件,中文文件下載時,文件名要經過URL編碼,否則會出現文件名亂碼
27      * @param response
28      * @throws FileNotFoundException
29      * @throws IOException
30      */
31     private void downloadChineseFileByOutputStream(HttpServletResponse response)
32             throws FileNotFoundException, IOException {
33         String realPath = this.getServletContext().getRealPath("/download/張家界國家森林公園.JPG");//獲取要下載的文件的絕對路徑
34         String fileName = realPath.substring(realPath.lastIndexOf("\\")+1);//獲取要下載的文件名
35         //設置content-disposition響應頭控制瀏覽器以下載的形式打開文件,中文文件名要使用URLEncoder.encode方法進行編碼,否則會出現文件名亂碼
36         response.setHeader("content-disposition", "attachment;filename="+URLEncoder.encode(fileName, "UTF-8"));
37         InputStream in = new FileInputStream(realPath);//獲取文件輸入流
38         int len = 0;
39         byte[] buffer = new byte[1024];
40         OutputStream out = response.getOutputStream();
41         while ((len = in.read(buffer)) > 0) {
42             out.write(buffer,0,len);//將緩衝區的數據輸出到客戶端瀏覽器
43         }
44         in.close();
45     }
46     
47     public void doPost(HttpServletRequest request, HttpServletResponse response)
48             throws ServletException, IOException {
49         doGet(request, response);
50     }
51 }
複製代碼

運行結果如下所示:

  

  文件下載注意事項:編寫文件下載功能時推薦使用OutputStream流,避免使用PrintWriter流,因爲OutputStream流是字節流,可以處理任意類型的數據,而PrintWriter流是字符流,只能處理字符數據,如果用字符流處理字節數據,會導致數據丟失。

範例:使用PrintWriter流下載文件

複製代碼
 1 package gacl.response.study;
 2 import java.io.FileInputStream;
 3 import java.io.FileNotFoundException;
 4 import java.io.FileReader;
 5 import java.io.IOException;
 6 import java.io.InputStream;
 7 import java.io.OutputStream;
 8 import java.io.PrintWriter;
 9 import java.net.URLEncoder;
10 import javax.servlet.ServletException;
11 import javax.servlet.http.HttpServlet;
12 import javax.servlet.http.HttpServletRequest;
13 import javax.servlet.http.HttpServletResponse;
14 /**
15  * @author gacl
16  * 文件下載
17  */
18 public class ResponseDemo02 extends HttpServlet {
19 
20     public void doGet(HttpServletRequest request, HttpServletResponse response)
21             throws ServletException, IOException {
22         downloadFileByPrintWriter(response);//下載文件,通過PrintWriter流
23     }
24 
25     /**
26      * 下載文件,通過PrintWriter流,雖然也能夠實現下載,但是會導致數據丟失,因此不推薦使用PrintWriter流下載文件
27      * @param response
28      * @throws FileNotFoundException
29      * @throws IOException
30      */
31     private void downloadFileByPrintWriter(HttpServletResponse response)
32             throws FileNotFoundException, IOException {
33         String realPath = this.getServletContext().getRealPath("/download/張家界國家森林公園.JPG");//獲取要下載的文件的絕對路徑
34         String fileName = realPath.substring(realPath.lastIndexOf("\\")+1);//獲取要下載的文件名
35         //設置content-disposition響應頭控制瀏覽器以下載的形式打開文件,中文文件名要使用URLEncoder.encode方法進行編碼
36         response.setHeader("content-disposition", "attachment;filename="+URLEncoder.encode(fileName, "UTF-8"));
37         FileReader in = new FileReader(realPath);
38         int len = 0;
39         char[] buffer = new char[1024];
40         PrintWriter out = response.getWriter();
41         while ((len = in.read(buffer)) > 0) {
42             out.write(buffer,0,len);//將緩衝區的數據輸出到客戶端瀏覽器
43         }
44         in.close();
45     }
46     
47     public void doPost(HttpServletRequest request, HttpServletResponse response)
48             throws ServletException, IOException {
49         doGet(request, response);
50     }
51 }
複製代碼

運行結果如下:

  

正常彈出下載框,此時我們點擊【保存】按鈕將文件下載下來,如下所示:

  

  可以看到,只下載了5.25MB,而這張圖片的原始大小卻是

  

  這說明在下載的時候數據丟失了,所以下載不完全,所以這張圖片雖然能夠正常下載下來,但是卻是無法打開的,因爲丟失掉了部分數據,如下所示:

  

   所以使用PrintWriter流處理字節數據,會導致數據丟失,這一點千萬要注意,因此在編寫下載文件功能時,要使用OutputStream流,避免使用PrintWriter流,因爲OutputStream流是字節流,可以處理任意類型的數據,而PrintWriter流是字符流,只能處理字符數據,如果用字符流處理字節數據,會導致數據丟失。

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章