ServletRequest 基本概念
JavaWeb中的 "Request"對象
實際為 HttpServletRequest 或者 ServletRequest, 兩者都為接口
服務器接收請求后,將請求數據進行對象封裝
功能大致分類
request的功能可以分為以下幾種：
- 封裝了請求頭數據；
- 封裝了請求正文數據，如果是GET請求，那么就沒有正文；
- request是一個域對象，可以把它當成Map來添加獲取數據；
- request提供了請求轉發和請求包含功能。
request是四大域對象之一
其他是ServletContext Session PageContext
Request的域方法
用來存儲一個對象，也可以稱之為存儲一個域屬性
| void setAttribute(String name, Object value); |
例如：servletContext.setAttribute(“xxx”, “XXX”)，在request中保存了一個域屬性，域屬性名稱為xxx，域屬性的值為XXX。
請注意，如果多次調用該方法，並且使用相同的name，那么會覆蓋上一次的值，這一特性與Map相同；
用來獲取request中的數據
| Object getAttribute(String name); |
當前在獲取之前需要先去存儲才行，
例如：
String value = (String)request.getAttribute(“xxx”);，獲取名為xxx的域屬性；
用來移除request中的域屬性，如果參數name指定的域屬性不存在，那么本方法什么都不做；
| void removeAttribute(String name); |
獲取所有域屬性的名稱；
| Enumeration getAttributeNames(); |
獲取請求頭數據
獲取指定名稱的請求頭；
| String getHeader(String name); |
獲取所有請求頭名稱；
| Enumeration getHeaderNames(); |
獲取值為int類型的請求頭。
| int getIntHeader(String name); |
獲取請求相關的其它方法
還提供了與請求相關的其他方法，有些方法是為了我們更加便捷的方法請求頭數據而設計，有些是與請求URL相關的方法
獲取請求體的字節數，GET請求沒有請求體，沒有請求體返回-1；
| int getContentLength(); |
獲取請求類型，如果請求是GET，那么這個方法返回null；
如果是POST請求，那么默認為application/x-www-form-urlencoded，表示請求體內容使用了URL編碼；
| String getContentType(); |
返回請求方法，例如：GET
| String getMethod(); |
返回當前客戶端瀏覽器的Locale。java.util.Locale表示國家和言語，這個東西在國際化中很有用；
| Locale getLocale(); |
獲取請求體編碼，如果沒有setCharacterEncoding()，那么返回null，表示使用ISO-8859-1編碼；
| String getCharacterEncoding(); |
設置請求編碼，只對請求體有效！注意，對於GET而言，沒有請求體！！！所以此方法只能對POST請求中的參數有效！
| void setCharacterEncoding(String code); |
返回請求協議，例如：http；
| String getScheme(); |
返回主機名，例如：localhost 或者 127.0.0.1
| String getServerName(); |
返回服務器端口號，例如：8080
| int getServerPort(); |
返回請求URI路徑，例如：/servlet/ServletA
| String getRequestURI(); |
返回請求URL路徑，例如：http://localhost:8080/servlet/ServletA，
即返回除了參數以外的路徑信息；
| StringBuffer getRequestURL(); |
返回請求URL中的參數，例如：name=zhangsan&age=28
| String getQueryString(); |
返回上下文路徑，例如：/servlet
| String getContextPath(); |
返回Servlet路徑，例如：/ServletA
| String getServletPath(); |
返回當前客戶端的IP地址；
| String getRemoteAddr(); |
返回當前客戶端的主機名，但這個方法的實現還是獲取IP地址；
| String getRemoteHost(); |
上面的路徑示例 假定請求地址為:
http://127.0.0.1:8080/servlet/ServletA?name=zhangsan&age=28
獲取請求參數
最為常見的客戶端傳遞參數方式有兩種GET 和 POST：
瀏覽器地址欄直接輸入：一定是GET請求；
超鏈接：一定是GET請求；
表單：可以是GET，也可以是POST，這取決與<form>的method屬性值；
GET請求和POST請求的區別：
GET請求：
POST請求：
獲取請求參數的具體方法
根據參數名稱獲取參數
| public String getParameter(String name); |
頁面一個超鏈接一個表單
<body> <a href="/servlet/ServletA?name=zhangsan&age=28">超鏈接</a> <hr/> <form action="/servlet/ServletA" method="post"> 參數1：<input type="text" name="name"/><br/> 參數2：<input type="text" name="age"/><br/> <input type="submit" value="提交"/> </form> </body>
Servlet中java代碼(doGet doPost 都一樣可以)
System.out.println("request.getParameter(\"name\"): " + request.getParameter("name"));
System.out.println("request.getParameter(\"age\"): " + request.getParameter("age"));
打印結果:
當多個參數名稱相同時，可以使用方法來獲取
| String[] getParameterValues(String name); |
http://127.0.0.1:8080/servlet/ServletA?name=zhangsan&name=lisi
System.out.println("request.getParameter(\"name\"): " + request.getParameter("name"));
String[] names = request.getParameterValues("name");
System.out.println(Arrays.toString(names));
打印結果:
可以看得出來request.getParameter("name") 打印的是第一個
獲取所有參數的名稱
| public Enumeration getParameterNames(); |
http://127.0.0.1:8080/servlet/ServletA?name=zhangsan&age=28&sex=male
Enumeration pNames = request.getParameterNames(); while(pNames.hasMoreElements()) { System.out.println(pNames.nextElement()); }
打印信息
獲取所有參數封裝到Map中，其中key為參數名，value為參數值
因為一個參數名稱可能有多個值，所以參數值是String[]，而不是String
| public Map getParameterMap(); |
http://127.0.0.1:8080/servlet/ServletA?name=zhangsan&age=28&sex=male&name=lisi&age=18
//轉換為Map Map<String,String[]> paramMap = request.getParameterMap(); //獲取鍵,根據鍵獲取值數組 for(String name : paramMap.keySet()) { String[] values = paramMap.get(name); System.out.println(name + ": " + Arrays.toString(values)); }
打印結果:
請求轉發和請求包含
RequestDispatcher forward include
無論是請求轉發還是請求包含，都表示由多個Servlet共同來處理一個請求。
請求轉發與請求包含比較
1.如果在AServlet中請求轉發到BServlet，那么在AServlet中就不允許再輸出響應體，
即不能再使用response.getWriter()和response.getOutputStream()向客戶端輸出，這一工作應該由BServlet來完成；
如果是使用請求包含，那么沒有這個限制；
2.請求轉發雖然不能輸出響應體，但還是可以設置響應頭的
例如：response.setContentType(”text/html;charset=utf-8”);
3.請求包含大多是應用在JSP頁面中，完成多頁面的合並；
4.請求轉發大多是應用在Servlet中，轉發目標大多是JSP頁面；
ServletA中代碼如下:
response.getWriter().println("ServletA");
//獲取“調度器”，其中參數為BServlet綁定的URL，即BServlet的<url-pattern>值。
RequestDispatcher rd = request.getRequestDispatcher("/ServletB");
rd.forward(request, response);
B中僅僅響應信息
請求http://127.0.0.1:8080/servlet/ServletA
頁面數據為:
可以看得到,雖然A中有response.getWriter().println("ServletA"); 但是沒有任何的結果,請求直接被轉發了
請求 http://127.0.0.1:8080/servlet/ServletA
ServletA中代碼如下:
response.getWriter().println("ServletA");
//獲取“調度器”，其中參數為BServlet綁定的URL，即BServlet的<url-pattern>值。
RequestDispatcher rd = request.getRequestDispatcher("/ServletB");
rd.include(request, response);
頁面數據為:
此時A和B Servlet的響應都可以正常輸出,也就是響應進行了合並
請求轉發與重定向比較
請求轉發是一個請求，而重定向是兩個請求；
請求轉發后瀏覽器地址欄不會有變化，而重定向會有變化，因為重定向是兩個請求；
請求轉發的目標只能是本應用中的資源，重定向的目標可以是其他應用；
請求轉發對ServletA和ServletB的請求方法是相同的，即要么都是GET，要么都是POST，因為請求轉發是一個請求；
重定向的第二個請求一定是GET；