嵌入式服务器 - Tomcat 服务器 - 使用 Tomcat 启动

Java - Web - Spring 《嵌入式服务器 - Tomcat 服务器 - 使用 Tomcat 启动》

一、引言

在 Java Web 开发中，服务器是承载应用程序运行的关键组件。传统上，我们会将开发好的 Web 应用打包成 WAR 文件，然后部署到独立的服务器（如 Apache Tomcat）中。而 Spring 框架提供了嵌入式服务器的支持，其中 Tomcat 是常用的嵌入式服务器之一。使用嵌入式 Tomcat 可以让我们更方便地开发和部署 Spring Web 应用，无需额外安装和配置独立的服务器。本文将详细介绍如何在 Spring 项目中使用嵌入式 Tomcat 服务器来启动应用。

二、嵌入式 Tomcat 服务器的优势

1. 开发便捷：无需额外安装和配置服务器，项目可以直接在 IDE 中运行。
2. 集成性好：与 Spring 框架无缝集成，减少了配置的复杂性。
3. 易于部署：可以将应用打包成可执行的 JAR 文件，方便在不同环境中部署。

三、使用 Tomcat 启动 Spring 应用的步骤

1. 创建 Spring Boot 项目

我们可以使用 Spring Initializr（https://start.spring.io/）来快速创建一个 Spring Boot 项目。在创建项目时，选择以下依赖：

• Spring Web：用于构建 Web 应用。
• Spring Boot DevTools：提供开发时的一些便利功能。

2. 编写控制器类

在 src/main/java 目录下创建一个控制器类，用于处理 HTTP 请求。以下是一个简单的示例：

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
@RestController
public class HelloController {
    @GetMapping("/hello")
    public String hello() {
        return "Hello, Embedded Tomcat!";
    }
}

在上述代码中，我们使用 @RestController 注解将该类标记为控制器，使用 @GetMapping 注解处理 HTTP GET 请求。当访问 /hello 路径时，将返回 “Hello, Embedded Tomcat!”。

3. 启动应用

Spring Boot 项目默认使用嵌入式 Tomcat 服务器，我们只需要运行主应用类即可启动服务器。主应用类通常带有 @SpringBootApplication 注解。以下是示例代码：

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
@SpringBootApplication
public class EmbeddedTomcatApplication {
    public static void main(String[] args) {
        SpringApplication.run(EmbeddedTomcatApplication.class, args);
    }
}

在上述代码中，SpringApplication.run 方法会启动 Spring Boot 应用，并自动配置和启动嵌入式 Tomcat 服务器。

4. 测试应用

启动应用后，打开浏览器或使用工具（如 Postman）访问 http://localhost:8080/hello，如果看到 “Hello, Embedded Tomcat!”，则说明应用已成功启动。

四、自定义嵌入式 Tomcat 配置

在某些情况下，我们可能需要对嵌入式 Tomcat 服务器进行一些自定义配置，例如修改端口号、配置 SSL 等。以下是一个修改端口号的示例：

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.web.embedded.tomcat.TomcatServletWebServerFactory;
import org.springframework.boot.web.server.WebServerFactoryCustomizer;
import org.springframework.context.annotation.Bean;
@SpringBootApplication
public class EmbeddedTomcatApplication {
    public static void main(String[] args) {
        SpringApplication.run(EmbeddedTomcatApplication.class, args);
    }
    @Bean
    public WebServerFactoryCustomizer<TomcatServletWebServerFactory> customizer() {
        return factory -> factory.setPort(8081);
    }
}

在上述代码中，我们定义了一个 WebServerFactoryCustomizer Bean，用于自定义 Tomcat 服务器的配置。通过 setPort 方法将端口号修改为 8081。

五、总结

通过以上步骤，我们可以轻松地在 Spring 项目中使用嵌入式 Tomcat 服务器来启动应用。嵌入式 Tomcat 服务器为我们的开发和部署带来了极大的便利，让我们可以更专注于业务逻辑的实现。