Servlet3.1规范阅读笔记摘要

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表单数据填充到参数集前必须满足的条件

  1. 该请求是一个HTTP请求或HTTPS请求
  2. HTTP的方法时POST
  3. 内容类型是application/x-www-form-urlencoded
  4. 该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-类型链过滤器
  • 缓存过滤器
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,772评论 6 477
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,458评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,610评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,640评论 1 276
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,657评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,590评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,962评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,631评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,870评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,611评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,704评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,386评论 4 319
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,969评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,944评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,179评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 44,742评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,440评论 2 342

推荐阅读更多精彩内容