click here(github) to get English tutorial.
点击 这里 获取github上发布的各release版本。
Pure.IoC是一个轻量级基于类和注解的自动依赖注入框架。
使用jdk 1.8
此框架依赖于 Style函数式工具集 v1.1.1
如果需要debug输出,则还依赖于log4j 1.2.17
推荐与Spring配合使用
以**已有的逻辑关系**代替**复杂的配置**。
通常写java时会使用Spring框架进行IoC管理。而Spring是基于bean的,配置起来首先需要将类映射到bean,然后描述bean的依赖关系。
事实上,很多时候依赖关系仅仅需要类型即可确定。比如说
class A{ ... public void setB(B b){ this.b=b; } } class B{ }
很显然,A依赖于B,A需要将一个B的实例通过setB注入进来。这应当是很自然的逻辑关系。
类型依赖在编码时就会设定好,所以,如果有工具能帮助完成这类“显而易见”的依赖该多好。于是我开发了Pure.IoC
设计Pure.IoC时经历了不少思考。考虑下面这样的“复杂”情况(其实已经算不复杂了)
@Singleton @Wire class Complex{ private ...... public Complex(){ ... } @Default public Complex(AnotherClass obj){ ... } public void setA(A a){ ... } public void setB(B b){ ... } public void setInterface(Interf1 interf){ ... } public void setInterface(@Use(clazz=Impl2.class)Interf2 interf){ ... } } @Default(clazz=Impl1.class) interface Interf1{ ... }
上述注解描述了:
注解应当可以无限的附加,也不能增加系统复杂性。所以,最终使用这种设计:
AnnotationHandler + HandlerChain
AnnotationHandler分为四种,
Handler被注册到IOCController上,根据注册的顺序进行handling操作。handler的内部实现有点像AOP,一般来说会调用chain.next().handle(...) ,然后根据返回值或者异常进行一些逻辑判断。详情见各Handler接口的handle方法文档
所以,可以非常方便的进行注解的扩展。
循环依赖虽然不很常见,但没准会遇到。A->B->C->A从逻辑上,A,B,C中必须有一个是单例,否则对象的创建将无限循环下去。
另外: Spring要求构造器不能循环依赖,否则无法完成构建。
不过Pure.IoC巧妙的解决了循环依赖的问题。
所以,即使是构造器中包含循环依赖,也能顺利的进行(本质上所有依赖都是构造器依赖)。
Pure.IoC由于设计为构造时注入,所以不需要任何额外组建即可放入框架中使用。也可配合Spring使用。甚至可以一部分setter通过本框架注入,一部分通过Spring注入。
直接与Struts2等相接也可以。由于注入过程完全在类内部,所以并不需要像Spring一样配置接管Struts2的对象工厂,而是直接就可使用(一个对象本身就是注入“工厂”)。
推荐的使用方法是
extends AutoWire
但是有些情况下必须继承别的类,那么有两种解决办法:
1.
@Wire class A { ... }
@Wire注解标注的类在任何经过Pure.IoC的情况下都会进行注入操作。在单独获取时可使用
AutoWire.get(A.class)
获取实例
2.
class A { public A(){ AutoWire.wire(this); } }
构造时将自己的引用交给框架进行注入。
实际上所有入口最终都调用AutoWire.wire(Object)
接着在程序入口直接调用
IOCController.autoRegister();
或者手动register各Handler,比如
register(new DefaultConstructorFilter());
如果是JavaEE,则可以写一个Listener完成这种操作
最后使用
IOCController.closeRegistering();
关闭handler的注册。(这一步可选,仅仅为了保证存储handler的list不会被修改)
没有任何注解参与时的默认行为是:
注入setter时,获取参数类型并向IOCController请求实例,获取实例后进行setter的invoke。
在获取实例时,取得唯一一个构造器,或者取得无参数的构造器。
如果构造器有参数,则取得参数类型对应实例。
最后进行构造
Use(clazz, constant, variable)
clazz代表使用指定的类型作注入 接下来会对指定的类型进行Type检查。
constant代表之前在IOCController上注册的“常量”
variable代表之前在IOCController上注册的“变量”,必须是一些static的成员或者方法。
Force(value)将String类型的value转化为对应的类型。Force只支持基本类型和String
Ignore忽略该setter
Default()
在可能产生歧义时指定构造时默认使用的构造函数
此外,进行Param处理时还提供自动的基本类型注入。若没有找到可用的注入,则将检查基本类型和数组类型,并初始化为默认初始值(0,false,array[length=0])