Spring Boot @Controller

来源：这里教程网时间：2026-02-17 21:35:58 作者：

Spring Boot @Controller 教程显示了如何在 Spring 应用中使用@Controller注解来构建 Web 控制器。

Spring 是流行的 Java 应用框架，而 Spring Boot 是 Spring 的演进，可以帮助轻松地创建独立的，生产级的基于 Spring 的应用。

Spring MVC

Spring MVC 是基于 Servlet API 构建的原始 Web 框架。它基于流行的 MVC 设计模式。 MVC（模型-视图-控制器）是一种软件体系结构模式，它将应用分为三个区域：模型，视图和控制器。该模型表示一个携带数据的 Java 对象。该视图表示模型包含的数据的可视化。控制器控制数据流入模型对象并在数据更改时更新视图。它使视图和模型分离。

Spring Framework 5.0 引入了一个名为 Spring WebFlux 的并行 Reactor栈 Web 框架。

@Controller

@Controller注解指示已注解的类是控制器。它是@Component的特长，可通过类路径扫描自动检测。它通常与基于@RequestMapping注解的注解处理程序方法结合使用。 @RestController是用于创建 Restful 控制器的同级便利注解。

Spring Boot @Controller示例

在以下应用中，我们演示@Controller的用法。该应用将当前数据和时间返回给客户端。

$ tree.├── pom.xml└── src    ├── main    │   ├── java    │   │   └── com    │   │       └── zetcode    │   │           ├── Application.java    │   │           └── controller    │   │               └── MyController.java    │   └── resources    │       ├── static    │       │   └── index.html    │       └── templates    │           └── showMessage.ftl    └── test        └── java

这是 Spring 应用的项目结构。

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>controllerex</artifactId>    <version>1.0-SNAPSHOT</version>    <packaging>jar</packaging>    <properties>        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>        <maven.compiler.source>11</maven.compiler.source>        <maven.compiler.target>11</maven.compiler.target>    </properties>    <parent>        <groupId>org.springframework.boot</groupId>        <artifactId>spring-boot-starter-parent</artifactId>        <version>2.1.1.RELEASE</version>    </parent>    <dependencies>        <dependency>            <groupId>org.springframework.boot</groupId>            <artifactId>spring-boot-starter-web</artifactId>        </dependency>        <dependency>            <groupId>org.springframework.boot</groupId>            <artifactId>spring-boot-starter-freemarker</artifactId>        </dependency>    </dependencies>    <build>        <plugins>            <plugin>                <groupId>org.springframework.boot</groupId>                <artifactId>spring-boot-maven-plugin</artifactId>            </plugin>        </plugins>    </build></project>

这是 Maven pom.xml文件。 spring-boot-starter-parent是父 POM，它为使用 Maven 构建的应用提供依赖关系和插件管理。 spring-boot-starter-freemarker是 Freemarker 模板引擎的依赖项。此依赖项还将在项目中包含 Spring MVC。 spring-boot-maven-plugin将 Spring 应用打包到可执行的 JAR 或 WAR 归档文件中。

com/zetcode/MyController.java

package com.zetcode.controller;import org.springframework.stereotype.Controller;import org.springframework.web.bind.annotation.RequestMapping;import org.springframework.web.servlet.ModelAndView;import java.time.LocalDateTime;import java.time.format.DateTimeFormatter;import java.util.HashMap;@Controllerpublic class MyController {    @RequestMapping(value = "/getDateAndTime")    public ModelAndView getDateAndTime() {        var now = LocalDateTime.now();        var dtf = DateTimeFormatter.ofPattern("yyyy/MM/dd HH:mm:ss");        var date_time = dtf.format(now);        var params = new HashMap<String, Object>();        params.put("date_time", date_time);        return new ModelAndView("showMessage", params);    }}

这是MyController。它响应来自客户端的请求。它找出当前日期和时间，并将处理过程解析为showMessage.ftl模板，并将其传递给数据。

@Controllerpublic class MyController {

MyController带有@Controller注解。

@RequestMapping(value = "/getDateAndTime")public ModelAndView getDateAndTime() {

getDateAndTime()方法映射到getDateAndTime URL 模式；它返回ModelAndView，它是 Web MVC 框架中 Model 和 View 的持有人。

var now = LocalDateTime.now();var dtf = DateTimeFormatter.ofPattern("yyyy/MM/dd HH:mm:ss");var date_time = dtf.format(now);

我们获取并格式化本地日期和时间。

var params = new HashMap<String, Object>();params.put("date_time", date_time);

日期和时间字符串将添加到参数映射中。

return new ModelAndView("showMessage", params);

我们返回ModelAndView。由于 POM 文件中存在 Freemarker 依赖性，因此 Spring 将处理解析为showMessage.ftl模板文件，并将params对象传递给它。

resources/static/index.html

<!DOCTYPE html><html>    <head>        <title>Home page</title>        <meta charset="UTF-8">        <meta name="viewport" content="width=device-width, initial-scale=1.0">    </head>    <body>        <p>            <a href="getDateAndTime">Get date and time</a>        </p>    </body></html>

这是主页。它包含一个调用 Spring 控制器的链接。它是静态资源，位于预定义的src/main/resources/static目录中。

resources/templates/showMessage.ftl

<!DOCTYPE html><html><head>    <title>Show message</title>    <meta charset="UTF-8">    <meta name="viewport" content="width=device-width, initial-scale=1.0"></head><body>Date and time: ${date_time}    </body></html>

showMessage.ftl是一个 Freemarker 模板文件。它位于预定义的src/main/resources/templates目录中。它使用${}语法输出日期和时间。

com/zetcode/Application.java

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

Application是设置 Spring Boot 应用的入口。 @SpringBootApplication注解启用自动配置和组件扫描。在扫描过程中，将查找@Controller注解，并从MyController类创建一个 Spring bean。