Drools使用手册第二章.doc

第二章：安装和设置2.1.安装和使用Drools提供了基于eclipse的IDE，但这是可选的，Drools的核心只需要Java1.4（J2SE）。一个简单的开始方法是下载和安装eclipse插件，它需要Eclipse GEF框架已经安转。插件将为你提供所有需要的依赖：你可以简单的建立一个新的规则项目，然后所有事情将会安排好。关于规则工作台和IDE的详细内容请查阅后面的专述章节。安装eclipse插件就像普通插件一样，解压后放到插件目录即可。Eclipse插件的使用不是必需的。规则文件能够以文本或表格的方式输入，规则工作台仅仅是提供方便性的一个工具。人们已经通过很多方式集成了工作引擎，并不存在要求用同一种方式。作为一种可选的方式，你可以直接下载bin发布包，将它们包含在你的项目的classpath变量中。2.1.1.依赖库Drools被分为几个模块，一些是用在规则的开发和编译中，另一些是用在运行时。在许多情况下，人们只想简单的包括运行时依赖的库文件。这样可以带来最大的灵活性。但是在某些情况下，我们需要将运行时的库引用文件尽可能的更小，比如将规则发布到二进制执行文件中。核心的运行引擎可以被压缩的很小，只需要两个jar文件约100k的大小。以下是描述对于Jboss 规则引擎的重要库文件： drools-core.jar 核心引擎，运行时组件。包含了RETE引擎和LEAPS引擎。这个仅提供了运行时支持，当你已经将规则预编译好，并与Package或RuleBase对象发布时，这是运行时唯一需要依赖的。 drools-compiler.jar 包含编译和构建组件，从规则源码建立可执行的Rule Base。这个库是你的应用通常需要使用到运行时的依赖库，但在你已经预编译了规则后它不是必需的，只有drools-core.jar是必需的。 drools-jsr94.jar 是对JSR-94（一种规则引擎访问规范）的一个实现，这本质上是一个在drools-compiler组件之上的层。需要注意的是，基于JSR-94规范，访问规则需要经过一系列复杂定义的接口调用。在可能情况下，直接使用Drools API会更加简单，但是在一些运行环境中遵循JSR-94规范是必须的。 drools-decisiontables.jar 这是对决策表进行“编译”的组件，它需要与drools-compiler组件一起使用来完成编译。它可以提供对excel和CSV格式的输入的支持。 以上组件也引用了不少其它的依赖库，主要是drools-compiler, drools-jsr94 or drools-decisiontables模块需要其它引用库。当你运行在Java1.5环境中时，对XML库德引用可能是不需要的。其中关键的引用是“JCI”，它是apache java编译接口工具，提供运行时编译的能力；POI提供了表格解析的能力；Antlr提供了规则语言的语法分析能力。注意：如果你正在J2EE或Servlet容器中使用Drools，并且你被JDT的classpath问题所烦恼，你可以选择使用janino编译器。设置系统属性piler为Dpiler=JANINO。2.1.2.运行时 在这里讨论的运行时需求是指将规则使用二进制格式发布（使用Package或RuleBase对象）。这是一个可选的特性，使得保持你的运行环境为轻量级的。你可以使用drools-compiler在进程外产生规则包，然后将它们发布到运行状态的系统中。系统只需要drools-core.jar就可以执行规则包。这是一种可选的发布模式，许多人不需要将他们的系统进行这样的裁剪，但对某些环境来说是一个解决方案。2.1.3.安装IDE (规则工作台)Eclipse中的规则工作台需要你有eclipse3.2以上版本，eclipse GEF 同样需要3.2以上。你可以通过现在插件或在线更新的方式安装它。另一个可选的方式是使用Jboss IDE，它包含了预包装好的所有需要的插件，以及选择其他工具单独规则。你可以选择仅安装Jboss IDE自带的“bundle（包）”中的规则。.安装GEFGEF是eclipse图形化编辑框架，它为插件中的组件提供图像化显示功能。如果你没有安装GEF，你可以选择使用更新机制或从网站下载。像其它大多数Eclipse的发布版本一样Jboss IDE已经有了GEF，因此对一些人来说这一步可以忽略。首先你打开帮助菜单Help-Software updates-Find and install。然后选择Calisto更新站点：接下来选择GEF插件:按下next按钮，允许安装插件（可能需要重启eclipse）。一旦安装完成，你就可以继续安装规则插件。.从zip压缩文件安装从zip文件安装，需要先下载和解压文件。在zip文件中你将看到plugin目录，以及插件的jar文件。你可以选择将插件的jar文件放到你的eclipse应用的plugin目录，然后重启eclipse。.Installing from the update site使用更新站点是安装插件的一种便利方式，并且保持最新的版本（eclipse平台会自动检查需要的更新）。它是用来与重要更新和最新补丁同步的好办法。一些防火墙可能造成eclipse连接更新站点困难，如果你遇到这个问题，那就采用手工方式安装插件。同样，如果你是使用手工安装插件的方式，那也需要手工的卸载。步骤1：使用eclipse帮助菜单发现安抓特性 步骤2:选择“Search for new features to install”来安装新的插件（如果你是想检查已有插件的更新版本，使用另一个选项）。 步骤3: 屏幕显示已经在你的eclipse中定义好的更新站点 步骤4: 按下New Remote Site按钮，在弹出的对话框中指定Name和URLName: JBoss Rules URL: /labs/jbossrules/updates/drools-ide-update/步骤5: 选择你刚刚加入的更新站点。Eclipse在将来自动检查更新时将会包含这个站点。步骤6: 你应该看到了从站点中返回的可用特性（Drools IDE）。 步骤7：许可证。选择接受许可证。一旦完成这步，工作台将开始下载。完成下载需要一点时间。 步骤8: 确认这是你想要的特性 步骤9: 接受组件是没有签名的提示(not been digitally signed) 步骤10: 完成后需要重启工作台 2.2.从源码进行安装Drools是开源软件项目，因此手册中提供如何从源码进行构建的指导。从源码构建意味着你可以使用到还在开发中，尚未正式发布的最新特性。虽然Drools是相当复杂的，但是许多人为此做出了贡献。Drools在JDK1.4或更高的版本上工作。你仅需要安装下面列出的工具，版本是指最低的版本要求。 Eclipse 3.2 / Subversion Client 1.3 - recommended win32 client Ant 1.6 确认ant和java的可执行文件在合适路径下。例子给出对于win32系统的示范：Path=D:javaj2sdk1.4.2_10bin;D:javaapache-ant-1.6.5bin;下面的环境变量也需要设置。同样是win32下的范例：JAVA_HOME=D:javaj2sdk1.4.2_10ANT_HOME=D:javaapache-ant-1.6.5以前的release使用maven2作为构建机制，但限制ant是主要的构建机制。Maven现在被Ant用来管理项目依赖的其它项目。你当然也可以继续安装Maven2并使用它，那里有一个pom.xml文件为每一个模块提供管理定义。2.3.源码CheckoutDrools 可以从Subversion（一种源码同步管理工具）站点中下载： Anonymous SVN /labs/jbossrules/trunk/ Developers secured SVN /labs/jbossrules/trunk/通过TortoiseSVN从Subversion站点中下载源码，一旦checkout完毕后按下OK按钮，你可以看到如下的目录Setup TortoiseSVN to checkout from the subversion repository and clikc OK Once the checkout has finished you should see the folders as shown below.2.4.构建2.4.1.构建源码现在我们已经获得了源码，下一步就是构建和安装源码。我们通过Ant来构建，它使用maven2来管理需要的依赖（你不需要另外下载Maven2）。注意，插件是被分开来构建的，但构建过程将更新插件的依赖项（指你需要构建更新版本的构件时需要更新的依赖部分版本）。在项目根路径下输入ant来获得构建脚本的明细列表。你应该能够看到包含更详细内容的清单：C:Projectsjboss-rules-newantBuildfile: build.xmlhelp: echo Drools Build Help echo - echo echo The build process is for the following four modules: echo drools-core echo drools-compiler echo drools-decisiontables echo drools-jsr94 echo echo Further to this there are two Eclipse project: echo drools-examples - To use open Eclipse and import. echo Requires the Drools Eclipse plugin. echo Either build the plugin from drools-ide echo or install from the Eclipse update site echo /labs/jbossrules/updates echo drools-ide - To use open Eclipse and import. echo Select export and plugin fragements to echo generate the Drools Eclipse plugin echo Depends on all the depencies being copied echo to its lib directory at the end of build-all, echo which calls copy-deps. echo echo Targets echo - echo echo clean-all - cleans all directories echo echo build-all - builds all modules echo echo javadocs - generates the javadoc at target/docs echo echo manual - generates the docbook documentation in echo html and single_html format at target/docs echo echo dist-all - generates the distribution builds for echo src, bin, bin-withdeps and examples echo echo Each module can individually be executed with clean, compile, echo test and build. To use simply use the following commands, echo replace $module with one of the module names: echo clean-$module echo compile-$module echo test-$module echo build-$module echo echo Generates specific distribution builds: echo dist-src echo dist-bin echo dist-bin-withdeps echo dist-examples echo echo You may also pass the following system properties: echo -Dtest.skip=true echo -Djavadocs.skip=true echo -Dmanual.skip=true echo echo Targets may be combined: echo ant -Dtest.skip clean-all build-all echo echo For more help use the build system to generate the manual echo or you can find the manual online at: echo /portal/jbossrules/docs/index.htmlBUILD SUCCESSFUL通常进行构建任务运行ant clean-all build-all，这会将所有旧的编译遗留文件清除，然后测试并构建源代码，并报告所有错误。编译结果的jar文件被放在项目根目录下的/target目录中。当Ant构建好任何模块后，它会在本地的Maven2存储库中自动安装结果jar。它可以很容易被其它项目的pom.xml引用或者复制到任何地方。2.4.2.手工构建Drools使用Docbook来构建使用指南。Ant被用来建立该文件应用。文件被产生为四种不同的格式，但共享同样的图片目录。在可能的情况下，PDF格式假设使用SVG图片。Drools uses Docbook for this manual. Ant is used to build the documentation. The documentation produces four different formats, all share the same images directory. PDFs will attempt to use SVG images where possible. html_single 整个手册在一个单独的Html文件中 html 手册根据章节不同被分为多个文档 PDF (当前被取消了，因为图片尺寸的布局问题) 带导航的常规PDF文件。 eclipse 文档适合被eclipse插件所包含。使用手册能够依据项目根目录的build.xml产生，只要调用ant manul即可，产生的文档被复制到target/docs目录。实际上是为了建立指南调用一个独立的ant在documentation/manual目录下的build.xml文件；文档在被复制到target/docs目录之前先在documentation/manual/build目录下被产生。C:devjbossrulesant manualBuildfile: build.xmlmanual: delete Deleting directory D:devjbossrulesdocumentationmanualbuildclean:all.doc:lang.all:lang.misc: copy Copying 102 files to C:devjbossrulesdocumentationmanualbuildensharedimages copy Copying 1 file to C:devjbossrulesdocumentationmanualbuildensharedcss style Transforming into C:devjbossrulesdocumentationmanualbuildensharedimages style Processing C:devjbossrulesdocumentationmanualenChapter-Papersguests_at_table.svg to C:devjbossrulesdocumentationmanualbuildensharedimagesChapter-Papersguests_at_table.svg style Loading stylesheet C:devjbossrulesdocumentationmanualenstylesvisio_svg.xsl style Processing C:devjbossrulesdocumentationmanualenChapter-Papersmake_path.svg to C:devjbossrulesdocumentationmanualbuildensharedimagesChapter-Papersmake_path.svg style Processing C:devjbossrulesdocumentationmanualenChapter-Papersmanners_activity_diagram.svg to C:devjbossrulesdocumentationmanualbuildensharedimagesChapter-Papersmanners_activity_diagram.svg style Processing C:devjbossrulesdocumentationmanualenChapter-Performance_Tuningbeta_node.svg to C:devjbos.snip.lang.dochtml: mkdir Created dir: C:devjbossrulesdocumentationmanualbuildenhtml copy Copying 1 file to C:devjbossrulesdocumentationmanualbuildenhtml java Writing bk01-toc.html for book java Writing pr01.html for preface(preface) java ID recommended on part: Reference Manual java ID recommended on chapter: The Rule Engine java ID recommended on section: What is a Rule Engine java ID recommended on section: Background java ID recommended on figure: Inference Engine java ID recommended on figure: SQL as a simplistic Inference Engine java ID recommended on figure: Additional Reading java ID recommended on section: Rules java ID recommended on figure: A Basic Rete network java ID recommended on figure: A Basic Rete network.snip.lang.dochtmlsingle: mkdir Created dir: C:devjbossrulesdocumentationmanualbuildenhtml_single java ID recommended on part: Reference Manual java ID recommended on chapter: The Rule Engine java ID recommended on section: What is a Rule Engine java ID recommended on section: Background java ID recommended on figure: Inference Engine java ID recommended on figure: SQL as a simplistic Inference Engine java ID recommended on figure: Additional Reading java ID recommended on section: Rules java ID recommended on figure: A Basic Rete network java ID recommended on figure: A Basic Rete network java ID recommended on section: Why use a Rule Engine.snip. java ID recommended on section: Make Path and Path Done java ID recommended on figure: Rete Diagram java ID recommended on section: Continue and Are We Done java ID recommended on section: Conclusion java ID recommended on section: Output Summary java ID recommended on index copy Copying 142 files to C:devjbossrulestargetdocsBUILD SUCCESSFULTotal time: 54 secondsC:devjbossrules图2.1. 使用Ant产生指南可以在targetdocs目录下找到产生的指南，每一种格式一个独立目录使用手册在复制到目标目录前，首先在构建目录中产生，如下所示：2.5.Eclipse2.5.1.产生Eclipse项目Drools中包含了可以在eclipse中打开的项目，这些是由maven 2产生的。如果你已经安装了maven 2，可以自动重新产生eclipse项目，甚至于将其产生为IntelliJ等环境中可使用的项目。详情见下，但大多数人可以忽略这些。Maven可以产生标准的Eclipse项目，但是它不能产生Eclipse插件项目。为drools-core, drools-compiler 和drools-jsr94产生Eclipse项目，输入“mvn eclipse:eclipse”。2.5.2.导入Eclipse项目产生了Eclispe项目的文件后，就可以导入Eclipse中。当启动Eclipse后，将workspace设为check out出来的目录处。当调用“mvn install”，所有的项目依赖项目被下载并且加入本地Maven储存库中。除非你明确指定存储库所在位置，否则Eclipse不能找到这些依赖项目的位置。要完成这个，需要设置M2_REPO路径变量。2.5.3.导出IDE 插件Drools-ide项目使用subversion来checked out，并准备导出一旦插件已经被构建，打开构建后的导出目录，并将jar文件拷贝到Eclipse插件目录中在这时，如果Eclipse已经打开，需要重启一次。现在你可以在工具条上看到新的Drools菜单，并且drl文件会有相应的图标，并且对规则文件内容进行语法高亮显示。2.5.4.建立更新站点Building the update site同样也有一个插件的更新站点项目。对于想更新更新站点项目的程序员，需要获得项目源码。它们同样保存在SVN中，但是在 /jbossrules/update目录，代替了/trunk目录。They are plain vanilla eclipse f