Updates project-create.md

Auto commit by GitBook Editor

project-create.md

+# 新开项目
+
+本章节将引导您从 零 开始，创建一个可以运行的 Demo 工程。此工程基于HEL融租易标准版，包含一个 demo 实例。
+  
+## 后端项目
+
+
+### 确定项目信息
+1. groupId  本项目的代号，比如融租易项目，代号为 hel
+2. artifactId  本项目的顶层目录名称，使用项目代号(第一个字母大写)
+ + Parent，如 HelParent
+3. package 包名称，使用项目代号 + core ,如 Hel.core
+4. archetypeVersion 是指模板项目的版本，可以使用以下版本号
+>  1.0-RELEASE
+  
+### 新建项目  (融租易HEL1.0)
+
+确定上述信息后，可以使用如下命令新建项目：
+
+`注意`  maven-archetype-plugin `2.4`及以下版本可以正常使用下面命令
+
+```
+mvn archetype:generate  -D archetypeGroupId=hel-custom -D archetypeArtifactId=hel-custom-parent-archetype -D archetypeVersion=1.0-RELEASE -D groupId=hel -D artifactId=HelParent -D package=Hel.core -D version=1.0-RELEASE -D archetypeRepository=https://hel.hand-china.com/nexus/content/repositories/Hel-Releases
+
+```
+
+在maven-archetype-plugin `3.0.0` 版本中，移除了对-D archetypeRepository参数的支持，会报以下错误
+![](/assets/mvn_archetype_plugin.png)
+
+解决方案：
+指定使用2.4版本的archetype-plugin插件：
+```
+mvn org.apache.maven.plugins:maven-archetype-plugin:2.4:generate  -D archetypeGroupId=hel-custom -D archetypeArtifactId=hel-custom-parent-archetype -D archetypeVersion=1.0-RELEASE -D groupId=hel -D artifactId=HelParent -D package=Hel.core -D version=1.0-RELEASE -D archetypeRepository=https://hel.hand-china.com/nexus/content/repositories/Hel-Releases
+
+```
+
+
+> 以下内容所指的 `HelParent` 均指上面命令中的参数 `artifactId` 的值，请按实际情况替换
+
+新的项目目录结构如下：
+```
+.
+├── README.md (项目README，请在此处写上项目开发的注意信息，方便团队协同)
+├── core（功能实现项目）
+│   ├── pom.xml （子项目core的pom.xml文件）
+│   └── src
+│       └── main
+│           ├── java
+│           │   ├── hel
+│           │   │   └── core（前面的包名称）
+│           │   │       ├── db（数据表结构，数据初始化入口文件）
+│           │   │       │   └── liquibase.groovy
+│           │   └── resources（项目配置文件目录）
+│           │       ├── spring （spring配置文件目录）
+│           │       ├── config.properties
+│           │       └── logback.xml（日志配置文件）
+│           └── webapp（Webapp目录）
+│               ├── resources（UI 资源库目录）
+|               |        └── demo.js(demo.js样例，可以删除)
+│               └── WEB-INF
+│                   └── view（页面文件目录）
+│                       └── demo.html（demo.html样例，可以删除）
+├── core-db（数据库脚本及初始化数据项目）
+│   ├── pom.xml
+│   └── src
+│       └── main
+│           └── java
+│               └── hel
+│                   └── core
+│                       └── db
+│                           ├── data（数据文件）
+│                           │   └── (init-data)
+│                           └── table（数据库表结构管理）
+│                               └── 2016-06-01-init-migration.groovy
+└── pom.xml
+
+```
+
+### 确定本项目使用的数据库
+
+> 目前已经测试过支持的数据库有Mysql,Oracle,SqlServer  
+> 请修改 `HelParent/core/src/main/java/hel/core/db/liquibase.groovy` 以适配不同的数据库
+
+确定好数据库后，按照 [Oracle,MySql,Sqlserver数据库配置](database-config.md) 修改项目配置文件。    
+修改配置文件后，按照[创建数据库](database-init.md) 中的步骤创建数据库  
+
+
+### 编译整个项目
+在 HelParent 目录下执行：
+```
+mvn clean install -Dmaven.test.skip=true
+```
+
+<a name="liquibase"> </a>
+
+### 初始化数据库表结构及基础数据
+在 HelParent 项目录下执行：
+
+- MySql 
+     - `mvn process-resources -D skipLiquibaseRun=false -D db.driver=com.mysql.jdbc.Driver -D db.url=jdbc:mysql://127.0.0.1:3306/hel_dev -Ddb.user=hel_dev -Ddb.password=hel_dev`
+- SqlServer 
+     - `mvn process-resources -D skipLiquibaseRun=false  -Ddb.user=hel_dev -Ddb.password=hel_dev-D db.driver=com.microsoft.sqlserver.jdbc.SQLServerDriver -D db.url="jdbc:sqlserver://127.0.0.1:1433; DatabaseName=hel_dev"`
+- Oracle 
+     - `mvn process-resources -D skipLiquibaseRun=false -D db.driver=oracle.jdbc.driver.OracleDriver -D db.url=jdbc:oracle:thin:@127.0.0.1:1521:HEL -Ddb.user=hel_dev -Ddb.password=hel_dev
+   - 以上命令中，需要按实际情况修改 url，user，password
+
+### 测试
+1. 在 HelParent 工程目录下执行命令(IntelliJ IDEA 用户可以跳过此步骤)
+  ```
+  mvn eclipse:eclipse
+  ```
+  
+3. 将所有工程导入 IDE 工具（Eclipse，IntelliJ IDEA）中
+4. 配置 Server ，配置 JNDI 数据源，参照[多数据库配置](chapter1.1.md)
+  - 需要 Tomcat 7+， 不支持 Tomcat 6
+5. 将 hel 工程发布到 tomcat，运行
+
+### 更新HEL依赖
+
+  [更新项目依赖的HEL版本](project-update.md)
+