使用 jakarta.* 包在 Tomcat 10.x 上部署 Spring 5.x

kne*_*406 5 java spring tomcat

TL;DR:我有一个适用于 Tomcat 9 的 Spring MVC helloworld 应用程序。 Tomcat 10 上的同一个应用程序为 Web 请求映射提供了 404 错误。

问题

将 Spring MVC 5 helloworld 应用程序部署到 Tomcat 10 时,该应用程序为 Web 请求映射提供 404 错误。相同的 helloworld 应用程序适用于 Tomcat 9。它在 Tomcat 9 上显示 helloworld 消息。

我所期待的

我希望应用程序在 Tomcat 10 上显示 helloworld 消息。

环境

  • 微软视窗 10
  • 雄猫 10.0.2
  • 春季MVC 5.3.3

我进行的研究

我在 Spring 参考手册的 Web Servlet 部分进行了研究。我还在线测试了 Spring MVC 教程。这些教程适用于 Tomcat 9。但是,相同的教程在 Tomcat 10 上失败了。我还在 Tomcat 10 上执行了谷歌搜索。我看到了对 Jakarta EE 的引用,但不确定这是否是问题的根源。Java EE 8 和 Jakarta EE 8 向后兼容。

如何繁殖

我创建了一个非常基本的 helloword 项目来测试这一点。这是我用于该项目的代码。

pom.xml

<project xmlns="http://maven.apache.org/POM/4.0.0"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">

    <modelVersion>4.0.0</modelVersion>
    <groupId>com.example.spring</groupId>
    <artifactId>example-spring</artifactId>
    <version>1.0</version>
    <packaging>war</packaging>

    <properties>
        <maven.compiler.target>11</maven.compiler.target>
        <maven.compiler.source>11</maven.compiler.source>
    </properties>

    <dependencies>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-webmvc</artifactId>
            <version>5.3.3</version>
        </dependency>

        <dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>javax.servlet-api</artifactId>
            <version>4.0.0</version>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-war-plugin</artifactId>
                <version>3.3.1</version>
            </plugin>
        </plugins>
    </build>
</project>
Run Code Online (Sandbox Code Playgroud)

项目初始化器.java

package com.example;

import org.springframework.web.servlet.support.AbstractAnnotationConfigDispatcherServletInitializer;

public class ProjectInitializer extends AbstractAnnotationConfigDispatcherServletInitializer {

    @Override
    protected Class<?>[] getServletConfigClasses() {
        return new Class[] { PureJavaConfig.class };
    }

    @Override
    protected String[] getServletMappings() {
        return new String[] { "/" };
    }
    
    @Override
    protected Class<?>[] getRootConfigClasses() {
        return null;
    }
}
Run Code Online (Sandbox Code Playgroud)

纯Java配置文件

package com.example;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.ComponentScan;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.ViewResolver;
import org.springframework.web.servlet.config.annotation.EnableWebMvc;
import org.springframework.web.servlet.view.InternalResourceViewResolver;

@Configuration
@EnableWebMvc
@ComponentScan("com.example")
public class PureJavaConfig {

    @Bean
    public ViewResolver viewResolver() {    
        InternalResourceViewResolver resolver = new InternalResourceViewResolver();
        resolver.setSuffix(".jsp");
        resolver.setPrefix("/WEB-INF/jsp/");
        return resolver;
    }
    
}
Run Code Online (Sandbox Code Playgroud)

教程控制器.java

package com.example;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping;

@Controller
public class TutorialController {

    @GetMapping("/")
    public String home() {
        return "home";
    }
}
Run Code Online (Sandbox Code Playgroud)

主页.jsp

<html>
<body>Hello World of Spring! <%= java.time.LocalDateTime.now() %></body>
</html>
Run Code Online (Sandbox Code Playgroud)

这个项目在 Tomcat 9 上运行正常。它显示 helloworld 消息。但是,当我在 Tomcat 10 上运行时,收到 404 错误消息。

kne*_*406 10

TL;DR:Spring MVC 5 不能在 Tomcat 10 上运行,因为包重命名javax.*jakarta.*

经过进一步的研究,我能够找到我的问题的答案。Spring MVC的5确实不能在Tomcat 10.这项工作是因为Tomcat的10是基于雅加达EE 9中,其中原料药包名称从javax.*jakarta.*

Tomcat 10 在下载网页上提到了这一点:

Tomcat的10起的用户应该知道,从Java EE的迁移到雅加达EE与Java EE转移到Eclipse基金会的一部分,因此,初级包装,所有已经实现的API已经从javax.*jakarta.*。这几乎肯定需要更改代码才能使应用程序从 Tomcat 9 及更早版本迁移到 Tomcat 10 及更高版本。

对于 Spring MVC 5,Spring MVC DispatcherServlet依赖于javax.servlet.*包命名空间。这是使用 Java EE 8javax包命名。由于 Tomcat 10 基于 Jakarta EE 9,因此javax不支持用于命名的包。这解释了为什么 Spring MVC 5 在 Tomcat 10 上不起作用。

有针对 Spring 框架提交的 github 问题与此相关:

Spring 核心 5 未在 tomcat 10 上启动

支持 Jakarta EE 9(jakarta.* 命名空间中的注释和接口)

就我而言,我不会迁移到 Tomcat 10,而是继续使用 Tomcat 9,直到 Spring 框架升级到 Jakarta EE 9。

  • @izogfif:哦,这是一个错字。这是行不通的。我添加了*不*。我对我的答案进行了编辑:_Spring MVC 5 does *not* work on Tomcat 10._ (4认同)
  • 在第二段中写道`Spring MVC 5 目前在 Tomcat 10 上工作`。那么它有效还是无效? (3认同)