1、smart-servlet 简介
smart-servlet 是一个基于 Jakarta Servlet 6.1 的轻量级 Servlet 容器,适用于 Java 17+ 环境。
产品特色
-
国产血统:全球首款全栈核心技术自研的国产 Servlet 容器。
-
性能优越:搭载最新版通信微内核(smart-socket)和 http 服务模块 (smart-http)。
-
安全可靠:严格遵循协议规范;支持加密传输方式。
-
极致轻量:发行包仅 1 MB。
-
简洁易用:支持 War 包、springboot、maven-plugin 等多种运行模式,使用体验 100% 兼容 Tomcat。
目标用户
-
有着信创需求的企业用户。
-
对服务并发能力要求高的企业用户。
-
想要研究 servlet 技术的个人开发者。
2、 版本更新
历时 2 个多月,smart-servlet 对于 Servlet 6 规范的实现度愈加完善。如今的 TCK 用例通过率已高达 99.5%,仅剩 8 个测试用例有待适配。
更新内容:
-
升级
jakarta.servlet-api
适配版本至6.1.0
-
实现
HttpServletRequest#newPushBuilder
规范。 -
实现
ServletContext#getEffectiveMajorVersion
规范 -
实现
ServletContext#getEffectiveMinorVersion
规范 -
优化
ServletInputStream
规范实现 -
优化
CLIENT-CERT
认证模式 -
优化
Plugin
多个接口设计 -
支持
sun-web.xml
的自动解析加载
TCK 报告:
version | Tests | Errors | Success Rate | Time |
---|---|---|---|---|
v2.0 | 1716 | 199 | 88.4% | 2024-07-28 |
v2.1 | 1718 | 95 | 94.5% | 2024-08-11 |
v2.2 | 1716 | 29 | 98.3% | 2024-08-31 |
v2.3 | 1717 | 8 | 99.5% | 2024-11-10 |
本次除了版本功能的发布,我们还为社区用户带来了一项福利。
smart-servlet 是一款商业不友好的产品。所谓的不友好
也仅体现在企业用户需要获得授权方可使用该产品。
为了不让该规则阻碍个人开发者体验 smart-servlet,我们将为所有个人开发者提供免费的社区版License。
3、快速上手
我们提供了三种方式启用 smart-servlet,您可根据实际情况选择其中适用的一种。
方式一:maven 插件
这是一种类似:tomcat-maven-plugin
的使用方式,通常应用于 Java Web 工程的本地开发环境。集成该插件只需在 pom.xml 中加入以下代码,便可以在 IDE 中启动 servlet 服务。
<build>
<plugins>
<plugin>
<groupId>tech.smartboot.servlet</groupId>
<artifactId>smart-servlet-maven-plugin</artifactId>
<version>{最新版}</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>tech.smartboot.servlet</groupId>
<artifactId>smart-servlet-spring-boot-starter</artifactId>
<version>{最新版}</version>
</dependency>
</dependencys>
方式三:发行包
发行包适用于 War 包的部署方式,也是生产环境中常用的一种形式。
下载地址:https://smartboot.tech/smart-servlet/guides/release_note/