六、Spring 中注解的使用及区别

@Configuration ， @ComponentScan，
@Component，@Controller，@Service，@Repository，@RestController，
@Bean，@Scope，
@Autowired，@Resource，
@Qualifier，
@PostConstruct，@PreDestory，
@RequestMapping，@GetMapping，@PostMapping，@PutMapping，@DeleteMapping，@PatchMapping，
@RequestBody，@Validated，@Valid，@RequestParam，@PathVariable，
@ModelAttribute

@Configuration 作用于类上

作用：用 @Configuration 标注的类就相当于 xml 中的<beans> </beans>
注意：

  • @Configuration 不可以是final类型；
  • @Configuration 不可以是匿名类；
  • 嵌套的 configuration 必须是静态类。
package com.wl;

import org.springframework.context.annotation.Configuration;

@Configuration // 相当于 applicationContext.xml
public class ApplicationContext{
}
@ComponentScan 作用于类上，自动扫描组件

作用：扫描指定包下的组件，意思就是把指定包下有 @Component 或 @Controller 或 @Service或 @Repository 注解标注的类，注入到 spring 容器中。

使用示例：

Test 类

package com.wl.test;

import org.springframework.context.ApplicationContext;
import org.springframework.context.annotation.AnnotationConfigApplicationContext;
import org.springframework.context.annotation.ComponentScan;
import org.springframework.context.annotation.Configuration;

import com.wl.ioc.Apple;

@Configuration
@ComponentScan("com.wl.ioc")  // 等同于<context:component-scan base-package="com.wl.ioc" />
public class Test {

    public static void main(String[] args) {
        ApplicationContext ctx = new AnnotationConfigApplicationContext(Test.class);
        Apple apple = (Apple) ctx.getBean("apple");
        apple.show();
    }
}

Apple 类

package com.wl.ioc;

import org.springframework.stereotype.Component;

@Component
public class Apple implements Fruit {

    @Override
    public void show() {
        System.out.println("apple");
    }
}
@Bean 作用于返回实例的方法上

作用：返回 Bean 实例，相当于<beans><bean /></beans>中的<bean />部分。
属性：
value
name：默认为方法名，等同于 value，相当于 bean 的名称，二者不能同时使用。
autowire ： 表示该 bean 自动装配的类型，不推荐使用。
参数：Autowire.NO（默认），Autowire.BY_NAME，Autowire.BY_TYPE
initMethod：对象初始化调用方法。
destroyMethod：对象销毁调用方法。
使用示例

Test 类

package com.wl.test;

import org.springframework.beans.factory.annotation.Autowire;
import org.springframework.context.ApplicationContext;
import org.springframework.context.annotation.AnnotationConfigApplicationContext;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.ComponentScan;
import org.springframework.context.annotation.Configuration;

import com.wl.ioc.Banana;

@Configuration
@ComponentScan("com.wl.ioc")
public class Test {

    public static void main(String[] args) {
        ApplicationContext ctx = new AnnotationConfigApplicationContext(Test.class);
        Banana banana = (Banana) ctx.getBean("bana");
        banana.show();
    }
    
    @Bean(name = "bana")  // 不需要 Banana 类写 @Component 注解了，写了也不会报错
    public static Banana banana() {
        return new Banana();
    }
}

Banana 类

package com.wl.ioc;

public class Banana implements Fruit {

    @Override
    public void show() {
        System.out.println("banana");
    }

    public void init() {
        System.out.println("banana init");
    }

    public void destroy() {
        System.out.println("banana destroy");
    }

}
@Component 作用于类上

作用：将当前类交给 spring bean 工厂管理。
属性：value 不写，默认 value 值为类名（类名首字母小写）。
使用示例：
Fruit 接口

package com.wl.ioc;

public interface Fruit {
    void show();
}

Apple 类（要交给 bean 工厂管理的类）

package com.wl.ioc;

import org.springframework.stereotype.Component;

@Component(value = "apple")  // 等同于 <bean id="apple" class="com.wl.ioc.Apple" />
public class Apple implements Fruit {

    @Override
    public void show() {
        System.out.println("apple");
    }
}

Test 类

package com.wl.test;

import org.springframework.context.ApplicationContext;
import org.springframework.context.annotation.AnnotationConfigApplicationContext;
import org.springframework.context.annotation.ComponentScan;
import org.springframework.context.annotation.Configuration;

