License: Apache 2.0
jBeanBox是一个微形但功能较齐全的IOC/AOP工具,除了引入的第三方库之外,它的核心只有十多个类,源码只有1500行左右。它运用了“Box”编程模式,利用纯粹的Java类作为配置。jBeanBox运行于JDK1.6或以上。
jBeanBox的开发目的是要克服其它IOC/AOP工具的一些问题:
手工下载jbeanbox-2.4.8.jar放到项目的类目录,或在pom.xml中加入以下配置:
com.github.drinkjava2
jbeanbox
2.4.8
jBeanBox不依赖于任何第三方库,为避免包冲突,它将用到的CGLIB等第三方库以源码内嵌方式包含在项目中。jBeanBox的jar包尺寸较大,约为750K,如果用不到AOP功能,可以只使用它的DI内核,称为"jBeanBoxDI", 只有49k大小,将上面artifactId中的jbeanbox改成jbeanboxdi即可。jBeanBoxDI项目详见jbeanboxdi子目 录。
以下演示了9种不同的注入方式:
public class HelloWorld { public static class User { String name; public User() { } @VALUE("User1") public User(String name) { this.name = name; } void setName(String name) { this.name = name; } void init() {this.name = "User6";} @PreDestroy void end() {this.name= "User9";} } public static class UserBox extends BeanBox { Object create() {return new User("User2");} } public static class H7 extends UserBox {{setAsValue("User7");}} public static void main(String[] args) { User u1 = JBEANBOX.getInstance(User.class); User u2 = JBEANBOX.getBean(UserBox.class); User u3 = JBEANBOX.getBean(new BeanBox().injectConstruct(User.class, String.class, value("User3"))); User u4 = JBEANBOX.getBean(new BeanBox(User.class).injectValue("name", "User4" )); User u5 = JBEANBOX .getBean(new BeanBox(User.class).injectMethod("setName", String.class, value("User5"))); User u6 = JBEANBOX.getBean(new BeanBox().setBeanClass(User.class).setPostConstruct("init")); BeanBoxContext ctx = new BeanBoxContext(); Interceptor aop=new MethodInterceptor() { public Object invoke(MethodInvocation invocation) throws Throwable { invocation.getArguments()[0]="User8"; return invocation.proceed(); } }; User u7 = ctx.bind(String.class, "7").bind("7", H7.class) .getBean(ctx.getBeanBox(User.class).addMethodAop(aop, "setName",String.class).injectField("name", autowired())); System.out.println(u1.name); //Result: User1 System.out.println(u2.name); //Result: User2 System.out.println(u3.name); //Result: User3 System.out.println(u4.name); //Result: User4 System.out.println(u5.name); //Result: User5 System.out.println(u6.name); //Result: User6 System.out.println(u7.name); //Result: User7 u7.setName(""); System.out.println(u7.name); //Result: User8 ctx.close(); System.out.println(u7.name); //Result: User9 } }
这个例子的输出结果是依次打印出“User1” 、“User2”...到“User9”。下面遂一解释:
上例除了一头一尾外,主要演示了jBeanBox的Java方法配置,Java方法即可以动态执行,也可以在定义好的BeanBox类中作为固定配 置执行,固定的配置可以打下配置的基调,当固定配置需要变动时可以用同样的Java方法来进行调整(因为本来就是同一个BeanBox对象)甚至临时创建 出新的配置,所以jBeanBox同时具有了固定配置和动态配置的优点。另外当没有源码时,例如配置第三方库的实例,这时所有的注解方式配置都用不上,唯 一能用的只有Java配置方式。
上例中的value()方法是从JBEANBOX类中静态引入的全局方法,这个示例的源码位于单元测试目录下的HelloWorld.java。
jBeanBox不光支持Java方式配置,还支持注解方式配置,它支持以下注解:
@INJECT 类似于JSR中的@Inject注解,但允许添加目标类作为参数
@POSTCONSTRUCT 等同于JSR中的@PostConstruct注解
@PREDESTROY 等同于JSR中的@PreDestroy注解
@VALUE 类似于Spring中的@Value注解
@PROTOTYPE 等同于Spring中的@Prototype注解
@AOP 用于自定义AOP注解,详见AOP一节
jBeanBox还能自动识别并支持以下JSR及Spring的注解:
JSR的注解:@PostConstruct, @PreDestroy, @Inject, @Singleton, @scope(“prototype”), @scope(“singleton”)
Spring的注解:@Autowired @Prototype
因为注解方式配置大家都非常熟悉,这里就不作详细介绍了,在jBeanBox\test目录下能找到一 个"AnnotationInjectTest.java"文件,演示了各种注解方式配置的使用。另外还可以调用 ctx.setAllowSpringJsrAnnotation(false)去禁用JSR、Spring注解,也可以调用 ctx.setAllowAnnotation(false)去禁用所有注解(也就是说只能用Java方式配置了)。
关于注解方式配置,jBeanBox与其它IOC工具不同点在于:它不支持@Qualifer、@Name、@Provider这三个JSR330注解,这是因为笔者认为这3个注解在jBeanBox中可以用已有注解实现,如:
@Inject @Named("JDBC-URL") private String url; 在jBeanBox中可以用以下方式替代: @INJECT(JDBC_URL.class) private String url; //其中JDBC_URL.class是一个BeanBox类 或 @VALUE("$JDBC-URL") private String url; //$JDBC-URL值可以通过配置BeanBoxContext中的ValueTranslator来解释。 又如: @Named("p") public class Person {} 在jBeanBox中看来,Person类已经有了唯一的ID: Person.class, 无需再定义一个多余的“P”作为ID,所有静态定义的类,它的类本身就是唯一的ID。jBeanBox对于静态定义的类,默认均为单例类,所以每次ctx.getBean(Person.class)都会获得同一个单例对象。
@Named的问题是它是字符串类型的,无法利用IDE快速定位到配置文件,当项目配置很多时,不利于维护。
jBeanBox是一个无需定义Bean ID的IOC工具,注意:如果是手工动态创建的BeanBox配置,默认均为非单例类。如果用setSingleton(true)方法硬改成单例,那问 题来了,它的ID是什么? 很简单,它的唯一ID就是这个动态创建的配置实例本身。BeanBox box1=new BeanBox(A.class).setSingeton(true), 则每次ctx.getBeanBox(box1)就会获得同一个A类型的单例对象。当然,也可以用ctx.bind("id1",box1),则相当于手 工给它绑定了一个ID值"id1",可以用getBean("id1")来获取它。jBeanBox没有自动扫描、预创建单例之类的功能,所以它的启动非 常快速。如果有人有自动扫描、预创建单例、预绑定ID名之类的需求,必须手工编写一个工具类来实现这个目的(jBeanBox暂不提供),例如在程序运行 开始时调用一下ctx.getBean(A.class)就会在上下文中暂存一个A的单例类,下次访问时会直接从缓存中取。
示例一只是笼统演示了一下jBeanBox的Java方式配置,现在再回过头来详细介绍一下它的Java方式配置:
Java方式配置,对于BeanBox来说,还有两个特殊的方法create和config,如下示例:
public static class DemoBox extends BeanBox { public Object create(Caller caller) { A a = new A(); a.field1 = caller.getBean(B.class); return a; } public void config(Object o, Caller caller) { ((A) o).field2 = caller.getBean(C.class); } }
上例表示DemoBox中创建的Bean是由create方法来生成,由config方法来修改。create和config方法中的Caller参数可以省略,如果不需要利用这个Caller参数进行加载其它Bean的话。
jBeanBox功能大都可以用Java配置或注解配置两种方式来实现,同样地,它对AOP的支持也有两种方式:
public static class AopDemo1 { String name; String address; String email; //getter & setters... } public static class MethodAOP implements MethodInterceptor { public Object invoke(MethodInvocation invocation) throws Throwable { invocation.getArguments()[0] = "1"; return invocation.proceed(); } } public static class BeanAOP implements MethodInterceptor { public Object invoke(MethodInvocation invocation) throws Throwable { invocation.getArguments()[0] = "2"; return invocation.proceed(); } } public static class GlobalAOP implements MethodInterceptor { @Override public Object invoke(MethodInvocation invocation) throws Throwable { invocation.getArguments()[0] = "3"; return invocation.proceed(); } } public static class AopDemo1Box extends BeanBox { { this.injectConstruct(AopDemo1.class, String.class, value("0")); this.addMethodAop(MethodAOP.class, "setName", String.class); this.addBeanAop(BeanAOP.class, "setAddr*"); } } @Test public void aopTest1() { JBEANBOX.bctx().bind("3", GlobalAOP.class); JBEANBOX.bctx().addGlobalAop("3", AopDemo1.class, "setEm*"); AopDemo1 demo = JBEANBOX.getBean(AopDemo1Box.class); demo.setName("--"); Assert.assertEquals("1", demo.name); demo.setAddress("--"); Assert.assertEquals("2", demo.address); demo.setEmail("--"); Assert.assertEquals("3", demo.email); }
上面的命名规则采用“*”做为模糊匹配字符,代表任意长度、任意字符。
注解方式AOP只有两种类型,针对方法的和针对类的,没有针对上下文的。 注解方式需要用到一个特殊的注解@AOP,它是用来自定义自已的AOP注解用的,使用示例如下:
public static class Interceptor1 implements MethodInterceptor { public Object invoke(MethodInvocation invocation) throws Throwable { invocation.getArguments()[0] = "1"; return invocation.proceed(); } } public static class Interceptor2 implements MethodInterceptor { public Object invoke(MethodInvocation invocation) throws Throwable { invocation.getArguments()[0] = "2"; return invocation.proceed(); } } @Retention(RetentionPolicy.RUNTIME) @Target({ ElementType.TYPE }) @AOP public static @interface MyAop1 { public Class value() default Interceptor1.class; public String method() default "setNa*"; } @Retention(RetentionPolicy.RUNTIME) @Target({ ElementType.METHOD }) @AOP public static @interface MyAop2 { public Class value() default Interceptor2.class; } @MyAop1 public static class AopDemo1 { String name; String address; public void setName(String name) { this.name = name; } @MyAop2 public void setAddress(String address) { this.address = address; } } @Test public void aopTest1() { AopDemo1 demo = JBEANBOX.getBean(AopDemo1.class); demo.setName("--"); Assert.assertEquals("1", demo.name); demo.setAddress("--"); Assert.assertEquals("2", demo.address); }
本文所说的AOP是针对Aop alliance联盟标准的接口来说的,它已经被包含在jBeanBox中,无需再单独引入(当然重复引入也不会有问题)。Aop alliance联盟标准是比较有用的一个接口,实现了各种AOP实现之间的互换性,基于它,jBeanBox可以替换掉Spring的内核而使用它的声 明式事务,这种互换性能够实现的前提就是因为Spring的声明式事务实现(如TransactionInterceptor)也实现了Aop alliance联盟标准接口MethodInterceptor。
jBeanBox从2.4.8版本起,AOP功能大副削减,去掉了不常用的前置、后置、异常切面功能,只保留了支持AOP alliance联盟标准接口MethodInterceptor的功能(注意在CGLIB也有一个同名的接口,不要混淆)。实现了 MethodInterceptor接口的类,通常称为Interceptor,但在jBeanBox中图省事,也把它称为AOP,毕竟写成 addBeanAop要比写成addBeanInterceptor简洁一些。
jBeanBox具备循环依赖检测功能,如果发现循环依赖注入(如A构造器中注入B,B的构造器中又需要注入A),将会抛出BeanBoxException运行时异常。 但是,以下这种字段或方法中出现的循环依赖注入在jBeanBox中是允许的:
public static class A { @Inject public B b; } public static class B { @Inject public A a; } A a = JBEANBOX.getBean(A.class); Assert.assertTrue(a == a.b.a);//true
jBeanBox支持多个上下文实例(BeanBoxContext),每个上下文实例都是互不干拢的。例如一个User.class可以在3个上 下文中各自用不同的配置方式(注解、Java)生成3个单例,这3个“单例”都是相对于当前上下文唯一的,它们的属性与各自的配置有关。
JBEANBOX.getBean()方法是利用了一个缺省的全局上下文,可以用JBEANBOX.bctx()方法来获取,所以如果一个项目中不 需要用到多个上下文,可以直接使用JBEANBOX.getBean()方法来获取实例,这样可以节省一行创建一个新上下文的代码。
BeanBoxContext的每个实例都在内部维护着配置信息、单例缓存等,在BeanBoxContext实例的close方法被调用后,它的 配置信息和单例被清空,当然,在清空之前,所有单例类的PreDestroy方法(如果有的话)被调用运行。所以对于需要回调PreDestroy方法的 上下文来说,在关闭时不要忘了调用close方法。对于缺省的全局上下文来说就是JBEANBOX.close()方法。
BeanBoxContext的常用方法详解:
以下为jBeanBox的性能与其它IOC工具的对比(只对比DI注入功能,搭建一个由6个对象组成的实例树),可见jBeanBox创建非单例的 速度大约为Guice的一半,但依然要比Spring快得多,是Spring的45倍左右。测试程序详见:[di-benchmark](https://github.com/drinkjava2/di-benchmark)
Runtime benchmark, fetch new bean for 500000 times: --------------------------------------------------------- Vanilla| 31ms Guice| 1154ms Feather| 624ms Dagger| 312ms Genie| 609ms Pico| 4555ms jBeanBoxNormal| 2075ms jBeanBoxTypeSafe| 2371ms jBeanBoxAnnotation| 2059ms SpringJavaConfiguration| 92149ms SpringAnnotationScanned| 95504ms Split Starting up DI containers & instantiating a dependency graph 4999 times: ------------------------------------------------------------------------------- Vanilla| start: 0ms fetch: 0ms Guice| start: 1046ms fetch: 1560ms Feather| start: 0ms fetch: 109ms Dagger| start: 46ms fetch: 173ms Pico| start: 376ms fetch: 217ms Genie| start: 766ms fetch: 247ms jBeanBoxNormal| start: 79ms fetch: 982ms jBeanBoxTypeSafe| start: 0ms fetch: 998ms jBeanBoxAnnotation| start: 0ms fetch: 468ms SpringJavaConfiguration| start: 51831ms fetch: 1834ms SpringAnnotationScanned| start: 70712ms fetch: 4155ms Runtime benchmark, fetch singleton bean for 5000000 times: --------------------------------------------------------- Vanilla| 47ms Guice| 1950ms Feather| 624ms Dagger| 2746ms Genie| 327ms Pico| 3385ms jBeanBoxNormal| 188ms jBeanBoxTypeSafe| 187ms jBeanBoxAnnotation| 171ms SpringJavaConfiguration| 1061ms SpringAnnotationScanned| 1045ms
虽然IOC工具大多应用在单例场合,性能大家都差不多(因为从缓存中取),但是如果遇到必须生成非单例的场合,例如每次访问生成一个新的页面实例,这时候Spring就不够看了, 至于启动速度,则更是慢到离谱了。
以上就是对jBeanBox的介绍,没有别的文档了,因为毕竟它的核心源码也只有1千多行(第三方工具如CGLIB、JSR接口等不算在内),有问题去看看它的源码可能更简单一些。
更多关于jBeanBox的用法还可以在jSqlBox项目中看到它的运用(数据源的配置、声明式事务示例等)。
jBeanBox是一个微形(只有单个Java文件约1000行源码)但功能较齐全的IOC/AOP工具,利用了Java的初始化块实现的Java配 置代替XML,比目前Spring或Guice的Java配置更简单更实用。jBeanBox遵循BSD-3开源协议,目前的版本是jBeanBox2.2。 其他一些IOC / AOP框架问题: 1)Spring,HiveMind的和其他IOC/AOP工具使用XML
jBeanBox第一版终于完成了,已更新到项目目录https://sourceforge.net/projects/jbeanbox/ 下,有兴趣的可以看一看。 这个项目的主要特点: 1)简单,只用一个Java文件实现了IOC/AOP功能,源码不到350行,由此可见实现IOC/AOP实际上很简单。 2) 用Java类代替XML作为配置文件,Java作为配置文件的主要优点是IDE支持类名检查、重构。
1、Aop 1.1、get(...) Aop.get(...) 可以在任意时空创建对象并且对其进行依赖注入,例如: Service service = Aop.get(Service.class); 以上代码会创建 Service 对象,如果 Service 中使用了 @Before 配置过拦截器,那么会生效,如果 Service 中的属性使用了 @Inject,则会被注入依赖对象。 1.2、in
我创造了一个切入点。但它不起作用。请协助我下面的代码。http://www.springframework.org/schema/beans/spring-beans-3.0.xsd http://www.springframework.org/schema/aop/spring-aop-3.0.xsd“> https://pastebin.com/qi0cjkjj
我编写了一组简单的类,向一位朋友演示如何为AOP(而不是xml配置)使用注释。我们无法使@ComponentScan工作,并且AnnotationConfigApplicationContext getBean的行为也不正常。我想明白两件事。请参阅下面的代码: PersonOperationSI.java PersonOperations.java PersonOperationsConfigCl
下面是我的代码片段: 服务我mpl.java 现在,我想要的是每当从方法worker(请求,字符串id)抛出null点异常时,我想要执行一些特定的任务,如上图所示。为此,我编写了一个方面类,如下所示: 我的方面。Java语言 电流输出: 期望输出: 如您所见,没有被触发,因此没有打印值。这是什么原因? 注: > 还尝试更改方法的名称,以消除任何也不起作用的重载问题。 到目前为止,尝试了各种其他切入
概念介绍 AOP(Aspect-oriented programming)即 面向切面的程序设计,AOP 和 OOP(Object-oriented programming)面向对象程序设计一样都是一种程序设计思想,AOP 只是 OOP 的补充和延伸,可以更方便的对业务代码进行解耦,从而提高代码质量和增加代码的可重用性。后面的篇章会结合实际案例,教会大家理解并学会使用 AOP。 AOP 并不规定必
AOP,面向方面的编程需要将程序逻辑分解为称为所谓的关注点的不同部分。 跨越应用程序多个点的功能称为跨领域问题,这些跨领域问题在概念上与应用程序的业务逻辑分开。 有许多常见的好例子,如日志记录,审计,声明式事务,安全性,缓存等。 OOP中模块化的关键单元是类,而在AOP中,模块化单元是方面。 依赖注入可以帮助您将应用程序对象相互分离,AOP可以帮助您将交叉问题与它们所影响的对象分离。 AOP就像P
介绍 首先,你不要看到 AOP 就感觉好难好复杂,看下去其实也就那样。而且在 imi 中你也不一定需要用到AOP,这是非必须的。 AOP 的概念通过搜索引擎一定是看烦了,而且看了也没什么大卵用,不贴近实际。 我先举个 AOP 实际应用的简单例子,比如在写一个方法的时候,可能要针对某个方法写前置和后置操作,传统写法如下: abstract class ParentClass { public
在webapp中,我使用Spring AOP在来电时检查服务的授权,并在返回结果时管理消息(info、warn、error)。使用方面可以节省代码行并概括服务的行为(而且看起来很性感^^)。 所以我在应用程序上下文中有这种类型的conf 我的方面看起来是这样的: 在执行任何标记为的方法之前,应该触发方法,这是一种解脱。