Spring注解⼤全
⼀、Spring bean注解
1.1、@SpringBootApplication
申明让spring boot⾃动给程序进⾏必要的配置,这个配置等同于:@Configuration ,@EnableAutoConfiguration 和 @ComponentScan 三个配置。
1.2、@Component
泛指各种组件,就是说当我们的类不属于各种归类的时候(不属于@Controller、@Services等的时候),我们就可以使⽤@Component来标注这个类,把普通pojo实例化到spring容器中,相当于配置⽂件中的:<bean id="" class=""/>。
所以可以理解为@Component可以细化为@Reposity,@Service,@Controller。
@Component("conversionImpl")
//其实默认的spring中的Bean id 为 conversionImpl(⾸字母⼩写)
public class ConversionImpl implements Conversion {
@Autowired
private RedisClient redisClient;
}
1.3、@ComponentScan
@ComponentScan主要就是定义扫描的路径从中出标识了需要装配的类⾃动装配到spring的bean容器中。前⾯说到过@Controller注
解,@Service,@Repository注解,它们其实都是组件,属于@Component注解,⽽@ComponentScan注解默认会装配标识了
@Controller,@Service,@Repository,@Component注解的类到spring容器中。
//扫描com.demo下的组件
@ComponentScan(value="com.demo")
@Configuration
public class myConfig {
}
1.4、@Service
⼀般⽤于修饰service层的组件
@Service()
public class UserService{
@Resource
private UserDao userDao;
public void add(){
userDao.add();
}
}
1.5、@EnableAutoConfiguration
SpringBoot⾃动配置(auto-configuration):尝试根据你添加的jar依赖⾃动配置你的Spring应⽤。例如,如果你的classpath下存在HSQLDB,并且你没有⼿动配置任何数据库连接beans,那么我们将⾃动配置⼀个内存型(in-memory)数据库。你可以将@EnableAutoConfiguration或者@SpringBootApplication注解添加到⼀个@Configuration类上来选择⾃动配置。如果发现应⽤了你不想要的特定⾃动配置类,你可以使⽤@EnableAutoConfiguration注解的排除属性来禁⽤它们。
1.6、@Configuration
Spring3.0,相当于传统的xml配置⽂件,如果有些第三⽅库需要⽤到xml⽂件,建议仍然通过@Configuration类作为项⽬的配置主类可以使⽤@ImportResource 注解加载xml配置⽂件。
proxyBeanMethods属性默认值是true,也就是说该配置类会被代理(CGLIB),在同⼀个配置⽂件中调⽤其它被@Bean注解标注的⽅法获取对象时会直接从IOC 容器之中获取。
注意:@Configuration注解的配置类有如下要求:
@Configuration不可以是final类型;
@Configuration不可以是匿名类;
嵌套的configuration必须是静态类。
@Configuration
public class AppConfig {
// 未指定bean 的名称,默认采⽤的是 "⽅法名" + "⾸字母⼩写"的配置⽅式
@Bean
public MyBean myBean(){
return new MyBean();
}
}
1.7、@ConfigurationProperties
前缀定义了哪些外部属性将绑定到类的字段上
根据 Spring Boot 宽松的绑定规则,类的属性名称必须与外部属性的名称匹配
我们可以简单地⽤⼀个值初始化⼀个字段来定义⼀个默认值
类本⾝可以是包私有的
类的字段必须有公共 setter ⽅法
激活 @ConfigurationProperties
只有当类所在的包被 Spring @ComponentScan 注解扫描到才会⽣效,默认情况下,该注解会扫描在主应⽤类下的所有包结构。
可以通过添加 @Component 注解让 Component Scan 扫描到。
@Component
@ConfigurationProperties(prefix = "demo")
class DemoProperties {
}
也可以通过 Spring 的 Java Configuration 特性实现同样的效果。
@Configuration
class PropertiesConfig {
@Bean
public DemoProperties demoProperties(){
return new DemoProperties();
}
}
使⽤ @EnableConfigurationProperties 注解让我们的类被 Spring Boot 所知道,在该注解中其实是⽤了@Import(EnableConfigurationPropertiesImportSelecto r.class) 实现
@Configuration
@EnableConfigurationProperties(DemoProperties.class)
class PropertiesConfig {
}
Duration
Spring Boot 内置⽀持从配置参数中解析 durations (持续时间),给出了明确的说明。
配置 duration 不写单位,默认按照毫秒来指定,我们也可已通过 @DurationUnit 来指定单位。常⽤单位如下:
ns for nanoseconds (纳秒)
us for microseconds (微秒)
ms for milliseconds (毫秒)
s for seconds (秒)
m for minutes (分)
h for hours (时)
d for days (天)
@Data
@ConfigurationProperties(prefix = "demo")
class DemoProperties {
@DurarionUnit(ChronoUnit.SECONDS)
private Duration timeout;
}
DataSize
与 Duration 的⽤法⼀⽑⼀样,默认单位是 byte (字节),可以通过 @DataSizeUnit 单位指定
但是,我测试的时候打印出来结果都是以 B (bytes) 来显⽰。常见单位如下
B for bytes
KB for kilobytes
MB for megabytes
GB for gigabytes
TB for terabytes
1.8、@Import
@Import注解是引⼊带有@Configuration的java类。
@Configuration
@Import({MyImportSelector.class, MyImportBeanDefinitionRegistrar.class, MyImportSelector1.class})
public static class Config {
@Bean
public BeanDemo0 beanDemo() {
System.out.println("----beanDemo----");
springboot结构BeanDemo0 beanDemo0 = new BeanDemo0();
beanDemo0.setId(1);
beanDemo0.setName("123");
return beanDemo0;
}
}
1.9、@ImportResource
@ImportResource是引⼊spring配置⽂件.xml
@Configuration
@ImportResource(locations = {"l"})
public class BeanConfigTest {
}
1.10、@Resource、@Autowired和@Inject
@Resource和@Autowired都是做bean注⼊时使⽤。
@Resource的作⽤相当于@Autowired,只不过@Autowired按照byType⾃动注⼊。
1、共同点
两者都可以写在字段和setter⽅法上。两者如果都写在字段上,那么就不需要再写setter⽅法。
2、不同点
1.10.1、@Autowired
Spring 2.5 引⼊。@Autowired为Spring提供的注解,需要导⼊包org.springframework.beans.factory.annotation.Autowired,只按照byType注⼊。
@Autowired注解是按照类型(byType)装配依赖对象,默认情况下它要求依赖对象必须存在,如果允许null值,可以设置它的required属性为false。如果我们想使⽤按照名称(byName)来装配,可以结合@Qualifier注解⼀起使⽤。
public class TestServiceImpl {
// 下⾯两种@Autowired只要使⽤⼀种即可
@Autowired
private UserDao userDao; // ⽤于字段上
@Autowired
public void setUserDao(UserDao userDao) { // ⽤于属性的⽅法上
this.userDao = userDao;
}
@Autowired
@Qualifier("userDao")
private UserDao userDao;
}
1.10.2、@Resource
@Resource默认按照ByName⾃动注⼊,由J2EE提供,是JSR250规范的实现,需要导⼊javax.annotation实现注⼊。
@Resource有两个重要的属性:name和type,⽽Spring将@Resource注解的name属性解析为bean的名字,⽽type属性则解析为bean的类型。所以,如果使⽤name属性,则使⽤byName的⾃动注⼊策略,⽽使⽤type属性时则使⽤byType⾃动注⼊策略。如果既不制定name也不制定type属性,这时将通过反射机制使⽤byName⾃动注⼊策略。
public class TestServiceImpl {
// 下⾯两种@Resource只要使⽤⼀种即可
@Resource(name="userDao")
private UserDao userDao; // ⽤于字段上
@Resource(name="userDao")
public void setUserDao(UserDao userDao) {
// ⽤于属性的setter⽅法上
this.userDao = userDao;
}
}
注:最好是将@Resource放在setter⽅法上,因为这样更符合⾯向对象的思想,通过set、get去操作属性,⽽不是直接去操作属性。
@Resource装配顺序:
如果同时指定了name和type,则从Spring上下⽂中到唯⼀匹配的bean进⾏装配,不到则抛出异常。
如果指定了name,则从上下⽂中查名称(id)匹配的bean进⾏装配,不到则抛出异常。
如果指定了type,则从上下⽂中到类似匹配的唯⼀bean进⾏装配,不到或是到多个,都会抛出异常。
如果既没有指定name,⼜没有指定type,则⾃动按照byName⽅式进⾏装配;如果没有匹配,则回退为⼀个原始类型进⾏匹配,如果匹配则⾃动装配。
1.10.3、@Inject
@Inject是JSR330 (Dependency Injection for Java)中的规范,需要导⼊javax.inject.Inject;实现注⼊。@Inject可以作⽤在变量、setter⽅法、构造函数上。根据类型进⾏⾃动装配的,如果需要按名称进⾏装配,则需要配合@Named。
@Named("XXX") 中的 XXX是 Bean 的名称,所以 @Inject和 @Named结合使⽤时,⾃动注⼊的策略就从 byType 转变成 byName 了。
public class User{
private Person person;
@Inject
pbulic void setPerson(Person person){
this.person = person;
}
@Inject
pbulic void setPerson1(@Named("main")Person person)
{
this.person = person;
}
}
1.11、@Repository
⽤于注解dao层,在daoImpl类上⾯注解。
1.12、@Bean
产⽣⼀个Bean对象,然后这个Bean对象交给Spring管理。⽤@Bean标注⽅法等价于XML中配置的bean。
产⽣这个Bean对象的⽅法Spring只会调⽤⼀次,随后这个Spring将会将这个Bean对象放在⾃⼰的IOC容器中。SpringIOC 容器管理⼀个或者多个bean,这些bean都需要在@Configuration注解下进⾏创建,在⼀个⽅法上使⽤@Bean注解就表明这个⽅法需要交给Spring进⾏管理。
@Bean
public class UserTest(){
public User getUser(){
System.out.println("创建user实例");
return new User("张三",26);
}
}
@Bean 注解的属性有:value、name、autowire、initMethod、destroyMethod。
name 和 value 两个属性是相同的含义的,在代码中定义了别名。为 bean 起⼀个名字,如果默认没有写该属性,那么就使⽤⽅法的名称为该 bean 的名称。autowire指定 bean 的装配⽅式,根据名称和根据类型装配,⼀般不设置,采⽤默认即可。autowire指定的装配⽅式有三种Autowire.NO (默认设置)、Autowire.BY_NAME、Autowire.BY_TYPE。
initMethod和destroyMethod指定bean的初始化⽅法和销毁⽅法,直接指定⽅法名称即可,不⽤带括号。
public class MyBean {
public MyBean(){
System.out.println("MyBean Initializing");
}
public void init(){
System.out.println("Bean 初始化⽅法被调⽤");
}
public void destroy(){
System.out.println("Bean 销毁⽅法被调⽤");
}
}
@Configuration
public class AppConfig {
@Bean(initMethod = "init", destroyMethod = "destroy")
public MyBean myBean(){
return new MyBean();
}
}
1.13、@Scope
@Scope注解默认的singleton单例模式。
@Scope注解是springIoc容器中的⼀个作⽤域,在 Spring IoC 容器中具有以下⼏种作⽤域:基本作⽤域singleton(单例)、prototype(多例),Web 作⽤域(reqeust、session、globalsession),⾃定义作⽤域。
prototype原型模式:
@Scope(value=ConfigurableBeanFactory.SCOPE_PROTOTYPE)在每次注⼊的时候回⾃动创建⼀个新的bean实例
singleton单例模式:
@Scope(value=ConfigurableBeanFactory.SCOPE_SINGLETON)单例模式,在整个应⽤中只能创建⼀个实例
globalsession模式:
@Scope(value=WebApplicationContext.SCOPE_GLOBAL_SESSION)全局session中的⼀般不常⽤
@Scope(value=WebApplicationContext.SCOPE_APPLICATION)在⼀个web应⽤中只创建⼀个实例
request模式:
@Scope(value=WebApplicationContext.SCOPE_REQUEST)在⼀个请求中创建⼀个实例
session模式:
@Scope(value=WebApplicationContext.SCOPE_SESSION)每次创建⼀个会话中创建⼀个实例
@Configuration
public class myConfig {
//默认是单例的。不需要特别说明
@Bean("person")
public Person person(){
return new Person("binghe002", 18);
}
}
@Configuration
public class myConfig {
//Person对象的作⽤域修改成prototype,多例的
@Scope("prototype")
@Bean("person")
public Person person(){
return new Person("binghe002", 18);
}
}
1.14、@Value
@Value的作⽤是通过注解将常量、配置⽂件中的值、其他bean的属性值注⼊到变量中,作为变量的初始值。
(1)、普通注⼊
@Value("张三")
private String name; // 注⼊普通字符串
(2)、bean属性、系统属性、表达式注⼊,使⽤@Value("#{}")。bean属性注⼊需要注⼊者和被注⼊者属于同⼀个IOC容器,或者⽗⼦IOC容器关系,在同⼀个作⽤域内。
// 注⼊其他Bean属性:注⼊beanInject对象的属性another,类具体定义见下⾯
@Value("#{beanInject.another}")
private String fromAnotherBean;
// 注⼊操作系统属性
@Value("#{systemProperties['os.name']}")
private String systemPropertiesName;
//注⼊表达式结果
@Value("#{T(java.lang.Math).random() * 100.0 }")
private double randomNumber;
(3)、配置⽂件属性注⼊@Value("${}")
@Value("#{}")读取配置⽂件中的值,注⼊到变量中去。配置⽂件分为默认配置⽂件application.properties和⾃定义配置⽂件。
1.15、@RestController
Spring4,注解是@Controller和@ResponseBody的合集,表⽰这是个控制器bean,并且是将函数的返回值直接填⼊HTTP响应体中,是REST风格的控制器。
@RestController
@RequestMapping(“/demoInfo2”)
publicclass DemoController2 {
@RequestMapping("/test")
public String test(){
return "ok";
}
}
1.16、@Controller
在SpringMVC 中,控制器Controller 负责处理由DispatcherServlet 分发的请求,它把⽤户请求的数据经过业务处理层处理之后封装成⼀个Model ,然后再把该Model 返回给对应的View 进⾏展⽰。在SpringMVC 中提供了⼀个⾮常简便的定义Controller 的⽅法,你⽆需继承特定的类或实现特定的接⼝,只需使⽤
@Controller 标记⼀个类是Controller ,然后使⽤@RequestMapping 和@RequestParam 等⼀些注解⽤以定义URL 请求和Controller ⽅法之间的映射,这样的Controller 就能被外界访问到。此外Controller 不会直接依赖于HttpServletRequest 和HttpServletResponse 等HttpServlet 对象,它们可以通过Controller 的⽅法参数灵活的获取到。
⽤于定义控制器类,在spring 项⽬中由控制器负责将⽤户发来的URL请求转发到对应的服务接⼝(service层),⼀般这个注解在类中,通常⽅法需要配合注解@RequestMapping。⽰例代码:
@Controller
@RequestMapping(“/demoInfo”)
public class DemoController {
@Autowired
private DemoInfoService demoInfoService;
@RequestMapping("/hello")
public String hello(Map<String,Object> map){
System.out.println("DemoController.hello()");
map.put("hello","from TemplateController.helloHtml");
//会使⽤hello.html或者hello.ftl模板进⾏渲染显⽰.
return"/hello";
}
}
1.17、@RequestMapping
提供路由信息,是⼀个⽤来处理请求地址映射的注解,可⽤于类或⽅法上。⽤于类上,表⽰类中的所
有响应请求的⽅法都是以该地址作为⽗路径。RequestMapping注解有六个属性,下⾯我们把她分成三类进⾏说明(下⾯有相应⽰例)。
1、 value, method;
value:指定请求的实际地址,指定的地址可以是URI Template 模式(后⾯将会说明);
method:指定请求的method类型, GET、POST、PUT、DELETE等;
2、consumes,produces
consumes:指定处理请求的提交内容类型(Content-Type),例如application/json, text/html; produces:    指定返回的内容类型,仅当request请求头中的(Accept)类型中包含该指定类型才返回;
3、params,headers
params:指定request中必须包含某些参数值是,才让该⽅法处理。
headers:指定request中必须包含某些指定的header值,才能让该⽅法处理请求。
@RestController
@RequestMapping("/home")
public class IndexController {
/**
* 将多个请求映射到⼀个⽅法上去
*/
@RequestMapping(value = {
“”,
“/page”,
"page*”,
"view/*,**/msg"
})
String indexMultipleMapping() {
return "Hello from index multiple mapping.”;
}
/**
* 是否是必须传参
* /home/name?person=xyz 或 /home/name
*/
@RequestMapping(value = “/name”)
String getName(@RequestParam(value = "person”, required = false) String personName) {
return "Required element of request param”;
}
/
**
* 请求类型,请求参数,默认值
*/
@RequestMapping(value = "/name", method = RequestMethod.GET)
String getName(@RequestParam(value = "person", defaultValue = "John") String personName) {        return "Required element of request param";
}
/**
* 产⽣⼀个 JSON 响应
*/
@RequestMapping(value = "/prod", produces = {
"application/JSON"
})
@ResponseBody
String getProduces() {
return "Produces attribute";
}
/**
* 可以同时处理请求中的 JSON 和 XML 内容
*/
@RequestMapping(value = "/cons", consumes = {
"application/JSON",
"application/XML"
})
String getConsumes() {
return "Consumes attribute";
}
/**
* 根据请求中的消息头内容缩⼩请求映射的范围
*/
@RequestMapping(value = “/head”, headers = {
"content-type=text/plain”,
"content-type=text/html"
})
String post() {
return "Mapping applied along with headers”;
}
/**
* 可以让多个处理⽅法处理到同⼀个URL 的请求, ⽽这些请求的参数是不⼀样的
*/
@RequestMapping(value = “/fetch”, params = {
"personId=10"
})
String getParams(@RequestParam(“personId”) String id) {
return "Fetched parameter using params attribute = " + id;
}
/**
* 使⽤正则表达式来只处理可以匹配到正则表达式的动态 URI
*/
@RequestMapping(value = “/fetch/{id:[a-z]+}/{name}”, method = RequestMethod.GET)

版权声明:本站内容均来自互联网,仅供演示用,请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198,我们将在24小时内删除。