Servlet3.1规范(http://pan.baidu.com/s/1bozDtE3)
HTTP协议参数
servlet的请求参数以字符串的形式作为请求的一部分从客户端发送到servlet容器,当请求是一个HttpServletRequest对象,且符合“参数可用时”描述的条件时,容器从URI查询字符串和POST数据中填充参数。参数以一系列的名-值对的形式保存。任何给定的参数的名称可存在多个参数值。ServletRequest接口的下列方法可访问这些参数
- getParameter
- getParameterNames
- getParameterValues
- getParameterMap
getParameterValues方法返回一个String对象的数组,包含了与参数名称相关的所有参数值。getParameter方法的返回值必须是getParameterValues方法返回的String对象数组中的第一个值。getParameterMap方法返回请求参数的一个java.util.Map对象,其中以参数名称作为map键,参数值作为map值。
查询字符串和POST请求的数据被汇总到请求参数集合中。查询字符串数据在POST数据之前发送。例如,如果请求由查询字符串a=hello和POST数据包a=goodbye&a=world组成,得到的参数集合顺序将是(hello,goodbye,world)
这些API不会暴露GET请求(HTTP1.1所定义的)的路径参数。他们必须从getRequestURI方法或getPathInfo方法返回的字符串值中解析。
当参数可用时
以下是POST表单数据填充到参数集前必须满足的条件
- 该请求是一个HTTP请求或HTTPS请求
- HTTP的方法时POST
- 内容类型是application/x-www-form-urlencoded
- 该servlet已经对request对象的任意getParameter方法进行了初始调用
如果不满足这些条件,而且参数集中不包括POST表单数据,那么servlet必须可以通过request对象的输入流得到POST数据。如果满足这些条件,那么request对象的输入流中直接读取POST数据将不再有效。
属性
属性是与请求相关联的对象。属性可以有容器设置来表达信息,否则无法通过API表示,或者由servlet设置将信息传达给另一个servlet(通过RequestDispather)。属性通过ServletRequest接口中下面的方法来访问
- getAttribute
- getAttributeNames
- setAttribute
只有一个属性值可与一个属性名称想关联。
头
servlet可以通过HttpServletRequest接口的下面方法访问HTTP请求的头部信息
- getHeader
- getHeaders
- getHeaderNames
getHeader方法返回给定头名称的头。多个头可以具有相同的名称,例如HTTP请求中的Cache-Control头。如果多个头的名称相同,getHeader方法返回请求中的第一个头。getHeaders方法允许访问所有与特定头名称相关的头值,返回一个String对象的枚举。
头可包含由String形式的int或Data数据。HttpServletRequest接口提供如下方便的方法访问直接类型的头数据:
- getIntHeader
- getDataHeader
如果把getIntHeader方法不能转换为int的头值,则抛出NumberFormatException异常。如果getDateHeader方法不能把一个头转换成一个Data对象,则抛出IllegalArgumentException异常。
请求路径元素
引导servlet服务请求的请求路径由许多重要部分组成。以下元素从请求URI路径得到,并通过request对象公开:
- Context Path:与ServletContext相关的路径前缀是这个servlet的一部分。如果这个上下文是基于web服务器的URL命名空间基础上的默认上下文,那么这个路径将是一个空字符串。否则,如果上下文是基于服务器的命名空间,那么这个路径以/字符开始,但不以/字符结束。
- Servlet Path:路径部分直接与请求激活的映射对应。这个路径以"/"字符开头,如果请求与"/*"或""模式匹配,在这种情况下,它是一个空字符串。
- PathInfo:请求路径的一部分,不输入Context Path或Servlet Path。如果没有额外的路径,它要么是null,要么是以“/”开头的字符串。
使用HttpServletRequest接口中的下面方法来访问这些信息
- getContextPath
- getServletPath
- getPathInfo
重要的是要注意,除了请求URI和路径部分的URL编码差异外,下面的等式永远为真:
requestURI = contextPath + servletPath + pathInfo
路径转换方法
在API中有两个方便的方法,允许开发者获得与某个特定的路径等价的文件系统路径。这些方法是:
- SerletContext.getRealPath
- HttpServletRequest.getPathTranslated
getRealPath方法需要一个字符串参数,并返回一个字符串形式的路径,这个路径对应一个在本地文件系统上的文件。getPathTranslated方法推断出请求的pathInfo的实际路径(译者注:把URL中servlet名称之后,查询字符串之前的路径信息转化成实际的路径)。
这些方法在servlet容器无法确定一个有效的文件路径 的情况下,如Web应用程序从归档中,在不能访问本地的远程文件系统上,或在一个数据库中执行时,这些方法必须返回null。JAR文件中META-INF/resources目录下的资源,只有当调用getRealPath()方法时才认为容器已经从包含它的JAR文件中解压,在这种情况下,必须返回解压缩后位置。
Servlet Context
ServletContext接口介绍
ServletContext(Servlet上下文)接口定义了servlet运行在的Web应用的视图。容器供应商负责提供Servlet容器的ServletContext接口的实现。Servlet可以使用ServletContext对象记录事件,获取URL引用的资源,存取当前上下文的其他Servlet可以访问的属性。
ServletContext是Web服务器中已知路径的根。例如,Servlet 上下文可以从http://www.mycorp.com/catalog 找出,/catalog请求路径称为上下文路径,所有以它开头的请求都会被路由到与ServletContext 相关联的Web应用。
ServletContext接口作用范围
每一个部署到容器的Web应用都有一个Servlet接口的实例与之关联。在容器分布在多台虚拟机的情况下,每个JVM的每个Web应用将有一个ServletContext实例。
如果容器内的Servlet没有部署到Web应用中,则隐含的作为“默认”Web应用的一部分,并有一个默认的ServletContext。在分布式的容器中,默认的ServletContext是非分布式的且仅存在于一个JVM中。
初始化参数
如下ServletContext接口方法允许Servlet访问由应用开发人员在Web应用中的部署描述符中指定的上下文初始化参数:
- getInitParameter
- getInitParameterNames
应用开发人员使用初始化参数来表达配置信息。代表性的例子是一个Webmaster的e-mail地址,或保存关键数据的系统名称。
配置
从Servlet 3.0开始添加到ServletContext,以便启用编程方式定义Servlet、Filter和它们映射到的url模式(url pattern)。
上下文属性
Servlet可以使用指定的名字将对象属性绑定到上下文。同一个Web应用内的其他任何Servlet都可以使用绑定到上下文的任意属性。以下Servlet接口中的方法允许访问此功能:
- setAttribute
- getAttribute
- getAttributeNames
- removeAttribute
Response
响应对象封装了从服务器返回到客户端的所有信息。在HTTP协议中,从服务器传输到客户端的信息通过HTTP头信息或响应的消息体。
缓冲
Servlet容器允许但不必为了提高效率而缓冲到客户端的输出。典型的服务器默认都是缓冲的,但允许servlet指定缓冲参数。
ServletResponse接口的如下方法允许servlet访问和设置缓冲信息:
- getBufferSize
- setBufferSize
- isCommitted
- reset
- resetBuffer
- flushBuffer
头信息
Servlet可以使用如下HttpServletResponse接口中的方法设置HTTP响应头:
- setHeader
- addHeader
setHeader方法设置一个给定名字和值的header。之前的header将被新的header替换。如果已经存在同名的header值的set,set中的值会被清空并用新的值替换。
addHeader方法使用给定的名字添加一个header值到set。如果没有header与给定的名字关联,则创建一个新的set。
Header可能包含表示int或Date对象的数据。以下HttpServletResponse接口提供的便利方法允许Servlet对适当的数据类型用正确的格式设置一个header: - setIntHeader
- setDateHeader
- addIntHeader
- addDateHeader
为了成功的传回给客户端,header必须在响应提交前设置。响应提交后的Header设置将被servlet容器忽略。
Servlet程序员负责保证为Servlet生成的内容设置合适的response对象的Content-Type header。HTTP 1.1规范中没有要求在HTTP响应中设置此header。当Servlet程序员没有设置该类型时,Servlet容器也不能设置默认的内容类型。
Response的生命周期
每个响应对象是只有当在servlet的service方法的范围内或在filter的doFilter方法范围内是有效的,除非该组件关联的请求对象已经开启异步处理
过滤器
过滤器(Filter)是Java组件,允许运行过程中改变进入资源的请求和资源返回的响应中的有效负载和header信息。
什么是过滤器
过滤器是一种代码重用的技术,它可以改变HTTP请求的内容,响应,及header信息。过滤器通常不产生响应或像servlet那样对请求作出响应,而是修改或调整到资源的请求,修改或调整来自资源的响应。
过滤器可以作用于动态或静态内容。
供开发人员使用的过滤器功能有如下几种类型:
- 在执行请求之前访问资源。
- 在执行请求之前处理资源的请求。
- 用请求对象的自定义版本包装请求对请求的header和数据进行修改。
- 用响应对象的自定义版本包装响应对响应的header和数据进行修改。
- 拦截资源调用之后的调用。
- 作用在Servlet,一组Servlet,或静态内容上的零个,一个或多个拦截器按指定的顺序执行。
过滤器组件示例
- 验证过滤器
- 日志记录和审计过滤器
- 图像转换过滤器
- 数据压缩过滤器
- 加密过滤器
- 词法(Tokenizing)过滤器
- 触发资源访问事件过滤器
- 转换XML内容的XSL/T过滤器
- MIME-类型链过滤器
- 缓存过滤器