2.安裝與配置

2.安裝與配置

概述

前面我們提到，URule Pro可采用的兩種運行模式：一種是客戶端服務器模式；另一種是嵌入式模式。客戶端服務器模式是指規(guī)則的設計、定義以及編譯都在服務器上，而客戶端只是負責從服務器上獲取編譯好的規(guī)則包運行，所以對于客戶端來說即可以是標準的Java Web應用，也可以是非Web的Java應用，但對于服務器來說則必須是一個標準的Java Web應用。

嵌入式模式是指規(guī)則的設計、定義、編譯以及實際規(guī)則包的運行都發(fā)生在當前運行環(huán)境中，所以嵌入式應用必須是一個標準的Java Web應用。嵌入式模式使用起來相對簡單，這里我們以嵌入式模式來介紹如何安裝配置URule Pro。

我們安裝分兩部分：一部分是介紹如何在本地快速安裝一個URule Pro示例項目，以幫助我們了解URule Pro的功能點；另一部分是介紹如何將URule Pro添加到項目中，以及如何對項目中URule Pro進行相關配置。

安裝一個URule Pro示例項目

在這一部分當中，我們將介紹如何在本地安裝一個可以演示URule Pro功能點的示例項目，安裝這個示例項目，要先保證操作系統(tǒng)中已安裝好1.7或以上版本JDK，同時安裝好Tomcat7或以上版本。

首先需要我們下載示例項目安裝包，點擊此處下載。 解壓示例項目安裝包，將解壓后其中名為“urule-demo”目錄復制到Tomcat的webapps目錄下；如果當前操作系統(tǒng)為windows，那么請在D盤根目錄下創(chuàng)建一個名為“repo”的目錄；如果當前系統(tǒng)為非windows，那么則需要用文本編輯器打開webapps目錄下的urule-demo下WEB-INF目錄中的config.properties文件，修改其中名為“urule.repository.dir”的屬性值。 可以看到urule.repository.dir屬性默認值為“D:/repo”，所以我們只需要將其改成一個當前系統(tǒng)中存在的可訪問的空目錄即可。

上述這些工作完成后，就可以運行Tomcat，然后打開瀏覽器（除IE以外的瀏覽器，不支持IE），訪問URL:http://localhost:8080/urule-demo，即可進入URule Pro示例項目操作主界面（這里的8080為Tomcat默認端口，如果你修改了這個端口，那么請采用你修改的端口）；在操作主界面右側(cè)“項目列表”節(jié)點上點擊右鍵，在彈出的菜單中選擇“導入項目”，在彈出的窗口中選擇第2步解壓下來的兩個示例項目(以.bak結(jié)尾的兩個文件)中的某一個，依次導入即可查看示例項目。

到這一步，我們的示例項目安裝就完成了，通過這個示例項目，我們可以感受URule Pro的操作風格以及功能特點，實際上，這個示例項目在http://112.124.15.63:8084中可以直接瀏覽。

如果想在項目中使用URule Pro，那么就需要將URule Pro安裝到項目當中，在下面的內(nèi)容當中我們將介紹如何把URule Pro安裝到項目中，這里提供了安裝到基于Maven的項目以及安裝到標準Web項目兩種方式。

基于Maven的Web項目安裝

首先我們需要創(chuàng)建了個標準的基于Maven的Java Web項目，然后打開項目的pom.xml文件，在其中添加URule Pro相關Jar包的依賴信息。

<dependency>
    <groupId>com.bstek.urule</groupId>
    <artifactId>urule-console-pro</artifactId>
    <version>2.2.3</version>
</dependency>

URule Pro自己的Jar有兩個：一個是urule-console-pro；另一個是urule-core-pro。urule-console-pro這個Jar包中包含了URule Pro的各種規(guī)則設計器、打包編譯工具、仿真測試環(huán)境等；urule-core-pro這個Jar中則包含了URule 規(guī)則包的核心執(zhí)行引擎。所以urule-console-pro依賴于urule-core-pro，對于Maven環(huán)境來說，只需要依賴urule-console-pro包即可。

