WebBuilder是一款很通用的平臺(tái),支持大多數(shù)運(yùn)行環(huán)境,包括但不限于:
操作系統(tǒng):Linux,Unix,Windows,Mac等
JDK環(huán)境:Java 8及以上版本(如果使用OpenJDK,需要下載Nashorn包。)
Web Server/App Server:Apache Tomcat,Jetty,Resin,WebLogic,WebSphere等所有符合工業(yè)標(biāo)準(zhǔn)的服務(wù)器
數(shù)據(jù)庫:Sql Server,MySql,Oracle,Db2,Sybase等所有符合工業(yè)標(biāo)準(zhǔn)的數(shù)據(jù)庫
瀏覽器:Chrome,IE,F(xiàn)irefox,Opera,Safari以及其他基于這些內(nèi)核的瀏覽器
移動(dòng)設(shè)備:Android,iOS,Windows Phone
通常情況下,只需復(fù)制WebBuilder應(yīng)用目錄至目標(biāo)服務(wù)器即可完成安裝。使用安裝向?qū)У哪康氖沁M(jìn)行數(shù)據(jù)庫表的創(chuàng)建和復(fù)制。
安裝的主要工作是配置應(yīng)用服務(wù)器的JNDI,關(guān)于JNDI的配置可以參考網(wǎng)上的相關(guān)文檔和資料。
以Tomcat8和Sql Server為例,安裝步驟如下(其他運(yùn)行環(huán)境部署步驟可參照此進(jìn)行):
安裝運(yùn)行環(huán)境:包括Java 8、Tomcat 8和Sql Server。
解壓縮軟件包webbuilder.zip,并把軟件包根目錄內(nèi)的wb目錄復(fù)制到tomcat8/webapps。
在tomcat8/webapps/wb目錄下創(chuàng)建META-INF目錄,并在META-INF目錄下創(chuàng)建context.xml文件以配置JNDI。
context.xml文件內(nèi)容如下:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE Context>
<Context reloadable="true" crossContext="true">
<WatchedResource>WEB-INF/web.xml</WatchedResource>
<Resource
name="jdbc/wb_sqlserver"
auth="Container" type="javax.sql.DataSource"
driverClassName="com.microsoft.sqlserver.jdbc.SQLServerDriver"
validationQuery="select 1" testWhileIdle="true" testOnBorrow="false"
url="jdbc:sqlserver://127.0.0.1:1433;DatabaseName=wb"
username="sa" password="111111"
maxActive="20" maxIdle="10" maxWait="-1" />
</Context>
其中,標(biāo)記為紅色字體部分需要根據(jù)目標(biāo)數(shù)據(jù)庫的實(shí)際情況,作相應(yīng)的更改,指定名稱的數(shù)據(jù)庫必須已經(jīng)存在。在軟件包中misc目錄下有context.xml文件可作jndi配置參考。
下載SQL Server驅(qū)動(dòng)jar包 sqljdbc4.jar,并復(fù)制該文件至tomcat8/lib目錄,如有必要重啟tomcat。
打開瀏覽器(開發(fā)階段建議使用Chrome)并訪問 http://ip:port/wb/setup (例如http://localhost:8080/wb/setup),然后使用安裝向?qū)硗瓿?WebBuilder 的安裝。
在安裝向?qū)е杏衃創(chuàng)建JNDI]按鈕,該功能用于輔助創(chuàng)建JNDI,如果我們已經(jīng)通過上述方法配置完成JNDI,可以不需要使用此功能。直接點(diǎn)擊[下一步]按鈕即可。
在安裝向?qū)е校斎肽J(rèn)數(shù)據(jù)庫JNDI和類型:
JNDI:java:comp/env/jdbc/wb_sqlserver
類型:sqlserver
輸入完成之后點(diǎn)擊下一步,直到系統(tǒng)自動(dòng)完成安裝。
安裝完成之后,使用管理員帳戶登錄到系統(tǒng),默認(rèn)首頁地址為 http://ip:port/wb/index,管理員默認(rèn)用戶名稱和密碼都為admin。
優(yōu)化Tomcat:可根據(jù)目標(biāo)系統(tǒng)實(shí)際情況配置和優(yōu)化連接池和線程池。
在安裝過程中如果發(fā)生錯(cuò)誤,請(qǐng)嘗試按下列方法來解決:
使用的Java版本是否為Java 8及以上版本。
檢查創(chuàng)建的默認(rèn)數(shù)據(jù)庫是否支持中文或utf-8編碼。
檢查Java和Tomcat的版本是否匹配,比如Java 8應(yīng)該使用Tomcat 8。
檢查tomcat8/conf/Catalina/localhost/wb.xml中的內(nèi)容是否同jndi配置文件context.xml同步(wb.xml文件名同應(yīng)用目錄名)。
如果安裝提示duplicate entry異常,請(qǐng)確認(rèn)數(shù)據(jù)庫是否設(shè)置支持utf-8或gbk編碼。
檢查數(shù)據(jù)庫驅(qū)動(dòng)jar包是否同數(shù)據(jù)庫版本匹配。
如發(fā)生異常NullPointerException,請(qǐng)檢查JRE是否支持服務(wù)器端JavaScript(Nashorn)。
如仍未能排除異常,請(qǐng)嘗試把軟件包中misc目錄下test-jndi.jsp復(fù)制到應(yīng)用目錄wb下并修改相關(guān)代碼,然后運(yùn)行以測試jndi有效性。
WebBuilder是一個(gè)典型的web應(yīng)用,包括兩個(gè)目錄wb和WEB-INF。
wb目錄是WebBuilder資源目錄,包括javascript,css,html,圖片,模塊,配置文件和其他相關(guān)文件等,wb目錄由以下子目錄組成:
css:樣式表目錄,樣式表文件建議放在此目錄。
images:圖片目錄,圖片文件建議放在此目錄。
libs:前端第三方庫目錄,包括extjs,bootstrap和touch等。
modules:模塊根目錄,所有模塊文件存放于此。此目錄受系統(tǒng)保護(hù),客戶端無法直接訪問。
script:客戶端JavaScript腳本目錄,JavaScript腳本文件建議放在此目錄(服務(wù)器端的JavaScript文件除外)。
system:系統(tǒng)目錄,含配置文件、變量文件、數(shù)據(jù)庫文件和服務(wù)器端JavaScript文件等。此目錄受系統(tǒng)保護(hù),客戶端無法直接訪問。需要保護(hù)的文件可放在此目錄下。
WEB-INF目錄通常用于存放Java的庫文件jar和類文件class。WebBuilder及其第三方j(luò)ar包放在WEB-INF/lib子目錄下。
此外在某些web應(yīng)用服務(wù)器上還有META-INF目錄,此目錄內(nèi)通常會(huì)有context.xml文件用于配置JNDI數(shù)據(jù)源。由于不同web應(yīng)用服務(wù)器對(duì)JNDI的配置不盡相同,因此該目錄在WebBuilder的軟件包中默認(rèn)省略。
聯(lián)系客服