目录
一、配置扫描路径(使用注解的方式存对象的前提)
二、使用类注解存储Bean对象
1、使用五大类注解存储Bean对象
2、为什么要这么多的类注解?
2.1、五大类注解之间的关系
3、获取Bean对象时的默认命名规则
三、使用方法注解来存储Bean对象
1、使用方法注解@Bean需要注意的事项
2、添加@Bean注解的方法的重命名
2.1、需要注意细节
上一篇博客中,说到的存储Bean对象的方式,每创建一个类都需要我们自己手动注入到spring中,这个过程比较繁琐。
Spring还有一种注入对象的方式,也就是使用注解。当我们学习使用Spring时,想要实现一个功能,首先需要考虑的是有没有实现对应功能的注解。下面我们来了解一下如何使用注解的方式来存储Bean对象。
一、配置扫描路径(使用注解的方式存对象的前提)
首先创建一个Spring项目,然后在resources包中创建一个spring-config.xml文件,然后向这个文件中配置下面的代码(Bean对象的扫描路径),这一步非常重要,如果这里出现问题,那么后续的操作都是纸上谈兵。这一步是使用注解向Spring中储存对象的基石(前提)。
spring-config.xml文件中添加的配置如下
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xmlns:content="http://www.springframework.org/schema/context"xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd http://www.springframework.org/schema/context https://www.springframework.org/schema/context/spring-context.xsd"><content:component-scan base-package="com.java.demo"></content:component-scan>
</beans>
上述的代码中<content:component-scan base-package="com.java.demo"></content:component-scan>是用来配置Bean的扫描根路径的。其中的base-package属性的值,就是配置的扫描路径。只有在这些目录中的类才会被扫描是否添加了注解,如果添加了注解,就将这些类存放到IoC容器中。
像下图中设置的扫描路径为com.java.demo,那么在扫描的时候,就会扫描这个目录中的所有类,并且包括这个目录中的子目录中的类也会扫描。所以我们在设置扫描路径的时候,尽可能的设置的详细一点,就好比我们设置的扫描路径为com,那么在扫描时,会将com中的所有类包括com目录中的子目录中的类也扫描一遍,这就会导致在启动类的时候工作量比较大,启动时间比较长。
二、使用类注解存储Bean对象
想要将对象存储在Spring中,有两种注解类型可以实现
- 类注解:@Controller(控制器)、@Service(服务)、@Repository(仓库)、@Component(组件)、@Configuration(配置)。
- 方法注解:@Bean
1、使用五大类注解存储Bean对象
1️⃣我们先使用@Controller来存储Bean对象,代码如下
package com.java.demo;import org.springframework.stereotype.Controller;@Controller
public class User {public void sayHi(){System.out.println("hello User.");}
}
我们类的创建需要在我们设置的扫描路径下,这样启动类获取对象时,可以扫描到这个User类使用了@Controller注解,就会将这个Bean对象存储到spring中
下面是获取IoC容器中的Bean对象,这个写法还是和上一个博客中写的获取Bean对象的方法一样,通过依赖查找来获取对象,默认情况下,Bean对象名称是以大驼峰方式命名类的小写形式(也就是Bean对象名默认为小驼峰形式)。
import com.java.demo.User;
import org.springframework.context.ApplicationContext;
import org.springframework.context.support.ClassPathXmlApplicationContext;public class App {public static void main(String[] args) {//1、得到容器对象ApplicationContext context = new ClassPathXmlApplicationContext("spring-config.xml");//2、得到Bean对象//这里获取Bean对象时,使用的对象名称是以大驼峰形式命名的类的小写形式(小驼峰)User user= context.getBean("user",User.class);//3、调用Bean方法user.sayHi();}
}
2️⃣使用@Service,@Repository,@Component,@Configuration注解来存储Bean对象,代码如下。
package com.java.demo;import org.springframework.stereotype.Service;@Service
public class UserService {public void sayHi(){System.out.println("hi,UserService.");}
}package com.java.demo;import org.springframework.stereotype.Repository;@Repository
public class UserRepository {public void sayHi(){System.out.println("hello UserRepository .");}
}package com.java.demo;import org.springframework.context.annotation.Configuration;@Configuration
public class UserConfiguration {public void sayHi(){System.out.println("hello userConfiguration .");}
}package com.java.demo;import org.springframework.stereotype.Component;@Component
public class UserComponent {public void sayHi(){System.out.println("hello userComponent .");}
}
import com.java.demo.*;
import org.springframework.context.ApplicationContext;
import org.springframework.context.support.ClassPathXmlApplicationContext;public class App2 {public static void main(String[] args) {//1、得到容器对象ApplicationContext context = new ClassPathXmlApplicationContext("spring-config.xml");//2、得到Bean对象UserRepository userRepository= context.getBean("userRepository", UserRepository.class);//3、调用Bean方法userRepository.sayHi();UserComponent userComponent= context.getBean("userComponent", UserComponent.class);userComponent.sayHi();UserConfiguration userConfiguration= context.getBean("userConfiguration", UserConfiguration.class);userConfiguration.sayHi();UserService userService= context.getBean("userService", UserService.class);userService.sayHi();}
}
可以看到只要这些使用了五大类注解的类在我们设置的扫描路径中,那么获取这些Bean对象时都会获取成功。
3️⃣但是如果我们创建的类,没有在扫描路径下,那么获取Bean对象时,就会失败。
这里我们创建一个student类,将其放在com目录下,来观察出现的结果。我们指定的扫描路径为com.java.demo.这里创建的student在com下,但是和Java目录同级,所以没有在扫描路径中。
package com;import org.springframework.stereotype.Component;@Component
public class Student {public void sayHi(){System.out.println("hello Student");}
}
4️⃣使用五大类注解存储Bean和使用XML格式存储Bean是可以混合使用的。
这种使用场景一般是,就像上述的student类,他在com目录下,而扫描路径是com.java.demo。想要使用这个Bean对象,如果使用注解的方式,就需要将扫描路径设置为com。这样扫描范围就非常的大,类启动的时候就会很慢。这种情况我们就可以使用XML格式存储Bean,其他的类还是使用类注解的方式存储Bean,扫描路径不变。
2、为什么要这么多的类注解?
上述进行了五大类注解的使用,最终结果都是将Bean对象存储到spring中,那么为什么需要这么多的注解呢?
这些注解都是通过在类上添加注解来告诉Spring容器它们的作用和职责,从而实现依赖注入和自动装配。它们使得开发人员能够更方便地管理和组织代码,并提供了灵活的配置和扩展性。
- @Controller:(控制器)将类标记为控制器组件,校验用户请求数据的正确性。
- @Service:(服务)将类标记为业务逻辑组件,服务、编排和调度具体执行方法,不会直接进行操作,根据请求判断具体调用哪个方法。
- @Repository:(数据持久层)将类标记为数据访问组件,用于直接与数据库进行交互
- @Component:(工具类层)将类标记为Spring容器的组件,为整个项目存放一些需要使用的组件,但是又和其他层没有什么实际交互。
- @Configuration:将类标记为配置类(项目中的一些配置)
上述的五大类注解也对应这个Java项目标准分层的层级,也就是说我们在写Java项目的时候需要按照这个分层类型来创建包和类,使用不同的注解,表示了这个类的作用,让程序员更好的管理程序代码。
2.1、五大类注解之间的关系
这些注解的作用都是相同的,都是将对象注入到对象中,所以他们之间一定存在一些共性的,我们来了解一下他们直接的关系。
可以看到五大类注解中,@Service(服务),@Repository(仓库),@Configuration(配置),@Controller(控制器)是基于@Component(组件)来实现的,这四个注解都是@Component的扩展。也可以理解为@Component是这个四个类注解的父类。
3、获取Bean对象时的默认命名规则
上述的代码中获取Bean对象的操作中,我们使用的对象名为小驼峰的形式,也就是类名的第一个字符小写其他字符不变形式。这种形式是使用类注解存储Bean对象之后,在获取对象时的默认形式,但是这个默认形成能够正常使用的前提是,这个类名是按照大驼峰的形式命名的,如果出现其他的类的命名方式,这个默认的用法就不能获取到Bean对象了。
下面我们使用一个列子来说明,我们创建一个UConfig类(不是按照大驼峰的形式命名的类),放在com.java.demo扫描路径下。然后来通过小驼峰的方式来命名Bean对象并获取(uConfig)观察结果。
package com.java.demo;import org.springframework.context.annotation.Configuration;@Configuration
public class UConfig {public void sayHi(){System.out.println("hello UConfig");}
}
使用小驼峰的形式命名对象名获取不到Bean对象,但是直接使用类名的方式可以作为对象名获取到Bean对象。
UConfig uConfig = context.getBean("UConfig", UConfig.class);
这里我们就需要看一下命名规则的源码了
按两下Shift键,idea就会弹出一个全局搜索的框,然后输入BeanName(查找对象的命名规则) ,然后点击圈出来的这个类。
进入AnnotationBeanNameGenerator类之后,找到下面的方法,他表示的就是生成BeanName
但是这个方法中并没有明确的写出Bean的命名,他最后调用的方法为创建默认对象名。进入这个方法继续查看。
进入decapitate方法,继续查看。这个方法给出了默认命名的细节实现。
如果类名的长度大于1并且满足第一个与第二个字符为大写,则构造的默认BeanName为原类名,按照大驼峰的规则命名的类名(第一个字符为大写,第二个字符为小写),构造的默认BeanName为原类名的小驼峰形式(第一个字符小写,其他字符不变)。
我们点击追踪,来查看一下这个默认命名的方法的实现,他是有JDK实现的。
✨ 总结:BeanName的规范命名规则
- 如果类名不存在或类名为空,BeanName为原类名
- 如果类名长度超过1,并且第一个与第二个字符为大写,则BeanName为原类名
- 类名按照大驼峰命名,也就是第一个字符大写,第二个字符小写,BeanName为原类名的小驼峰形式。
三、使用方法注解来存储Bean对象
1、使用方法注解@Bean需要注意的事项
我们说到类注解的时候,只需要将类注解加在类上就可以直接使用依赖查找的方式获取Bean对象,但是这里的方法注解的使用和类注解存在较大的差异。
1️⃣使用方法注解@Bean,需要方法的返回值是一个对象。
2️⃣方法注解@Bean不能单独使用,需要和五大类注解搭配使用。
这里我们通过一个示例来了解一下,创建一个普通的ArticleInfo(文章实体)类。给这个类并没有添加五大类注解。
package com.java.demo.model;import java.time.LocalDateTime;public class ArticleInfo {private int id;private String title;private String content;private LocalDateTime createTime;public void setId(int id) {this.id = id;}public void setTitle(String title) {this.title = title;}public void setContent(String content) {this.content = content;}public void setCreateTime(LocalDateTime createTime) {this.createTime = createTime;}@Overridepublic String toString() {return "ArticleInfo{" +"id=" + id +", title='" + title + '\'' +", content='" + content + '\'' +", createTime=" + createTime +'}';}
}
这里写一个伪代码,因为给文章实体类没有添加五大类注解,所以我们没有办法从容器中获取对象,这里我们自己在ArticleInfo方法中实例了一个对象,为其设置属性的值。给ArticleInfo方法添加@Bean注解。
package com.java.demo;import com.java.demo.model.ArticleInfo;
import org.springframework.context.annotation.Bean;import java.time.LocalDateTime;public class Articles {@Beanpublic ArticleInfo ArticleInfo(){//伪代码ArticleInfo articleInfo = new ArticleInfo();articleInfo.setId(1);articleInfo.setTitle("今天周几?");articleInfo.setContent("今天周一");articleInfo.setCreateTime(LocalDateTime.now());return articleInfo;}
}
获取bean对象
import com.java.demo.model.ArticleInfo;
import org.springframework.context.ApplicationContext;
import org.springframework.context.support.ClassPathXmlApplicationContext;public class App {public static void main(String[] args) {//1、得到容器对象ApplicationContext context = new ClassPathXmlApplicationContext("spring-config.xml");//2、得到Bean对象ArticleInfo articleInfo = context.getBean("ArticleInfo", ArticleInfo.class);//3、调用Bean方法System.out.println(articleInfo.toString());}
}
❓❓❓ 为什么方法注解不能和类注解一样,添加了之后就可以直接获取对象?
❗❗❗原因在与在我们创建的扫描路径中,存在很多类,每个类里面又存在很多方法,如果按照类注解的方式对目录中的方法进行扫描,那么程序的执行效率就会非常慢,所以规定在使用@Bean方法注解的时候,需要添加上类注解,这就相当于我们了解五大类注解的时候设置扫描路径是一个道理,精确扫描范围,提高程序的效率。
下面我们对Articles类添加一个类注解,表示扫描这个对象中的方法。再次执行扫描到添加了@Bean注解的方法的返回值就会被保存在容器中了,获取对象就会成功。
package com.java.demo;import com.java.demo.model.ArticleInfo;
import org.springframework.context.annotation.Bean;
import org.springframework.stereotype.Component;import java.time.LocalDateTime;@Component
public class Articles {@Beanpublic ArticleInfo ArticleInfo(){//伪代码ArticleInfo articleInfo = new ArticleInfo();articleInfo.setId(1);articleInfo.setTitle("今天周几?");articleInfo.setContent("今天周一");articleInfo.setCreateTime(LocalDateTime.now());return articleInfo;}
}
3️⃣我们使用方法注解@Bean将对象存入到容器中,我们在获取对象时默认的对象名为方法名。
2、添加@Bean注解的方法的重命名
使用依赖查找获取使用方法注解@Bean存储的对象时,传入的对象名默认的情况下为方法名,虽然说这样获取没有问题,但是在一个项目中的方法起名时有getXXX或者setXXX,用这种默认的方式获取对象,总是看起来不是很舒服。所以这里我们要说到重命名的问题。
@Bean注解是可以设置参数的,设置name属性就可以给存储的对象设置一个别名。
package com.java.demo;import com.java.demo.model.ArticleInfo;
import org.springframework.context.annotation.Bean;
import org.springframework.stereotype.Component;import java.time.LocalDateTime;@Component
public class Articles {@Bean("abc")public ArticleInfo ArticleInfo(){//伪代码ArticleInfo articleInfo = new ArticleInfo();articleInfo.setId(1);articleInfo.setTitle("今天周几?");articleInfo.setContent("今天周一");articleInfo.setCreateTime(LocalDateTime.now());return articleInfo;}
}import com.java.demo.model.ArticleInfo;
import org.springframework.context.ApplicationContext;
import org.springframework.context.support.ClassPathXmlApplicationContext;public class App {public static void main(String[] args) {//1、得到容器对象ApplicationContext context = new ClassPathXmlApplicationContext("spring-config.xml");//2、得到Bean对象ArticleInfo articleInfo = context.getBean("abc", ArticleInfo.class);//3、调用Bean方法System.out.println(articleInfo.toString());}
}
✨重命名@Bean的几种方式
//方式一
@Bean("abc");
//方式二
@Bean(name="abc")
//方式三
@Bean(value="abc")
//方式四:支持指定多个名称
@Bean(name={"abc","ddd","ccc"})
//方式五
@Bean(value={"aabc","ddd","eee"})
//方式六
@Bean({"aaa","bbb"})
2.1、需要注意细节
1️⃣当我们给Bean重命名了之后,就不能在使用Bean默认的对象名,也就是使用方法名获取对象,这个时候就会报错。
2️⃣在对Bean重命名时,不要使用当前类(以大驼峰形式命名的类)的小驼峰形式给Bean重命名,因为当前类添加了类注解,获取对象的时候默认是当前类名的小驼峰形式。当你获取Bean对象的时候,对象的名称重复了,就会报错。
3️⃣当我们对同一个类中多个方法返回的对象Bean重命名时,使用了相同的名字,这个时候程序执行的时候,从上往下执行,只会将第一个方法返回的Bean存储到Spring中,之后的相同名称的Bean就不会在存储到Spring中了,容器会忽略掉。
4️⃣当我们对不同类中的方法返回的对象Bean重命名时,使用了相同的名字,这个时候想要指定某个类中的方法先执行,我们使用@Order注解来控制类加载的顺序,在@Order()中设置的参数越大,表示当前类的加载权重越高,越先被加载,进而影响到类中方法的加载,也就影响到Spring中存放的是那个Bean了。
5️⃣在Spring中对一个方法添加了@Bean注解,那么这个方法不能设置参数。