Skip to content

Latest commit

 

History

History
executable file
·
124 lines (108 loc) · 6.16 KB

README.md

File metadata and controls

executable file
·
124 lines (108 loc) · 6.16 KB
Raw

play-ioc

简单可控的IoC容器

target

  • 稳定健壮(ing)的IoC和AOP功能
  • 与Spring相同的使用方式
  • lite版仅支持IoC，不支持AOP，不推荐使用play-ioc-lite
  • 推荐使用开箱即用的play-mvc

overview

  • 支持从xml中读取bean配置

  • 支持从注解中读取bean配置

  • ApplicationContext加载bean默认采用立即初始化，DefaultListableBeanFactory默认采用懒加载

  • 仅支持单例bean，不支持多实例

  • 目前暂不支持：

    • 暂不支持@Autowired，需要显式配置Bean
    • 不支持introduction引入增强，仅支持weave
    • 不支持指定aop生成代理对象的方式，默认使用JdkDynamicAopProxy，目标对象未实现接口时使用CglibAopProxy
    • 不支持动态代理指定构造函数参数
    • 不支持将bean的value类型配置为set,list,map，仅支持字符串和ref
    • 不支持为bean指定别名
    • 不支持构造注入与方法注入，仅支持属性注入
    • 不支持xml中指定扫描指定包，仅支持注解扫描指定包
    • 不支持创建和使用除 play-ioc支持的xml配置说明 外的自定义xml标签
    • 不支持将嵌套子元素作为属性，仅支持统一使用扁平方式指定属性
      • 不支持innerBean的写法，建议扁平化定义bean，使用ref属性引用其他bean
      • <property name="fieldName" value="valueHere"/>
      • <property name="fieldName"> <value="valueHere"></value> </property>
      • <property name="person"> <bean class="a.b.Person.class"></bean> </property>
    • 不支持xml格式校验和属性名校验，请手动检查
    • 不支持属性编辑器，默认自动转换基本类型对象，需要在源码上定制处理Date、File等字段
    • ...

  • 源码参考了 spring-framework 和tiny-spring

dev

 git clone https://github.com/datalking/play-ioc.git
 cd play-ioc/
 ./start-build-dev.sh

demo

使用 AnnotationConfigApplicationContext

// 指定要扫描的包名
ApplicationContext ctx = new AnnotationConfigApplicationContext("com.github.datalking.bean");
BeanAllStr beanAllStr = (BeanAllStr) applicationContext.getBean("beanAllStr");
System.out.println(beanAllStr);

使用 ApplicationContext

ApplicationContext applicationContext = new ClassPathXmlApplicationContext("beans-primitive.xml");
BeanAllStr beanAllStr = (BeanAllStr) applicationContext.getBean("beanAllStr");
System.out.println(beanAllStr);

使用 DefaultListableBeanFactory

// 初始化BeanFactory
AbstractBeanFactory beanFactory = new DefaultListableBeanFactory();
// 读取配置
XmlBeanDefinitionReader xmlBeanDefinitionReader = new XmlBeanDefinitionReader((BeanDefinitionRegistry) beanFactory);
xmlBeanDefinitionReader.loadBeanDefinitions("beans-primitive.xml");
BeanAllStr beanAllStr = (BeanAllStr) beanFactory.getBean("beanAllStr");
System.out.println(beanAllStr);

todo

  • cglib实现aop

  • @Order 注解控制配置类的加载顺序

  • aop织入顺序 @Order 注解支持

  • getBean By class

  • 支持别名

  • xml新增支持constructor-args元素

  • 处理嵌套bean的问题

  • xml中同名bean抛出异常

  • 处理AOP中的循环依赖

  • jdk动态代理实现aop

  • 支持BeanPostProcessor

  • 支持@ComponentScan配置basePackages

  • 手动通过注解注册bean生成BeanDefinition: @Configuration @Bean

  • 各种BeanDefinition转换成RootBeanDefinition

  • ApplicationContext支持开启与关闭懒加载

later

  • 通过@EnableAspectJAutoProxy的 proxyTargetClass 强制使用cglib生成代理对象
  • 同一个类同时被@Component标记和@Bean工厂方法标记时，要抛出异常
  • 支持@ComponentScan配置basePackageClasses
  • 支持@ComponentScans
  • 使用@Configuration、@Bean时支持调用带参数的构造函数
  • 使用@Configuration、@Bean时支持static方法
  • 扫描指定包时利用asm实现所有子包.class文件的不加载，最初是预加载指定包获取bean信息
  • 注解支持 @Named, @Injected
  • 解决多重嵌套依赖问题
  • ConfigurationClassParser.doProcessConfigurationClass()处理@ComponentScan后再次扫描@Configuration
  • ConfigurationClassParser.doProcessConfigurationClass()处理@Import的循环引用问题

user guide

  • play-ioc支持的xml配置说明
    • 顶层标签为 <beans>
    • <bean> 元素可配置 id,name,class属性，class必须，id和name都可选
    • <property> 元素可配置 name,value,ref属性，name必须，value和ref二选一
  • BeanDefinition保存bean属性元数据，包括beanClass和propertyValues
    • beanClass在xml读取阶段是字符串，在实例创建阶段是class对象
    • propertyValues存储属性键值对，在xml读取阶段是都是字符串，特殊的是ref属性会处理成RuntimeBeanReference
  • BeanDefinitionReader读取bean配置
    • 最终存储到DefaultListableBeanFactory的 beanDefinitionMap
    • 此时bean所对应的class可能未加载，一定未实例化，实例化一定发生在调用getBean()方法时
  • AbstractAutowireCapableBeanFactory的doCreateBean()方法会创建bean实例
    • bean实例最终保存到DefaultSingletonBeanRegistry的 singletonObjects
  • 注解相关
    • 使用注解时，要用 @Configuration，表示一个配置类，相当于配置文件的 <beans>， 同一个类上还可以配置 @ComponentScan、@EnableAspectJAutoProxy
    • @ComponentScan不设置值时，默认扫描该类所在的包及所有子包

License

MIT