WebBuilder 说明

本文件的目的在于使您快速了解WebBuilder，以及如何安装WebBuilder到您的系统中。

更多详情请访问：http://www.geejing.com

软件包目录和文件清单

• misc：一些常用的供配置应用服务器时作参考的文件。
• wb：WebBuilder应用目录，可把此目录直接复制到web应用服务器应用目录。
• license.html：WebBuilder及其第三方软件授权协议。
• readme.html：本文件，用于对本软件包进行说明。

运行环境和系统安装

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应用目录至目标服务器即可完成安装。使用安装向导的目的是进行数据库表的创建和复制。

安装的主要工作是配置应用服务器的JNDI，关于JNDI的配置可以参考网上的相关文档和资料。

以Tomcat8和Sql Server为例，安装步骤如下（其他运行环境部署步骤可参照此进行）：

1. 安装运行环境：包括Java 8、Tomcat 8和Sql Server。
2. 解压缩软件包webbuilder.zip，并把软件包根目录内的wb目录复制到tomcat8/webapps。
3. 在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配置参考。

4. 下载SQL Server驱动jar包 sqljdbc4.jar，并复制该文件至tomcat8/lib目录，如有必要重启tomcat。
5. 打开浏览器（开发阶段建议使用Chrome）并访问 http://ip:port/wb/setup （例如http://localhost:8080/wb/setup），然后使用安装向导来完成 WebBuilder 的安装。

在安装向导中，输入默认数据库JNDI和类型：

JNDI：java:comp/env/jdbc/wb_sqlserver
类型：sqlserver

输入完成之后点击下一步，直到系统自动完成安装。

6. 安装完成之后，使用管理员帐户登录到系统，默认首页地址为 http://ip:port/wb/index，管理员默认用户名称和密码都为admin。
7. 优化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 课堂：http://www.geejing.com/school
• WebBuilder 文档：http://www.geejing.com/wdocs
• WebBuilder 相关资源下载：http://www.geejing.com/download.html
• 官方网站：http://www.geejing.com
• 联系我们：contact@geejing.com