上面的Maven配置中，依賴的版本為2.2.3，實際使用時可以到https://search.maven.org上查詢關鍵字“urule-console-pro”找到當前最新的發(fā)行版本，這里的pom.xml依賴信息改成對應的最新的版本號即可。

在實際的使用過程當中，如果需要用到某個版本的SNAPSHOT，那么就需要在pom.xml當中添加一個repository信息，告訴Maven該到這里去下載SNAPSHOT版本的包，配置如下：

<repository>
    <id>sonatype</id>
    <url>https://oss.sonatype.org/content/groups/public/</url>
</repository>

具體的SNAPSHOT的版本信息，我們可以到https://oss.sonatype.org上查詢。

到這里，在基于Maven的標準Web項目中加載URule Pro的配置就完成了，我們再來看看一個標準的非Maven的Web項目如何將URule Pro添加進去。

安裝到標準Web項目

Maven項目可以通過配置依賴來加載Jar包，非Maven項目則需要直接將Jar包復制到/WEB-INF/lib目錄下。據(jù)此，我們可以首先點擊此處下載urule-console-pro模塊與urule-core-pro模塊所需要的第三方Jar包，將它們放到我們項目中的/WEB-INF/lib目錄下，然后再到https://search.maven.org/上查詢最新的urule-core-pro與urule-console-pro版本，下載下來放到/WEB-INF/lib目錄中即可。這樣，一個傳統(tǒng)的的Web項目中添加URule Pro相關Jar包的工作也就完成了。

如果是將URule Pro添加到一個已存在的標準Web項目，那么在添加第三方Jar包時要注意這些Jar包在當前項目中是否已存在，如果已經(jīng)存在，這時通常的做法是保留高版本，切不可放多個版本不同的相同Jar包，否則運行可能會出現(xiàn)錯誤。

接下來我們開始進行web應用層面配置，對于Web層面的配置，無論是Maven項目還是標準項目都是一樣的。

項目配置

因為urule-console-pro模塊架構(gòu)在Spring之上的，所以需要加載urule-console-pro模塊中提供的Spring配置文件，這個配置文件位于urule-console-pro對應的jar的classpath根下，名為urule-console-context.xml，所以如果我們的項目也是基于Spring的，那么可以打開一個項目中的Spring配置文件，在其中通過下面的代碼導入urule-console-context.xml文件：

<import resource="classpath:urule-console-context.xml"/>

如果你的項目不是基于spring，那么就不能采用上面的import方式加載urule-console-pro中所需要的spring配置文件，這時我們需要打開web.xml，在其中添加下面的代碼以加載urule-console-pro的spring配置文件：

<listener>
    <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
</listener>
<context-param>
    <param-name>contextConfigLocation</param-name>
    <param-value>classpath:urule-console-context.xml</param-value>
</context-param>

前面說過，因為urule-console-pro模塊依賴于urule-core-pro模塊，所以也需要加載urule-core-pro模塊中的spring配置文件，這個文件也位于urule-core-pro對應jar包的classpath根下，名為urule-core-context.xml，但我們這里在配置時卻不需加載它，原因是這個名為urule-core-context.xml的spring配置文件在urule-console-context.xml中已經(jīng)導入了，所以在有urule-console-pro的項目當中，就不需要再加載urule-core-context.xml，只需要加載urule-console-pro中的urule-console-context.xml文件即可。

通常情況下，我們建議在/WEB-INF目錄下創(chuàng)建一個名為context.xml的標準的spring配置文件，在這個context.xml中導入urule-console-pro模塊中的spring配置文件，這個context.xml的內(nèi)容如下所示：

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:context="http://www.springframework.org/schema/context"
    xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.0.xsd
        http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-3.0.xsd
    ">
    <import resource="classpath:urule-console-context.xml"/>
</beans>

