嵌入式Tomcat使用指南

嵌入式Tomcat允许你在Java应用程序中直接使用Tomcat服务器，而无需外部安装或配置。这对于开发、测试以及构建自动化流程非常有用。

1. 添加依赖

在Maven项目中，在pom.xml文件添加以下依赖：

<dependency>
    <groupId>org.apache.tomcat.embed</groupId>
    <artifactId>tomcat-embed-core</artifactId>
    <version>${project.version}</version>
</dependency>

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

<dependency>
    <groupId>junit.framework</groupId>
    <artifactId>junit</artifactId>
    <version>4.13.2</version>
    <scope>test</scope>
</dependency>

<build>
    <plugins>
        <!-- 使用Tomcat7EmbedContainer插件 -->
        <plugin>
            <groupId>org.apache.tomcat.maven.plugins.frontend tomcat-maven-plugin</groupId>
            <artifactId>tomcat-maven-plugin</artifactId>
            <version>${project.version}</version>
        </plugin>

        <!-- 配置Maven Surefire Plugin以支持嵌入式Tomcat -->
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-surefire-plugin</artifactId>
            <configuration>
                <argLine>-Djava.endorsed.dirs=${project.build.directory}/endorsed</argLine>
                <systemPropertyVariables>
                    <catalina.home>${project.build.directory}</systemPropertyVariables>
                </configuration>
            </plugin>

        <!-- 配置Maven Compiler Plugin -->
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>${maven.compiler.plugin.version}</version>
        </plugin>

    </plugins>
</build>

2. 创建一个简单的Servlet

import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import java.io.IOException;

@WebServlet("/hello")
public class HelloServlet extends HttpServlet {
    private static final long serialVersionUID = 1L;

    protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        response.setContentType("text/html");
        response.getWriter().println("<h1>Hello from embedded Tomcat!</h1>");
    }
}

3. 创建一个Maven项目并运行

创建一个新的Java Maven项目，并在src/main/java目录下添加上述Servlet类。

然后，在终端中执行以下命令：

mvn tomcat7:run-war

这将启动嵌入式Tomcat服务器，你可以通过访问http://localhost:8080/your_war_name/hello来测试你的Servlet。

4. 完整的项目结构

src/
├── main/
│   ├── java/
│   │   └── com.example.yourpackage/
│   │       └── HelloServlet.java
│   └── resources/
└── test/

pom.xml

5. 配置文件示例

在src/main/resources/ META-INF/context.xml中，你可以配置Tomcat的上下文：

<Context>
    <Resource name="jdbc/TestDB" auth="Container"
              type="javax.sql.DataSource"/>
</Context>

这样你就可以在应用程序中使用这个数据源。

6. 运行结果

当你运行项目时，嵌入式Tomcat服务器将启动，并监听8080端口。你可以通过浏览器访问你的Servlet：

http://localhost:8080/your_war_name/hello

你将看到页面显示“Hello from embedded Tomcat!”。

总结

使用嵌入式Tomcat可以让你在Java应用程序中直接运行Web应用，而无需外部服务器。通过Maven依赖管理和插件配置，你可以轻松地将其集成到项目中，并进行单元测试和开发。