JSP/Servlet开发——第二章 JSP数据交互(一)
1、 JSP内置对象:JSP内置对象是 Web 容器创建的一组对象;
●JSP常用的内置对象:out、request、application、session、response等;
●内置对象不需要实例化的原因:
★由Web容器加载的一组Servlet API的实例,这些实例由 JSP 规范进行了默认的初始化操作,可以直接在JSP中使用,特别要注意的是JSP内置对象名称均是JSP的保留字,不得当作自定义变名使用;
2、JSP的内置对象out:
●out对象是JspWriter类的实例; |
|
●out 内置对象是在 JSP 开发过程中使用最为频繁的对象,out 对用于向浏览器输出数据,其常用的方法是 print( ) , 该方法用于在页面中显示字符串信息。 eg:在页面上显示 “Hello JSP': <% out.print(“Hello JSP”); %> |
|
●out常用的方法: |
|
方法名称 |
说明 |
void print(Object c) |
向客户端打印数据(将各种类型的数据转换成字符串) |
void println(Object c) |
向客户端打印数据(将各种类型的数据转换成字符串)并换行(在html源代码里表现为回车,但在页面渲染为空格) |
void write(charset) |
向客户端打印数据(只能打印:字符、字符数组、字符串) |
3、 JSP 内置对象 request:
●request对象是最常用的 JSP 内置对象之一 , 其中包含了有关浏览器请求的信息;
工作原理:
●request对象常用方法:
方法名称 |
说明 |
String getParameter(String name) |
根据页面表单组件名称获取页面提交数据 |
String[ ] getParameterValues(String name) |
获取一组相同名称名命的表单组件提交的数据(表单组件对应多个值时的请求数据 ) |
void setCharacterEncoding(String charset) |
指定每个请求的编码 |
RequestDispatcher getRequestDispatcher(String path) |
返回一个javax.servlet.RequestDispatcher对象,该对象的forward( )方法用于转发请求 |
eg:编码实现学员的注册功能: |
|||
注册reginput . jsp页面的jsp: <body> <div align="center">请输入注册信息 <form name="form1" method="post" action="reginfo.jsp"> <table border="0" align="center"> <tr> <td>用户名:</td> <td><input type="text" name="name"></td> </tr> <tr> <td height="19">密码:</td> <td height="19"><input type="password" name="pwd"></td> </tr> <tr> <td>信息来源:</td> <td> <input type="checkbox" name="channel" value="报刊">报刊 <input type="checkbox" name="channel" value="网络">网络<br/> <input type="checkbox" name="channel" value="朋友推荐">朋友推荐 <input type="checkbox" name="channel" value="电视">电视 </td> </tr> <!-- 以下是提交、取消按钮 --> <tr > <td colspan="2" align="center" > <input type="submit" name="Submit" value="提交"> <input type="reset" name="Reset" value="取消"> </td> </tr> </table> </form> </div> </body>
eg:提交reginfo . isp页面的jsp: <body> <% request.setCharacterEncoding("UTF-8"); String name = request.getParameter("name"); String pwd = request.getParameter("pwd"); String[] channels = request.getParameterValues("channel"); %> <div align="center">你输入的注册信息 <table border="0" align="center"> <tr> <td width="80" height="20">用户名:</td> <td><%=name%></td> </tr> <tr> <td height="20">密码:</td> <td><%=pwd%></td> </tr> <tr> <td height="20">信息来源:</td> <td > <% if (channels != null) { for (String channel: channels) { out.print(channel+" "); } } %> </td> </tr> </table> </div> </body> |
|||
代码分析: ★request的getParameter()方法是最为常用的,使用此方法可以获得请求中所提交的参数值, 例如,注册页面 (reginput . jsp) 通过 HTML 表单为注册提交页面 (reginfo . isp) 提交了两个参数,名称分别为name 和 pwd,通过调用 request .getParameter( "name' ) 和 request.getParameter 就可以获取这两个参数的值; ★在注册页面中,出现了多个复选框 复选框的名称都是 channel, 在注册提交页面中使用getParameterValues(“channel”) 方法就可以获取一个字符串数组,该数组中存储的是所有选中的复选框对应的值。如果没有选择任何选项,请求中不包含名为channel的参数. 则该方法返回null; ★request 对象的 setCharacterEncodlrig ( ) 方法用于设置字符集,可以用来解决中文乱码问题,常用字符集编码有 ASCll 、ISO-8859-1 、GB2312、GBK、Unicode、UTF-8等,java在其内部使用 Unicode字符集来表示字符,这样就存在 Unicode 字符集和本地字符集进行换的过程,左Web 应用中, 通常都包括了浏览器、Web 服务器、Web 应用程序和数据库等部分,每一部分都有可能使用不同的字符集,从而导致字符数据在各种不同的字符集之间转换时,出现乱码的问题; ●乱码可能的原因: 1、JSP页面本身的编码: ★pageEncoding:页面本身的编码; ★浏览器渲染页面时采用的编码格式; ★一旦制定了一种编码格式,另一种编码格式如果不进行指定的话,默认都采用已经指定的编码格式; 2、浏览器渲染页面采用的编码 3、服务器保存数据采用的编码(request)
|
4、JSP内置对象response:
●与request对象相对应的是response对象,response对象用于响应客户请求并向客户端输出信息;
●工作原理:
●response对象常用的方法:
addCookie(Cookie cookie) |
向客户端添加Cookie; |
setContentType(String type) |
设置HTTP响应的contentType类型 |
setCharacterEncoding(String charset) |
设置响应所采用字符编码类型 |
sendRedirect(String location) |
将请求重新定位到一个新的URL上 |
◆最常用的方法:sendRedirect(String location):客户端将重新发送请求到指定的URL;
5、转发与重定向:
●转发:从程序运行的角度理解. 即当客户端发送一个请求到服务器后, Web 服务器在容器内部完成求跳转, 然后将最终的结果发送给浏览器,整个过程都是在容器内部完成的,而对应到客户端,无论服务器内部如何处理,作为浏览器都只是提交了一个请求,因而客户端的 URL 地址不会发生改变; ☆转发的实现很简单,使用 request 的 getRequestDispatcher ( ) 方法得到 RequestDispatcher 对象,此对象用于封装一个由路径所标识的服务器资源,然后用这个对象调用 forward )方法,将请求传递服务器上另外的 JSP 页面或者 HTML 文件; ☆转发可以在多个页面交互过程中实现请求数据的共享; |
||||||
●重定向:当用户登录成功后. 使用的是 response 对象的 sendRedirect ( ) 方法。 那么该方法行的结果是客户端重新向服务器请求一个地址链接,由于是发送新的请求 , 因而上次请求中的数将随之丢失 这种行为称为重定向。由于服务器重新定向了URL, 因而在客户端浏览器中显示的新的 URL 地址, 所以重定向可以理解为浏览器至少提交了两次请求 |
||||||
●转发和重定向有什么区别:转发和重定向都能够实现页面的跳转,不同之处表现在以下几方面: ◆转发过程:Web 服务器内部将一个 request 请求的处理权交给另外一个资源,属于同一个访问请求和响应过程,所以 request对象的信息不会丢失, ★转发是在服务器端发挥作用,通过 RequestDispatcher 对象的forward( ) 方法将交信息在多个页面间进行传递; ★转发是在服务器内部控制权的转移 , 客户端浏览器的地址栏不会显示出转向的地址。 ◆重定向过程:Web 服务器向浏览器返回一个响应,浏览器接受此响应后再发一个新的 http请求到服务器,这属于两次不同的请求, 则上一次请求的 request信息将丢失; ★重定向是在客户端发挥作用,通过请求新的地址实现页面转向。其通过浏览器重新请求地址,在地址栏中可以显示转向后的地址。 |
||||||
●如果需要在重定向的情况下将简单数据(值类型、字符串)传递到目标页面;也以使用查询字符串(Query String)实现: response.sendRedirect(“welcome.jsp?username=”+name”); 查询字符串以名值对方式 存储数据,通过“?”连接在URL的后面,多个名值对可以使用“&”进行分隔; ●查询字符串的应用:
|
6、JSP 内置对象 session:
●会话:
session:原义是指有始有终的一系列动作; eg:打电话时,甲方拿起电话拨通乙方电话这一系列的过程就可以称为一个会话,电话挂断时会话结束; |
★对Web开发来说,一个会话就是在一段时间内一个用户与 Web 服务器的一连串相关的交互过程,它可包含浏览器与服务器之间的多次请求,响应过程:在一次会话中,用户可能会多次请求访问一网页,也有可能请求访问同一个服务器的其他资源; |
▲下图描述了浏览器与服务器的一个会话过程:
★会话机制是一种服务器端的机制,当用户向服务器发出第一次请求时,服务器会为该用户创建唯一的会话,会话将一直延续到用户访问结束; ★当服务器接收到客户端的请求时,服务器首先会判断是否已经创建了与该客户端对应的会话,如果已经创建就将该请求与此会话相关联,如果没有包建,则会创建一个新会话,此客户端之后发送的请求将关联到该会话; ★而服务器判断是否创建了相关会话,是通过一个唯一的标识 sessionid来实现的。如果在客户端请求中包含了一个sessionid,则说明在此前已经为客户端创建了会话,服务器就会根据这个 sessionid将对应的会话对象读取出来;否则就会创建一个新的会话对象并生成一个 sessionid,并将 sessionid在本次晌应的过程返回客户端保存; |
★sessionid会返回客户端,那么在客户端 sessionid 会保存在什么位置? 回答:在客户端保存用户信息使用的是 cookie, 因此保存 sessionid 的方式也是使cookoe来实现的,在客户端的 cookie 中,保存 sessionid 的名称是 JSESSIONID, segsionid 的值是由一串复杂字符串组成的; eg:JSESSIONID=2A 11D30C7B32329D7C8BF16DC598C509 , 其中等号后面的字符串就是分配的 scssionid 对应的值; |
7、 session对象:
●session 对象作为JSP提供的内置对象之一 , session 对象允许用户访问会话的相关信息,以及绑定数据到话(在服务器端使用类似于哈希表的结构来保存信息)。绑定到会话的数据可以在多次请求之间持续有效;
◆ session对象的常用方法:
方法名称 |
说明 |
String getId() |
获取sessionid |
void setMaxInactiveInterval(int interval) |
设定session的非活动时间 |
int getMaxInactiveInterval() |
获取session的有效非活动时间(以秒为单位) |
void invalidate() |
设置session对象失效 |
void setAttribute(String key, Object value) |
以key/value的形式将对象保存对到session中 |
Object getAttribute(String key) |
通过key获取session中保存的对象值 |
void removeAttribute(String key) |
从session中删除指定名称(key)所对应的对象 |
●session与窗口的关系:
◆每个session对象都与一个浏览器窗口对应 ,重新开启一个浏览器窗口,可以重新创建一个session对象(不同版本浏览器可能有所差别)
◆通过超链接打开的新窗口,新窗口的session与其父窗口的session相同
8、使用 session 对象实现权限控制:
eg:用户通过登录页面登网站, 如果该用户是已注册用户 . 系统会保存该用户的登录信息. 并让用户进入其欲访问的页面;
用户直接访问网站的某个页面. 系统会查询是否保存有该用户的登录信息,如果有则显示该页面的内容;如果没有,则转入登录页面. 要求用户登录网站
●这里要实现的权限访问控制是基于 session 对象来完成的。
eg:使用 session 为新闻发布系增加访问控制,要求新闻发布系统中所有针对新闻的操作,如发布新闻、 修改新闻 、发布新闻标题、 修改新闻标题,都只能由管理员才能完成。普通用户没有权限进行访问,访问控制流程如图:
★根据新闻发布系统的访问控制流程,实现访问控制的流程如下:
1、在登陆页面输入用户名和密码; 2、在登陆处理页面进行登陆验证; 3、在会话中,保存用户信息,如果用户登录成功,则跳转到管理员页面; 4、在管理员页面读取会话中的用户信息,并进行校验; 5、验证失败,返回登陆页面; |
|
eg:登陆处理页面jsp的代码: <%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%> <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <title>登录处理页面</title> </head> <body> <% request.setCharacterEncoding("UTF-8"); //获取请求数据,并去除空格 String name = request.getParameter("userName").trim(); String pwd = request.getParameter("pwd").trim(); boolean valid = false; //判断用户验证是否成功 if("admin".equals(name)&&"admin".equals(pwd)){ valid = true; //设置用户登录信息 session.setAttribute("login", name); //设置session过期时间 session.setMaxInactiveInterval(10*60); } if (valid) { request.getRequestDispatcher("admin.jsp") .forward(request,response); } else { response.sendRedirect("index.jsp"); } %> </body> </html> 分析:接下来在管理员操作页面加入登录验证。此时要完成的任务是,从 session 中提取用户的信息,如果用户信息存在,则可以进行操作; 如果用户信息不存在 . 则跳转到登录页面。这一步实现了问的控制;
eg:在管理员界面加入如下代码: <%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%> <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <head> <title>管理员</title> </head> <body> <% String login = (String) session.getAttribute("login"); if (login == null){ response.sendRedirect("index.jsp"); return; } %> 您好,欢迎您! </body> </html> 分析:在登录处理页面中,已经实现了对用户的身份验证,为什么在此处还要再进验证。原因很简单.,如果用户不通过登录方式,而是直接在浏览器地址栏中输入管理员页面的地址这样将会直接绕过登录限制而访问成功。 所以需要在管理员操作界面再添加控制语句,以避免此情况的发生。 |
|
◆至此:此示例的访问控制已经基本实现了; ▲验证访问控制效果的具体步骤如下: 1、直接在浏览器地址栏中输入URL,访问管理员操作页面; 2、通过登录页面进入管理员操作页面; 3、重新开启一个浏览器窗口,直接访问管理员操作页面; |
|
◆按照以上步骤运行,观察每个步骤会发生什么样的结果 , 并思考为什么会产生这样的结果。下面对此进行分析: ☉如釆直接在浏览器地址栏中输入管理员操作页面的 URL, 系统会跳入登录页面 , 提示用户进行登录。 这个原因很简单,因为我们在管理员操作页面中加入了访问控制,只有正确登陆后,进入管理员操作界面,会话中才会存储用户登录成功的状态信息,才可以正常访问管理员操作页面; ☉如果重新开启一个浏览器窗口,直接访问管理员操作页面,不管在其他窗口中是否登陆,所进入的肯定是登录页面,这是我们经常遇到的问题,即 session 与浏器窗口的关系 ; ☉每个 session 对象都与浏览器一一对应,也就是说,重新开启一个浏览器窗口,相当于新创建一个 scssion 对象。但是需要注意的是,由于浏览器或版本不同,即使重新开启个浏览器窗口,也会认为是同一个 session 对象,也就是所谓的出现会话共享问题; ☆以 IE8为例,可以在浏览器上执行 "文件” — "新建会话’ 命令新建一个会话窗口。 ☆另外,提供两种取消浏览器窗口共享 session 的办法: 1、修改 IE8 的快捷方式:右击 IE8快捷方式图标,在弹出 的快捷菜单中选择 ’属性" —“ 目 标’ 选项, 末尾添加 “- nomerge",修改后如"C:\Program Files\Itemet Explorer\iexplorc.exe" -nomerge; 2、使用命令参数 "iexpldre.exe -nomerge' 打开IE ☉现在就可解释为什么在登录成功后,重新开启一个浏览器窗口直接访问管理员操作页即可进入登录页面了,在其他浏览器窗口中保存的登录信息与新的浏览器窗口完全无关,所以系统会判定尚未登录,跳转进入登录页面; |
9、会话的失效:
●会话也是有时效的,使会话失效的方式有两种: 一种是会话超时;另一种是手动调用方法设置失效; ●会话超时是指两次请求的时间间隔超过了服务器允许的最大时间间隔; |
●会话的超时间隔可通过三种方法设置: |
◆通过 session 对象的setMaxInactiveInterval( )方法设置,单位是秒; <% session.setAttribute("login","admin"); //参数 600 的单位是秒, 表示在 10 分钟后 session对象失效; session.setMaxInactiveInterval(600); response.sendRedirect("admin.jsp"); %> ◆在项目的web.xml中设置,单位是分钟,设置为0或负数,表示永不超时; <session-config> <session-timeout>10</session-timeout> </session-config> ◆在应用服务器中设置,在 Tomcat目录下的/conf/web.xml文件中找到<sesston-config>元素, 其中<sesston-config>元素中的 30 就是默认的时间,单位是分钟,可以修改其值; ◆项目A:web.xml,Tomcat:web.xml; ★Tomcat:web.xml:全局配置,项目A:web.xml:针对项目的配置;如果有重复的选项,调用项目A的web.xml; ★项目调用的是:项目A:web.xml + Tomcat:web.xml; ★修改Tomcat:web.xml对所有的项目都有影响; ☉动调用方法设置失效是通过调用 session 对象的 invalidate()方法实现的, 主要应用于用户注销的场合,但如果只想清空会话中绑定的某个数据对象,则可以调用 session . removeAttribute (String key)方法,将指定的对象从会话中清除,而会话仍然有效; |
10、 include指令:
●文件引用指令include,将一些可以重用的内客写入一个单独的文件,然后通过 include 指令引用该文件 , 从而缓解代码的冗余问題, 并且修改时也更方便;
●include 指令的基本语法:以<%@ 开始,以 %> 结束。
语法:<%@ include file="应用文件路径 " %>
● Include 指令表示,在 JSP 编译时插入一个包含文本或代码的文件,这个包含的过程是静态的,包含的文件可以是 JSP 页面、HTML 网页、文本文件等。
●include 指令只有一个 fi1e 属性 , 表示被包含的文件路径;
11、状态码:
状态码 |
含义 |
100 |
客户端应当继续发送请求。这个临时响应是用来通知客户端它的部分请求已经被服务器接收,且仍未被拒绝。客户端应当继续发送请求的剩余部分,或者如果请求已经完成,忽略这个响应。服务器必须在请求完成后向客户端发送一个最终响应。 |
101 |
服务器已经理解了客户端的请求,并将通过Upgrade消息头通知客户端采用不同的协议来完成这个请求。在发送完这个响应最后的空行后,服务器将会切换到在Upgrade消息头中定义的那些协议。 只有在切换新的协议更有好处的时候才应该采取类似措施。例如,切换到新的HTTP版本比旧版本更有优势,或者切换到一个实时且同步的协议以传送利用此类特性的资源。 |
102 |
由WebDAV(RFC 2518)扩展的状态码,代表处理将被继续执行。 |
200 |
请求已成功,请求所希望的响应头或数据体将随此响应返回。 |
201 |
请求已经被实现,而且有一个新的资源已经依据请求的需要而建立,且其URI已经随Location头信息返回。假如需要的资源无法及时建立的话,应当返回'202 Accepted'。 |
202 |
服务器已接受请求,但尚未处理。正如它可能被拒绝一样,最终该请求可能会也可能不会被执行。在异步操作的场合下,没有比发送这个状态码更方便的做法了。 返回202状态码的响应的目的是允许服务器接受其他过程的请求(例如某个每天只执行一次的基于批处理的操作),而不必让客户端一直保持与服务器的连接直到批处理操作全部完成。在接受请求处理并返回202状态码的响应应当在返回的实体中包含一些指示处理当前状态的信息,以及指向处理状态监视器或状态预测的指针,以便用户能够估计操作是否已经完成。 |
203 |
服务器已成功处理了请求,但返回的实体头部元信息不是在原始服务器上有效的确定集合,而是来自本地或者第三方的拷贝。当前的信息可能是原始版本的子集或者超集。例如,包含资源的元数据可能导致原始服务器知道元信息的超级。使用此状态码不是必须的,而且只有在响应不使用此状态码便会返回200 OK的情况下才是合适的。 |
204 |
服务器成功处理了请求,但不需要返回任何实体内容,并且希望返回更新了的元信息。响应可能通过实体头部的形式,返回新的或更新后的元信息。如果存在这些头部信息,则应当与所请求的变量相呼应。 如果客户端是浏览器的话,那么用户浏览器应保留发送了该请求的页面,而不产生任何文档视图上的变化,即使按照规范新的或更新后的元信息应当被应用到用户浏览器活动视图中的文档。 由于204响应被禁止包含任何消息体,因此它始终以消息头后的第一个空行结尾。 |
205 |
服务器成功处理了请求,且没有返回任何内容。但是与204响应不同,返回此状态码的响应要求请求者重置文档视图。该响应主要是被用于接受用户输入后,立即重置表单,以便用户能够轻松地开始另一次输入。 与204响应一样,该响应也被禁止包含任何消息体,且以消息头后的第一个空行结束。 |
206 |
服务器已经成功处理了部分GET请求。类似于FlashGet或者迅雷这类的HTTP下载工具都是使用此类响应实现断点续传或者将一个大文档分解为多个下载段同时下载。 该请求必须包含Range头信息来指示客户端希望得到的内容范围,并且可能包含If-Range来作为请求条件。 响应必须包含如下的头部域: Content-Range用以指示本次响应中返回的内容的范围;如果是Content-Type为multipart/byteranges的多段下载,则每一multipart段中都应包含Content-Range域用以指示本段的内容范围。假如响应中包含Content-Length,那么它的数值必须匹配它返回的内容范围的真实字节数。 Date ETag和/或Content-Location,假如同样的请求本应该返回200响应。 Expires,Cache-Control,和/或Vary,假如其值可能与之前相同变量的其他响应对应的值不同的话。 假如本响应请求使用了If-Range强缓存验证,那么本次响应不应该包含其他实体头;假如本响应的请求使用了If-Range弱缓存验证,那么本次响应禁止包含其他实体头;这避免了缓存的实体内容和更新了的实体头信息之间的不一致。否则,本响应就应当包含所有本应该返回200响应中应当返回的所有实体头部域。 假如ETag或Last-Modified头部不能精确匹配的话,则客户端缓存应禁止将206响应返回的内容与之前任何缓存过的内容组合在一起。 任何不支持Range以及Content-Range头的缓存都禁止缓存206响应返回的内容。 |
207 |
由WebDAV(RFC 2518)扩展的状态码,代表之后的消息体将是一个XML消息,并且可能依照之前子请求数量的不同,包含一系列独立的响应代码。 |
300 |
被请求的资源有一系列可供选择的回馈信息,每个都有自己特定的地址和浏览器驱动的商议信息。用户或浏览器能够自行选择一个首选的地址进行重定向。 除非这是一个HEAD请求,否则该响应应当包括一个资源特性及地址的列表的实体,以便用户或浏览器从中选择最合适的重定向地址。这个实体的格式由Content-Type定义的格式所决定。浏览器可能根据响应的格式以及浏览器自身能力,自动作出最合适的选择。当然,RFC 2616规范并没有规定这样的自动选择该如何进行。 如果服务器本身已经有了首选的回馈选择,那么在Location中应当指明这个回馈的URI;浏览器可能会将这个Location值作为自动重定向的地址。此外,除非额外指定,否则这个响应也是可缓存的。 |
301 |
被请求的资源已永久移动到新位置,并且将来任何对此资源的引用都应该使用本响应返回的若干个URI之一。如果可能,拥有链接编辑功能的客户端应当自动把请求的地址修改为从服务器反馈回来的地址。除非额外指定,否则这个响应也是可缓存的。 新的永久性的URI应当在响应的Location域中返回。除非这是一个HEAD请求,否则响应的实体中应当包含指向新的URI的超链接及简短说明。 如果这不是一个GET或者HEAD请求,因此浏览器禁止自动进行重定向,除非得到用户的确认,因为请求的条件可能因此发生变化。 注意:对于某些使用HTTP/1.0协议的浏览器,当它们发送的POST请求得到了一个301响应的话,接下来的重定向请求将会变成GET方式。 |
302 |
请求的资源现在临时从不同的URI响应请求。由于这样的重定向是临时的,客户端应当继续向原有地址发送以后的请求。只有在Cache-Control或Expires中进行了指定的情况下,这个响应才是可缓存的。 新的临时性的URI应当在响应的Location域中返回。除非这是一个HEAD请求,否则响应的实体中应当包含指向新的URI的超链接及简短说明。 如果这不是一个GET或者HEAD请求,那么浏览器禁止自动进行重定向,除非得到用户的确认,因为请求的条件可能因此发生变化。 注意:虽然RFC 1945和RFC 2068规范不允许客户端在重定向时改变请求的方法,但是很多现存的浏览器将302响应视作为303响应,并且使用GET方式访问在Location中规定的URI,而无视原先请求的方法。状态码303和307被添加了进来,用以明确服务器期待客户端进行何种反应。 |
303 |
对应当前请求的响应可以在另一个URI上被找到,而且客户端应当采用GET的方式访问那个资源。这个方法的存在主要是为了允许由脚本激活的POST请求输出重定向到一个新的资源。这个新的URI不是原始资源的替代引用。同时,303响应禁止被缓存。当然,第二个请求(重定向)可能被缓存。 新的URI应当在响应的Location域中返回。除非这是一个HEAD请求,否则响应的实体中应当包含指向新的URI的超链接及简短说明。 注意:许多HTTP/1.1版以前的浏览器不能正确理解303状态。如果需要考虑与这些浏览器之间的互动,302状态码应该可以胜任,因为大多数的浏览器处理302响应时的方式恰恰就是上述规范要求客户端处理303响应时应当做的。 |
304 |
如果客户端发送了一个带条件的GET请求且该请求已被允许,而文档的内容(自上次访问以来或者根据请求的条件)并没有改变,则服务器应当返回这个状态码。304响应禁止包含消息体,因此始终以消息头后的第一个空行结尾。 该响应必须包含以下的头信息: Date,除非这个服务器没有时钟。假如没有时钟的服务器也遵守这些规则,那么代理服务器以及客户端可以自行将Date字段添加到接收到的响应头中去(正如RFC 2068中规定的一样),缓存机制将会正常工作。 ETag和/或Content-Location,假如同样的请求本应返回200响应。 Expires,Cache-Control,和/或Vary,假如其值可能与之前相同变量的其他响应对应的值不同的话。 假如本响应请求使用了强缓存验证,那么本次响应不应该包含其他实体头;否则(例如,某个带条件的GET请求使用了弱缓存验证),本次响应禁止包含其他实体头;这避免了缓存了的实体内容和更新了的实体头信息之间的不一致。 假如某个304响应指明了当前某个实体没有缓存,那么缓存系统必须忽视这个响应,并且重复发送不包含限制条件的请求。 假如接收到一个要求更新某个缓存条目的304响应,那么缓存系统必须更新整个条目以反映所有在响应中被更新的字段的值。 |
305 |
被请求的资源必须通过指定的代理才能被访问。Location域中将给出指定的代理所在的URI信息,接收者需要重复发送一个单独的请求,通过这个代理才能访问相应资源。只有原始服务器才能建立305响应。 注意:RFC 2068中没有明确305响应是为了重定向一个单独的请求,而且只能被原始服务器建立。忽视这些限制可能导致严重的安全后果。 |
306 |
在最新版的规范中,306状态码已经不再被使用。 |
307 |
请求的资源现在临时从不同的URI响应请求。由于这样的重定向是临时的,客户端应当继续向原有地址发送以后的请求。只有在Cache-Control或Expires中进行了指定的情况下,这个响应才是可缓存的。 新的临时性的URI应当在响应的Location域中返回。除非这是一个HEAD请求,否则响应的实体中应当包含指向新的URI的超链接及简短说明。因为部分浏览器不能识别307响应,因此需要添加上述必要信息以便用户能够理解并向新的URI发出访问请求。 如果这不是一个GET或者HEAD请求,那么浏览器禁止自动进行重定向,除非得到用户的确认,因为请求的条件可能因此发生变化。 |
400 |
1、语义有误,当前请求无法被服务器理解。除非进行修改,否则客户端不应该重复提交这个请求。 2、请求参数有误。 |
401 |
当前请求需要用户验证。该响应必须包含一个适用于被请求资源的WWW-Authenticate信息头用以询问用户信息。客户端可以重复提交一个包含恰当的Authorization头信息的请求。如果当前请求已经包含了Authorization证书,那么401响应代表着服务器验证已经拒绝了那些证书。如果401响应包含了与前一个响应相同的身份验证询问,且浏览器已经至少尝试了一次验证,那么浏览器应当向用户展示响应中包含的实体信息,因为这个实体信息中可能包含了相关诊断信息。参见RFC 2617。 |
402 |
该状态码是为了将来可能的需求而预留的。 |
403 |
服务器已经理解请求,但是拒绝执行它。与401响应不同的是,身份验证并不能提供任何帮助,而且这个请求也不应该被重复提交。如果这不是一个HEAD请求,而且服务器希望能够讲清楚为何请求不能被执行,那么就应该在实体内描述拒绝的原因。当然服务器也可以返回一个404响应,假如它不希望让客户端获得任何信息。 |
404 |
请求失败,请求所希望得到的资源未被在服务器上发现。没有信息能够告诉用户这个状况到底是暂时的还是永久的。假如服务器知道情况的话,应当使用410状态码来告知旧资源因为某些内部的配置机制问题,已经永久的不可用,而且没有任何可以跳转的地址。404这个状态码被广泛应用于当服务器不想揭示到底为何请求被拒绝或者没有其他适合的响应可用的情况下。 |
405 |
请求行中指定的请求方法不能被用于请求相应的资源。该响应必须返回一个Allow头信息用以表示出当前资源能够接受的请求方法的列表。 鉴于PUT,DELETE方法会对服务器上的资源进行写操作,因而绝大部分的网页服务器都不支持或者在默认配置下不允许上述请求方法,对于此类请求均会返回405错误。 |
406 |
请求的资源的内容特性无法满足请求头中的条件,因而无法生成响应实体。 除非这是一个HEAD请求,否则该响应就应当返回一个包含可以让用户或者浏览器从中选择最合适的实体特性以及地址列表的实体。实体的格式由Content-Type头中定义的媒体类型决定。浏览器可以根据格式及自身能力自行作出最佳选择。但是,规范中并没有定义任何作出此类自动选择的标准。 |
407 |
与401响应类似,只不过客户端必须在代理服务器上进行身份验证。代理服务器必须返回一个Proxy-Authenticate用以进行身份询问。客户端可以返回一个Proxy-Authorization信息头用以验证。参见RFC 2617。 |
408 |
请求超时。客户端没有在服务器预备等待的时间内完成一个请求的发送。客户端可以随时再次提交这一请求而无需进行任何更改。 |
409 |
由于和被请求的资源的当前状态之间存在冲突,请求无法完成。这个代码只允许用在这样的情况下才能被使用:用户被认为能够解决冲突,并且会重新提交新的请求。该响应应当包含足够的信息以便用户发现冲突的源头。 冲突通常发生于对PUT请求的处理中。例如,在采用版本检查的环境下,某次PUT提交的对特定资源的修改请求所附带的版本信息与之前的某个(第三方)请求向冲突,那么此时服务器就应该返回一个409错误,告知用户请求无法完成。此时,响应实体中很可能会包含两个冲突版本之间的差异比较,以便用户重新提交归并以后的新版本。 |
410 |
被请求的资源在服务器上已经不再可用,而且没有任何已知的转发地址。这样的状况应当被认为是永久性的。如果可能,拥有链接编辑功能的客户端应当在获得用户许可后删除所有指向这个地址的引用。如果服务器不知道或者无法确定这个状况是否是永久的,那么就应该使用404状态码。除非额外说明,否则这个响应是可缓存的。 410响应的目的主要是帮助网站管理员维护网站,通知用户该资源已经不再可用,并且服务器拥有者希望所有指向这个资源的远端连接也被删除。这类事件在限时、增值服务中很普遍。同样,410响应也被用于通知客户端在当前服务器站点上,原本属于某个个人的资源已经不再可用。当然,是否需要把所有永久不可用的资源标记为'410 Gone',以及是否需要保持此标记多长时间,完全取决于服务器拥有者。 |
411 |
服务器拒绝在没有定义Content-Length头的情况下接受请求。在添加了表明请求消息体长度的有效Content-Length头之后,客户端可以再次提交该请求。 |
412 |
服务器在验证在请求的头字段中给出先决条件时,没能满足其中的一个或多个。这个状态码允许客户端在获取资源时在请求的元信息(请求头字段数据)中设置先决条件,以此避免该请求方法被应用到其希望的内容以外的资源上。 |
413 |
服务器拒绝处理当前请求,因为该请求提交的实体数据大小超过了服务器愿意或者能够处理的范围。此种情况下,服务器可以关闭连接以免客户端继续发送此请求。 如果这个状况是临时的,服务器应当返回一个Retry-After的响应头,以告知客户端可以在多少时间以后重新尝试。 |
414 |
请求的URI长度超过了服务器能够解释的长度,因此服务器拒绝对该请求提供服务。这比较少见,通常的情况包括: 本应使用POST方法的表单提交变成了GET方法,导致查询字符串(Query String)过长。 重定向URI“黑洞”,例如每次重定向把旧的URI作为新的URI的一部分,导致在若干次重定向后URI超长。 客户端正在尝试利用某些服务器中存在的安全漏洞攻击服务器。这类服务器使用固定长度的缓冲读取或操作请求的URI,当GET后的参数超过某个数值后,可能会产生缓冲区溢出,导致任意代码被执行[1]。没有此类漏洞的服务器,应当返回414状态码。 |
415 |
对于当前请求的方法和所请求的资源,请求中提交的实体并不是服务器中所支持的格式,因此请求被拒绝。 |
416 |
如果请求中包含了Range请求头,并且Range中指定的任何数据范围都与当前资源的可用范围不重合,同时请求中又没有定义If-Range请求头,那么服务器就应当返回416状态码。 假如Range使用的是字节范围,那么这种情况就是指请求指定的所有数据范围的首字节位置都超过了当前资源的长度。服务器也应当在返回416状态码的同时,包含一个Content-Range实体头,用以指明当前资源的长度。这个响应也被禁止使用multipart/byteranges作为其Content-Type。 |
417 |
在请求头Expect中指定的预期内容无法被服务器满足,或者这个服务器是一个代理服务器,它有明显的证据证明在当前路由的下一个节点上,Expect的内容无法被满足。 |
421 |
从当前客户端所在的IP地址到服务器的连接数超过了服务器许可的最大范围。通常,这里的IP地址指的是从服务器上看到的客户端地址(比如用户的网关或者代理服务器地址)。在这种情况下,连接数的计算可能涉及到不止一个终端用户。 |
422 |
从当前客户端所在的IP地址到服务器的连接数超过了服务器许可的最大范围。通常,这里的IP地址指的是从服务器上看到的客户端地址(比如用户的网关或者代理服务器地址)。在这种情况下,连接数的计算可能涉及到不止一个终端用户。 |
422 |
请求格式正确,但是由于含有语义错误,无法响应。(RFC 4918 WebDAV)423 Locked 当前资源被锁定。(RFC 4918 WebDAV) |
424 |
由于之前的某个请求发生的错误,导致当前请求失败,例如PROPPATCH。(RFC 4918 WebDAV) |
425 |
在WebDav Advanced Collections草案中定义,但是未出现在《WebDAV顺序集协议》(RFC 3658)中。 |
426 |
客户端应当切换到TLS/1.0。(RFC 2817) |
449 |
由微软扩展,代表请求应当在执行完适当的操作后进行重试。 |
500 |
服务器遇到了一个未曾预料的状况,导致了它无法完成对请求的处理。一般来说,这个问题都会在服务器的程序码出错时出现。 |
501 |
服务器不支持当前请求所需要的某个功能。当服务器无法识别请求的方法,并且无法支持其对任何资源的请求。 |
502 |
作为网关或者代理工作的服务器尝试执行请求时,从上游服务器接收到无效的响应。 |
503 |
由于临时的服务器维护或者过载,服务器当前无法处理请求。这个状况是临时的,并且将在一段时间以后恢复。如果能够预计延迟时间,那么响应中可以包含一个Retry-After头用以标明这个延迟时间。如果没有给出这个Retry-After信息,那么客户端应当以处理500响应的方式处理它。 注意:503状态码的存在并不意味着服务器在过载的时候必须使用它。某些服务器只不过是希望拒绝客户端的连接。 |
504 |
作为网关或者代理工作的服务器尝试执行请求时,未能及时从上游服务器(URI标识出的服务器,例如HTTP、FTP、LDAP)或者辅助服务器(例如DNS)收到响应。 注意:某些代理服务器在DNS查询超时时会返回400或者500错误 |
505 |
服务器不支持,或者拒绝支持在请求中使用的HTTP版本。这暗示着服务器不能或不愿使用与客户端相同的版本。响应中应当包含一个描述了为何版本不被支持以及服务器支持哪些协议的实体。 |
506 |
由《透明内容协商协议》(RFC 2295)扩展,代表服务器存在内部配置错误:被请求的协商变元资源被配置为在透明内容协商中使用自己,因此在一个协商处理中不是一个合适的重点。 |
507 |
服务器无法存储完成请求所必须的内容。这个状况被认为是临时的。WebDAV(RFC 4918) |
509 |
服务器达到带宽限制。这不是一个官方的状态码,但是仍被广泛使用。 |
510 |
获取资源所需要的策略并没有没满足。(RFC 2774) |