這樣就需要將上面在web.xml中添加到listener做些修改，contextConfigLocation的值改成/WEB-INF/context.xml，如下面代碼所示：

<listener>
    <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
</listener>
<context-param>
    <param-name>contextConfigLocation</param-name>
    <param-value>/WEB-INF/context.xml</param-value>
</context-param>

在URule Pro中有一些默認的允許外部覆蓋的屬性，比如用于指定當前知識庫存放目錄的urule.repository.dir屬性等，對于這些屬性我們可以在項目的WEB-INF目錄下新建一個名為configure的properties文件，在添加設置這些屬性值，然后在我們的context.xml文件中通過如下方法加載即可：

<context:property-placeholder location="/WEB-INF/configure.properties" ignore-unresolvable="true" order="1"/>

如果你的項目中已有Properties文件，那么直接在這個Properties文件里配置這些屬性即可。

如果你是將URule Pro配置到一個已存在的Spring項目中，同時項目也要加載自己的Spring Properties文件，比如通過下面的方式加載自己的Properties文件


<context:property-placeholder location="/WEB-INF/app.properties"/&


這時啟動應用，我們會發(fā)現(xiàn)啟動過程中系統(tǒng)會報各種屬性找不到的異常，解決辦法就是在上面配置中加上 ignore-unresolvable="true" 以及 order="1"兩個屬性即可，其中ignore-unresolvable屬性表達忽略當前配置的Properties文件中沒有配置的屬性，order屬性值表示加載優(yōu)先級，值越小，優(yōu)先級越高。

當然如果你的項目中Properties文件的加載是通過配置PropertyPlaceholderConfigurer為bean的方式加載，那么同樣需要為這個bean添加如下兩個屬性，作用也是一樣。

最后我們還需要在項目的web.xml當中添加URule Pro中的一個Servlet，這個Servlet負責控制臺中所有頁面與服務端的交互，配置信息如下：

<servlet>
    <servlet-name>uruleServlet</servlet-name>
    <servlet-class>com.bstek.urule.console.servlet.URuleServlet</servlet-class>
