21.Spring Bean及Java類的熱部署
簡介
在URule Pro中支持Spring Bean及Java類的熱部署功能,利用該功能,可(kě)将需要熱部署的Spring Bean及相關Java類文件實時(shí)部署到正在運行(xíng)的服務器(qì)中。 對于采用客戶端服務器(qì)模式運行(xíng)的URule Pro應用,隻需要在服務端部署好需要的Spring Bean及相關Java類文件,客戶端會(huì)自動獲取這些(xiē)已部署的Spring Bean及相關Java類文件信息,并對其進行(xíng)執加載。
有(yǒu)了這個(gè)功能,URule Pro中無論是用戶自定義的動作(zuò)庫還(hái)是內(nèi)置動作(zuò)庫相關的Spring Bean及Java類,都可(kě)以在服務器(qì)運行(xíng)情況下,實時(shí)動态部署。
部署方式
登錄系統,在進入團隊主頁面即可(kě)看到Jar文件熱部署入口鏈接,如下圖:
打開(kāi)Jar文件熱部署的管理(lǐ)頁面,點擊工具欄上(shàng)“添加Jar文件”按鈕添加一個(gè)新的部署項,在彈出的窗口中輸入項目名稱,點擊“确定”後就會(huì)出現文件上(shàng)傳按鈕,選擇一個(gè)合适的jar文件上(shàng)傳即可(kě)。如下圖所示:
完成之後點擊頁面工具欄上(shàng)“部署”,即可(kě)将所有(yǒu)部署項中上(shàng)傳的Jar文件動态部署到當前項目中;如果當前項目被當成URule Server使用,同時(shí)又在項目裏配置了客戶端地址,那(nà)麽在Server上(shàng)部署完成後,系統會(huì)提示我們要不要将這些(xiē)動态的Jar文件推送到URule客戶端,如果選擇是,那(nà)麽這些(xiē)客戶端立即接收到這些(xiē)Jar文件并動态加載。
Spring配置文件及Jar文件要求
從部署方式上(shàng)了解到,我們隻需要将需要熱部署的Jar包上(shàng)傳到系統即可(kě),如果其中要加載Spring Bean,那(nà)麽還(hái)需要定義好Spring的xml配置文件放在Jar包中一并上(shàng)傳,下面來(lái)舉例說明(míng)Spring配置文件及Jar文件打包方式。
假如我們需要部署下面這個(gè)Java類文件,內(nèi)容如下:
package test;
/**
* @author Jacky.gao
* @since 2019年1月11日
*/
public class BusinessTest {
public String hello(String name) {
System.out.println(new OtherBusiness().getENV());
return "Hello, "+name;
}
}
從上(shàng)面的代碼中可(kě)以看出,這裏的hello方法引用了OtherBusiness類中的getENV方法,OtherBusiness類源碼如下:
package test;
/**
* @author Jacky.gao
* @since 2019年1月11日
*/
public class OtherBusiness {
public String getENV() {
return "環境 is OK...";
}
}
可(kě)以看到getENV方法非常簡單,隻是返回一個(gè)字符串而已,對于BusinessTest類,我們希望它成為(wèi)一個(gè)标準的Spring Bean,所以還(hái)要添加一個(gè)Spring的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
">
<bean id="dybean" class="test.BusinessTest"></bean>
</beans>
在上(shàng)面這段xml配置中,test.BusinessTest類被配置成為(wèi)一個(gè)标準的Spring Bean,Bean的ID為(wèi)dybean。到這裏Java類的編寫及Spring Bean的xml配置工作(zuò)就完成了,接下來(lái)就需要将它們打包Jar并上(shàng)傳到URule中實際熱部署。
為(wèi)了演示Java類引用多(duō)個(gè)不同Jar包中其它類庫的情形,這裏我們把BusinessTest類和(hé)OtherBusiness類打成兩個(gè)Jar文件,分别是main.jar和(hé)slave.jar,至于Spring Bean的xml配置文件放在兩個(gè)Jar文件中任何一個(gè)中都可(kě)以,隻是xml的名稱必須是urule-spring-context.xml,且這個(gè)名為(wèi)urule-spring-context.xml的Spring配置文件必須放在Jar文件的根下,這裏我們把這個(gè)urule-spring-context.xml文件打包在main.jar文件當中。
打包好的main.jar文件結構如下圖所示:
打包好的slave.jar文件結構如下圖所示:
上(shàng)面的兩個(gè)Jar文件中,BusinessTest類和(hé)OtherBusiness類都位于test這個(gè)package下,所以截圖中隻看到test這個(gè)package。 對于URule Pro來(lái)說,每個(gè)Jar文件中都可(kě)以包含一個(gè)名為(wèi)urule-spring-context.xml的Spring的xml配置文件,如果包含每個(gè)文件中的Spring配置文件都會(huì)被解析并加載; 當然也可(kě)以都不包含,這樣熱部署時(shí)引擎隻會(huì)加載Jar包中的類。
配置
當我們點擊“态部署Jar文件的配置頁面”上(shàng)的部署按鈕時(shí),系統會(huì)嘗試取到知識庫裏所有(yǒu)已上(shàng)傳的Jar文件,然後通(tōng)過System.getProperty("java.io.tmpdir")取到當前JVM應用的臨時(shí)目錄,同時(shí)在其下創建名為(wèi)urule-jars的目錄,最後取當前系統日期作(zuò)為(wèi)Jar文件的最終存儲目錄。
每次點擊“部署”按鈕時(shí),系統都會(huì)嘗試删除原來(lái)的由系統日期生(shēng)成的子目錄,再根據當前日期重新創建子目錄,再把所有(yǒu)的Jar文件放在這個(gè)目錄下。
在臨時(shí)目錄中生(shēng)成好所有(yǒu)的已上(shàng)傳的Jar文件後,接下來(lái)系統會(huì)嘗試加載這個(gè)目錄下的所有(yǒu)Jar文件,如果這些(xiē)Jar文件根下包含名為(wèi) urule-spring-context.xml的Spring配置文件,系統也會(huì)将這個(gè)文件加載到Spring上(shàng)下文中。
實際使用中,如果不想讓引擎通(tōng)過System.getProperty("java.io.tmpdir")這種方式,取到的臨時(shí)目錄來(lái)作(zuò)為(wèi)動态Jar文件的存儲父目錄,那(nà)麽可(kě)以在Spring的Properties文件中添加一個(gè)名為(wèi)urule.dynamicJarsPath的屬性來(lái)手工指定一個(gè)用于存儲動态Jar文件的 父目錄,需要注意的是通(tōng)過urule.dynamicJarsPath屬性指定的目錄一定要存在,否則啓動時(shí)會(huì)産生(shēng)錯誤。
對于采用客戶端服務器(qì)模式運行(xíng)的應用來(lái)說,如果客戶端是一個(gè)Java Web應用,那(nà)麽隻需要按照客戶端服務器(qì)模式中介紹的在客戶端中配置好接收服務端推送過來(lái)的知識庫的Servlet即可(kě),這樣服務端動态Jar部署時(shí)會(huì)提示是否推送到客戶端,如果選是,那(nà)麽這些(xiē)動态Jar文件會(huì)直接推送到目标客戶端,客戶端收到後也會(huì)按照上(shàng)述方式加載這些(xiē)Jar文件及其中可(kě)能存在的名為(wèi)urule-spring-context.xml的Spring配置文件。
和(hé)知識包的客戶端一樣,客戶端也可(kě)以主動檢查服務端是否存在動态Jar文件,檢查方式也是在客戶端上(shàng)配置“urule.resporityServerUrl”屬性值,客戶端中配置好“urule.resporityServerUrl”屬性值後,客戶端應用除了會(huì)利用這個(gè)URL到服務端下載規則包,還(hái)會(huì)在啓動時(shí)利用這個(gè)URL檢查服務端是否存在動态加載的Jar文件,如果有(yǒu)則下載到客戶端并加載;這時(shí)服務端的“urule/dynamic/checkLatestJarsDir”和(hé)“urule/dynamic/loadDynamicJars”這兩個(gè)URL要保證匿名可(kě)訪問,否則客戶端啓動時(shí)會(huì)産生(shēng)錯誤。
如果客戶端是一個(gè)标準的Java應用,而非一個(gè)Java Web應用,對于這種類型的應用來(lái)說,為(wèi)了可(kě)以取到服務端生(shēng)成的動态Jar文件,我們可(kě)以在客戶端Spring的Properties文件中添加一個(gè)名為(wèi)urule.dynamicJarsRemoteLoadInterval的屬性 來(lái)決定客戶端每隔多(duō)久利用客戶端上(shàng)配置的urule.resporityServerUrl屬性值到服務端檢查有(yǒu)沒有(yǒu)新的動态Jar産生(shēng),如果有(yǒu)則從服務端取回并加載。
urule.dynamicJarsRemoteLoadInterval的屬性值單位為(wèi)分鍾,如果我們設置其值為(wèi)5,那(nà)就表示每隔5分鍾到服務端檢查是否生(shēng)成新的動态Jar文件,如果不設置則表示客戶端不會(huì)定期檢查服務端是否有(yǒu)新的動态Jar包産生(shēng)。
如果是springboot項目,需要在spring的配置文件中添加屬性配置
spring.main.allow-bean-definition-overriding=true