## WebBuilder 说明

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

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

### 软件包目录和文件清单

- misc：一些常用的杂项文件，用于配置web应用服务器；
- source：WebBuilder源代码；
- wb：WebBuilder应用目录，可把此目录直接复制到web应用服务器应用目录；
- license.html：WebBuilder及其第三方软件授权协议；
- readme.html：本文件，用于对WebBuilder进行说明；

### 运行环境和系统安装

WebBuilder是一款很通用的平台，支持大多数运行环境，包括但不限于：

- 操作系统：Linux，Unix，Window，Mac等
- JDK环境：支持JDK6及以上版本（JDK需支持服务器端JS，标准JDK都支持该功能。个别如低版本OpenJDK无该功能，可单独下载Rhino/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应用目录至目标服务器即可完成安装。使用安装向导的目的是进行数据库表的创建和复制，并初始化系统变量。

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

1. 安装运行环境：包括JDK6、Tomcat6和Sql Server；
2. 解压缩下载的软件包wb7.zip，并把其中的wb目录复制到tomcat6/webapps/wb；
3. 在tomcat6/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"
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，并复制该文件至tomcat6/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：可根据目标系统实际情况配置和优化连接池和线程池。Tomcat6版本可下载性能优化文件tcnative-1.dll至tomcat6/bin目录。

在安装过程中如果发生错误，请尝试按下列方法来解决：

- 检查tomcat6/conf/Catalina/localhost/wb.xml中的内容是否同jndi配置文件context.xml同步（wb.xml文件名同应用目录名）；
- 检查数据库驱动jar包是否同数据库版本匹配；
- 如发生异常NullPointerException，请检查JRE是否支持服务器端JavaScript（如低版本OpenJDK不支持服务器端JavaScript，可以下载Rhino包）。
- 如仍未能排除异常，请尝试把软件包中misc目录下test-jndi.jsp复制到应用目录wb下并修改相关代码，然后运行以测试jndi有效性，或在项目中加载WebBuilder源码后调试com.wb.util.DbUtil.getConnection方法以查找异常原因。

### 如果我遇到了问题该怎么办

如果您在使用WebBuilder过程中遇到任何问题可以通过以下方式联系我们：

- 社区：http://www.putdb.com
- QQ：157563514
- QQ群：238634835
- 电子邮件：contact@putdb.com