[翻译]Drools6.2帮助文档-10. CDI



10. CDI
更多相关网页：
http://www.jdon.com/38322
http://www.jdon.com/37976
http://www.cdi-spec.org/
10.1.介绍
CDI，全称Contexts and Dependency Injection（上下文和依赖注入），是向应用程序提供声明控制和结构的Java规范。KIE可以用它来实现自动实例化和绑定，而不需要使用编程的API。
10.2.注解
@KContainer,@KBase, @KSession都支持可选的'name'属性。CDI在它注入的时候一般不会"getOrCreate"，同一组注解下，所有注入都会得到相同的实例。'name'标签会强制给每个名称一个唯一实例，尽管这个名称的所有的实例会在使用equals方法得到的结果是true。
10.2.1. @KReleaseId
绑定一个实例指向一个特定版本的KieModule。如果kie-ci在classpath中，依赖关系会被自动解决，并从远程仓库中下载。
10.2.2.@KContainer
@KContainer是可选的，因为在使用@Inject和变量类型推断时会被检测到，并添加进来。
图10.1.注入KieContainer
@Inject

private KieContainer kContainer;
图10.2.为动态的KieModule注入KieContainer
@Inject

@KReleaseId(groupId = "jar1", artifactId =
"art1", version =
"1.1")

private KieContainer kContainer;
图10.3.为动态的KieModule注入带名称的KieContainer
@Inject

@KContainer(name = "kc1")

@KReleaseId(groupId = "jar1", artifactId =
"art1", version =
"1.1")

private KieContainer kContainer;

10.2.3. @KBase
@KBase是可选的，因为在使用@Inject和变量类型推断时会被检测到，并添加进来。
如果给的话，默认参数是在kmodule.xml中定义的KieBase的值属性和名称。
图10.4. 注入默认的KieBase，从Classpath KieContainer获得
@Inject

private KieBase kbase;

图10.5. 注入默认的KieBase，从动态KieModule获得
@Inject

@KReleaseId( groupId = "jar1", artifactId =
"art1", version =
"1.0")

private KieBase kbase;

图10.6. 'jar1.KBase1' KieBase版本加载时一起处理（不懂）
@Inject

@KBase("kbase1")

@KReleaseId( groupId = "jar1", artifactId =
"art1", version =
"1.0")

private KieBase kbase1v10;
@Inject

@KBase("kbase1")

@KReleaseId( groupId = "jar1", artifactId =
"art1", version =
"1.1")

private KieBase kbase1v10;

图10.7. 使用'name'属性强制为'jar1.KBase1'
KieBase创建新实例
@Inject

@KSession(value="kbase1", name="kb1")

@KReleaseId( groupId = "jar1", artifactId =
"art1", version =
"1.0")

private KieBase kbase1kb1;
@Inject

@KSession(value="kbase1", name="kb2")

@KReleaseId( groupId = "jar1", artifactId =
"art1", version =
"1.0")

private KieBase kbase1kb2;

10.2.4.@KSession for
KieSession
@KSession是可选的，因为在使用@Inject和变量类型推断时会被检测到，并添加进来。
如果指定的话，默认参数是在kmodule.xml中定义的KieSession的值属性和名称。
Figure 10.8. 注入默认的KieSession，从ClasspathKieContainer获得
@Inject

private KieSession ksession;
图10.9. 注入默认的KieSession，从动态KieModule获得
@Inject

@KReleaseId( groupId = "jar1", artifactId =
"art1", version =
"1.0")

private KieSession ksession;

图10.10. 'jar1.KBase1' KieBase版本加载时一起处理（同样不懂）
@Inject

@KSession("ksession1")

@KReleaseId( groupId = "jar1", artifactId =
"art1", version =
"1.0")

private KieSession ksessionv10;
@Inject

@KSession("ksession1")

@KReleaseId( groupId = "jar1", artifactId =
"art1", version =
"1.1")

private KieSession ksessionv11;

图10.11. 使用'name'标签强制为'jar1.KBase1'
KieSession创建新实例
@Inject

@KSession(value="ksession1", name="ks1")

@KReleaseId( groupId = "jar1", artifactId =
"art1", version =
"1.0")

private KieSession ksession1ks1
@Inject

@KSession(value="ksession1", name="ks2")

@KReleaseId( groupId = "jar1", artifactId =
"art1", version =
"1.0")

private KieSession ksession1ks2

10.2.5.@KSession for StatelessKieSession
@KSession是可选的，因为在使用@Inject和变量类型推断时会被检测到，并添加进来。
如果指定的话，默认参数是在kmodule.xml中定义的KieSession的值属性和名称。
图10.12. 注入默认的StatelessKieSession，从ClasspathKieContainer获得
@Inject

private StatelessKieSession ksession;

图10.13. 注入默认的StatelessKieSession，从动态KieModule获得
@Inject

@KReleaseId( groupId = "jar1", artifactId =
"art1", version =
"1.0")

private StatelessKieSession ksession;

图10.14. 'jar1.KBase1' KieBase版本加载时一起处理（同样不懂）
@Inject

@KSession("ksession1")

@KReleaseId( groupId = "jar1", rtifactId =
"art1", version =
"1.0")

private StatelessKieSession ksessionv10;
@Inject

@KSession("ksession1")

@KReleaseId( groupId = "jar1", rtifactId =
"art1", version =
"1.1")

private StatelessKieSession ksessionv11;

图10.15.使用'name'标签强制为'jar1.KBase1'StatelessKieSession创建新实例

@Inject

@KSession(value="ksession1", name="ks1")

@KReleaseId( groupId = "jar1", artifactId =
"art1", version =
"1.0")

private StatelessKieSession ksession1ks1
@Inject

@KSession(value="ksession1", name="ks2")

@KReleaseId( groupId = "jar1", artifactId =
"art1", version =
"1.0")

private StatelessKieSession ksession1ks2

10.3. API示例对比

CDI可以注入实例到字段，甚至以参数形式传递它们。下面是使用字段注入的例子。
图10.16. CDI示例，命名的KieSession
@Inject

@KSession("ksession1")

KieSession kSession;
public
void
go(PrintStream out) {

kSession.setGlobal("out", out);

kSession.insert(new Message("Dave",
"Hello, HAL. Do you read me, HAL?"));

kSession.fireAllRules();

}
这种方式下代码更少，且比API方法更具声明性。

图10.17. 使用API实现相同功能的代码
public
void
go(PrintStream out) {

KieServices ks =KieServices.Factory.get();

KieContainer kContainer =ks.getKieClasspathContainer();
KieSession kSession = kContainer.newKieSession("ksession1");

kSession.setGlobal("out", out);

kSession.insert(new Message("Dave",
"Hello, HAL. Do you read me, HAL?"));

kSession.fireAllRules();

}