import com.wl.ioc.Apple;

@Configuration
@ComponentScan("com.wl.ioc")
public class Test {

    public static void main(String[] args) {
        ApplicationContext ctx = new AnnotationConfigApplicationContext(Test.class);
        Apple apple = (Apple) ctx.getBean("apple");
        apple.show();
    }
}
@Controller，@Service 和 @Repository 就是更加细化的 @Component ，使用方式与 @Component 相同。

@Controller：用于标注控制层，控制层
@Service：用于标注服务层，service 层
@Repository：用于标注数据访问层，dao 层

@RestController 作用于类上

@RestController = @Controller + @ResponseBody
作用：用于返回 json 数据。
使用示例（对比 IndexController1 和 IndexController2 完全理解）
IndexController1

package com.wl.controller;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;

import com.wl.model.Person;

@Controller
public class IndexController1 {

    @RequestMapping("/IndexController1/index1")
    public String index1() {
        return "index";
    }

    @RequestMapping("/IndexController1/index2")
    @ResponseBody
    public Object index2() {
        Person person = new Person("张三", "男");
        return person;
    }
}

IndexController2

package com.wl.controller;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;

import com.wl.model.Person;

@RestController
public class IndexController2 {

    @RequestMapping("/IndexController2/index1")
    public String index1() {
        return "index";
    }

    @RequestMapping("/IndexController2/index2")
    public Object index2() {
        Person person = new Person("张三", "男");
        return person;
    }
}

访问路径为：http://localhost:8080/IndexController1/index1
返回结果：index 页面（index.html 或 index.jsp）

访问路径为：http://localhost:8080/IndexController1/index2
返回结果：{"name":"张三","gender":"男"}

访问路径为：http://localhost:8080/IndexController2/index1
返回结果：index（字符串）

访问路径为：http://localhost:8080/IndexController2/index2
返回结果：{"name":"张三","gender":"男"}

@Scope 作用于类上或 配合 @Bean使用

作用：声明 bean 的作用域。
五种作用域：singleton（默认），prototype，request，session，global-session
作用域的说明参照 三、Bean的作用域及生命周期

@Autowired 作用于类成员变量，方法和构造函数，最常用

@Autowired 是 Spring 提供的注解
作用：按照类型注入。
注意：

  • 如果该类型在 IoC 容器中不止一个，就会按照名称注入。
  • 如果在 IoC 容器中没有找到该类型，则抛出异常，可以用 required=false 使注入类型可以为空。
@Resource 作用于类成员变量，方法和构造函数

@Resource 是 jdk 提供的注解，是 JSR250 规范实现的
作用：按照 bean 的名称（name）注入。

@Inject 作用于类成员变量，方法和构造函数

@Inject 是 jdk 提供的注解，是 JSR330 规范实现的
作用：按照类型注入，没有 required 属性。

@Qualifier 作用于类成员变量时必须与@Autowired连用，给方法参数注入时才可单独使用

作用：当 IoC 容器中同一类型存在多个 bean 实例，则需要使用 @Qualifier 注解指定注入的 bean 名称

@PostConstruct 用于指定初始化方法用在方法上

作用：对象初始化调用方法，等同于 @Bean 中 的 initMethod

@PreDestory 用于指定销毁方法（用在方法上）

作用：对象销毁调用方法，等同于 @Bean 中 的 destroyMethod

@RequestMapping 作用于TYPE（Class, interface包括注解和枚举类型）和METHOD

作用：接收浏览器发到控制器的请求，与其相似的还有@GetMapping，@PostMapping，@PutMapping，@DeleteMapping，@PatchMapping，主要属性如下

  1. path 指定请求路径的url
  2. value 和path属性是相同
  3. method 指定该方法的请求方式
  4. params 指定限制请求参数的条件
  5. headers 发送的请求中必须包含的请求头
@GetMapping 作用于METHOD

作用：处理 get 请求，

@PostMapping 作用于METHOD

作用：处理 post 请求，侧重添加

@DeleteMapping 作用于METHOD

作用：处理 delete 请求，侧重删除

@PutMapping 作用于METHOD

作用：处理 put 请求。侧重整体修改，一般修改都用这个

@PatchMapping 作用于METHOD

作用：处理 patch 请求，侧重局部修改，这个还没用过

