Jetty 11 不检测 Servlet
Jetty 11 Doesn't Detect Servlets
我有一个使用 Jetty 部署本地服务器的示例项目 here。
我使用 mvn package exec:java
命令到 运行 本地服务器,它工作正常。它加载 HTML 个文件,以及来自 servlet 的内容。以下是相关文件:
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>io.happycoding</groupId>
<artifactId>app-engine-hello-world</artifactId>
<version>1</version>
<properties>
<!-- App Engine currently supports Java 11 -->
<maven.compiler.source>11</maven.compiler.source>
<maven.compiler.target>11</maven.compiler.target>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<jetty.version>9.4.35.v20201120</jetty.version>
<!-- Project-specific properties -->
<exec.mainClass>io.happycoding.ServerMain</exec.mainClass>
<googleCloudProjectId>YOUR_PROJECT_ID_HERE</googleCloudProjectId>
</properties>
<dependencies>
<!-- Java Servlets API -->
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>javax.servlet-api</artifactId>
<version>4.0.1</version>
</dependency>
<!-- Jetty -->
<dependency>
<groupId>org.eclipse.jetty</groupId>
<artifactId>jetty-server</artifactId>
<version>${jetty.version}</version>
</dependency>
<dependency>
<groupId>org.eclipse.jetty</groupId>
<artifactId>jetty-annotations</artifactId>
<version>${jetty.version}</version>
</dependency>
</dependencies>
<build>
<plugins>
<!-- Copy static resources like html files into the output jar file. -->
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-resources-plugin</artifactId>
<version>2.7</version>
<executions>
<execution>
<id>copy-web-resources</id>
<phase>compile</phase>
<goals><goal>copy-resources</goal></goals>
<configuration>
<outputDirectory>
${project.build.directory}/classes/META-INF/resources
</outputDirectory>
<resources>
<resource><directory>./src/main/webapp</directory></resource>
</resources>
</configuration>
</execution>
</executions>
</plugin>
<!-- Package everything into a single executable jar file. -->
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-shade-plugin</artifactId>
<version>3.2.4</version>
<executions>
<execution>
<phase>package</phase>
<goals><goal>shade</goal></goals>
<configuration>
<createDependencyReducedPom>false</createDependencyReducedPom>
<transformers>
<transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
<mainClass>${exec.mainClass}</mainClass>
</transformer>
</transformers>
</configuration>
</execution>
</executions>
</plugin>
<!-- App Engine plugin for deploying to the live site. -->
<plugin>
<groupId>com.google.cloud.tools</groupId>
<artifactId>appengine-maven-plugin</artifactId>
<version>2.2.0</version>
<configuration>
<projectId>${googleCloudProjectId}</projectId>
<version>1</version>
</configuration>
</plugin>
</plugins>
</build>
</project>
ServerMain.java
package io.happycoding;
import java.net.URL;
import org.eclipse.jetty.annotations.AnnotationConfiguration;
import org.eclipse.jetty.server.Handler;
import org.eclipse.jetty.server.handler.DefaultHandler;
import org.eclipse.jetty.server.Server;
import org.eclipse.jetty.servlet.DefaultServlet;
import org.eclipse.jetty.webapp.Configuration;
import org.eclipse.jetty.webapp.WebAppContext;
import org.eclipse.jetty.webapp.WebInfConfiguration;
/**
* Starts up the server, including a DefaultServlet that handles static files,
* and any servlet classes annotated with the @WebServlet annotation.
*/
public class ServerMain {
public static void main(String[] args) throws Exception {
// Create a server that listens on port 8080.
Server server = new Server(8080);
WebAppContext webAppContext = new WebAppContext();
server.setHandler(webAppContext);
// Load static content from inside the jar file.
URL webAppDir =
ServerMain.class.getClassLoader().getResource("META-INF/resources");
webAppContext.setResourceBase(webAppDir.toURI().toString());
// Enable annotations so the server sees classes annotated with @WebServlet.
webAppContext.setConfigurations(new Configuration[]{
new AnnotationConfiguration(),
new WebInfConfiguration(),
});
// Look for annotations in the classes directory (dev server) and in the
// jar file (live server)
webAppContext.setAttribute(
"org.eclipse.jetty.server.webapp.ContainerIncludeJarPattern",
".*/target/classes/|.*\.jar");
// Handle static resources, e.g. html files.
webAppContext.addServlet(DefaultServlet.class, "/");
// Start the server!
server.start();
System.out.println("Server started!");
// Keep the main thread alive while the server is running.
server.join();
}
}
HelloWorldServlet.java
package io.happycoding.servlets;
import java.io.IOException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
@WebServlet("/hello")
public class HelloWorldServlet extends HttpServlet {
@Override
public void doGet(HttpServletRequest request, HttpServletResponse response)
throws IOException {
response.setContentType("text/html;");
response.getWriter().println("<h1>Hello world!</h1>");
}
}
同样,这工作正常...只要我使用 Jetty 9。
但是如果我更新我的 pom.xml
文件以将我的 jetty.version
设置为 11.0.0
,那么我的 servlet URL 突然得到一个 404。我在控制台中没有看到任何错误。
我需要对我的代码进行哪些更改才能让 servlet 在 Jetty 11 中再次工作?
(我问这个问题是因为我收到了一堆针对各种学生项目的 dependabot 更新,它们都停止工作了,我正试图以尽可能少的摩擦来理清它们。)
Jetty 11 基于 Jakarta Servlet 5.0,它是 Jakarta EE 9 的一部分。
Jakarta EE 9 经历了命名空间和包装的“大爆炸”变化(他们的名字,不是我的),不再是 javax.servlet.*
,现在是 jakarta.servlet.*
。
Jetty 11 中几乎没有任何东西可以寻找 javax.servlet.*
。
一些快速历史......
- Oracle 拥有 Java EE。
- Oracle 出品 Java EE 7.
- Oracle 决定不再 create/manage EE。
- Oracle 将所有 EE 都捐给了 Eclipse 基金会。
- Oracle 没有授予 Eclipse 基金会在这个新的 EE 现实中使用“java”或“javax”的权利。
- Eclipse Foundation 出于法律原因将其重命名为“Jakarta EE”。
- Eclipse Foundation 发布“Jakarta EE 8”,本质上只是出于法律原因重命名的“Java EE 7”(尚未更改包命名空间)
- Eclipse Foundation 出于法律原因将所有包装从
javax.<spec>
重命名为 jakarta.<spec>
。
- Eclipse Foundation 发布了“Jakarta EE 9”,本质上就是“Jakarta EE 8”,但更改了名称空间(这就是上面提到的“大爆炸”)
(请注意,我浏览了这些步骤之间发生的许多其他事情)
javax.servlet.*
已死,万岁jakarta.servlet.*
.
Jetty 维护以下版本(当前)
Jetty
Servlet
EE
Namespace
Jetty 9.4.x
Servlet 3.1
Java EE 7
javax.servlet
Jetty 10.x
Servlet 4.0
Jakarta EE 8
javax.servlet
Jetty 11.x
Servlet 5.0
Jakarta EE 9
jakarta.servlet
没有向后兼容性功能允许 javax.servlet
和 jakarta.servlet
在 Jetty 版本中共存。 (我们已经尝试过几次,Servlet 规范的复杂性使得 HttpSession、RequestDispatcher、动态 servlet/filter 注册等变得非常困难)。 Jetty 正在使用 Servlet 6.0 中的 Servlet 规范来尝试解决这些问题。直到 Jetty 12 才可能发布支持这两个名称空间的 Jetty。
现在,我们所能希望的最好的(并且有几个项目开始这样做,所有 alpha 质量 ATM)是某种工具来更新你的 jars and/or 中新包装的源代码然后在基于雅加达的服务器上 运行 的自动化方式。
我有一个使用 Jetty 部署本地服务器的示例项目 here。
我使用 mvn package exec:java
命令到 运行 本地服务器,它工作正常。它加载 HTML 个文件,以及来自 servlet 的内容。以下是相关文件:
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>io.happycoding</groupId>
<artifactId>app-engine-hello-world</artifactId>
<version>1</version>
<properties>
<!-- App Engine currently supports Java 11 -->
<maven.compiler.source>11</maven.compiler.source>
<maven.compiler.target>11</maven.compiler.target>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<jetty.version>9.4.35.v20201120</jetty.version>
<!-- Project-specific properties -->
<exec.mainClass>io.happycoding.ServerMain</exec.mainClass>
<googleCloudProjectId>YOUR_PROJECT_ID_HERE</googleCloudProjectId>
</properties>
<dependencies>
<!-- Java Servlets API -->
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>javax.servlet-api</artifactId>
<version>4.0.1</version>
</dependency>
<!-- Jetty -->
<dependency>
<groupId>org.eclipse.jetty</groupId>
<artifactId>jetty-server</artifactId>
<version>${jetty.version}</version>
</dependency>
<dependency>
<groupId>org.eclipse.jetty</groupId>
<artifactId>jetty-annotations</artifactId>
<version>${jetty.version}</version>
</dependency>
</dependencies>
<build>
<plugins>
<!-- Copy static resources like html files into the output jar file. -->
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-resources-plugin</artifactId>
<version>2.7</version>
<executions>
<execution>
<id>copy-web-resources</id>
<phase>compile</phase>
<goals><goal>copy-resources</goal></goals>
<configuration>
<outputDirectory>
${project.build.directory}/classes/META-INF/resources
</outputDirectory>
<resources>
<resource><directory>./src/main/webapp</directory></resource>
</resources>
</configuration>
</execution>
</executions>
</plugin>
<!-- Package everything into a single executable jar file. -->
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-shade-plugin</artifactId>
<version>3.2.4</version>
<executions>
<execution>
<phase>package</phase>
<goals><goal>shade</goal></goals>
<configuration>
<createDependencyReducedPom>false</createDependencyReducedPom>
<transformers>
<transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
<mainClass>${exec.mainClass}</mainClass>
</transformer>
</transformers>
</configuration>
</execution>
</executions>
</plugin>
<!-- App Engine plugin for deploying to the live site. -->
<plugin>
<groupId>com.google.cloud.tools</groupId>
<artifactId>appengine-maven-plugin</artifactId>
<version>2.2.0</version>
<configuration>
<projectId>${googleCloudProjectId}</projectId>
<version>1</version>
</configuration>
</plugin>
</plugins>
</build>
</project>
ServerMain.java
package io.happycoding;
import java.net.URL;
import org.eclipse.jetty.annotations.AnnotationConfiguration;
import org.eclipse.jetty.server.Handler;
import org.eclipse.jetty.server.handler.DefaultHandler;
import org.eclipse.jetty.server.Server;
import org.eclipse.jetty.servlet.DefaultServlet;
import org.eclipse.jetty.webapp.Configuration;
import org.eclipse.jetty.webapp.WebAppContext;
import org.eclipse.jetty.webapp.WebInfConfiguration;
/**
* Starts up the server, including a DefaultServlet that handles static files,
* and any servlet classes annotated with the @WebServlet annotation.
*/
public class ServerMain {
public static void main(String[] args) throws Exception {
// Create a server that listens on port 8080.
Server server = new Server(8080);
WebAppContext webAppContext = new WebAppContext();
server.setHandler(webAppContext);
// Load static content from inside the jar file.
URL webAppDir =
ServerMain.class.getClassLoader().getResource("META-INF/resources");
webAppContext.setResourceBase(webAppDir.toURI().toString());
// Enable annotations so the server sees classes annotated with @WebServlet.
webAppContext.setConfigurations(new Configuration[]{
new AnnotationConfiguration(),
new WebInfConfiguration(),
});
// Look for annotations in the classes directory (dev server) and in the
// jar file (live server)
webAppContext.setAttribute(
"org.eclipse.jetty.server.webapp.ContainerIncludeJarPattern",
".*/target/classes/|.*\.jar");
// Handle static resources, e.g. html files.
webAppContext.addServlet(DefaultServlet.class, "/");
// Start the server!
server.start();
System.out.println("Server started!");
// Keep the main thread alive while the server is running.
server.join();
}
}
HelloWorldServlet.java
package io.happycoding.servlets;
import java.io.IOException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
@WebServlet("/hello")
public class HelloWorldServlet extends HttpServlet {
@Override
public void doGet(HttpServletRequest request, HttpServletResponse response)
throws IOException {
response.setContentType("text/html;");
response.getWriter().println("<h1>Hello world!</h1>");
}
}
同样,这工作正常...只要我使用 Jetty 9。
但是如果我更新我的 pom.xml
文件以将我的 jetty.version
设置为 11.0.0
,那么我的 servlet URL 突然得到一个 404。我在控制台中没有看到任何错误。
我需要对我的代码进行哪些更改才能让 servlet 在 Jetty 11 中再次工作?
(我问这个问题是因为我收到了一堆针对各种学生项目的 dependabot 更新,它们都停止工作了,我正试图以尽可能少的摩擦来理清它们。)
Jetty 11 基于 Jakarta Servlet 5.0,它是 Jakarta EE 9 的一部分。
Jakarta EE 9 经历了命名空间和包装的“大爆炸”变化(他们的名字,不是我的),不再是 javax.servlet.*
,现在是 jakarta.servlet.*
。
Jetty 11 中几乎没有任何东西可以寻找 javax.servlet.*
。
一些快速历史......
- Oracle 拥有 Java EE。
- Oracle 出品 Java EE 7.
- Oracle 决定不再 create/manage EE。
- Oracle 将所有 EE 都捐给了 Eclipse 基金会。
- Oracle 没有授予 Eclipse 基金会在这个新的 EE 现实中使用“java”或“javax”的权利。
- Eclipse Foundation 出于法律原因将其重命名为“Jakarta EE”。
- Eclipse Foundation 发布“Jakarta EE 8”,本质上只是出于法律原因重命名的“Java EE 7”(尚未更改包命名空间)
- Eclipse Foundation 出于法律原因将所有包装从
javax.<spec>
重命名为jakarta.<spec>
。 - Eclipse Foundation 发布了“Jakarta EE 9”,本质上就是“Jakarta EE 8”,但更改了名称空间(这就是上面提到的“大爆炸”)
(请注意,我浏览了这些步骤之间发生的许多其他事情)
javax.servlet.*
已死,万岁jakarta.servlet.*
.
Jetty 维护以下版本(当前)
Jetty | Servlet | EE | Namespace |
---|---|---|---|
Jetty 9.4.x | Servlet 3.1 | Java EE 7 | javax.servlet |
Jetty 10.x | Servlet 4.0 | Jakarta EE 8 | javax.servlet |
Jetty 11.x | Servlet 5.0 | Jakarta EE 9 | jakarta.servlet |
没有向后兼容性功能允许 javax.servlet
和 jakarta.servlet
在 Jetty 版本中共存。 (我们已经尝试过几次,Servlet 规范的复杂性使得 HttpSession、RequestDispatcher、动态 servlet/filter 注册等变得非常困难)。 Jetty 正在使用 Servlet 6.0 中的 Servlet 规范来尝试解决这些问题。直到 Jetty 12 才可能发布支持这两个名称空间的 Jetty。
现在,我们所能希望的最好的(并且有几个项目开始这样做,所有 alpha 质量 ATM)是某种工具来更新你的 jars and/or 中新包装的源代码然后在基于雅加达的服务器上 运行 的自动化方式。