Servlet API

 Servlet API的查询网址：通过Tomcat的官网链接找到

可见，Servlet API有4个packages

javax.servlet  // 包含定义Servlet和Servlet容器之间契约的类和接口
javax.servlet.http  // 包含定义Http Servlet和Servlet容器之间契约的类和接口
javax.servlet.annotation  // 包含标注Servlet、Filter、Listener标注的标注。
javax.servlet.description  // 包含提供程序化登录web应用程序的配置信息的类型。

Servlet接口

Servlet技术的核心是javax.servelt.Servlet接口，该接口是所有Servlet类必须直接或者间接实现的一个接口。

Servlet接口定义了Servlet与Servlet容器之间的契约，即Servlet容器将Servlet类载入内存，并在Servlet实例上调用具体的方法，在每个应用程序中，每种Servlet类型只能有一个实例。

 Servlet接口中定义了5个抽象方法

Servlet没有main()方法，所有的行为都由Servlet容器控制，调用Servlet方法时的参数也有Servlet容器传递。

ServletRequest接口

对于每一个HTTP请求，Servlet容器都会创建一个javax.servlet.ServletRequest实例，并将其传递给Servlet的service()方法。ServletRequest实例封装了这个HTTP请求的信息。

常用的方法有：

public int getContentlength()  // 获得请求主体的字节数
public String getContentType()  // 获取请求主体的MIME类型
public String getProtocol()  // 获得这个HTTP请求的协议名称和版本
public String getParameter(String name)  // 获取指定参数的值，通常用于返回HTML表单域的值或者查询字符串的值
public String getParameterNames()
public String getParameterMap()
public String getParameterValues()

ServletResponse接口

javax.servlet.ServletResponse接口表示一个Servlet响应。在调用Servlet的service()方法前，Servlet容器会首先创建一个ServletResponse实例，并将其作为第二个参数传递给service()，ServletResponse隐藏了向浏览器发送相应的复杂过程。

常用方法有：

public java.io.PrintWriter getWriter()  //  得到一个向客户端发送文本的PrintWriter实例。默认使用ISO-8895-1编码
public ServletOutputStream getOutputStream()  // 用于发送二进制数据的
pubic void setContentType(String type)  // 设置相应的内容类型，比如"text/html"表示内容类型为HTML

ServletConfig接口

ServletConfig实例对象可以封装通过注解（@WebServlet）或者部署描述符（web.xml文件）传递给Servlet的初始配置信息。

当Servlet容器初始化Servlet时，Servlet容器会向Servlet的init()方法传入一个ServletConfig实例对象。因此在Servlet内部可以通过调用ServletConfig的响应方法获得初始参数的值

通过注解或者部署描述符传入的每一条信息就叫做一个初始参数。每个初始参数由key和value两个元件组成。

该接口只有4个方法

使用ServletConfig在Servlet中获取初始参数的范例

package app01a;

import java.io.IOException;
import java.io.PrintWriter;

import javax.servlet.Servlet;
import javax.servlet.ServletConfig;
import javax.servlet.ServletException;
import javax.servlet.ServletRequest;
import javax.servlet.ServletResponse;
import javax.servlet.annotation.WebInitParam;
import javax.servlet.annotation.WebServlet;

@WebServlet(name = "ServletConfigDemoServlet", urlPatterns = { "/servletConfigDemo" },   //url映射
            initParams = { @WebInitParam(name = "admin", value = "harry Taciak"),  // 向Servlet中传入初始参数
                           @WebInitParam(name = "emial", value = "admin@example.com")  // 向Servlet中传入初始参数
                         }
           )
public class ServletConfigDemoServlet implements Servlet {
    private transient ServletConfig servletConfig;
    @Override
    public void destroy() {    }

    @Override
    public ServletConfig getServletConfig() {
        return this.servletConfig;
    }

    @Override
    public String getServletInfo() {
        return "servletConfig demo";
    }

