JEESZ 分布式框架开发环境部署

1. 环境准备

1. 开发工具： Eclipse IDE（建议使用高一点的版本）

2. JDK 版本：JDK1.7

3. 项目管理： Maven3.1.1

2. 安装步骤

1. 安装 jdk1.7 并配置环境变量（相信大家都会做，这里不再做重复的说明）

2. 安装 maven：maven 安装过程就是解压缩的过程（我已经帮大家解压了,目录：E:\myprj\jeesz-maven\apache-maven-3.1.1）,为了方便大家，这边已经提供了相关的安装包，会在打包的目录下共享。

3. mavan配置环境变量，右击我的电脑à属性à高级系统设置à环境变量à找到（系统变量 path），在最前面输入你的 maven安装包路径，声明：因为上一步解压了指定的目录，所以配置如下：

E:\myprj\jeesz-maven\apache-maven-3.1.1\bin;

相信大家都有配过环境变量，如果您不是很清楚，请查询相关资料，了解一下 maven的相关知识。

4. 打开 cmd，在里面敲：mvn –version，出现以下结果说明你 maven 安装成功了

mvn 是 maven 的一个指令，mvn -version 是查看版本信息，我的操作系统是 64位的 WIN7，安装的 maven 是 3.1.1，如果能打印如上信息，说明到此 Maven3 已经在你的电脑上安装完成。

5. 创建工作空间(进入后选中 j2ee 视图)

6. 配置 Eclipse 编码为 UTF-8

Eclipse 工具栏中选择 WindowPrefrencesGeneralWorkspace

7. 配置 jre 环境(之前大家需要安装了 jdk1.7 版本，这里就使用安装好的 jdk进行配置)：

选择 Window-Prefrences-java-Installed JREs-Edit-选择自己本地 jdk 安装路径-Finished-OK

8. 去除 JavaScript 的验证等信息（因为项目中大量使用 js、css、xml 等其他不同格式的文件，考虑到每次编译的执行时间，所以这边临时将一些验证信息去除）

Window-Prefrences-Validation-Suspend all validators-ok

9. 修 改 刚 刚 安 装 的 maven settings.xml 配 置 文 件 ， 路 径 如 下 ：E:\myprj\jeesz-maven\apache-maven-3.1.1\conf, 添 加 本 地 库 地 址 ：<localRepository>E:/myprj/jeesz-maven/apache-maven-3.1.1/repository</localRepository>

修改中央库路径（在网络正常的情况下，可以从远程中央库下载缺失的jar 包,我这里使用了 Oschina 的中央库，如果网络有问题，大家可以使用自己公司的私服进行加载相关 jar包），考虑到大家包有时候下载不下来，我这里也给大家共享了项目所需要的 jar 包，全部放到了以下目录：E:/myprj/jeesz-maven/apache-maven-3.1.1/repository

10. Eclipse 中配置 maven 安装目录和 Setting 文件加载的本地库目录

11. 导入 Maven 项目

File-Import-Existing Maven Projects-下一步

选择你本地的 maven 项目（请选中 jeesz-project 根目录），点击确定：

加载出来所有项目后，点击 finish 完成

提醒：这个导入的过程要一段时间，因为我本地连接网络，所以会从远程中央库下载项目所需要的所有的 jar 包，请大家耐心等候。如果你使用了本地库则不需要等待很长时间，如果是使用公司私服，则等待时间也不会很长。导入后的项目信息：

本地库的包已经下载了：

12. 下载完所有 jar 包，更新 maven 项目：

1) 选中所有项目 2) 右键选择 maven-Update project…-选择所有-勾选关联项-点击 ok

如果项目还出现红 X 错误，则必定是缺少相关的 jar 包，可以使用：Window-showView-problem 窗口查看异常信息：

如果缺少 jar 包，可以将我们提供的 jar 包直接 copy 到你指定目录即可。

待项目里面的所有错误全部清零后才能进行下一步工作（如下图所示）选中所有项目，对项目进行清理：Project-clean

