Spring Boot @Controller · ZetCode 中文系列教程

# Spring Boot `@Controller` > 原文： [http://zetcode.com/springboot/controller/](http://zetcode.com/springboot/controller/) 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 的并行反應式棧 Web 框架。 ## `@Controller` `@Controller`注解指示已注解的類是控制器。它是`@Component`的特化，可通過類路徑掃描自動檢測。它通常與基于`@RequestMapping`注解的注解處理器方法結合使用。 `@RestController`是用于創建 Restful 控制器的同級便利注解。 ## Spring Boot `@Controller`示例在以下應用中，我們演示`@Controller`的用法。該應用將當前數據和時間返回給客戶端。 ```java $ 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` ```java <?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` ```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; @Controller public 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`模板，并將其傳遞給數據。 ```java @Controller public class MyController { ``` `MyController`帶有`@Controller`注解。 ```java @RequestMapping(value = "/getDateAndTime") public ModelAndView getDateAndTime() { ``` `getDateAndTime()`方法映射到`getDateAndTime` URL 模式；它返回`ModelAndView`，它是 Web MVC 框架中 Model 和 View 的持有者。 ```java var now = LocalDateTime.now(); var dtf = DateTimeFormatter.ofPattern("yyyy/MM/dd HH:mm:ss"); var date_time = dtf.format(now); ``` 我們獲取并格式化本地日期和時間。 ```java var params = new HashMap<String, Object>(); params.put("date_time", date_time); ``` 日期和時間字符串將添加到參數映射中。 ```java return new ModelAndView("showMessage", params); ``` 我們返回`ModelAndView`。由于 POM 文件中存在 Freemarker 依賴項，因此 Spring 將處理解析為`showMessage.ftl`模板文件，并將`params`對象傳遞給它。 `resources/static/index.html` ```java <!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` ```java <!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` ```java package com.zetcode; import org.springframework.boot.SpringApplication; import org.springframework.boot.autoconfigure.SpringBootApplication; @SpringBootApplication public class Application { public static void main(String[] args) { SpringApplication.run(Application.class, args); } } ``` `Application`是設置 Spring Boot 應用的入口。 `@SpringBootApplication`注解啟用自動配置和組件掃描。在掃描過程中，將查找`@Controller`注解，并從`MyController`類創建一個 Spring bean。 ```java $ mvn spring-boot:run ``` 應用運行后，我們可以導航到`localhost:8080`。在本教程中，我們展示了如何在 Spring 應用中使用`@Controller`注解。您可能也對相關教程感興趣： [Spring Boot `@RestController`教程](/springboot/restcontroller/)， [Java Servlets 教程](/articles/javaservlet/)， [Spring Boot `@ResponseStatus`教程](/springboot/responsestatus/)， [Spring Boot `@ExceptionHandler`教程](/springboot/exceptionhandler/)， [Spring Boot 上傳文件](/springboot/uploadfile/)， [Spring Boot `@Component`教程](/springboot/component/)， [Spring Boot `@RequestParam`教程](/springboot/requestparam/)， [Java 教程](/lang/java/)。