Spring Boot 注册 Servlet 的五种方法

一、Spring Boot 提供了 ServletRegistrationBean, FilterRegistrationBean, ServletListenerRegistrationBean 三个类分别用来注册 Servlet, Filter, Listener

复制代码
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;

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 这个配置文件了,所有的组件都可以通过代码配置或者注解@WebServlet/@WebFilter/@WebListener来达到目的。

复制代码
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;

@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);
    }

}

**注意:**需要在启动类上配置上注解@ServletComponentScan来扫描这三个注解@ServletComponentScan扫描@WebServlet和@WebFilter及@WebListener的配置

三、实现org.springframework.boot.web.servlet.ServletContextInitializer向容器中注入bean的方式动态注册

复制代码
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;

@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;


@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");
    }

}

四、 使用org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping.registerMapping()方法运行时动态注册

复制代码
   private void registerServerEndpoint(String path, Object bean) throws NoSuchMethodException {
        RequestMappingHandlerMapping mapping = applicationContext.getBean(RequestMappingHandlerMapping.class);
        RequestMappingInfo.BuilderConfiguration config = new RequestMappingInfo.BuilderConfiguration();

        if (webMvcProperties.getPathmatch().getMatchingStrategy() == WebMvcProperties.MatchingStrategy.PATH_PATTERN_PARSER) {
            config.setPatternParser(new PathPatternParser());
        } else {
            config.setPathMatcher(new AntPathMatcher());
        }
        RequestMappingInfo handleGet = RequestMappingInfo.paths(path).methods(RequestMethod.GET).options(config).build();
        mapping.registerMapping(handleGet, bean, ServletHttpHandler.class.getMethod("handleGet"));

        RequestMappingInfo handlePost = RequestMappingInfo.paths(path).methods(RequestMethod.POST).options(config).build();
        mapping.registerMapping(handlePost, bean, ServletHttpHandler.class.getMethod("handlePost", String.class));
    }

五、使用org.springframework.web.servlet.function.RouterFunction注册

复制代码
import com.fasterxml.jackson.databind.ObjectMapper;
import lombok.extern.slf4j.Slf4j;
import org.springframework.http.MediaType;
import org.springframework.web.servlet.function.RouterFunction;
import org.springframework.web.servlet.function.RouterFunctions;
import org.springframework.web.servlet.function.ServerRequest;
import org.springframework.web.servlet.function.ServerResponse;

import javax.servlet.ServletException;
import java.io.IOException;
import java.time.Duration;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import java.util.UUID;

public class StreamServer {
    private final ObjectMapper objectMapper = new ObjectMapper();
    private final String endpoint;
    private final RouterFunction<ServerResponse> router;

    public StreamServer(String endpoint) {
        this.endpoint = endpoint;
        this.router = RouterFunctions.route()
                .POST(this.endpoint, this::handlePost)
                .build();
    }

    public RouterFunction<ServerResponse> getRouter() {
        return this.router;
    }

    private ServerResponse handlePost(ServerRequest request) throws ServletException, IOException {
        List<MediaType> acceptHeaders = request.headers().asHttpHeaders().getAccept();
        if (!acceptHeaders.contains(MediaType.TEXT_EVENT_STREAM)
                || !acceptHeaders.contains(MediaType.APPLICATION_JSON)) {
            return ServerResponse.badRequest()
                    .body("Invalid Accept headers. Expected TEXT_EVENT_STREAM and APPLICATION_JSON");
        }
        String body = request.body(String.class);
        log.info("body:{}", body);
        String sessionId = UUID.randomUUID().toString();

        return ServerResponse.sse(sseBuilder -> {
            sseBuilder.onComplete(() -> {
                log.debug("Request response stream completed for session: {}", sessionId);
            });
            sseBuilder.onTimeout(() -> {
                log.debug("Request response stream timed out for session: {}", sessionId);
            });

            try {
                for (int i = 0; i < 100; ++i) {
                    Map<String, Object> row = new HashMap<>();
                    row.put("rowId", i + 1);
                    row.put("rowName", i + 1);
                    String json = objectMapper.writeValueAsString(row);
                    sseBuilder.id(sessionId)
                            .event("message")
                            .data(json);
                }
                sseBuilder.complete();
            } catch (Exception e) {
                log.error("Failed to handle request stream: {}", e.getMessage());
                sseBuilder.error(e);
            }
        }, Duration.ZERO);
    }
}


import com.github.kylewka.smartai.demo.stream.StreamServer;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.function.RouterFunction;
import org.springframework.web.servlet.function.ServerResponse;

@Configuration
public class StreamServerConfig {

    @Bean
    public StreamServer streamServer() {
        return new StreamServer("/test/stream");
    }

    @Bean
    public RouterFunction<ServerResponse> sseRoute(StreamServer streamServer) {
        return streamServer.getRouter();
    }
}

总结:

1 参考文章: https://huanghaoheng.blog.csdn.net/article/details/128703156

2 参考文章: https://cloud.tencent.com/developer/article/1544924

相关推荐
weixin_446260852 小时前
HACO:面向动态部署环境的对冲式智能计算可靠多智能体调度框架
后端·python·flask
ttwuai3 小时前
Cursor 生成 CRUD 后,Go 后台接口别只测 200:JWT、RBAC 和 tenant_id 怎么验
开发语言·后端·golang
用户8356290780513 小时前
Python 实现 Excel 页面布局与打印设置自动化
后端·python
用户9931441579843 小时前
微服务框架中获取用户信息
后端
xuanWb4 小时前
手写一个 LLM API 网关:Anthropic 与 OpenAI 协议转换的完整实现
后端
苍何4 小时前
给 Codex 换皮肤这门生意,被我开源了
后端
用户8356290780514 小时前
Python 实现 Excel 命名范围(Named Range)的创建与管理
后端·python
程序员David4 小时前
我让 Claude 从架构文档一路干到代码,踩了三个坑才摸清边界
后端
Zane19944 小时前
并发 vs 并行:别再傻傻分不清了,一文讲透 Java 并发编程的第一课
java·后端