第 1 章 导言
上一页
下一页
第 1 章 导言
最好使用firefox浏览这份教程。 在使用internet explorer的时候会有一些问题。
1.1. 许可证与最终用户许可协议
jBPM是依据GNU Lesser General Public License（LGPL） 和JBoss End User License Agreement（EULA）中的协议发布的， 请参考 完整的LGPL协议和 完整的最终用户协议。
1.2. 下载
可以从sourceforge上下载发布包。
http://sourceforge.net/projects/jbpm/files/
1.3. 源码
可以从jBPM的SVN仓库里下载源代码。 https://anonsvn.jboss.org/repos/jbpm/jbpm4/
1.4. 什么是jBPM
jBPM是一个可扩展、灵活的流程引擎， 它可以运行在独立的服务器上或者嵌入任何Java应用中。
1.5. 文档内容
在这个用户指南里， 我们将介绍在持久执行模式下的jPDL流程语言。 持久执行模式是指流程定义、 流程执行以及流程历史都保存在关系数据库中， 这是jBPM实际通常使用的方式。
这个用户指南介绍了jBPM中支持的使用方式。 开发指南介绍了更多的、高级的、定制的、 没有被支持的选项。
1.6. 从jBPM 3升级到jBPM 4
没办法实现从jBPM 3到jBPM 4的升级。 可以参考开发指南来获得更多迁移的信息。
1.7. 报告问题
在用户论坛或者我们的支持门户报告问题的时候， 请遵循如下模板： === 环境 ============================== - jBPM Version : 你使用的是哪个版本的jBPM？ - Database : 使用的什么数据库以及数据库的版本 - JDK : 使用的哪个版本的JDK？如果不知道可以使用'java -version'查看版本信息 - Container : 使用的什么容器？（JBoss, Tomcat, 其他） - Configuration : 你的jbpm.cfg.xml中是只导入了jbpm.jar中的默认配置， 还是使用了自定义的配置？ - Libraries : 你使用了jbpm发布包中完全相同的依赖库的版本？ 还是你修改了其中一些依赖库？ === Process ================================== 这里填写jPDL流程定义 === API =================================== 这里填写你调用jBPM使用的代码片段 === Stacktrace ============================== 这里填写完整的错误堆栈 === Debug logs ============================== 这里填写调试日志 === Problem description ========================= 请保证这部分短小精悍并且切入重点。比如，API没有如期望中那样工作。 或者，比如，ExecutionService.SignalExecutionById抛出了异常。 聪明的读者可能已经注意到这些问题已经指向了可能导致问题的几点原因：） 特别是对依赖库和配置的调整都很容易导致问题。 这就是为什么我们在包括安装和使用导入实现建议配置机制时花费了大量的精力。 所以，在你开始在用户手册覆盖的知识范围之外修改配置之前，一定要三思而行。 同时在使用其他版本的依赖库替换默认的依赖库之前， 也一定要三思而行。
第 2 章 安装配置 2.1. 发布
只需要把jBPM (jbpm-4.X.zip) 下载下来，然后解压到你的硬盘上的什么地方。 你将看到下面的子目录：
? ? ? ? ? ? ?
doc: 用户手册，javadoc和开发指南 examples: 用户手册中用到的示例流程 install: 用于不同环境的安装脚本
lib: 第三方库和一些特定的jBPM依赖库 src: 源代码文件
jbpm.jar: jBPM主库归档 migration: 参考开发指南
2.2. 必须安装的软件
jBPM需要JDK （标准java）5或更高版本。 http://java.sun.com/javase/downloads/index.jsp
为了执行ant脚本，你需要1.7.0或更高版本的apache ant： http://ant.apache.org/bindownload.cgi
2.3. 快速上手
这个范例安装是最简单的方式开始使用jBPM。 这一章介绍了完成范例安装的步骤。
如果你之前下载过jboss-5.0.0.GA.zip，你可以把它放到
${jbpm.home}/install/downloads目录下。 否则脚本会为你下载它，但是它会消耗一些时间（与你的网络情况有关）。 eclipse-jee-galileo-win32.zip也一样（或者eclipse-jee-galileo-linux-gtk(-x86_64).tar.gz在linux平台下 和eclipse-jee-galileo-macosx-carbon.tar.gz在Mac OSX平台下）。 打开命令控制台，进入目录${jbpm.home}/install。 然后运行 ant demo.setup.jboss 或者
ant demo.setup.tomcat 这将
? ? ? ? ? ? ? ? ? ? ?
把JBoss安装到${jbpm.home}/jboss-5.0.0.GA目录 把jBPM安装到JBoss中。 安装hsqldb，并在后台启动。 创建数据库结构 在后台启动JBoss
根据示例创建一个examples.bar业务归档，把它发布到jBPM数据库中 从${jbpm.home}/install/src/demo/example.identities.sql，读取用户和组。
安装eclipse到${jbpm.home}/eclipse 启动eclipse
安装jBPM web控制台 安装Signavio web建模器 当这些都完成后，JBoss（或Tomcat，根据demo.setup脚本中的选择）会在后台启动。 一旦eclipse完成启动，你可以继续执行下面的教程 第 3 章 流程设计器（GPD）来开始编码你的jBPM业务流程。
或者你可以启动建模流程，通过 Signavio web设计器。 或者使用jBPM控制台。 你可以使用下面用户之一进行登陆： 表 2.1. 示例控制台用户： 用户名 密码 alex password mike password peter password mary password 目前存在的问题： 现在，对于一些比较慢的机器，在初始化报表时， 控制台的失效时间太短了，所以当你第一次请求报表时， 会出现超时，控制台会崩溃。 注销，然后再次登录，就可以避过这个问题。 这个问题已经提交到JIRA中了 JBPM-2508
2.4. 安装脚本
jBPM下载包中包含了一个install目录， 目录中有一个ant的build.xml文件，你可以使用它来 把jBPM安装到你的应用环境中。
最好严格按照这些安装脚本， 进行安装和发布jBPM配置文件。我们可以自定义jBPM配置文件， 但这是不被支持的。
要想调用安装脚本，打开命令行，进入${jbpm.home}/install目录。 使用ant -p你可以看到 这里可以使用的所有脚本。脚本的参数都设置了默认值， 可以快速执行，下面列表给出了可用脚本的概况：
?
?
? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ?
demo.setup.jboss：安装jboss，把jbpm安装到jboss中， 启动jboss，创建jbpm数据库表结构，部署实例，加载实例身份认证信息， 安装并启动eclipse
demo.setup.tomcat：安装tomcat，把jboss安装到tomcat中， 启动tomcat，创建jbpm数据库表结构，部署实例，加载实例身份认证信息， 安装并启动eclipse
clean.cfg.dir：删除${jbpm.home}/install/generated/cfg 文件夹。 create.cfg：创建一个配置在 ${jbpm.home}/install/generated/cfg下，基于当前的参数。
create.jbpm.schema：在数据库中创建jbpm表 create.user.webapp创建一个基本的webapp在 ${jbpm.home}/install/generated/user-webapp中
delete.jboss：删除安装的jboss delete.tomcat：删除安装的Tomcat
demo.teardown.jboss：删除jbpm数据库的表并停止jboss
demo.teardown.tomcat：停止tomcat和hsqldb服务器（如果需要） drop.jbpm.schema：从数据库中删除jbpm的表 get.eclipse：下载eclipse如果它不存在
get.jboss：下载一个JBoss AS，已经测试过当前的jBPM版本，如果它不存在
get.tomcat：下载一个Tomcat，已经测试过当前的jBPM版本，如果它不存在
hsqldb.databasemanager：启动hsqldb数据库管理器
install.eclipse：解压eclipse，下载eclipse如果它不存在 install.jboss：下载JBoss如果它不存在，并解压 install.jbpm.into.jboss：把jBPM安装到JBoss中
install.tomcat：把tomcat下载到${tomcat.distro.dir}如果tomcat不存在，并解压tomcat
install.jbpm.into.tomcat：把jBPM安装到tomcat中 install.examples.into.tomcat：部署所有的实例流程
install.signavio.into.jboss：把signavio安装到jboss中 install.signavio.into.tomcat把signavio安装到tomcat中 load.example.identities：读取实例用户和用户组数据到数据库 reinstall.jboss：删除之前的jboss安装，并重新安装jboss