快捷導(dǎo)航

SpringBoot注冊Servlet的三種方法詳解

更新時間：2019年05月07日 10:44:53 作者：Java技術(shù)棧

這篇文章主要介紹了SpringBoot注冊Servlet的三種方法詳解，教你如何Spring Boot 注冊 Servlet、Filter、Listener，小編覺得挺不錯的，現(xiàn)在分享給大家，也給大家做個參考。一起跟隨小編過來看看吧

本文棧長教你如何在 Spring Boot 注冊 Servlet、Filter、Listener。

一、Spring Boot 注冊

Spring Boot 提供了 ServletRegistrationBean, FilterRegistrationBean, ServletListenerRegistrationBean 三個類分別用來注冊 Servlet, Filter, Listener，下面是 Servlet 的示例代碼。

import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;

/**
 * @author Java技術(shù)棧
 */
public class RegisterServlet extends HttpServlet {

  @Override
  protected void service(HttpServletRequest req, HttpServletResponse resp) throws IOException {
    String name = getServletConfig().getInitParameter("name");
    String sex = getServletConfig().getInitParameter("sex");

    resp.getOutputStream().println("name is " + name);
    resp.getOutputStream().println("sex is " + sex);
  }

}

@Bean
public ServletRegistrationBean registerServlet() {
  ServletRegistrationBean servletRegistrationBean = new ServletRegistrationBean(
      new RegisterServlet(), "/registerServlet");
  servletRegistrationBean.addInitParameter("name", "javastack");
  servletRegistrationBean.addInitParameter("sex", "man");
  return servletRegistrationBean;
}

二、組件掃描注冊

Servlet 3.0 之前，Servlet、Filter、Listener 這些組件都需要在 web.xml 中進行配置，3.0 之后開始不再需要 web.xml 這個配置文件了，所有的組件都可以通過代碼配置或者注解來達到目的。

如下圖所示，截圖自 Servlet 3.1。

Servlet 3.0 開始提供了這 3 個注解來代替。

@WebServlet => 代替 servlet 配置

@WebFilter => 代替 filter 配置

@WebListener => 代替 listener 配置

配置 Servlet 示例

import javax.servlet.annotation.WebInitParam;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;

/**
 * @author Java技術(shù)棧
 */
@WebServlet(name = "javaServlet", urlPatterns = "/javastack.cn", asyncSupported = true,
    initParams = {
    @WebInitParam(name = "name", value = "javastack"),
    @WebInitParam(name = "sex", value = "man") })
public class JavaServlet extends HttpServlet {

  @Override
  protected void service(HttpServletRequest req, HttpServletResponse resp) throws IOException {
    String name = getServletConfig().getInitParameter("name");
    String sex = getServletConfig().getInitParameter("sex");

    resp.getOutputStream().println("name is " + name);
    resp.getOutputStream().println("sex is " + sex);
  }

}

配置 Filter 示例

/**
 * @author Java技術(shù)棧
 */
@WebFilter(filterName = "javaFilter", urlPatterns = "/*", initParams = {
    @WebInitParam(name = "name", value = "javastack"),
    @WebInitParam(name = "code", value = "123456") })
public class JavaFilter implements Filter {

  @Override
  public void init(FilterConfig filterConfig) throws ServletException {
    System.out.println("java filter init.");
    String name = filterConfig.getInitParameter("name");
    String code = filterConfig.getInitParameter("code");
    System.out.println("name is " + name);
    System.out.println("code is " + code);
  }

  @Override
  public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
      throws IOException, ServletException {
    System.out.println("java filter processing.");
    chain.doFilter(request, response);
  }

  @Override
  public void destroy() {
    System.out.println("java filter destroy.");
  }

}

Listener 配置方式類似，上面的示例代碼一看就懂，這里不再詳述。

需要注意的是，為了安全考慮，內(nèi)嵌服務(wù)器不會直接執(zhí)行 Servlet 3.0 里面的 javax.servlet.ServletContainerInitializer 接口，或者 Spring 中的 org.springframework.web.WebApplicationInitializer 接口，否則會導(dǎo)致終止 Spring Boot 應(yīng)用。

所以，如果使用的是 Spring Boot 內(nèi)嵌服務(wù)器，需要在配置類上面添加額外的 @ServletComponentScan 注解來開啟 Servlet 組件掃描功能，如果使用的是獨立的服務(wù)器，則不需要添加，會使用服務(wù)器內(nèi)部的自動發(fā)現(xiàn)機制。

三、動態(tài)注冊

如果你想在 Spring Boot 中完成 Servlet、Filter、Listener 的初始化操作，你需要在 Spring 中實現(xiàn)下面這個接口，并注冊為一個 bean。

org.springframework.boot.web.servlet.ServletContextInitializer

ServletContext 提供了幾個動態(tài)注冊的方法，如下所示。

以下為動態(tài)添加 Servlet 示例代碼。

import javax.servlet.annotation.WebInitParam;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;

/**
 * @author Java技術(shù)棧
 */
@WebServlet(name = "javaServlet", urlPatterns = "/javastack.cn", asyncSupported = true,
    initParams = {
    @WebInitParam(name = "name", value = "javastack"),
    @WebInitParam(name = "sex", value = "man") })
public class JavaServlet extends HttpServlet {

  @Override
  protected void service(HttpServletRequest req, HttpServletResponse resp) throws IOException {
    String name = getServletConfig().getInitParameter("name");
    String sex = getServletConfig().getInitParameter("sex");

    resp.getOutputStream().println("name is " + name);
    resp.getOutputStream().println("sex is " + sex);
  }

}

import cn.javastack.springbootbestpractice.servlet.InitServlet;
import org.springframework.boot.web.servlet.ServletContextInitializer;
import org.springframework.stereotype.Component;

import javax.servlet.ServletContext;
import javax.servlet.ServletRegistration;

/**
 * @author Java技術(shù)棧
 */
@Component
public class ServletConfig implements ServletContextInitializer {

  @Override
  public void onStartup(ServletContext servletContext) {
    ServletRegistration initServlet = servletContext
        .addServlet("initServlet", InitServlet.class);
    initServlet.addMapping("/initServlet");
    initServlet.setInitParameter("name", "javastack");
    initServlet.setInitParameter("sex", "man");
  }

}

總結(jié)

本文介紹了在 Spring Boot 下的 3 種注冊 Servlet、Filter、Listener 的方式，大家靈活運用。

以上就是本文的全部內(nèi)容，希望對大家的學習有所幫助，也希望大家多多支持腳本之家。

您可能感興趣的文章: