1、smart-servlet 简介

smart-servlet 是目前 Gitee、Github 平台上首款，也是唯一款全栈核心技术自研的国产开源的 Servlet 容器项目。

产品特色

• 国产血统：核心技术 100% 全栈自研。

• 性能优越：搭载最新版通信微内核 smart-socket。

• 安全可靠：严格遵循协议规范；支持加密传输方式。

• 简洁易用：支持 War 包、springboot、maven-plugin 等多种运行模式，使用体验 100% 兼容 Tomcat。

2、 版本更新

停更几个月后，smart-servlet 终于引来一个全新的版本。

经过无数次的纠结，最终下定决心抛弃一切历史包袱。从一个新的起点继续发展这个项目（这个起点同时也有可能是个终点~）。

此前为了考虑存量系统的移植性，smart-servlet 特地将 servlet 适配的最低规范设定在 2.5。但长久以来，smart-servlet 都找不到存在的意义。

一方面，Spring 已然成为企业级应用开发的事实标准，servlet 早就成为过去式；另一方面，用户没有理由放弃 tomcat、undertow 而转用 smart-servlet。即便是在信创的大背景下，只要把现成开源项目的源码下载下来稍加包装，就算得上自研、可控、国产化。这个时候还继续投入 smart-servlet 显得有点可笑，过程中无数次想要放弃，所以版本迭代也比较拖沓。

最近社区中最具热度的事件莫过于 Java 21 的发布，虽然这个版本没有特别吸引我的地方，但为了项目发展需要，适当蹭一蹭这个热度。所以作了一个较为冲动的决定：将 smart-servlet 的开发、运行环境切换为 Java 21；同时， servlet 适配的规范提升至了 Jakarta Servlet 5.0。希望通过这样的调整，能为这个项目注入新的活力。

本次更新内容：

1. 实现 FilterRegistration#getServletNameMappings 规范。

2. 实现 ServletContext#getResourcePaths 规范。

3. 实现 ServletContext#getJspConfigDescriptor 规范。

4. 实现 ServletContext#requestCharacterEncoding 规范。

5. 实现 ServletContext#responseCharacterEncoding 规范。

6. 优化 ServletResponse#setCharacterEncoding 规范实现。

7. 优化 ServletResponse#getContentType 规范实现。

8. 优化 ServletResponse#setContentType 规范实现。

9. 优化 ServletResponse#getOutputStream 规范实现。

10. 移除 javax.servlet-api，替换为：jakarta.servlet-api:5.0.0。

11. 移除 javax.annotation-api，替换为：jakarta.annotation-api:2.0.0。

12. 移除 javax.websocket-api，替换为：jakarta.websocket-api:2.0.0。

13. 升级 smart-http 至 1.3.1。

14. 升级 maven-plugin-plugin 至 3.9.0。

15. 升级 springboot 至 3.0.6。

3、快速上手

我们提供了三种方式启用 smart-servlet，您可根据实际情况选择其中适用的一种。

方式一：maven 插件

这是一种类似：tomcat-maven-plugin 的使用方式，通常应用于 Java Web 工程的本地开发环境。集成该插件只需在 pom.xml 中加入以下代码，便可以在 IDE 中启动 servlet 服务。

<build>
    <plugins>
        <plugin>
            <groupId>org.smartboot.servlet</groupId>
            <artifactId>smart-servlet-maven-plugin</artifactId>
            <version>0.5</version><!--最新版本 -->
            <configuration>
                <port>8080</port>
                <path>/portal</path>
            </configuration>
        </plugin>
    </plugins>
</build>

插件的版本建议采用最新版本，另外主要的配置项包括：

• port：servlet 服务启动的监听端口

• path：Servlet 容器上下文路径，即 ContextPath，通常以 / 表示。当然也支持自定义，但必须以 / 开头 完成配置后在控制台输入：mvn package smart-servlet:run 即可。

方式二：smart-servlet-spring-boot-starter

用过 springboot 的 spring-boot-starter-tomcat 或者 spring-boot-starter-undertow 的朋友应该对此不陌生。

smart-servlet-spring-boot-starter 本质上就是 smart-servlet 对 spring-boot-starter-web 的另一种适配。

只需按照以下方式调整 springboot 工程中 pom.xml 文件的配置，便可将 springboot 的默认 Servlet 容器替换成 smart-servlet。

<dependencys>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
        <exclusions>
            <!-- Exclude the Tomcat dependency -->
            <exclusion>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-starter-tomcat</artifactId>
            </exclusion>
        </exclusions>
    </dependency>
    <!-- Use smart-servlet instead -->
    <dependency>
        <groupId>org.smartboot.servlet</groupId>
        <artifactId>smart-servlet-spring-boot-starter</artifactId>
        <version>0.5</version><!--最新版本 -->
    </dependency>
</dependencys>

方式三：发行包

发行包适用于 War 包的部署方式，也是生产环境中常用的一种形式。

下载地址：https://gitee.com/smartboot/smart-servlet/releases/

smartboot 开源组织，一个容易被误认为是在 “重复造轮子” 的低调组织。曾获得 2020 年度 OSC 中国开源项目「优秀 Gitee 组织 」荣誉。

该组织内的明星项目包括：

• smart-socket
  历时 5 年精炼出 2 千多行代码，轻松实现百万级长连接的 AIO 通信框架。

• smart-http
  基于 smart-socket 实现的 HTTP/1.1 web 服务。

• smart-servlet
  基于 smart-http 实现的 Servlet 3.1/4.0 容器服务。

• smart-mqtt
  基于 smart-socket 实现的 MQTT 3.1.1/5.0 Broker&Client 服务。

• smart-flow
  一款具备可观测性的轻量级业务编排框架。

组织地址：https://smartboot.tech/
代码仓库：https://gitee.com/smartboot