嵌入式Tomcat运行Servlet和JSP

末蓝、 2023-09-30 10:48 57阅读 0赞

在本教程中，我们展示了如何使用嵌入式 Tomcat 服务器。Tomcat可以嵌入模式运行；这意味着无需构建 WAR 文件并将其部署在独立的 Tomcat 服务器中。本教程中的示例是使用 Maven 构建的。

### Tomcat ###

Apache Tomcat是 Java Servlet、JavaServer Pages、Java 表达式语言和 Java WebSocket 技术的开源实现。

Apache Maven是一个软件项目管理和理解工具。该项目在一个名为`pom.xml`. 它包含项目对其他外部模块和组件的依赖关系、构建顺序、目录和所需的插件。

### 创建一个 servlet ###

在下面的示例中，我们创建了一个带有嵌入式 Tomcat 服务器的命令行 Java 应用程序。该应用程序附加了一个简单的 servlet。

![10f2db6dd9d6014848878a2724eb74cf.png][]

图：项目结构

该图显示了 NetBeans 中的项目结构。请注意，我们使用的是 Java Maven 控制台应用程序，而不是 Maven Web 应用程序。

pom.xml

<?xml version="1.0" encoding="UTF-8"?>
    <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.zetcode</groupId>
        <artifactId>EmbeddedTomcatEx</artifactId>
        <version>1.0-SNAPSHOT</version>
        <packaging>jar</packaging>
        <properties>
            <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
            <maven.compiler.source>1.8</maven.compiler.source>
            <maven.compiler.target>1.8</maven.compiler.target>
            <tomcat.version>9.0.0.M6</tomcat.version>
        </properties>
        
        <dependencies>
            
            <dependency>
                <groupId>javax.servlet</groupId>
                <artifactId>javax.servlet-api</artifactId>
                <version>3.1.0</version>
            </dependency>         
            <dependency>
                <groupId>org.apache.tomcat.embed</groupId>
                <artifactId>tomcat-embed-core</artifactId>
                <version>${tomcat.version}</version>
            </dependency>
            <dependency>
                <groupId>org.apache.tomcat.embed</groupId>
                <artifactId>tomcat-embed-logging-juli</artifactId>
                <version>${tomcat.version}</version>
            </dependency>
            
           
        </dependencies>    
        
        <build>    
            <plugins>
                <plugin>
                    <groupId>org.codehaus.mojo</groupId>
                    <artifactId>appassembler-maven-plugin</artifactId>
                    <version>1.1.1</version>
                    <configuration>
                        <assembleDirectory>target</assembleDirectory>
                        <programs>
                            <program>
                                <mainClass>com.zetcode.embedded.EmbeddedTomcatEx</mainClass>
                                <name>webapp</name>
                            </program>
                        </programs>
                    </configuration>
                    <executions>
                        <execution>
                            <phase>package</phase>
                            <goals>
                                <goal>assemble</goal>
                            </goals>
                        </execution>
                    </executions>
                </plugin>
            </plugins>    
        </build>
        
    </project>

Maven`pom.xml`包含嵌入式 Tomcat 服务器和构建应用程序的汇编插件的依赖项。JSP 容器的依赖不包含在这个应用程序中，因为我们只有一个 servlet。

EmbeddedTomcatEx.java

package com.zetcode.embedded;
    
    import javax.servlet.ServletException;
    import javax.servlet.http.HttpServlet;
    import javax.servlet.http.HttpServletRequest;
    import javax.servlet.http.HttpServletResponse;
    import java.io.File;
    import java.io.IOException;
    import java.io.Writer;
    import org.apache.catalina.Context;
    import org.apache.catalina.LifecycleException;
    import org.apache.catalina.startup.Tomcat;
    
    public class EmbeddedTomcatEx {
    
        public static void main(String[] args) throws LifecycleException,
                InterruptedException, ServletException {
    
            Tomcat tomcat = new Tomcat();
            tomcat.setPort(8082);
    
            Context ctx = tomcat.addContext("/", new File(".").getAbsolutePath());
    
            Tomcat.addServlet(ctx, "Embedded", new HttpServlet() {
                @Override
                protected void service(HttpServletRequest req, HttpServletResponse resp) 
                        throws ServletException, IOException {
                    
                    Writer w = resp.getWriter();
                    w.write("Embedded Tomcat servlet.\n");
                    w.flush();
                    w.close();
                }
            });
    
            ctx.addServletMapping("/*", "Embedded");
    
            tomcat.start();
            tomcat.getServer().await();
        }
    }

这`EmbeddedTomcatEx`是一个 Java 控制台应用程序，其中包括一个嵌入式 Tomcat 服务器。

Tomcat tomcat = new Tomcat();
    tomcat.setPort(8082);

Tomcat在8082端口启动。默认端口为8080；NetBeans 使用 8084 作为其内置的 Tomcat 服务器。我们选择了另一个端口，以免发生冲突。

Context ctx = tomcat.addContext("/", new File(".").getAbsolutePath());

每个应用程序都映射到一个上下文。使用该`addContext()`方法，我们创建了一个不支持 JSP 文件且没有`web.xml` 文件的应用程序。我们为文档库使用根上下文路径和当前工作目录。

Tomcat.addServlet(ctx, "Embedded", new HttpServlet() {
        @Override
        protected void service(HttpServletRequest req, HttpServletResponse resp) 
                throws ServletException, IOException {
            
            Writer w = resp.getWriter();
            w.write("Embedded Tomcat servlet.\n");
            w.flush();
            w.close();
        }
    });

