依赖注入与JSR-330的参考实现——Guice
2016-11-24 11:03
375 查看
转载自http://wwsun.github.io/posts/di-guice-post.html
依赖注入与JSR-330的参考实现——Guice
Mar 13, 2015
依赖注入(控制反转的一种形式),它是Java开发主流中一个重要的编程范式(思维方式)。简单的说,使用DI技术可以让对象从别处获得依赖项,而不是由它自己来构造。使用DI有很多好处,它能降低代码之间的耦合度,让代码更易于测试、更易读。Java DI的官方标准是JSR-330,本文我们还会介绍JSR-330的参考实现Guice 3,一个轻量级 的DI框架。
IoC and DI
使用IoC范式编程时,程序逻辑的流程通常是由一个功能中心来控制的。而使用IoC,这个“中心控制”的设计原则会被反转过来。调用者的代码处理程序的执行顺序,而程序逻辑则被封装在接受调用的子流程中。通过一个例子来理解IoC:
在GUI应用中,GUI框架负责控制调用事件处理器,而不是应用逻辑。当用户点击了一个动作,比如“向前”,GUI框架会自动调用 对应的事件处理器,而应用逻辑可以把重点放在处理动作上。程序的控制被反转了,将控制权由应用逻辑转移到了GUI框架。
IoC也被称为好莱坞原则:会有另一段代码拥有最初的控制线程,并且由它来调用你的代码,而不是由你的代码调用它。
不要给我们打电话,我们会打给你。——好莱坞原则
IoC有多种不同的实现,包括工厂模式、服务器定位模式,当然还有依赖注入。需要注意的是,DI并不等于IoC,DI只是IoC的一种实现方式,IoC是一种机制。
DI是IoC的一种特定形态,是指寻找依赖项的过程不在当前执行代码的直接控制之下。Java中为DI提供的容器有Guice、Spring、PicoContainer等。DI的好处有:松耦合、易测试、强内聚、可重用、更轻盈的代码。
Example
下面编写代码来解释到底什么是DI,如何使用DI。我们首先编写传统的代码,然后使用工厂模式解耦,进而再使用DI来改进代码,通过这个过程,你将了解到DI的精妙之处。这些改进都基于同一个关键技术,即面向接口编程。
假设你想找到所有对Java可开发人员比较友善的好莱坞经纪人。首先,我们有了一个AgentFinder接口,及其两个实现类SpreadSheetAgentFinder和WebServiceAgentFinder。AgentFinder接口如下:
public interface AgentFinder {
public List findAllAgents();
}
传统方式寻找友善经纪人
为了找到经纪人,项目中有个默认的HollywoodService类,它会从SpreadSheetAgentFinder里得到一个经纪人列表,并且过滤出友善的经纪人,最终返回该列表。
public class HollywoodService {
public static List getFriendlyAgents() {
AgentFinder finder = new SpreadsheetAgentFinder();
List agents = finder.findAllAgents();
List friendlyAgents = filterAgents(agents,”Java Developers”);
}
这是最传统的编码方式,显然,HollywoodService被SpreadsheetAgentFinder这个AgentFinder的具体实现死死的绑定住了。
为了改进这个问题,通常我们会想到一个常用的设计模式——工厂模式。工厂模式可以一定程度上解耦程序,它也是IoC的一种实现方式。
工厂模式
利用工厂模式(其实这里用到的是一个简单工厂)重新编写上面的代码,如下:
public List getFriendlyAgents(String agentFinderType) {
AgentFinderFactory factory = AgentFinderFactory.getInstance();
AgentFinder finder = factory.getAgentFinder(agentFinderType);
List agents = finder.findAllAgents();
return filterAgents(agents, “Java Developers”);
}
如你所见,这里不再有具体的实现来黏住你,而是通过注入agentFinderType的方式让你选择想要的AgentFinder。但这里仍然还有问题:
代码注入的仅仅是一个引用凭据(agentFinderType),而不是真正实现AgentFinder的对象
方法getFriendlyAgents中还有获取其依赖的代码,达不到只关注自身智能的理想状态
我们需要通过DI来达成这两个目标。
手工实现DI
public static List getFriendlyAgents(AgentFinder finder){
List agents = finder.findAllAgents();
return filterAgents(agents,”Java Developers”);
}
上面的代码是一个纯手工打造的DI方案,AgentFinder被直接注入到getFriendlyAgents方法中。现在这个getFriendlyAgents方法干净利落,只专注于纯业务逻辑。
但是,这种手工方式的DI显然存在问题,如何配置AgentFinder具体实现的问题并没有解决,原本AgentFinderFactory要做的工作还是要找一个地方去做。解决这个问题的方式是借助DI框架,而DI框架就是把你的代码打包起来的运行时环境,在你需要的时候注入依赖项。
使用Guice
Java中DI方面的标准规范是JSR-330,它提供了统一的DI通用功能的标准,而且提供了你需要了解的幕后规则及限制。这里不具体介绍JSR-330,有兴趣的可以查找相关资料阅读。我们重点介绍JSR-330的参考实现Guice,它是一个由Google实现的针对Java 6以上版本的流行的、轻量级的DI框架。
下面我们使用Guice来解决手工方式实现DI的不足问题:
首先我们需要创建一个定义绑定关系的AgentFinderModule模块(配置类)。
public class AgentFinderModule extends AbstractModule{
@Override
protected void configure() {
bind(AgentFinder.class).to(WebServiceAgentFinder.class);
}
}
绑定关系的确立在调用Guice的bind方法时发生,把要绑定的类(AgentFinder)传给它,然后调用to方法指明要注入到哪个实现类。
下面我们来Guice版本的HollywoodService:
public class HollywoodServiceGuice {
private AgentFinder finder = null;
}
我们在模块中声明了绑定关系,下面我们就可以让注入器构建对象关系图了。接下来我们看看在独立Java程序和Web应用程序这两种情况下分别要如何实现:
构建Guice对象关系图——独立Java程序
public class HollywoodServiceClient {
public static void main(String[] args) {
Injector injector = Guice.createInjector(new AgentFinderModule());
HollywoodServiceGuice hollywoodServiceGuice = injector.getInstance(HollywoodServiceGuice.class);
List agents = hollywoodServiceGuice.getFriendlyAgents();
}
}
构建Guice对象关系图——Web应用程序 把Gucie-servlet.jar加到web应用的类库中,然后再web.xml中添加下面的配置项:
guiceFilter
com.google.inject.servlet.GuiceFilter
guiceFilter
/*
然后是标准动作,扩展ServletContextListener以便使用Guice的ServeltModule:
public class MyGuiceServletConfig extends GuiceServletContextListener {
@Override
protected Injector getInjector() {
return Guice.createInjector(new ServletModule());
}
}
最好,将其加入到web.xml文件中,以便servlet容器在部署应用时触发该类:
com.example.MyGuiceServletConfig
经由注入器创建HollywoodServiceGuice,你得到一个配置完备的类,马上就可以调用其中的getFriendlyAgents方法了。
关于JSR-330和Guice的更多用法,请参考其Github页面。
依赖注入与JSR-330的参考实现——Guice
Mar 13, 2015
依赖注入(控制反转的一种形式),它是Java开发主流中一个重要的编程范式(思维方式)。简单的说,使用DI技术可以让对象从别处获得依赖项,而不是由它自己来构造。使用DI有很多好处,它能降低代码之间的耦合度,让代码更易于测试、更易读。Java DI的官方标准是JSR-330,本文我们还会介绍JSR-330的参考实现Guice 3,一个轻量级 的DI框架。
IoC and DI
使用IoC范式编程时,程序逻辑的流程通常是由一个功能中心来控制的。而使用IoC,这个“中心控制”的设计原则会被反转过来。调用者的代码处理程序的执行顺序,而程序逻辑则被封装在接受调用的子流程中。通过一个例子来理解IoC:
在GUI应用中,GUI框架负责控制调用事件处理器,而不是应用逻辑。当用户点击了一个动作,比如“向前”,GUI框架会自动调用 对应的事件处理器,而应用逻辑可以把重点放在处理动作上。程序的控制被反转了,将控制权由应用逻辑转移到了GUI框架。
IoC也被称为好莱坞原则:会有另一段代码拥有最初的控制线程,并且由它来调用你的代码,而不是由你的代码调用它。
不要给我们打电话,我们会打给你。——好莱坞原则
IoC有多种不同的实现,包括工厂模式、服务器定位模式,当然还有依赖注入。需要注意的是,DI并不等于IoC,DI只是IoC的一种实现方式,IoC是一种机制。
DI是IoC的一种特定形态,是指寻找依赖项的过程不在当前执行代码的直接控制之下。Java中为DI提供的容器有Guice、Spring、PicoContainer等。DI的好处有:松耦合、易测试、强内聚、可重用、更轻盈的代码。
Example
下面编写代码来解释到底什么是DI,如何使用DI。我们首先编写传统的代码,然后使用工厂模式解耦,进而再使用DI来改进代码,通过这个过程,你将了解到DI的精妙之处。这些改进都基于同一个关键技术,即面向接口编程。
假设你想找到所有对Java可开发人员比较友善的好莱坞经纪人。首先,我们有了一个AgentFinder接口,及其两个实现类SpreadSheetAgentFinder和WebServiceAgentFinder。AgentFinder接口如下:
public interface AgentFinder {
public List findAllAgents();
}
传统方式寻找友善经纪人
为了找到经纪人,项目中有个默认的HollywoodService类,它会从SpreadSheetAgentFinder里得到一个经纪人列表,并且过滤出友善的经纪人,最终返回该列表。
public class HollywoodService {
public static List getFriendlyAgents() {
AgentFinder finder = new SpreadsheetAgentFinder();
List agents = finder.findAllAgents();
List friendlyAgents = filterAgents(agents,”Java Developers”);
return friendlyAgents; } //filterAgents
}
这是最传统的编码方式,显然,HollywoodService被SpreadsheetAgentFinder这个AgentFinder的具体实现死死的绑定住了。
为了改进这个问题,通常我们会想到一个常用的设计模式——工厂模式。工厂模式可以一定程度上解耦程序,它也是IoC的一种实现方式。
工厂模式
利用工厂模式(其实这里用到的是一个简单工厂)重新编写上面的代码,如下:
public List getFriendlyAgents(String agentFinderType) {
AgentFinderFactory factory = AgentFinderFactory.getInstance();
AgentFinder finder = factory.getAgentFinder(agentFinderType);
List agents = finder.findAllAgents();
return filterAgents(agents, “Java Developers”);
}
如你所见,这里不再有具体的实现来黏住你,而是通过注入agentFinderType的方式让你选择想要的AgentFinder。但这里仍然还有问题:
代码注入的仅仅是一个引用凭据(agentFinderType),而不是真正实现AgentFinder的对象
方法getFriendlyAgents中还有获取其依赖的代码,达不到只关注自身智能的理想状态
我们需要通过DI来达成这两个目标。
手工实现DI
public static List getFriendlyAgents(AgentFinder finder){
List agents = finder.findAllAgents();
return filterAgents(agents,”Java Developers”);
}
上面的代码是一个纯手工打造的DI方案,AgentFinder被直接注入到getFriendlyAgents方法中。现在这个getFriendlyAgents方法干净利落,只专注于纯业务逻辑。
但是,这种手工方式的DI显然存在问题,如何配置AgentFinder具体实现的问题并没有解决,原本AgentFinderFactory要做的工作还是要找一个地方去做。解决这个问题的方式是借助DI框架,而DI框架就是把你的代码打包起来的运行时环境,在你需要的时候注入依赖项。
使用Guice
Java中DI方面的标准规范是JSR-330,它提供了统一的DI通用功能的标准,而且提供了你需要了解的幕后规则及限制。这里不具体介绍JSR-330,有兴趣的可以查找相关资料阅读。我们重点介绍JSR-330的参考实现Guice,它是一个由Google实现的针对Java 6以上版本的流行的、轻量级的DI框架。
下面我们使用Guice来解决手工方式实现DI的不足问题:
首先我们需要创建一个定义绑定关系的AgentFinderModule模块(配置类)。
public class AgentFinderModule extends AbstractModule{
@Override
protected void configure() {
bind(AgentFinder.class).to(WebServiceAgentFinder.class);
}
}
绑定关系的确立在调用Guice的bind方法时发生,把要绑定的类(AgentFinder)传给它,然后调用to方法指明要注入到哪个实现类。
下面我们来Guice版本的HollywoodService:
public class HollywoodServiceGuice {
private AgentFinder finder = null;
@Inject public HollywoodServiceGuice(AgentFinder finder){ this.finder = finder; } public List<Agent> getFriendlyAgents(){ List<Agent> agents = finder.findAllAgents(); return filterAgents(agents, "Java Developers"); } //...
}
我们在模块中声明了绑定关系,下面我们就可以让注入器构建对象关系图了。接下来我们看看在独立Java程序和Web应用程序这两种情况下分别要如何实现:
构建Guice对象关系图——独立Java程序
public class HollywoodServiceClient {
public static void main(String[] args) {
Injector injector = Guice.createInjector(new AgentFinderModule());
HollywoodServiceGuice hollywoodServiceGuice = injector.getInstance(HollywoodServiceGuice.class);
List agents = hollywoodServiceGuice.getFriendlyAgents();
}
}
构建Guice对象关系图——Web应用程序 把Gucie-servlet.jar加到web应用的类库中,然后再web.xml中添加下面的配置项:
guiceFilter
com.google.inject.servlet.GuiceFilter
guiceFilter
/*
然后是标准动作,扩展ServletContextListener以便使用Guice的ServeltModule:
public class MyGuiceServletConfig extends GuiceServletContextListener {
@Override
protected Injector getInjector() {
return Guice.createInjector(new ServletModule());
}
}
最好,将其加入到web.xml文件中,以便servlet容器在部署应用时触发该类:
com.example.MyGuiceServletConfig
经由注入器创建HollywoodServiceGuice,你得到一个配置完备的类,马上就可以调用其中的getFriendlyAgents方法了。
关于JSR-330和Guice的更多用法,请参考其Github页面。
References 1. https://github.com/google/guice/wiki/GettingStarted 2. The Well-Grounded Java Developer, chapter 3, Dependency Injection
相关文章推荐
- 依赖注入与JSR-330的参考实现——Guice
- 依赖注入与JSR-330的参考实现——Guice
- 3. 什么是JSR参考实现? - JavaEE基础系列
- spring3零配置注解实现Bean定义(包括JSR-250、JSR-330)
- spring3零配置注解实现Bean定义(包括JSR-250、JSR-330)
- spring3零配置注解实现Bean定义(包括JSR-250、JSR-330)
- 利用XML实现通用WEB报表打印(参考)
- Portlet API参考实现的秘密
- 利用XML实现通用WEB报表打印(参考)
- 参考:关于Javascript中实现暂停的几篇文章
- 一个最符合中国国情的工作流设计参考(包括PHP实现)
- CLDC及MIDP参考实现的编译
- 参考:关于Javascript中实现暂停的几篇文章
- ASP.NET 2.0 Internet安全之参考实现
- Portlet API参考实现的秘密
- 权限管理设计、分析、实现参考资料
- 利用Micro3D和JSR-184使用相同代码实现旋转立方体的效果
- JDO学习笔记之Sun JDO参考实现篇
- DataGrid 功能实现收集(转)保留做参考
- UAProf 参考实现