play-ioc

simple ioc container with aop support.

License

License

MIT
Categories

Categories

Data
GroupId

GroupId

com.github.datalking
ArtifactId

ArtifactId

play-ioc
Last Version

Last Version

0.0.3
Release Date

Release Date

Type

Type

jar
Description

Description

play-ioc
simple ioc container with aop support.
Project URL

Project URL

https://github.com/datalking/play-ioc
Source Code Management

Source Code Management

https://github.com/datalking/play-ioc/tree/master

Download play-ioc

How to add to project

<!-- https://jarcasting.com/artifacts/com.github.datalking/play-ioc/ -->
<dependency>
    <groupId>com.github.datalking</groupId>
    <artifactId>play-ioc</artifactId>
    <version>0.0.3</version>
</dependency>
// https://jarcasting.com/artifacts/com.github.datalking/play-ioc/
implementation 'com.github.datalking:play-ioc:0.0.3'
// https://jarcasting.com/artifacts/com.github.datalking/play-ioc/
implementation ("com.github.datalking:play-ioc:0.0.3")
'com.github.datalking:play-ioc:jar:0.0.3'
<dependency org="com.github.datalking" name="play-ioc" rev="0.0.3">
  <artifact name="play-ioc" type="jar" />
</dependency>
@Grapes(
@Grab(group='com.github.datalking', module='play-ioc', version='0.0.3')
)
libraryDependencies += "com.github.datalking" % "play-ioc" % "0.0.3"
[com.github.datalking/play-ioc "0.0.3"]

Dependencies

compile (6)

Group / Artifact Type Version
aopalliance : aopalliance jar 1.0
org.aspectj : aspectjweaver jar 1.6.11
cglib : cglib-nodep jar 3.1
org.slf4j : slf4j-api jar 1.7.21
log4j : log4j jar 1.2.17
org.slf4j : slf4j-log4j12 jar 1.7.21

test (1)

Group / Artifact Type Version
junit : junit jar 4.12

Project Modules

There are no modules declared in this project.

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-frameworktiny-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

com.github.datalking

data talking

talk is cheap, show me the data

Versions

Version
0.0.3
0.0.2
0.0.1