运行环境WebBuilder是一款很通用的平台,支持大多数运行环境,包括但不限于: 操作系统:Linux,Unix,Windows,Mac等 JDK环境:Java 8及以上版本(如果使用OpenJDK,需要下载Nashorn包。) Web Server/App Server:Apache Tomcat,Jetty,Resin,WebLogic,WebSphere等所有符合工业标准的服务器 数据库:Sql Server,MySql,Oracle,Db2,Sybase等所有符合工业标准的数据库 浏览器:Chrome,IE,Firefox,Opera,Safari以及其他基于这些内核的浏览器 移动设备:Android,iOS,Windows Phone
安装WebBuilder通常情况下,只需复制WebBuilder应用目录至目标服务器即可完成安装。使用安装向导的目的是进行数据库表的创建和复制。 安装的主要工作是配置应用服务器的JNDI,关于JNDI的配置可以参考网上的相关文档和资料。 以Tomcat8和Sql Server为例,安装步骤如下(其他运行环境部署步骤可参照此进行): 安装运行环境:包括Java 8、Tomcat 8和Sql Server。 解压缩软件包webbuilder.zip,并把软件包根目录内的wb目录复制到tomcat8/webapps。 
在tomcat8/webapps/wb目录下创建META-INF目录,并在META-INF目录下创建context.xml文件以配置JNDI。 
context.xml文件内容如下: <?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>
其中,标记为红色字体部分需要根据目标数据库的实际情况,作相应的更改,指定名称的数据库必须已经存在。在软件包中misc目录下有context.xml文件可作jndi配置参考。 下载SQL Server驱动jar包 sqljdbc4.jar,并复制该文件至tomcat8/lib目录,如有必要重启tomcat。 打开浏览器(开发阶段建议使用Chrome)并访问 http://ip:port/wb/setup (例如http://localhost:8080/wb/setup),然后使用安装向导来完成 WebBuilder 的安装。 
在安装向导中有[创建JNDI]按钮,该功能用于辅助创建JNDI,如果我们已经通过上述方法配置完成JNDI,可以不需要使用此功能。直接点击[下一步]按钮即可。 在安装向导中,输入默认数据库JNDI和类型: JNDI:java:comp/env/jdbc/wb_sqlserver 类型:sqlserver
输入完成之后点击下一步,直到系统自动完成安装。 安装完成之后,使用管理员帐户登录到系统,默认首页地址为 http://ip:port/wb/index,管理员默认用户名称和密码都为admin。 优化Tomcat:可根据目标系统实际情况配置和优化连接池和线程池。
在安装过程中如果发生错误,请尝试按下列方法来解决: 使用的Java版本是否为Java 8及以上版本。 检查创建的默认数据库是否支持中文或utf-8编码。 检查Java和Tomcat的版本是否匹配,比如Java 8应该使用Tomcat 8。 检查tomcat8/conf/Catalina/localhost/wb.xml中的内容是否同jndi配置文件context.xml同步(wb.xml文件名同应用目录名)。 如果安装提示duplicate entry异常,请确认数据库是否设置支持utf-8或gbk编码。 检查数据库驱动jar包是否同数据库版本匹配。 如发生异常NullPointerException,请检查JRE是否支持服务器端JavaScript(Nashorn)。 如仍未能排除异常,请尝试把软件包中misc目录下test-jndi.jsp复制到应用目录wb下并修改相关代码,然后运行以测试jndi有效性。
WebBuilder目录和文件结构WebBuilder是一个典型的web应用,包括两个目录wb和WEB-INF。 wb目录是WebBuilder资源目录,包括javascript,css,html,图片,模块,配置文件和其他相关文件等,wb目录由以下子目录组成: css:样式表目录,样式表文件建议放在此目录。 images:图片目录,图片文件建议放在此目录。 libs:前端第三方库目录,包括extjs,bootstrap和touch等。 modules:模块根目录,所有模块文件存放于此。此目录受系统保护,客户端无法直接访问。 script:客户端JavaScript脚本目录,JavaScript脚本文件建议放在此目录(服务器端的JavaScript文件除外)。 system:系统目录,含配置文件、变量文件、数据库文件和服务器端JavaScript文件等。此目录受系统保护,客户端无法直接访问。需要保护的文件可放在此目录下。
WEB-INF目录通常用于存放Java的库文件jar和类文件class。WebBuilder及其第三方jar包放在WEB-INF/lib子目录下。 此外在某些web应用服务器上还有META-INF目录,此目录内通常会有context.xml文件用于配置JNDI数据源。由于不同web应用服务器对JNDI的配置不尽相同,因此该目录在WebBuilder的软件包中默认省略。
|