Question

一分钟入门

从 Activiti 网站下载 Activiti Explorer 的 WAR 文件后， 可以按照下列步骤以默认配置运行样例。 你需要一个 Java 运行环境和 Apache Tomcat （其实，任何提供了 servlet 功能的 web 容器都可以正常运行。但是我们主要是使用 tomcat 进行的测试）。

• 把下载的 activiti-explorer.war 复制到 Tomcat 的 webapps 目录下。
• 执行 Tomcat 的 bin 目录下的 startup.bat 或 startup.sh 启动服务器。
• Tomcat 启动后，打开浏览器访问 http://localhost:8080/activiti-explorer。 使用 kermit/kermit 登录。

这样就好了！Activiti Explorer 默认使用 H2 内存数据库，如果你想使用其他数据库 请参考这里。

安装 Activiti

要安装 Activiti 你需要一个 Java 运行环境 和 Apache Tomcat。 还要确认设置好JAVA_HOME系统变量。 不同的操作系统下的设置方法是不同的。

要运行 Activiti Explorer 和 REST web 应用，你要从 Activiti 的下载页下载 WAR 文件， 复制到 Tomcat 安装目录下 webapps 目录下。 默认 Explorer 应用使用的内存数据库已经包含了示例流程，用户和群组信息。

下面是示例中可以使用的用户：

Table 2.1.示例用户

账号	密码	角色
kermit	kermit	admin
gonzo	gonzo	manager
fozzie	fozzie	user

现在，你可以访问下列 web 应用：

Table 2.2.webapp 工具

Webapp 名称	URL	描述
Activiti Explorer	http://localhost:8080/activiti-explorer	流程引擎的用户控制台。使用它来启动新流程，分配任务， 查看并认领任务，等等。这个工具也可以用来管理 Activiti 引擎。

注意 Activiti Explorer 演示实例只是一种简单快速展示 Activiti 的功能的方式。 但是并不是说只能使用这种方式使用 Activiti。 Activiti 只是一个 jar， 可以内嵌到任何 Java 环境中：swing 或者 Tomcat, JBoss, WebSphere 等等。 也可以把 Activiti 作为一个典型的单独运行的 BPM 服务器运行。 只要 java 可以做的，Activiti 也可以。

安装 Activiti 数据库

就像在一分钟入门里说过的，Activiti Explorer 默认使用 H2 内存数据库。 要让 Activiti 使用独立运行的 H2 数据库或者其他数据库， 可以修改 Activiti Explorer web 应用 WEB-INF/classes 目录下的 db.properties。

另外，注意 Activiti Explorer 自动生成了演示用的默认用户和群组，流程定义，数据模型。 要想禁用这个功能，要修改 WEB-INF 目录下的 activiti-standalone-context.xml。 可以使用下面的 demoDataGenerator bean 定义代码完全禁用安装默认数据。从代码中也可以看出，我们可以单独启用或禁用每一项功能。

      <bean class="org.activiti.explorer.demo.DemoDataGenerator">
        <property name="processEngine" ref="processEngine" />
        <property name="createDemoUsersAndGroups" value="false" />
        <property name="createDemoProcessDefinitions" value="false" />
        <property name="createDemoModels" value="false" />
      </bean>
    

引入 Activiti jar 和依赖

为了引用 Activiti jar 和依赖，我们推荐使用 Maven（或 Ivy）， 它简化了我们之间的依赖管理。 参考 http://www.activiti.org/community.html#maven.repository 来为你的项目引入必须的 jar 包。

如果不想用 Maven，你也可以自己把这些 jar 引入到你的项目中。 Activiti 下载 zip 包包含了一个 libs 目录， 包含了所有 Activiti 的 jar 包（和源代码 jar 包）。依赖没有用这种方式发布。 Activiti 引擎必须的依赖如下所示（通过 mvn dependency:tree 生成）：

org.activiti:activiti-engine:jar:5.12.1
+- org.apache.commons:commons-email:jar:1.2:compile
|  +- javax.mail:mail:jar:1.4.1:compile
|  \- javax.activation:activation:jar:1.1:compile
+- org.apache.commons:commons-lang3:jar:3.1:compile
+- org.mybatis:mybatis:jar:3.1.1:compile
+- org.springframework:spring-beans:jar:3.1.2.RELEASE:compile
|  \- org.springframework:spring-core:jar:3.1.2.RELEASE:compile
|     +- org.springframework:spring-asm:jar:3.1.2.RELEASE:compile
|     \- commons-logging:commons-logging:jar:1.1.1:compile
\- joda-time:joda-time:jar:2.1:compile
       

注意：只有使用了 mail service task 才必须引入 mail 依赖 jar。所有依赖可以在 Activiti 源码的模块中， 通过 mvn dependency:copy-dependencies 下载。

下一步

使用 Activiti Explorer web 应用 是一个熟悉 Activiti 概念和功能的好办法。但是， Activiti 的主要目标是为你自己的应用添加强大的 BPM 和工作流功能。 下面的章节会帮助你熟悉 如何在你的环境中使用 Activiti 进行编程：

• 配置章节 会教你如何设置 Activiti， 如何获得 ProcessEngine 类的实例， 它是所有 Activiti 引擎功能的中心入口。
• API 章节会带领你了解建立 Activiti API 的服务。 这些服务用简便的方法提供了 Activiti 引擎的强大功能， 它们可以使用在任何 Java 环境下。
• 对深入了解 BPMN 2.0，Activiti 引擎中流程的编写结构感兴趣吗？ 请继续浏览 BPMN 2.0 章节。