servlet specification笔记 I

   最近对开源框架的研究涉及不少原理性的东西，索性找来servlet2.5的specification，再次留下一点东西，方便以后回忆。

 

   首先，这个版本的规范已经不建议使用SingleThreadModel接口来实现多线程的操作。这个接口的意义在于要求容器保证一次仅有一个request线程传入service方法被其处理。

   servlet的生命周期包含： 装载和实例化， 初始化， 处理请求， 服务终止。

   在初始化过程中，一个servlet实力可能会抛出UnavailableException或者ServletException，在这种情况下，此servlet必须被容器释放终止而不划归入活动的服务中。destroy方法不会被调用，因为这会被认为是不成功的的初始化。

   而在处理请求过程中，servlet也可能会抛出这两个异常，ServletException表示容器应该采取适当措施来清理这个request，而UnavailableException表示servlet没有能力处理请求，暂时的或是永久的。UnavailableException可以表示永久性的服务不可用，或者是暂时性的服务不可用，在这两种情况下，容器分别会返回SC_NOT_FOUND(404),或者SC_SERVICE_UNAVAILABLE(503)。容器可以选择忽视这两种不同，直接取永久性为选择。

 

  第三章 请求

  1.HTTP Protocol Parameters是由客户端发送到servlet容器的一些字符串

         getParameter getParameterNames getParameterValues getParameterMap

 

  2.Attributes则是一个request中涉及的一些对象。getAttribute getAttributeNames setAttribute

It is suggested that all attributes placed in the attribute set be named in accordance with the reverse domain name convention suggested by the Java Programming Language Specification1 for package naming.

   3.Headers

        getHeader getHeaders getHeaderNames getIntHeader getDateHeader

   4.Request Path Elements  迫使一个servlet处理一个请求的请求路径由许多重要的片段组成。以下的元素师从request URI路径中获得，而通过request对象暴露出来的：

        Context Path 包含此Servlet的ServletContext所使用的前缀。若为空，则表示此上下文处于Web server‘s URL命名空间的根目录，若不是，此路径以'/'为起始，而不以它为结束。

        Servlet Path

        PathInfo 为空或者起始于'/'

   5.Path Translation Methods

      在API中有两个很方便的方法可以用来或者一个特殊path的对应的文件系统的path

      ServletContext.getRealPath  HttpServletRequest.getPathTranslated

      前者需要一个String返回一个String表示本地文件系统的文件路径，后者计算request中pathInfo的真实路径

      容器不能确定一颗有效地文件path的时候，比如application是从一个归档文件中执行，或是一个远程的文件或数据库的时候，需要返回null

    6.Cookies

      getCookies

    7.SSL Attributes

      如果request是有一个安全的protocol传输而来，比如HTTPS，此星系必须有ServletRequest接口的isSecure方法给暴露出来。容器需要提供给程序员如下的一些信息:

            cipher suite        javax.servlet.request.cipher_suite String

            bit size of the algorithm      javax.servlet.request.key_size    Integer

     同时，如果有SSL验证包含在request中，容器必须通过ServletRequest的javax.servlet,request,X509Certificate属性暴露给程序员， 此为一个类型为java.security.cert.X509Certificate的数组

    8.Internationalization

        客户选可以选择性地指示Web server他们希望response由何种语言提供。此信息包含在HTTP.1.1 specification所描述的Accept-Language header中。

        getLocale  getLocales此方法返回Enumertion， 以偏好的locale开始，之后为客户端可以接受的locales。如果没有偏好设置，则返回default，而enum中则只包含一个enum。

    9.Request data encoding

        现今，许多浏览器并不发送一个编码修饰符，char，在Content-Type header中，而使得此决定保持开放。这种情况下，getCharacterEncoding方法会返回null。     setCharacterEncoding(String enc) 此方法需要在解析数据之前被调用以覆盖字符编码策略。

    10.Lifetime of the Request Object

        任意request对象只在一个servlet的service方法或者一个filter的doFilter方法的域中保持合法。容器通常会回收重用request对象，以防止构建request对象的性能消耗。开发者必须明白在这些域外维护队request对象的引用会造成不可预知的结果