S2JH新增WIKI页面：开发基础环境配置说明，基于SSH的企业Web应用开发框架

概要说明

以下以我本人实际开发环境为例，简要说明开发环境配置过程，供初学者参考。当然你也完全可以根据熟悉的开发工具和环境可自行参考调整配置。本说明仅对配置过程予以说明，其中涉及到诸如Maven，Git等工具的使用相关请自行通过其他渠道了解。

提示说明： 以下说明和截图以自己平时使用的Ubuntu 14 X64位操作系统环境，Windows和32位系统环境请注意对应调整安装软件版本和相关路径参数等。

JDK：JDK6

理论上JDK5+应该都可以，我目前本地是Oracle JDK6，这个安装我想就没必要不多说了。建议安装Oracle JDK，网上说OpenJDK存在一些问题，不过具体没有实际验证过。

IDE： Spring Tool Suite 3.5 based on Eclipse 4.3.X

（Spring Tool Suite）STS3.5参考下载地址： http://spring.io/tools/sts/all ，理论上Eclipse系列IDE应该都能正常导入使用。

STS3.5中基本上预装集成了大部分常用插件，如Spring系列，GIT等，同时还包含一个vfabric-tc-server，直接作为WEB应用开发部署Server，不用再单独下载配置Tomcat了。

初始化一个Workspace，可以根据一些常见优化建议，设置Workspace UTF-8编码，关闭不必要的的Startup，Validation选项等，优化STS启动和工程编译构建时间。

Apache Maven 3.0.X

Apache Maven目前官方同步发布3.2, 3.1, 3.0系列，估计是互补兼容的要不也不会几个版本同时维护更新。 目前自己本地为maven 3.0.4版本，其他版本未测试过，因此建议安装3.0.X系列Maven。

参考下载地址：http://maven.apache.org/download.cgi 注意滚动到Maven 3.0.5区域。

Maven下载到本地解压后，可根据自己习惯设定本地资源库地址/私服地址等配置。 然后一个步骤是需要在STS中设定指向本地Maven环境，参考如下图：

从Git资源库Checkout工程代码

根据自己的习惯通过STS的GIT插件或其他如TortoiseGit等工具，从git资源库checkout整个工程代码。OsChina和 GitHub两个资源库同步更新，可自行根据访问情况选择，建议优先选择OsChina Git一般会访问更快。当然你如果熟悉SVN，可以选择GitHub支持SVN Checkout方式。各站点的Checkout方式请自行根据站点对应说明文档操作。

工程代码checkout后目录结构参考如图：

将工程代码import到STS的workspace

启动按照前面已指向设定好Maven的STS Workspace，由于整个工程结构按照Maven的parent/module模式的父子目录结构，因此需要以Maven项目方式import导入所有项目，否则如果按照常规的项目导入只会导入parent主目录工程。

菜单或右键选择import..., 然后按照如下图示选择：



然后点击浏览git checkout的s2jh工程主目录，会自动解析出一系列依赖项目列表：



之后点击Finish开始导入项目。期间会进行整个项目的初始化编译构建/Maven资源库的下载初始化等操作，可能耗时较长，请耐心等待。

之后展开s2jh-parent项目，在pom.xml右键选择“Run As.” - > "Maven install", STS将自动编译构建/单元测试/初始化本地资源库，整个依赖项目列表。最终执行成功如下图：

Server配置

STS自带一个基于Tomcat的vfabric-tc-server，可以直接用于开发调试。如下图，工作空间默认就已初始化一个Server配 置，如下图双击左侧xml配置文件，最基本的需要添加一个 URIEndoing=“UTF-8”的编码参数，否则get请求会出现中文乱码问题。其余的诸如端口号/JNDI数据源等可根据实际需要修改即可。框架 默认配置以H2嵌入数据库运行模式，暂时可以不用配置数据库链接参数等。



然后在server上面右键选择 Add/Remove..., 把prototype WEB项目加入的server部署：

初始化Server运行

框架默认配置以H2嵌入数据库运行模式，首次运行需要初始化数据库。如下图，修改对应文件和参数为true：



之后启动Server ,查看Console会看到一系列数据库DDL和DML语句，最终启动运行完成大致如下图：



提示：H2数据库以文件方式运行（具体H2数据文件路径可通过在启动日志中搜索“Using H2 EmbeddedFileDatabase:”对应行内容) ，只需初始化一次即可，因此初始化启动之后下次启动Server之前最好改回关闭初数据库始化参数jdbc.initialize.database.enable=false。

如H2文件路径信息：Using H2 EmbeddedFileDatabase: /home/java/h2/prototype, 此/home/java/h2/prototype是文件前缀信息不是目录，其总/home/java/h2才是一个具体文件目录，如果在试用样列应用过 程随意乱修改数据把应用搞乱了而希望重新初始化数据库，只需把/home/java/h2目录下所有prototype为前缀的文件删除，并重新设置 jdbc.initialize.database.enable=true运行Server即可。

浏览器访问Web应用

启动最新版本的FireFox或Chrome或IE8+浏览器，访问：http://localhost:8080/prototype/ ， 出现如下图所示，无需输入登录信息直接点击下方的测试入口admin入口链接即可进入系统主界面：

开发指南

之后即可参考开发指南部分进行Demo样列功能开发了！