Spring Boot 中的 @Controller 注解：原理、用法与示例

前言

Spring Boot 是一个快速开发 Spring 应用程序的框架，它提供了很多有用的功能和特性。其中，@Controller 注解是一个常用的注解，它可以将一个 Java 类标记为 Spring MVC 中的控制器。本文将介绍 Spring Boot 中 @Controller 注解的原理、用法和示例。

@Controller 注解的原理

在 Spring MVC 中，@Controller 注解用于标识一个 Java 类是一个控制器。控制器负责接收请求、处理请求，并返回响应。具体来说，使用 @Controller 注解的类将会被 Spring MVC 自动扫描，并注册为一个控制器。

@Controller 注解的作用和 @Component 注解类似，都是将一个类标记为 Spring 的组件。但是，@Controller 注解还有以下特性：

• 自动映射 URL。@Controller 注解可以自动将请求映射到控制器的方法上。
• 支持视图解析。@Controller 注解可以将方法的返回值解析为视图，并渲染到客户端。

@Controller 注解的用法

使用 @Controller 注解的步骤如下：

1. 创建控制器类

首先，需要创建一个 Java 类，并使用 @Controller 注解来标注这个类。

@Controller
public class HelloController {
    @GetMapping("/hello")
    public String hello() {
        return "hello";
    }
}

2. 编写控制器方法

在控制器类中，需要编写控制器方法。控制器方法处理请求，并返回响应。控制器方法可以使用 Spring MVC 提供的注解来指定请求的 URL、请求方法和其他参数。

@GetMapping("/hello")
public String hello() {
    return "hello";
}

上面的代码中，@GetMapping 注解用于指定请求的 URL，即 /hello。方法的返回值为 “hello”，表示要渲染名为 “hello” 的视图。

3. 配置视图解析器

在 Spring MVC 中，控制器方法的返回值可以是一个视图名称，也可以是一个 ModelAndView 对象。为了将视图名称解析为实际的视图，需要配置一个视图解析器。

@Bean
public ViewResolver viewResolver() {
    InternalResourceViewResolver resolver = new InternalResourceViewResolver();
    resolver.setPrefix("/WEB-INF/views/");
    resolver.setSuffix(".jsp");
    return resolver;
}

上面的代码中，创建了一个 InternalResourceViewResolver 对象，并将前缀设置为 /WEB-INF/views/，后缀设置为 .jsp。这样，当控制器方法返回 “hello” 时，Spring MVC 将会解析为 /WEB-INF/views/hello.jsp。

4. 启动应用程序

最后，需要启动应用程序，并访问 http://localhost:8080/hello，就可以看到 “hello” 视图的内容了。

@SpringBootApplication
public class MyApp {
    public static void main(String[] args) {
        SpringApplication.run(MyApp.class, args);
    }
}

@Controller 注解的示例

下面是一个使用 @Controller 注解的示例项目。

1. 创建项目

使用 Spring Initializr 创建一个新的 Spring Boot 项目，添加以下依赖：

• Spring Web
• Thymeleaf

2. 创建控制器类

创建一个 GreetingController 类，并使用 @Controller 注解来标注这个类。

@Controller
public class GreetingController {
    @GetMapping("/greeting")
    public String greeting(@RequestParam(name = "name", required = false, defaultValue = "World") String name, Model model) {
        model.addAttribute("name", name);
        return "greeting";
    }
}

上面的代码中，@GetMapping 注解用于指定请求的 URL，即 /greeting。方法的参数中，@RequestParam 注解用于指定请求参数。如果请求中没有传递 name 参数，则使用默认值 “World”。方法的返回值为 “greeting”，表示要渲染名为 "greeting"的视图。

3. 创建视图模板

在 src/main/resources/templates 目录下，创建一个名为 greeting.html 的 Thymeleaf 模板文件。

<!DOCTYPE html>
<html>
<head>
    <title>Greeting</title>
</head>
<body>
    <h1>Hello, [[${name}]]!</h1>
</body>
</html>

上面的代码中，[[${name}]] 表示 Thymeleaf 表达式，用于获取控制器方法中传递的 name 参数的值。

4. 启动应用程序

最后，启动应用程序，并访问 http://localhost:8080/greeting?name=Jack，可以看到 “Hello, Jack!” 的内容。

@SpringBootApplication
public class MyApp {
    public static void main(String[] args) {
        SpringApplication.run(MyApp.class, args);
    }
}

总结

@Contoller 注解是 Spring Boot 中常用的注解之一，它可以将一个 Java 类标记为 Spring MVC 中的控制器。控制器负责接收请求、处理请求，并返回响应。本文介绍了 @Controller 注解的原理、用法和示例，希望可以帮助读者更好地理解和使用这个注解。