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 界面等，直接进行业务编写处理。近期会不断的完善文档，请时刻关注。