1.HttpServletRequest
1.1HttpServletRequest定义
HttpServletRequest是一个接口,其父接口是ServletRequest
HttpServletRequest是Tomcat将请求报文转换封装而来的对象,在Tomcat调用service方法时传入
HttpServletRequest代表客户端发来的请求,所有请求中的信息都可以通过该对象获得
1.2HttpServletRequest的API
1.2.1 获取请求行信息相关
| API |
功能解释 |
| StringBuffer getRequestURL(); |
获取客户端请求的url |
| String getRequestURI(); |
获取客户端请求项目中的具体资源 |
| int getServerPort(); |
获取客户端发送请求时的端口 |
| int getLocalPort(); |
获取本应用在所在容器的端口 |
| int getRemotePort(); |
获取客户端程序的端口 |
| String getScheme(); |
获取请求协议 |
| String getProtocol(); |
获取请求协议及版本号 |
| String getMethod(); |
获取请求方式 |
1.2.2 获得请求头信息相关
| API |
功能解释 |
| String getHeader(String headerName); |
根据头名称获取请求头 |
| Enumeration getHeaderNames(); |
获取所有的请求头名字 |
| String getContentType(); |
获取content-type请求头 |
1.2.3获得请求参数相关
| API |
功能解释 |
| String getParameter(String parameterName); |
根据请求参数名获取请求单个参数值 |
| String[] getParameterValues(String parameterName); |
根据请求参数名获取请求多个参数值数组 |
| Enumeration getParameterNames(); |
获取所有请求参数名 |
| Map<String, String[]> getParameterMap(); |
获取所有请求参数的键值对集合 |
| BufferedReader getReader() throws IOException; |
获取读取请求体的字符输入流 |
| ServletInputStream getInputStream() throws IOException; |
获取读取请求体的字节输入流 |
| int getContentLength(); |
获得请求体长度的字节数 |
1.2.4 其他API
| API |
功能解释 |
| String getServletPath(); |
获取请求的Servlet的映射路径 |
| ServletContext getServletContext(); |
获取ServletContext对象 |
| Cookie[] getCookies(); |
获取请求中的所有cookie |
| HttpSession getSession(); |
获取Session对象 |
| void setCharacterEncoding(String encoding) ; |
设置请求体字符集 |
2.HttpServletResponse
2.1 HttpServletResponse定义
HttpServletResponse是一个接口,其父接口是ServletResponse
HttpServletResponse是Tomcat预先创建的,在Tomcat调用service方法时传入
HttpServletResponse代表对客户端的响应,该对象会被转换成响应的报文发送给客户端,通过该对象我们可以设置响应信息
2.2 HttpServletResponse的常见API
2.2.1设置响应行相关
| API |
功能解释 |
| void setStatus(int code); |
设置响应状态码 |
2.2.2设置响应头相关
| API |
功能解释 |
| void setHeader(String headerName, String headerValue); |
设置/修改响应头键值对 |
| void setContentType(String contentType); |
设置content-type响应头及响应字符集(设置MIME类型) |
2.2.3设置响应体相关
| API |
功能解释 |
| PrintWriter getWriter() throws IOException; |
获得向响应体放入信息的字符输出流 |
| ServletOutputStream getOutputStream() throws IOException; |
获得向响应体放入信息的字节输出流 |
| void setContentLength(int length); |
设置响应体的字节长度,其实就是在设置content-length响应头 |
2.2.4其他API
| API |
功能解释 |
| void sendError(int code, String message) throws IOException; |
向客户端响应错误信息的方法,需要指定响应码和响应信息 |
| void addCookie(Cookie cookie); |
向响应体中增加cookie |
| void setCharacterEncoding(String encoding); |
设置响应体字符集 |