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客户端，即浏览器发送请求及接受响应的各部分内容，请参考后面的博文。