13. 尝试对项目进行编译、打包看是否有问题：

注意：一般我们打包编译是针对于根项目，因为里面配置了所有的依赖关系。右键 jeesz-project-Run As-Maven build

在弹出的对话框中录入 clean install –X 命令，勾选 Skip tests，Run…提醒：如果对 maven 命令不是很熟的，可以去查下相关的资料这边简单做下解释：clean install –X 表示清理所有项目并将 jar 包装载到本地库，其中-X 表示输出的信息（一般在出现 maven 问题的时候可以使用-X 来定位问题。）

此时控制台开始编译装载所有的包，这个过程有点漫长，请大家耐心等候。

出现以下结果说明项目是正常的。

打好的包（包含 war、jar），都在 target 文件夹下，这边只以 jeesz-web-admin为实例截图如下

14. 使用 Tomcat 发布 jeesz 项目（发布过程不做详细介绍，大家都会做）：

下面对各个不同的项目进行介绍：

Jeesz-web-admin: 可以独立部署（后台管理平台）
Jeesz-web-service:可以独立部署（REST 服务平台，客户可以根据自己的业务去拓展 Rest 服务，里面已经写好了相关的实例）

Jeesz-service-bookmark、jeesz-service-task 为 dubbo 服务提供者（这边只通过收藏和待办项目来对 dubbo 服务项目开发做相关介绍，客户可以根据自己的业务去拓展 dubbo 服务，可以同时部署，也可以拆分部署）

Jeesz-web-bookmark、jeesz-web-task 为 dubbo 消费者平台，其中 dubbo 服务对外暴漏的服务接口为：Jeesz-facade-bookmark、jeesz-façade-task（这边只通过收藏和待办项目来描述 dubbo 客户端怎样调用 dubbo 服务提供者的过程，客户可以将 dubbo 消费端植入到不同的项目中，只需要做一些简单配置就可以了）

部署条件：

1) 执行 mysql 数据库脚本: jeesz.sql

数据库 jdbc 的配置项可以参考

2) Jeesz-web-admin 可以直接通过 tomcat 部署

登陆用户名密码：jeesz/admin

3) Jeesz-web-service:可以通过 tomcat 独立部署

登陆用户名密码：jeesz/admin

4) 部署 dubbo 相关的项目需要具备以下条件：
安装 dubbo 管控平台，将 war 包解压到 tomcat，并将目录替换为

根目录，直接启动 tomcat 即可（开发环境提供 window）

Zookeeper 注册中心安装，我这边提供了 zookeeper-3.4.5 版本（开发环境提供 window），进入安装目录启动即可

提醒： 我这边已经给提供了相关的程序，其中 dubbo 管控平台要独立部署在 Tomcat 服务器上，这个不需要进行高可用配置，直接启动tomcat 就可以启动。Zookeeper 注册中心有相关的命令可以直接运行启动。如果想部署在 linux 系统上，可以看我们提供的相关文档即可。

5) 待 dubbo 管控台和注册中心启动 ok，则将 Jeesz-service-bookmark、jeesz-service-task 项目同时（可以独立部署）部署到 tomat 中，为 dubbo服务提供者

6) 登陆 dubbo 管控台查看相关的服务信息，可以看到你发布的服务已经由管控台进行管控了：http://localhost:80 直接通过地址可以访问是因为将包名改为了 Root   用户名密码：root/root 

7) 分部部署 Jeesz-web-bookmark、jeesz-web-task dubbo 消费者项目，目的是让开发人员了解服务是怎样调用的。

到此整个项目的安装过程先到这里，请各位开发人员安装完项目后投入开发，所有的业务直接服务化，因为项目是基于驱动开发的，故将你们的表设计好，通过 jeesz-web-admin 项目的 gen 代码生成模块自动生成所有的 controller、service、dao、xml、jsp 界面等，直接进行业务编写处理。近期会不断的完善文档，请时刻关注。