@RequestBody 作用于PARAMETER

作用：用于接收前端传递给后端的 json 串，经常与@Valid或 @Validated一起使用，它会将 json 中的 key 与实体类中的属性实装（调用 setter）

@Validated 作用于PARAMETER，TYPE，METHOD

作用：校验传入参数是否符合规范，来自org.springframework.validation.annotation包

@Valid 作用于PARAMETER，METHOD，FIELD，CONSTRUCTOR，PARAMETER，TYPE_USE

作用：校验传入参数是否符合规范，来自javax.validation包

@RequestParam 作用于PARAMETER

作用：将请求参数绑定到控制器的方法参数上
属性：name / value 作用一样；required是否必传；defaultValue默认值

@PathVariable 作用于PARAMETER

作用：将URL中占位符参数{xxx}绑定到控制器类的方法形参中，RESTful风格请求（了解RESTful）
属性：name / value 作用一样，required是否必传

package com.wl.controller;

import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class HelloController {

    @ModelAttribute
    public void updateById(@PathVariable(name = "id",required = false) String id) {
        String str = "hello";
        return str + id;
    }

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

访问路径为：http://localhost:8080/update/45
运行结果：hello45
访问路径为：http://localhost:8080/update/
运行结果：hello

@ModelAttribute 作用于PARAMETER，METHOD

作用：作用在方法上，表示当前方法会在控制器方法前执行；作用在参数上，获取指定的数据给参数赋值。

package com.wl.controller;

import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.ModelAttribute;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class HelloController {

    @RequestMapping("/update/{id}")
    public void beforeMethodExecute(Model model) {
        String str = "hello";
        model.addAttribute("str", str);
    }

    @RequestMapping("/test1")
    public String test1(Model model) {
        return model.getAttribute("str");
    }

    @RequestMapping("/test2")
    public String test2(@ModelAttribute("str") String str) {
        return str;
    }
}

访问路径:http://localhost:8080/test1
运行结果：hello
访问路径:http://localhost:8080/test2
运行结果：hello

最后编辑于 ：
©著作权归作者所有,转载或内容合作请联系作者
  • 人面猴
    序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
    沈念sama阅读 216,258评论 6赞 498
  • 死咒
    序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
    沈念sama阅读 92,335评论 3赞 392
  • 救了他两次的神仙让他今天三更去死
    文/潘晓璐 我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
    开封第一讲书人阅读 162,225评论 0赞 353
  • 道士缉凶录：失踪的卖姜人
    文/不坏的土叔 我叫张陵，是天一观的道长。 经常有香客问我，道长，这世上最难降的妖魔是什么？ 我笑而不...
    开封第一讲书人阅读 58,126评论 1赞 292
  • 港岛之恋（遗憾婚礼）
    正文 为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
    茶点故事阅读 67,140评论 6赞 388
  • 恶毒庶女顶嫁案：这布局不是一般人想出来的
    文/花漫 我一把揭开白布。 她就那样静静地躺着，像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上，一...
    开封第一讲书人阅读 51,098评论 1赞 295
  • 城市分裂传说
    那天，我揣着相机与录音，去河边找鬼。 笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。 我是一名探鬼主播，决...
    沈念sama阅读 40,018评论 3赞 417
  • 双鸳鸯连环套：你想象不到人心有多黑
    文/苍兰香墨 我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
    开封第一讲书人阅读 38,857评论 0赞 273
  • 万荣杀人案实录
    序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
    沈念sama阅读 45,298评论 1赞 310
  • 护林员之死
    正文 独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,518评论 2赞 332
  • 白月光启示录
    正文 我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,678评论 1赞 348
  • 活死人
    序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
    沈念sama阅读 35,400评论 5赞 343
  • 日本核电站爆炸内幕
    正文 年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
    茶点故事阅读 40,993评论 3赞 325
  • 男人毒药：我在死后第九天来索命
    文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,638评论 0赞 22
  • 一桩弑父案，背后竟有这般阴谋
    文/苍兰香墨 我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,801评论 1赞 268
  • 情欲美人皮
    我被黑心中介骗来泰国打工， 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。 一个月前我还...
    沈念sama阅读 47,661评论 2赞 368
  • 代替公主和亲
    正文 我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
    茶点故事阅读 44,558评论 2赞 352