🎉 套壳 Tomcat 突破 Spring 限制,国产 Servlet 容器的无奈之举

来源: 投稿
2024-04-15 09:36:00

1、smart-servlet 简介

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

产品特色

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

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

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

  • 极致轻量:发行包不足 800KB

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

2、 版本更新

背景

这个版本源于社区用户反馈的一个 ISSUE:springboot 工程在使用 websocket 时启动报错

websocket 原本就是企业版的特性,只不过基于 smart-servlet 的沙箱机制能让开源版 smart-servlet 正常启动,但在使用时会给于提示信息。

但是通过观察 ISSUE 中的堆栈,意识到 springboot 的 websocket 还做了一些额外操作。若不符合其要求,启动时便会触发异常。

解决方案

进一步分析源码后,可以看到 Spring 在启动时会根据当前的容器类型初始化相应的RequestUpgradeStraegy

可是很遗憾,spring 2.7.x 版本限定死了适配容器为:Tomcat、Jetty、Undertow、Glassfish、Weblogic、Websphere。(PS:莫非他们认为别人做不出 Servlet 容器了

显然让 Spring 去除其封闭性不太现实,那干脆 smart-servlet 通过一些 “歪门邪道” 启用自定义的RequestUpgradeStraegy

既然 spring 是根据包路径区分容器类型的,那 smart-servlet 就套一个 Tomcat 的壳,也定一个org.springframework.web.socket.server.standard.TomcatRequestUpgradeStrategy类,只不过其中的实现换成 smart-servlet 。

就这样,smart-servlet 实现了对 spring weboscket 的适配。

websocket 特性仅限于闭源企业版

更新内容

  1. HttpServletRequestImpl 新增附件接口。

  2. 调整 WebsocketProvider 接口设计,移除onHandShark,新增getWebSocketServerContainer

  3. 优化 Provider 升级提示文案。

  4. 优化 javax.websocket 规范实现。

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>

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

  • 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>{最新版}</version>
    </dependency>
</dependencys>

方式三:发行包

发行包适用于 War 包的部署方式,也是生产环境中常用的一种形式。(PS:联系作者获取最新版)

展开阅读全文
点击加入讨论🔥(27) 发布并加入讨论🔥
本篇精彩评论
没被spring掐脖子,倒是被这些套壳项目掐脖子,给个用你们的理由
2024-04-16 09:33
11
举报
一个WebSocket竟然搞闭源企业版,你凭什么让spring支持你!
2024-04-15 23:28
11
举报
开源项目加上国产,就是骗钱的😄,难道不允许外国开发者提交commit吗?如果合并了外国开发者的commit就不是国产了吗?
2024-04-16 09:11
10
举报
可以,互联网宣发玩明白了,经典标题雷声大雨点小
2024-04-15 16:26
3
举报
虽然这个smart-servle跟套壳项目无关,而且人家websocket企业版也好像没问题(至少人家好像一开始就这样的而不是中途转变的),但是,国产项目不得不说被某些x蒙,信创,文档收费影响了。
2024-05-16 22:26
1
举报
27 评论
6 收藏
分享
返回顶部
顶部