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