1、smart-servlet 简介
smart-servlet 是目前 Gitee、Github 平台上首款，也是 唯一的全栈核心技术自研 的国产开源的 Servlet 容器项目。
![]()
产品特色
版本比较
| 功能 |
开源版 |
企业版 |
| 目标用户 |
个人 |
企业 |
| Servlet 基础能力 |
✅ |
✅ |
| Websocket 规范 |
❌ |
✅ |
| 异步规范 |
❌ |
✅ |
| JSP |
❌ |
❌ |
2、 版本更新
特性一：移除安全相关的规范实现
在 Servlet 第13章定义了关于安全相关的规范，为开发人员提供了一套完整的安全框架。使他们能够在构建Web应用程序时考虑到安全性，并实施必要的安全措施。通过这些机制，可以保护Web应用程序免受未授权访问和潜在的安全威胁，确保数据的完整性和保密性。
![]()
但是很遗憾，这份规范已然过时。倒不是说这份规范哪里存在涉及缺陷，而是如今这个时代，“安全”是一个非常庞大且复杂的系统性问题，并非 Servlet 区区几个接口规范所能涵盖全的。
现实情况下关于安全问题，往往都是开发人员根据自身的业务特性设计的一套处理方案。况且 Java 生态最不缺的，就是众多专业人员开发的各类安全框架，集成三方框架（例如：Spring Security）可比 Servlet 容器提供的方案更具安全性。
因此，smart-servlet 没有必要去做这件意义不大的事情，故在本版本中移除了此前实现的部分代码。
特性二：适配 Spring 的Servlet实例化特性
更具规范（下图所示），当 loadOnStart 为负数时，容器可以自由决定 Servlet 的初始化时机。
![]()
但实际情况是此类 Servlet 若过早的被初始化，当 Spring 的 WebMvcConfigurationSupport 子类被标记了 org.springframework.cloud.context.config.annotation.RefreshScope 注解。将导致 DispatchServlet 完成初始化之际，Spring 的 bean 还未全部完成实例化，最终导致某些 URL Mapping 失效。
为了解决 Spring 的适配问题，当 loadOnStart 为负数时，smart-servlet 只能将执行 Servlet#init 的动作延迟至执行 Servlet#service 之前。
更新内容
-
新增 HttpSessionIdListener 规范实现。
-
新增 HttpServletRequest#changeSessionId 规范实现。
-
优化 ServletContext#getResourcePaths 规范实现。
-
移除 Principal 相关实现。
-
调整 Servlet 初始化策略，适配 spring 环境。
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>{最新版}</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>{最新版}</version>
</dependency>
</dependencys>
扫描以下二维码限时体验企业版：
![]()
方式三：发行包
发行包适用于 War 包的部署方式，也是生产环境中常用的一种形式。
扫描以下二维码限时体验企业版：
![]()
