【Spring Boot】Spring Boot 的常用注解

1.什么是注解式编程

注解（annotations）用来定义一个 类、属性 或一些 方法，以便程序能被编译处理。它相当于一个 说明文件，告诉应用程序某个被注解的类或属性是什么，要怎么处理。注解可以用于标注包、方法和变量等。

下方代码中的注解 @RestController，是一个用来定义 Rest 风格的控制器。其中，注解 @GetMapping("/hello") 定义的访问路径是 "/hello"。

@RestController
public class Hello {
	@GetMapping("hello")
	public String hello() throws Exception{
		return "Hello, Spring Boot!";
	}
}
1
2
3
4
5
6
7

2.了解系统注解

下面重点介绍一下 @SuppressWarnnings 注解。它有以下几种属性

• unchecked：未检查的转化。
• unused：未使用的变量。
• resource：泛型，即未指定类型。
• path：在类中的路径。原文件路径中有不存在的路径。
• deprecation：使用了某些不赞成使用的类和方法。
• fallthrough：switch 语句执行到底，不会遇到 break 关键字。
• serial：实现了 Serializable，但未定义 serialVersionUlD。
• rawtypes：没有传递带有泛型的参数。
• all：代表全部类型的警告。

3.使用在类名上的注解

3.1 @RestController

它用于返回 JSON（JavaScript Object Notation，JS 对象简谱）、XML（eXtensible Markup Language）等数据，但不能返回 HTML 页面。相当于注解 @ResponseBody 和注解 @Controller 合在一起的作用。

例如：

@RestController
public class HelloWorldController {
    @RequestMapping("/hello")
    public String hello() {
        return "Hello, Spring Boot!";
    }
}
1
2
3
4
5
6
7

3.2 @Controller

它用于标注控制器层，在 MVC 开发模式中代表 C（控制器）。

下面的代码程序和 3.1 @RestController 中的例子是等效的，也是返回 JSON 格式的数据。

@Controller
public class HelloWorldBMvcController{
    @RequestMapping("/helloworldB")
    @ResponseBody
    public String helloWorld() throws Exception {
        return "Hello, Spring Boot!";
    }
}
1
2
3
4
5
6
7
8

@Controller 主要用于构建 MVC 模式的程序。

3.3 @Service

它用于声明一个业务处理类（实现非接口类），用于标注服务层，处理业务逻辑。

例如，以下代码就是继承 ArticleService 来实现其方法。

/**
 * Description: 标注为服务类
 */
@Service
public class ArticleServiceImpl implements ArticleService {
    @Autowired
    private ArticleRepository articleRepository;
    /** 
    * Description：重写 service 接口的实现，实现根据 id 查询对象功能
    */
    @Override
    public Article findArticleByld(long id) {
        return articleRepository.findBvld(id);
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

3.4 @Repository

它用于标注数据访问层。

3.5 @Component

它用于把普通 POJO（Plain Ordinay Java Objects，简单的 Java 对象）实例化到 Spring 容器中。当类不属于注解 @Conroller 和 @Service 等时，就可以使用注解 @Component 这个类。它可以配合 CommandLineRunner 使用，以便在程序启动后执行一些基础任务。

Spring 会把被注解 @Conroller、@Service、@Repository、@Component 标注的类纳入 Spring 容器中进行管理。

3.6 @Configuration

它用于标注配置类，并且可以由 Spring 容器自动处理。它作为 Bean 的载体，用来指示一个类声明、一个或多个 @Bean 方法，在运行时为这些 Bean 生成 BeanDefinition 和服务请求。

3.7 @Resource

@Autowired 与 @Resource 都可以用来装配 Bean，也都可以写在字段上或 Seter 方法上。

public class AritcleController {
    @Resource
    private ArticleRepository articleRepository;
    /** 
    * Description: 新增保存方法
    */
    @PostMapping("")
    public String saveArticle(Article model) {
        articleRepository.save(model);
        return "redirect:/article/";
    }
}
1
2
3
4
5
6
7
8
9
10
11
12

3.8 @Autowired

它表示被修饰的类需要注入对象。Spring 会扫描所有被 @Autowired 标注的类，然后根据类型在 IoC 容器中找到匹配的类进行注入。被@Autowired 注解后的类不需要再导入文件。

3.9 @RequestMapping

它用来处理请求地址映射，用在类或方法上。如果用在类上，则表示类中的所有响应请求的方法都是以该地址作为父路径的。该注解有 6 个属性。

• Params：指定 Request 中必须包含某些参数值，才让该方法处理。
• Headers：指定 Request 中必须包含某些指定的 header 值，才能让该方法处理请求。
• Value：指定请求的实际地址，指定的地址可以是 URI Template 模式。
• Method：指定请求的 Method 类型，如 GET、POST、PUT、DELETE 等。
• Consumes：指定处理请求的提交内容类型 Content-Type，如 application/json,text/html。
• Produces：指定返回的内容类型。只有当 Request 请求头中的 Accept 类型中包含该指定类型时才返回。

3.10 @Transactional

它可以用在接口、接口方法、类及类方法上。

但 Spring 不建议在接口或者接口方法上使用该注解，因为该注解只有在使用基于接口的代理时才会生效。如果异常被捕获（try { } catch {}）了，则事务就不回滚了。如果想让事务回滚，则必须再往外抛出异常（try { } catch { throw Exception }。

3.11 @Qualifier

它的意思是 “合格者”，用于标注哪一个实现类才是需要注入的。需要注意的是，@Qualifier 的参数名称为被注入的类中的注解 @Service 标注的名称。

@Qualifier 常和 @Autowired 一起使用，如以下代码:

@Autowired
@Qualifier("articleService")
1
2

4.使用在方法上的注解

4.1 @RequestBody

它常用来处理 JSON / XML 格式的数据。通过 @RequestBody 可以将请求体中的（JSON / XML）字符串绑定到相应的 Bean上，也可以将其分别绑定到对应的字符串上。

举例：用 AJAX（前端）提交数据，然后在控制器（后端）接收数据。

在前端页面中使用 AJAX 提交数据的代码如下：

$.ajax({
    url:"/post",
    type:"POST",
    data:'{"name":"pipi"}',
    // 这里不能写成 content-type
    contentType:"application/json charset=utf-8",
    success:function(data){
        alert("request success !");
    }
});
1
2
3
4
5
6
7
8
9
10

在控制器中接收数据的代码如下：

@requestMapping("/post")
public void post(@requestBody String name){
    //省略
}
1
2
3
4

4.2 @PathVariable

用于获取路径中的参数。

4.3 @Bean

它代表产生一个 Bean，并交给 Spring 管理。用于封装数据，一般有 Setter、Getter 方法在 MVC 模型中，对应的是 M（模型）。

4.4 @ResponseBody

它的作用是通过转换器将控制器中方法返回的对象转换为指定的格式，然后写入 Response 对象的 body 区。它常用来返回 JSON / XML 格式的数据。

使用此注解后，数据直接写入输入流中，不需要进行视图渲染。用法见以下代码:

@GetMapping("/test")
@ResponseBody
public String test() {
    return "test";
}
1
2
3
4
5

5.其他常用注解

Spring Boot 提供的注解非常多，这里不可能面面俱到。在以后得博客中还会详细讲解一些注解。