JSP Servlet中Request与Response所有成员方法的研究
HttpServletRequest与HttpServletResponse作为Servlet中doGet、doPost等方法中传递的参数，承接了Http请求与响应中的大部分功能，请求的解析与响应的返回都需要靠这两个对象进行，他们中的所有方法及功能在下边总结了一下，希望能对学习Java Web开发有所帮助。
1、HttpServletRequest：
/* * 记录各个request.get的值 * request.getAsyncContext();AsyncContext * 获取异步传输的文本内容 * request.getAttribute(String);Object * Attribute与Parameter不同，Attr是在程序里用SetA设置进去的，而Par是接收网页的参数 * 多用于session的设值，session.setA，可以设置自己的类型，getP只能接收String，而getA可以为object * request.getAttributeNames();Enumeration<String> * 获取一个枚举类型，hasmoreelement，nextelement * request.getAuthType();String * 返回身份验证方法的名称，basic，SSL，form，client_cert和digest，若没有身份验证则为null * AuthType可在web.xml中配置，使用<login-config><auth-method>xx<real-name>xxx来配置 * 一般用于远程网页链接，即输入网页地址，弹出一个登陆界面，那里的时候才会用 * 读取文件头中的Authorization信息 * request.getCharacterEncoding();String * 返回网页使用的编码，在网页的charset中的值 * request.getContentLength();int * 只用于POST请求，表示所发送数据的字节数 * request.getContentLengthLong();long * 同上，用于数据量非常大时，long八个字节 * request.getContentType();String * 获取content-type，包括编码。<meta content="text/html; charset=gb2312" http-equiv="Content-Type"/> * Content-Type，用于定义网络文件的类型和网页的编码，决定浏览器将以什么形式、什么编码读取这个文件 * request.getContextPath();String * 获取项目的根目录名，如本项目应该是/MyTestWeb。返回指定servlet上下文（web应用）的URL的前缀。 * 用绝对路径时，可以使用getRealPath()（不推荐），request.getSession().getServletContext().getRealPath("/") * request.getCookies();Cookie[] * 很明显，返回网页的cookies，数组形式cookie是名称+值的形式保存的 * request.getDateHeader("String");long * 用于将指定头信息的部分转换成方便转换为时间类型的长整数型，简化getHeaders * request.getDispatcherType();DispatcherType * 未知... * request.getHeader("headname");String * 获取指定头信息 * request.getHeaderNames();Enumeration<String> * 获取名字的枚举，用于遍历 * request.getHeaders("headersname");Enumeration<String> * 获取一个name的多个值序列，返回请求给出的指定类型的所有HTTP头标的名称的枚举值，它对具有多取值的头标非常有用。 * request.getInputStream();ServletInputStream继承自io.InputStream * 获取请求内容，可以获取post方法在网页中通过send传递的内容，但是要通过InputStreamReader实例化 * 同时InputStreamReader也不能直接被读取为字符串，要使用BufferedReader实例化InputStreamReader * 之后就可以使用BufferedReader的readline来获取中间的数据了。 * 或者直接使用InputStream的read方法写给read的参数，byte数组 * 该方法只能读取一次，因为是流，所以读完就没了 * request.getIntHeader("head");int * 从头内容获取数值 * request.getLocalAddr();String * 获取本地地址，根据访问方法不同而不同，为127.0.0.1或者公网ip * request.getLocale();Locale(util中) * 获取本地位置信息，若ZHCN等等 * request.getLocales();Enumeration<Locale> * 有多个位置信息时获取枚举 * request.getLocalName();String * 获取本地IP的名称，如127.0.0.1就是localhost * request.getLocalPort();int * 获取端口号，本应用就是8081 * request.getMethod();String * 获取Http方法，有get，head,put,delete,post,options * request.getParameter("code");String * 获取提交参数，即网址？后面的内容，一一对应关系。即便是POST，这个也只能获取？后面的参数 * POST与GET的不同是可以send里面写内容，网址里面传递的参数还是一样的 * request.getParameterMap();Map<String,String[]> * 返回类型是String[]的原因是参数名称有可能相同，如果用getPara返回同名参数多个值的会把各个值结合起来 * PS:遍历Map的方法，Set<Entry<String, String[]>> set = map.entrySet();先获取EntrySet * 然后获取EntrySet的迭代器Iterator<Entry<String, String[]>> it = set.iterator(); * 接着使用迭代的getNext来获取各个元素Entry<String, String[]> entry = it.next(); * 最后使用Entry.getvalue获取字符串数组 * request.getParameterNames();Enumeration<String> * 获取参数名的枚举 * request.getParameterValues("code");String[] * 获取同名参数的多个值 * request.getPart("file");Part * 用于上传文件，一个Part为一个文件，mime类型为multipart/form-data * 程序中需要添加@MultipartConfig注解 * request.getParts();Collection<Part> * 获取一个Part的集合，用于上传多个文件 * request.getPathInfo();String * 返回在URL中指定的任意附加路径信息。不带参数，一般是相对于Servlet的路径 * pathinfo返回的字符串是经过Servlet服务器URL Decode过的。 * 输出:URL中Servlet路径之后、查询字符串之前的那部分。 * request.getPathTranslated();String * 映射到服务器实际路径之后的路径信息。 * request.getProtocol();String * 获取协议信息和版本号，即HTTP/1.1 * request.getQueryString();String * 这是字符串形式的附加到URL后面的查询字符串，数据仍旧是URL编码的。 * 在Servlet中很少需要用到未经解码的数据，一般使用getParameter访问各个参数。 * request.getReader();BufferedReader * 获取BufferedReader,和inputStream那一大堆获取的内容一样。。。 * request.getRealPath("/");String * 获取绝对路径，被废弃了，请使用request.getSession().getServletContext().getRealPath("/") * request.getRemoteAddr();String * 客户端的IP * request.getRemoteHost();String * 客户端的主机名 * request.getRemotePort();int * 客户端的端口号 * request.getRemoteUser();String * 客户端的用户名 * request.getRequestDispatcher("");RequestDispatcher * 请求转发，获取请求过来的地址，与该地址共享一个Request * request.getRequestedSessionId();String * 返回这个请求相应的session id * request.getRequestURI();String * 获得请求URL，不包含请求内容，不包含域名 * request.getRequestURL();StringBuffer * 获取URL，包含域名，不包含请求内容 * 未被Servlet服务器URL Decode过。 * request.getScheme();String * 返回协议名称，http * request.getServerName();String * 获得服务器名，本地IP * request.getServerPort();int * 获取服务器端口号 * request.getServletContext();ServletContext * 获取该Servlet的相关信息，getServletConfig().getServletContext().getServerInfo() * request.getServletPath();String * URL中调用Servlet的那一部分，不包含附加路径信息和查询字符串。 * request.getSession();HttpSession * 获取Session对话，用于与网页通信，很有用 * equest.getSession(boolean);HttpSession * request.getSession(true)：若存在会话则返回该会话，否则新建一个会话。 * request.getSession(false)：若存在会话则返回该会话，否则返回NULL * request.getUserPrincipal();Principal * 返回一个java.security.Principal 对象，该对象包含当前授权用户的名称 * 使用request.getUserPrincipal().getName()得到用户名 * 没有通过认证就没有返回值，是用户登录后才有值的，通过了JAAS认证，也就是登录 * * request.authenticate(HttpServletResponse response);boolean * 证明是真实的、可靠的或有效的;鉴定，使生效 * request.changeSessionId();String * Change the session id of the current session associated with this request and return the new session id. * request.isAsyncStarted();boolean * 异步传输是否开始 * request.isAsyncSupported();boolean * 是否支持异步传输 * isRequestedSessionIdFromCookie();boolean * SessionId是否是从cookies中获得的 * request.isRequestedSessionIdFromUrl();boolean * SessionId是否是从URL中获取的，已废弃 * request.isRequestedSessionIdFromURL();boolean * 同上，这个没废弃 * request.isRequestedSessionIdValid();boolean * 检查SessionId是否是有效的 * request.isSecure();boolean * 是否是安全的，即是否使用了安全协议，如https * request.isUserInRole("role");boolean * 判断用户是否是某个种类的角色，类型可以在web.xml中配置（tomcat-users.xml） * request.login("user", "password");void * 使用用户名和密码进行登录 * request.logout();void * 用户登出 * request.notify();request.notifyAll();void * 用于线程操作，详细见教材 * request.removeAttribute("at");void * 删除某个属性值，对应set * request.setAttribute("at", request);void * 设置某个属性值 * request.setCharacterEncoding("utf-8");void * 设置获取各个字符时使用的编码方式，应与网页的编码方式一样 * 仅仅只适用于设置post提交的request body的编码而不是设置get方法提交的queryString的编码。 * 该方法告诉应用服务器应该采用什么编码解析post传过来的内容。 * request.startAsync(request, response);void * 开始异步传输，可以不带参数 * request.upgrade();void * 开始更新？ * request.wait(12); * 实现了线程的类都有该方法，用于等待 */
2、HttpServletResponse
/* * response对象 * response.addCookie(new Cookie("a","aa"));void * 增加cookie * response.addDateHeader("date", 23456789l);void * 在头部增加日期 * response.addHeader("asf", "sff");void * 增加头部信息 * response.addIntHeader("fsf", 12);void * 在头部增加数值类型 * response.encodeRedirectUrl("utf-8");废弃 * response.encodeRedirectURL("utf-8");String * 通过指定的编码对URL进项编码，并携带sessionid，跨应用 * response.encodeUrl("utf-8");废弃 * response.encodeURL("utf-8");String * 通过指定的编码对URL进项编码，并携带sessionid，本应用 * 假如有sessionId，且不是从cookie中获得的，就放到url尾部，否则直接返回原url。 * response.flushBuffer();vodi * 立即发送缓冲区字符给客户端即浏览器 * response.getBufferSize();int * 获取缓冲区大小 * response.getCharacterEncoding();String * 获取编码类型 * response.getContentType();String * 获取Content的MIME类型和编码 * response.getHeaderNames();Collection<String> * 获取所有Header的name列表 * response.getHeaders("aa");Collection<String> * 获取所有aa的头的值列表 * response.getLocale();Locale * 获取本地信息，如zhcn * response.getOutputStream();ServletOutputStream继承自OutputStream * 获取输出流，和inputStream对应，bufferedReader和printWriter对应 * response.getStatus();int * 获取response的状态码，有200,301,404,500 * response.getWriter();PrintWriter * 获取一个PrintWriter，用于向response返回数据，从而向客户端返回数据，比Stream使用方便 * response.isCommitted();boolean * 调用PrintWriter对象的close()方法关闭底层输出流,方法在关闭输出流之前会先把缓冲区内的数据提交到客户端。 * 因此在调用PrintWriter 对象的 close()方法之前，response.isCommitted()方法返回 false； * 而在调用PrintWriter对象的close()方法之后，response.isCommitted()方法返回true。 * response.reset();void * 清除buffer，设置页面不缓存，同时清除状态码和头，如果已经发送数据则跑出异常 * response.resetBuffer();void * 只清除buffer * response.sendError(1,"123");void * response.sendError(123); * response.sendError(1,"123"); * setStatus方法用来设置Servlet向客户端返回的状态码，它用来设置没有出错的状态。 * 如果Servlet运行出错，Servlet可以使用sendError方法设置状态码， * 如sendError(int sc)方法设置错误状态代码。sendError(int sc,String msg)方法除了设置状态码 * 还向客户发出一条错误信息。 * response.sendRedirect("xx.html"); * 返回一个重定向，并把新的request与response交给重定向的页面进行处理 * sendRedirect方法向客户发出临时重新导向的响应。它生成的响应状态码为302。 * 该响应给了客户一个新的URL分区。如果缓冲器已经被清空，这个方法会弹出一个IllegalStateException例外。 * response.setBufferSize(123); * 设置缓冲区大小 * response.setCharacterEncoding("utf-8"); * 设置字符编码 * response.setContentLength(123); * 设置返回内容的长度，在header中也有 * response.setContentLengthLong(1345l); * 长度非常长是使用 * response.setContentType("dfd"); * 设置ContentType，包括编码和类型信息 * 网页的Http头中ContentType("text/html; charset=GBK")的作用： * 告诉浏览器网页中数据是什么编码\ * 表单提交时，通常浏览器会根据ContentType指定的charset对表单中的数据编码，然后发送给服务器的。 * 这里需要注意的是：这里所说的ContentType是指http头的ContentType，而不是在网页中meta中的ContentType。 * response.setDateHeader("asd", 123l); * 修改日期头 * response.setHeader("sfds", "sdfsdf"); * 修改头 * response.setIntHeader("sf", 3123); * 设置数值头 * response.setLocale(locale ); * 设置本地环境 * response.setStatus(1); * 设置Http状态码，为出错的情况用 * response.setStatus(12, "dasd"); * 设置状态码并带一条消息 * * * */
3、用于测试的代码
AsyncContext async = request.getAsyncContext(); String attribute = (String) request.getAttribute("code"); Enumeration<String> enumer = request.getAttributeNames(); String authtype = request.getAuthType(); String character = request.getCharacterEncoding(); int len = request.getContentLength(); long lenl = request.getContentLengthLong(); String contenttype = request.getContentType(); String contextpath = request.getContextPath(); Cookie[] cook = request.getCookies(); long dataHeader = request.getDateHeader(""); DispatcherType dispatcher = request.getDispatcherType(); String header = request.getHeader("headname"); Enumeration<String> headernames = request.getHeaderNames(); Enumeration<String> headersname = request.getHeaders("headersname"); ServletInputStream ins = request.getInputStream(); int i = request.getIntHeader("head"); String add = request.getLocalAddr(); Locale locale = request.getLocale(); Enumeration<Locale> locales = request.getLocales(); String localname = request.getLocalName(); int port = request.getLocalPort(); String method = request.getMethod(); String codep = request.getParameter("code"); Map<String,String[]> map = request.getParameterMap(); Enumeration<String> Pnames = request.getParameterNames(); String[] values = request.getParameterValues("code"); Part pa = request.getPart("file"); Collection<Part> pas = request.getParts(); String pathin = request.getPathInfo(); String trans = request.getPathTranslated(); String protoc = request.getProtocol(); String query = request.getQueryString(); BufferedReader br = request.getReader(); String rp = request.getRealPath("/"); String ra = request.getRemoteAddr(); String rh = request.getRemoteHost(); int rport = request.getRemotePort(); String ru = request.getRemoteUser(); RequestDispatcher rd = request.getRequestDispatcher(""); String rsi = request.getRequestedSessionId(); String uri = request.getRequestURI(); String scheme = request.getScheme(); String servern = request.getServerName(); int sport = request.getServerPort(); ServletContext scon = request.getServletContext(); String spath = request.getServletPath(); HttpSession session1 = request.getSession(); HttpSession session2 = request.getSession(true); Principal prc = request.getUserPrincipal(); boolean authe = request.authenticate(response);//证明是真实的、可靠的或有效的;鉴定，使生效 String cs = request.changeSessionId(); boolean iss = request.isAsyncStarted(); boolean isss = request.isAsyncSupported(); boolean issr = request.isRequestedSessionIdFromCookie(); boolean irsi = request.isRequestedSessionIdFromUrl(); boolean irss = request.isRequestedSessionIdFromURL(); boolean isiv = request.isRequestedSessionIdValid(); boolean isivs = request.isSecure(); boolean isr = request.isUserInRole("role"); request.login("user", "password"); request.logout(); request.notify(); request.notifyAll(); request.removeAttribute("at"); request.setAttribute("at", request); request.setCharacterEncoding("utf-8"); request.startAsync(); request.startAsync(request, response); //request.upgrade(); response.addCookie(new Cookie("a","aa")); response.addDateHeader("date", 23456789l); response.addHeader("asf", "sff"); response.addIntHeader("fsf", 12); boolean ch = response.containsHeader("asf"); String eru = response.encodeRedirectUrl("utf-8"); String eru1 = response.encodeRedirectURL("utf-8"); String eu = response.encodeUrl("utf-8"); String eu1 = response.encodeURL("utf-8"); response.flushBuffer(); int bs = response.getBufferSize(); String ge = response.getCharacterEncoding(); String cont = response.getContentType(); String se = response.getHeader("aa"); Collection<String> ghn = response.getHeaderNames(); Collection<String> ghn1 = response.getHeaders("aa"); Locale sss = response.getLocale(); ServletOutputStream ost = response.getOutputStream(); int rs = response.getStatus(); PrintWriter writer1 = response.getWriter(); boolean isc = response.isCommitted(); response.reset(); response.resetBuffer(); response.sendError(1,"123"); response.sendError(123); response.sendRedirect("xx.html"); response.setBufferSize(123); response.setCharacterEncoding("utf-8"); response.setContentLength(123); response.setContentLengthLong(1345l); response.setContentType("dfd"); response.setDateHeader("asd", 123l); response.setHeader("sfds", "sdfsdf"); response.setIntHeader("sf", 3123); response.setLocale(locale ); response.setStatus(1); response.setStatus(12, "dasd");
上面的内容只是作为总结，并没有说明各个方法的作用以及取出来的对象的作用，比如说Session，是一个很有用的对象，要知道他的用法，请看后面的博文。
关于Http客户端，即浏览器发送请求及接受响应的各部分内容，请参考后面的博文。
