Spring Dependency Lookup

Tìm kiếm phụ thuộc trong Spring

Tìm kiếm phụ thuộc là cách tìm kiếm phụ thuộc theo cách chủ động hoặc thủ công, thường cần phụ thuộc vào container hoặc API tiêu chuẩn để thực hiện.

Tìm kiếm phụ thuộc trong IoC có thể được chia thành các loại sau:

• Tìm kiếm theo tên Bean
• Tìm kiếm theo kiểu Bean
• Tìm kiếm theo tên Bean + kiểu Bean
• Tìm kiếm theo chú thích Java

Ngoài ra, tùy thuộc vào đối tượng Bean được tìm kiếm là đối tượng duy nhất hay tập hợp, và liệu có cần tìm kiếm chậm hay không, có các API khác nhau tương ứng.

Tìm kiếm theo kiểu đối tượng duy nhất

Giao diện tìm kiếm theo kiểu đối tượng duy nhất - BeanFactory

• Tìm kiếm theo tên Bean
  • getBean(String)
  • Spring 2.5 ghi đè tham số mặc định: getBean(String, Object…)
• Tìm kiếm theo kiểu Bean
  • Tìm kiếm Bean theo thời gian thực
    • Spring 3.0 getBean(Class)
    • Spring 4.1 ghi đè tham số mặc định: getBean(Class, Object…)
  • Tìm kiếm Bean theo thời gian chậm trong Spring 5.1
    • getBeanProvider(Class)
    • getBeanProvider(ResolvableType)
• Tìm kiếm theo tên Bean + kiểu Bean: getBean(String, Class)

Tìm kiếm theo kiểu tập hợp đối tượng

Giao diện tìm kiếm theo kiểu tập hợp đối tượng - ListableBeanFactory

• Tìm kiếm theo kiểu Bean
  • Lấy danh sách tên Bean cùng kiểu
    • getBeanNamesForType(Class)
    • Spring 4.2 ghi đè tham số mặc định: getBeanNamesForType(ResolvableType)
  • Lấy danh sách các đối tượng Bean cùng kiểu
    • getBeansOfType(Class) và các phương thức tương tự
• Tìm kiếm theo chú thích kiểu
  • Lấy danh sách tên Bean có chú thích kiểu
    • getBeanNamesForAnnotation(Class<? extends Annotation>)
  • Lấy danh sách các đối tượng Bean có chú thích kiểu
    • getBeansWithAnnotation(Class<? extends Annotation>)
  • Lấy đối tượng chú thích kiểu cụ thể cho Bean có tên cụ thể
    • findAnnotationOnBean(String, Class<? extends Annotation>)

Tìm kiếm theo cấu trúc phụ thuộc

Giao diện tìm kiếm theo cấu trúc phụ thuộc - HierarchicalBeanFactory

• BeanFactory cha: getParentBeanFactory()
• Tìm kiếm theo cấu trúc
  • Tìm kiếm theo tên Bean
    • Dựa trên phương thức containsLocalBean
  • Tìm kiếm danh sách các đối tượng Bean cùng kiểu
    • Kiểu đơn: BeanFactoryUtils#beanOfType
    • Kiểu tập hợp: BeanFactoryUtils#beansOfTypeIncludingAncestors
  • Tìm kiếm danh sách tên Bean dựa trên chú thích Java
    • BeanFactoryUtils#beanNamesForTypeIncludingAncestors

Tìm kiếm phụ thuộc lười biếng

Giao diện tìm kiếm phụ thuộc lười biếng của Bean

• org.springframework.beans.factory.ObjectFactory
• org.springframework.beans.factory.ObjectProvider (Mở rộng tính năng Java 8 cho Spring 5)
• Giao diện hàm
  • getIfAvailable(Supplier)
  • ifAvailable(Consumer)
• Mở rộng Stream - stream()

Tìm kiếm phụ thuộc an toàn

Loại tìm kiếm phụ thuộc	Cài đặt đại diện	An toàn
Tìm kiếm theo kiểu đơn	BeanFactory#getBean	Không
	ObjectFactory#getObject	Không
	ObjectProvider#getIfAvailable	Có
Tìm kiếm theo kiểu tập	ListableBeanFactory#getBeansOfType	Có
	ObjectProvider#stream	Có

Lưu ý: Sự an toàn của tìm kiếm phụ thuộc theo cấu trúc phụ thuộc vào giao diện BeanFactory mà nó mở rộng, đơn lẻ hoặc tập hợp.

Phụ thuộc có sẵn được tìm kiếm

Phụ thuộc có sẵn được tìm kiếm trong AbstractApplicationContext

Bean	Tên Bean	Sử dụng trong mã lệnh
environment	Đối tượng Environment	Cấu hình bên ngoài và Profiles
systemProperties	Đối tượng java.util.Properties	Thuộc tính hệ thống Java
systemEnvironment	Đối tượng java.util.Map	Biến môi trường hệ điều hành
messageSource	Đối tượng MessageSource	Văn bản đa ngôn ngữ
lifecycleProcessor	Đối tượng LifecycleProcessor	Xử lý Bean Lifecycle
applicationEventMulticaster	Đối tượng ApplicationEventMulticaster	Truyền tải sự kiện Spring

Phụ thuộc có sẵn được tìm kiếm trong ApplicationContext dựa trên chú thích (một phần)

Tên Bean	Đối tượng Bean	Sử dụng trong mã lệnh
org.springframework.context.annotation.internalConfigurationAnnotationProcessor	Đối tượng ConfigurationClassPostProcessor	Xử lý các lớp cấu hình Spring
org.springframework.context.annotation.internalAutowiredAnnotationProcessor	Đối tượng AutowiredAnnotationBeanPostProcessor	Xử lý các chú thích @Autowired và @Value
org.springframework.context.annotation.internalCommonAnnotationProcessor	Đối tượng CommonAnnotationBeanPostProcessor	(Kích hoạt điều kiện) Xử lý các chú thích JSR-250 như @PostConstruct
org.springframework.context.event.internalEventListenerProcessor	Đối tượng EventListenerMethodProcessor	Xử lý các phương thức lắng nghe sự kiện Spring được chú thích bằng @EventListener
org.springframework.context.event.internalEventListenerFactory	Đối tượng DefaultEventListenerFactory	Chuyển đổi phương thức lắng nghe sự kiện @EventListener thành ApplicationListener
org.springframework.context.annotation.internalPersistenceAnnotationProcessor	Đối tượng PersistenceAnnotationBeanPostProcessor	(Kích hoạt điều kiện) Xử lý các chú thích JPA

Các ngoại lệ kinh điển trong tìm kiếm phụ thuộc

Các lớp con của BeansException

Loại ngoại lệ	Điều kiện kích hoạt (ví dụ)	Ví dụ tình huống
NoSuchBeanDefinitionException	Khi tìm kiếm Bean không tồn tại trong container	BeanFactory#getBeanObjectFactory#getObject
NoUniqueBeanDefinitionException	Khi tìm kiếm theo kiểu Bean, container có nhiều hơn	BeanFactory#getBean(Class)
BeanInstantiationException	Khi Bean tương ứng với kiểu không phải là lớp cụ thể	BeanFactory#getBean
BeanCreationException	Khi khởi tạo Bean	Lỗi khi thực hiện phương thức khởi tạo Bean
BeanDefinitionStoreException	Khi cấu hình BeanDefinition không hợp lệ	Không thể mở tài nguyên cấu hình XML