1、smart-servlet 简介
smart-servlet 是目前 Gitee、Github 平台上首款,也是唯一款全栈核心技术自研的国产开源的 Servlet 容器项目。
![]()
产品特色
模块介绍
| 模块 |
说明 |
代码量 |
| servlet-core |
实现了 Servlet 规范的核心模块 |
17000+ |
| smart-servlet-maven-plugin |
类似 tomcat-maven-plugin 的 maven 插件 |
100+ |
| spring-boot-stater |
适配 springboot 的启动器,类似:spring-boot-starter-tomcat |
100+ |
2、 版本更新
本次更新内容:
-
smart-http升级至1.2.7
-
优化ErrorPage规范实现。
-
实现AsyncContext规范。
-
实现ServletRequest#startAsync规范
-
优化HttpServletResponse#addCookie、getCharacterEncoding、setContentType规范实现。
-
优化ServletOutputStream#write规范。
-
修复ServletRequestDispatcherWrapper#setParameters方法名单词拼写错误问题。
-
修复ServletContext#setAttribute中replace情况下的value提取错误问题。
-
修复当某个类实现多个Listener接口时,仅其中一个Listener生效的问题。
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.4</version><!--最新版本 -->
<configuration>
<port>8080</port>
<path>/portal</path>
</configuration>
</plugin>
</plugins>
</build>
插件的版本建议采用最新版本,另外主要的配置项包括:
方式二: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.4</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