08、JFinal 历史配置:web.xml 中的过滤器

恢复被破坏的 XML 标签,明确配置类与过滤映射前提,避免混用 javax 与 jakarta。

简明结论

不能。历史正文丢失了 XML 标签,无法作为可用配置。本页恢复结构示意,保留为 Servlet 部署方式参考;旧项目使用的 JFinal、容器与 Servlet 版本仍未确认。

只有类名和 /* 能构成 web.xml 配置吗?

不能。历史正文丢失了 XML 标签,无法作为可用配置。本页恢复结构示意,保留为 Servlet 部署方式参考;旧项目使用的 JFinal、容器与 Servlet 版本仍未确认。

配置结构

下面是放入匹配 Servlet 版本的 web-app 根节点中的片段,不是完整部署项目:

<filter>
  <filter-name>jfinal</filter-name>
  <filter-class>com.jfinal.core.JFinalFilter</filter-class>
  <init-param>
    <param-name>configClass</param-name>
    <param-value>demo.DemoConfig</param-value>
  </init-param>
</filter>
<filter-mapping>
  <filter-name>jfinal</filter-name>
  <url-pattern>/*</url-pattern>
</filter-mapping>

demo.DemoConfig 必须真实存在并满足对应版本 JFinalConfig 要求,不能只复制字符串。过滤器名要与映射一致。

迁移前检查

先确认打包方式与容器加载位置,再核对 JFinal 与 Servlet API 的 javax.servlet / jakarta.servlet 兼容性。不要把 Tomcat 不同主版本当成只换端口的升级,也不要把 Undertow 启动方式和 web.xml 部署混合使用。

预期验证是容器成功加载正确配置类、路由响应正常且静态资源行为符合要求。本轮没有部署 WAR,未宣称该片段已在具体容器运行。

下一步:Action 的入口。

整理范围与出处

本次依据下方版本资料整理说明与示例;历史导入资料的来源状态单独列示,不将技术参考认作原作者信息。原始发布日期与地址保留。