    @Override
    public void init(ServletConfig servletConfig) throws ServletException {
        this.servletConfig = servletConfig;
    }

    @Override
    public void service(ServletRequest request, ServletResponse response) throws ServletException, IOException {
        ServletConfig servletConfig = getServletConfig();
        String admin = servletConfig.getInitParameter("admin");
        String email = servletConfig.getInitParameter("email");
        response.setContentType("text/html");
        PrintWriter writer = response.getWriter();
        writer.print("<html><head></head><body>" + 
                    "Admin: " + admin +
                    "<br/>Email: " + email +
                    "</body></html>");
    }
}
View Code

ServletContext接口

 ServletContext实例对象表示Servlet应用程序，每个Web应用程序只有一个上下文。

通过调用ServletConfig对象的getServletContext()方法，可以获得ServletContext实例对象。

ServletContext用于Web应用中的资源共享。有了ServletContext，就可以共享从应用程序中的所有资料出访问到的信息，并且可以动态注册Web对象。

ServletContext将Web对象保存在ServletContext中的一个内部Map中，保存在ServletContext中的对象称为属性。

GenericServlet抽象类

public abstract class GenericServlet
extends java.lang.Object
implements Servlet, ServletConfig, java.io.Serializable

GenericServlet抽象类实现了Servlet接口和ServletConfig接口。并完成了以下工作：

-- 将init()方法中的ServletConfig对象赋给一个类的成员变量，来保存ServletConfig，从而可以通过调用getServletConfig()获得ServletConfig对象。其实现代码如下：

public void init (ServletConfig servletConfig) throws ServletException {
    this.servletConfig = servletConfig;
    this.init();  // 这是 GenericServlet 提供的一个没有参数的init()方法，可以通过覆盖init()来提供初始化代码
}

-- 为Servlet接口中的除了service()方法外提供默认的实现

-- 提供方法，包围ServletConfig中的方法.

HttpServlet抽象类

public abstract class HttpServlet
extends GenericServlet

HttpServlet类覆写了GenericServlet类中的service()方法；同时还重载了另外一个service() 方法，二者的参数类型不同。

覆盖后的service()方法将Servlet容器的ServletRequest和ServletResponse对象分别转化成HttpServletRequest和HttpServletResponse对象，并调用新的service()方法。

public void service(ServletRequest req, ServletResponse resp) throws ServletException, IOException {
    HttpServletRequest request;
    HttpServletResponse response;
    try {
        request = (HttpServletRequest) req;  // 类型转换
        response = (HttpServletResponse) resp;  // 类型转换
    } catch (ClasscastException e) {
        throw new ServletException("non-Http request or response");
    }
    service(request, response);  // 调用新的service()方法
}

// 由于在调用Servlet的service()时，Servlet容器总会传入一个HttpServletRequest和一个HttpServletResponse，预备使用Http，因此这种转换总会成功。

然后，HttpServlet中的service()方法会检查用来发送请求的HTTP请求方法（通过调用HttpServletRequest的getMethod()方法获得），并根据HTTP方法调用相应的doGet()、doPost()、doHead()、doPut()、doTrace()、doOptions()、doDelete()中的一个。

因此不需要覆写service()方法了，只需要覆写相应的doXxx()即可，其中doGet()和doPost()最常用。

总之，HttpServlet有两个特性是GenericService()所不具备的

（1）不用覆写service()方法，而是覆写doGet()、doPost()、或者其他doXxx()方法

（2）使用HttpServletRequest和HttpServletResponse，而不是ServletRequest和ServletResponse。

HttpServletRequest接口

HttpServletRequest表示在HTTP环境中的ServletRequest。

public interface HttpServletRequest
extends ServletRequest

HttpServletResponse接口

HttpServletResponse表示在HTTP环境中的ServletResponse。

public interface HttpServletResponse
extends ServletResponse

 

posted on 2018-10-17 11:55  0820LL  阅读(200)  评论(0)  编辑  收藏  举报

导航