smart-servlet 是一款实现了 Servlet 3.1 规范,支持多应用隔离部署的的 Web 容器。与此同时,smart-servlet 还是一款插件化容器,基于内置的沙箱环境确保 smart-servlet 拥有最精简的运行能力,用户还可以通过自定义插件扩展容器的服务能力。
一、架构设计
smart-servlet 在 smart-http 的基础之上,通过继承 HttpHandle 实现了 Servlet 规范。这意味着任何 smart-http 服务都可以通过单独引入 smart-servlet 核心包的方式,将普通的 http 应用改造成 servlet 应用,而且这个成本是极低的。
产品特色
- 国产血统:核心技术 100% 全栈自研。
- 性能优越:搭载最新版通信微内核 smart-socket。
- 安全可靠:严格遵循协议规范;支持加密传输方式。
- 简洁易用:支持 War 包、springboot、maven-plugin等多种运行模式,使用体验100%兼容 Tomcat。
二、更新内容
- 【新特性】实现 servlet 3.1 的文件上传规范。
- 【新特性】实现 HttpServletRequest#getRemoteUser 接口规范。
- 【新特性】新增War包解压工具。
- 【优化】开辟三方依赖存放package,现已集成:bcel、commons-fileupload、commons-io。
- 【优化】Http响应报文头Server显示:smart-servlet
- 【优化】临时文件存放于系统参数 java.io.tmpdir 指定的路径。
- 【优化】springboot starter模块禁用 debug 模式。
三、快速上手
我们提供了三种方式启用 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.1.9</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.1.9</version><!--最新版本 -->
</dependency>
</dependencys>
方式三:发行包
发行包适用于 War 包的部署方式,也是生产环境中常用的一种形式。
下载地址:https://gitee.com/smartboot/smart-servlet/releases
四、最后
smart-servlet 已经实现了比较常用的 Servlet 规范,绝大多数应用都可以无缝移植过来。有些细节部分也在持续完善,当下我们已经部署了两个应用运行在 smart-servlet 之上进行全网公测,欢迎广大社区用户前来体验。
文档地址:https://smartboot.gitee.io/smart-servlet/
仓库地址:https://gitee.com/smartboot/smart-servlet