</servlet>
<servlet-mapping>
    <servlet-name>uruleServlet</servlet-name>
    <url-pattern>/urule/*</url-pattern>
</servlet-mapping>

在上面的servlet配置當中，需要注意的是servlet-mapping中的url-pattern的值必須是/urule/*。

到這里，在項目中添加URule Pro的操作就完成了，接下來，需要打開我們放在/WEB-INF目錄下的configure.properties文件，在其中添加一個名為urule.repository.dir屬性，用于指定URule的資源庫存放的目錄，比如設置urule.repository.dir=D:/repo，表示采用D盤repo目錄來作為URule的資源庫目錄，這時我們需要在D盤中創(chuàng)建一個名為repo的空目錄，否則啟動時會產(chǎn)生找不到目錄的錯誤。

配置完成后，運行項目，瀏覽地址：http://localhost:\[port\]/\[contextPath\]/urule/frame，就可以看到URule Pro的操作控制臺頁面。

項目啟動過程當中，會看到在控制臺有個關于日志信息的警告，這是因為項目中采用了sl4j-log4j的日志框架，但項目的classpath中卻沒有定義log4j.properties文件，所以我們還需要在項目的classpath目錄下添加一個名為log4j.properties文件，在其中定義好日志輸出方式。
一個定義好的向控制臺輸出日志的log4j.properties文件內(nèi)容如下：
```
log4j.rootLogger=INFO,stdout

log4j.appender.stdout=org.apache.log4j.ConsoleAppender log4j.appender.stdout.layout=org.apache.log4j.PatternLayout log4j.appender.stdout.layout.ConversionPattern=[URULE] %p [%t] %C.%M(%L) | %m%n

> 我們可以直接采用上面的內(nèi)容作為log4j.properties文件內(nèi)容，當然也可以根據(jù)需要自己定義。


## 參數(shù)


在前面我們添加的configure.properties中，已經(jīng)添加了一個名為urule.repository.dir參數(shù)，用于指定URule Pro資源庫存儲的目錄，除此之外，URule Pro還提供了下面這些常用參數(shù)可供配置：


| 參數(shù)名 | 描述 |
| :--- | :--- |
| urule.repository.dir | 配置當前知識庫存放目錄，該參數(shù)值與下面的urule.repository.xml參數(shù)值至少要有一個不為空，否則系統(tǒng)啟動會報錯。在URule Pro當中，引擎支持兩種存儲知識庫方式：一種就是在這里通過配置urule.repository.dir參數(shù)指定目錄，將資源存儲到具體的目錄當中；另一種通過配置urule.repository.xml參數(shù)來指定一個可存儲到數(shù)據(jù)庫的配置文件，這樣知識庫就可以存儲到數(shù)據(jù)庫當中。默認urule.repository.dir參數(shù)為空，所以如果我們不想用數(shù)據(jù)庫來存儲規(guī)則相關的知識庫，那么我們就需要配置好該參數(shù)。在配置這個目錄時，我們可以給出一個絕對路徑作為其資源庫存儲目錄，也可以是一個相對于當前WEB目錄的相對路徑；如“D:/repo”就表示將采用D盤下repo目錄為資源庫目錄，需要注意的是，這里repo目錄必須要存在，如果不存在那么將會產(chǎn)生錯誤。如果要采用相對于當前WEB應用的相對路徑，那么可以設置成“/repo”，那就表示在當前WEB應用根下使用repo目錄為資源庫存儲目錄，如果repo目錄不存在，系統(tǒng)將會自動創(chuàng)建。 |
| urule.repository.xml | 通過該參數(shù)在外部指定一個將資源庫存儲到數(shù)據(jù)庫的配置文件，這樣系統(tǒng)啟動時就會按照這個文件中定義的數(shù)據(jù)庫信息自動創(chuàng)建存儲庫所需要的各種表，從而實現(xiàn)將URule Pro知識庫存儲到數(shù)據(jù)庫的目的，后面章節(jié)中會有專門的內(nèi)容介紹如何將知識存儲到數(shù)據(jù)庫。如果在配置了urule.repository.xml參數(shù)后，又配置了urule.repository.dir參數(shù)指定了目錄，那么這個目錄就用于存儲與數(shù)據(jù)庫相關的緩存信息。如果沒有配置urule.repository.dir參數(shù)，那么緩存信息默認將在Jvm的臨時目錄中存儲（通過System.getProperty\("java.io.tmpdir"\)獲取到的目錄） |
| urule.resporityServerUrl | 客戶端上配置的服務器地址，用于獲取在服務器上的知識包信息，詳細描述見“客戶端服務器配置”章節(jié)。 |
| urule.knowledgeUpdateCycle | 值為一個數(shù)字，用來指定客戶端多久到服務端檢查當前知識包有沒有更新。如果為0則每次都檢查，為1則永不檢查，為1以上的值，則表示每隔多少毫秒檢查一次，比如10000，就表示每隔10000毫秒檢查一次。默認值是0，表示每次都檢查，詳細描述見“客戶端服務器配置”章節(jié)。 |
| urule.welcomePage | 一個URL，用于替換URule Pro主界面第一次看到的工作區(qū)內(nèi)容，我們可以配置個URL，這樣默認就會顯示這個URL對應的內(nèi)容。 |
| urule.console.title | 一個字符串，用來替代URule控制臺頁面的title，默認值是“URule Pro Console”。 |
| urule.authority.type | 用于定義權(quán)限配置里權(quán)限配置主體的類型，默認為“用戶”，如果我們需要修改這個屬性，那么需要將中文先轉(zhuǎn)換為uniocde。 |
| urule.debug | 調(diào)試信息是否輸出，默認為true，設置成false的時候，規(guī)則運行時所有的調(diào)試信息都不會輸出。 |