使用该方法添加了一个新的 servlet `addServlet()`。servlet 只是用一些 ASCII 文本来响应。

ctx.addServletMapping("/*", "Embedded");

servlet 映射控制如何访问名为 Embedded 的 servlet。对于我们的示例，任何 URL 最终都会调用我们的 servlet。

tomcat.start();
    tomcat.getServer().await();

Tomcat 服务器已启动。

$ curl localhost:8082/
    Embedded Tomcat servlet.

我们运行应用程序并使用该`curl`工具对其进行测试。

### JSP 文件 ###

在第二个示例中，我们使用嵌入式 Tomcat 服务器来提供 JSP 文件。

pom.xml

<?xml version="1.0" encoding="UTF-8"?>
    <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.zetcode</groupId>
        <artifactId>EmbeddedTomcatEx2</artifactId>
        <version>1.0-SNAPSHOT</version>
        <packaging>jar</packaging>
        <properties>
            <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
            <maven.compiler.source>1.8</maven.compiler.source>
            <maven.compiler.target>1.8</maven.compiler.target>
            <tomcat.version>9.0.0.M6</tomcat.version>
        </properties>
        
        <dependencies>
            
            <dependency>
                <groupId>javax.servlet</groupId>
                <artifactId>javax.servlet-api</artifactId>
                <version>3.1.0</version>
            </dependency>         
            <dependency>
                <groupId>org.apache.tomcat.embed</groupId>
                <artifactId>tomcat-embed-core</artifactId>
                <version>${tomcat.version}</version>
            </dependency>
            <dependency>
                <groupId>org.apache.tomcat.embed</groupId>
                <artifactId>tomcat-embed-logging-juli</artifactId>
                <version>${tomcat.version}</version>
            </dependency>
            
            <dependency>
                <groupId>org.apache.tomcat</groupId>
                <artifactId>tomcat-jasper</artifactId>
                <version>${tomcat.version}</version>
            </dependency>
            
            <dependency>
                <groupId>org.apache.tomcat</groupId>
                <artifactId>tomcat-jasper-el</artifactId>
                <version>${tomcat.version}</version>
            </dependency>
            
            <dependency>
                <groupId>org.apache.tomcat</groupId>
                <artifactId>tomcat-jsp-api</artifactId>
                <version>${tomcat.version}</version>
            </dependency>        
            
        </dependencies>    
        
        <build>
        
            <plugins>
                <plugin>
                    <groupId>org.codehaus.mojo</groupId>
                    <artifactId>appassembler-maven-plugin</artifactId>
                    <version>1.1.1</version>
                    <configuration>
                        <assembleDirectory>target</assembleDirectory>
                        <programs>
                            <program>
                                <mainClass>com.zetcode.embedded.EmbeddedTomcatEx2</mainClass>
                                <name>webapp</name>
                            </program>
                        </programs>
                    </configuration>
                    <executions>
                        <execution>
                            <phase>package</phase>
                            <goals>
                                <goal>assemble</goal>
                            </goals>
                        </execution>
                    </executions>
                </plugin>
            </plugins>    
        </build>
        <name>EmbeddedTomcatEx2</name>
    </project>

在此`pom.xml`文件中，我们还包括嵌入式 Tomcat JSP 容器的依赖项：`tomcat-jasper`、`tomcat-jasper-el`和`tomcat-jsp-api`.

index.jsp

<%@page contentType="text/html" pageEncoding="UTF-8"%>
    <!DOCTYPE html>
    <html>
        <head>
            <title>JSP file</title>
            <meta charset="UTF-8">
        </head>
        <body>
            <p>
                This is a simple JSP file.            
            </p>
        </body>
    </html>

这是一个由嵌入式 Tomcat 服务器提供服务的简单 JSP 文件。

EmbeddedTomcatEx2.java

package com.zetcode.embedded;
    
    import javax.servlet.ServletException;
    import java.io.File;
    import org.apache.catalina.LifecycleException;
    import org.apache.catalina.startup.Tomcat;
    
    public class EmbeddedTomcatEx2 {
    
        public static void main(String[] args) throws LifecycleException,
                InterruptedException, ServletException {
    
            String docBase = "src/main/webapp/";
            
            Tomcat tomcat = new Tomcat();
            tomcat.setPort(8082);
    
            tomcat.addWebapp("/", new File(docBase).getAbsolutePath());
    
            tomcat.start();
            tomcat.getServer().await();
        }
    }

该应用程序提供一个 JSP 文件。该文件位于`src/main/webapp` 子目录中。

tomcat.addWebapp("/", new File(docBase).getAbsolutePath());

这次我们使用`addWebapp()`将我们的应用程序添加到 Tomcat 服务器。

$ curl localhost:8082/
    
    <!DOCTYPE html>
    <html>
        <head>
            <title>JSP file</title>
            <meta charset="UTF-8">
        </head>
        <body>
            <p>
                This is a simple JSP file.            
            </p>
        </body>
    </html>

当我们访问应用程序时，我们会得到这个。

这是嵌入式 Tomcat 教程。使用嵌入式 Tomcat，我们提供了一个 servlet 和一个 JSP 文件。我们使用 Apache Tomcat、Maven 和 NetBeans。

[10f2db6dd9d6014848878a2724eb74cf.png]: https://img-blog.csdnimg.cn/img_convert/10f2db6dd9d6014848878a2724eb74cf.png