Servlet & JSP - Servlet API Overview

时间:2022-03-15 01:46:34

Servlet & Generic & HttpServlet

类图

Servlet & JSP - Servlet API Overview

Servlet 的生命周期

init、service 和 destroy 是 servlet 的生命周期方法,它们的调用规则如下:

init: 当第一次请求 servlet 时,servlet 容器会调用此方法,而后面即使再接收到请求,容器也不会再调用此方法。因此,可以在 init 方法内做一些初始化的操作。当调用此方法时,容器会传递一个 ServletConfig 参数,可以使用一个类级别的变量将该参数保留。Servlet 不是单例的,但是 servlet 容器对每个 Servlet 类只会构造一个实例。

service: 当接收到请求时,servlet 容器调用此方法。

destory: 当 servlet 被销毁时,容器会调用此方法。这通常是 web 应用从 servlet 容器卸载或者 servlet 容器关闭的时候。可以在 destroy 方法做一些清理操作。

load-on-startup 参数

默认情况下,当 servlet 第一次接收到请求,servlet 容器才会去构造并初始化 servlet 实例。使用 load-on-startup 参数,可以指定容器启动时就加载 servlet。当初始化操作比较复杂,耗时长时,load-on-startup 参数特别有用。load-on-startup 是一个整型的参数,它指定了容器加载 servlet 的顺序。当取值小于 0 或没有指定时,servlet 容器可以选择在任意时候实例化 servlet。当取值大于或等于 0 时,值越小,servlet 容器越优先实例化 servlet。当 load-on-startup 取值一样,servlet 容器自行选择加载 servlet 的顺序。load-on-startup 参数不同通过 @WebServlet 注解指定,而只能 web.xml 中配置:

<servlet>
<servlet-name>myServlet</servlet-name>
<servlet-class>com.huey.hello.servlets.MyServlet</servlet-class>
<load-on-startup>1</load-on-startup>
</servlet>

ServletRequest & HttpServletRequest

ServletRequest(HttpServletRequest) 封装了一个(HTTP)请求。下面是 ServletRequest(HttpServletRequest)常用的方法:

getServletContext: 获取 servlet 上下文实例。

getSession: 获取会话实例。

getCookies: 获取 Cookie。

getHeader: 获取 HTTP 请求的首部。类似的方法还有 getIntHeader。还有一些获取特定首部的方法:getContentLength、getContentType 等。

getParameter: 获取表单和 URL 的请求参数。类似的方法还有 getParameterValues、getParameterNames 和 getParameterMap。

getAttribute: 获取请求的属性。

getRemoteAddr: 返回发送请求的客户端或最后一个代理的 IP 地址。

getRemoteHost: 返回发送请求的客户端或最后一个代理的完全限定名称。

getUserPrincipal: 返回当前已经验证过的用户的 java.security.Principal 对象。如果用户没有经过验证,则返回 null。

ServletResponse & HttpServletResponse

ServletResponse(HttpServletResponse) 封装了一个(HTTP)响应。下面是 ServletResponse(HttpServletResponse)常用的方法:

setContentType: 设置响应的内容。

addCookie: 将指定的 cookie 添加至响应。

addHeader: 将指定的首部添加至响应。

ServletConfig

在调用 servlet 的 init 方法时,servlet 容器会传递一个 ServletConfig 对象,ServletConfig 封装了 servlet 的配置信息。有两种方法可以配置 servlet 的初始参数。

在 web.xml 中配置 servlet 的初始参数:

<servlet>
<servlet-name>myServlet</servlet-name>
<servlet-class>com.huey.hello.servlets.MyServlet</servlet-class>
<init-param>
<param-name>user</param-name>
<param-value>huey</param-value>
</init-param>
</servlet>

使用 Servlet3.0,还可以通过 @WebServlet 配置初始参数:

@WebServlet(name = "myServlet", urlPatterns = {"/my"},
initParams = { @WebInitParam(name="user", value="huey")})
public class MyServlet extends HttpServlet {
// ...
}

getInitParameter、getInitParameterNames 等方法可以获取初始参数:

ServletConfig servletConfig = this.getServletConfig();
Enumeration<String> initParamNames = servletConfig.getInitParameterNames();
while (initParamNames.hasMoreElements()) {
String paramName = (String) initParamNames.nextElement();
resp.getWriter().println(paramName + ": " + servletConfig.getInitParameter(paramName));
}

ServletContext

ServletContent 表示的是 servlet 应用,每个 web 应用都只有一个上下文。在分布式环境,一个应用部署在多个容器中,则每个 JVM 有一个 ServletContext 对象。可以通过 servletConfig.getServletContext() 方法获取 ServletContext 对象。下面是 ServletContext 类常用的方法:

getInitParameter: 获取应用的初始参数。初始参数在 web.xml 中 <context-param> 元素指定。类似的方法还有 getInitParameterNames。

getAttribute: 获取应用的属性, 类似的方法还有 getAttributeNames。

setAttribute: 设置应用的属性。

removeAttribute: 删除应用的属性。

getContextPath: 返回 Web 应用程序的上下文路径。

getRealPath(String path): 为给定的虚拟路径返回服务器文件系统上的绝对文件路径。

getResource(String path): 返回指向映射到指定路径的资源的 URL。该路径必须以 "/" 开头,并相对于当前上下文根进行解释。

getResourceAsStream(String path): 类似 getResource,返回的是 InputStream 对象。