Skip to content

H
hel-developer-guide
Commit b88e3a1f authored by zydgitboox's avatar zydgitboox
Browse files
Options

Track 16 files into repository. 

- untracked assets/mvn_archetype_plugin.png
- modified codeStyle.md
- modified git-guide.md
- modified liquibase-use.md
- modified project-create.md
- removed 前端组件/grid.md
- modified 前端组件/hlsDataSource.md
- modified 前端组件/hlsDatePicker.md
- untracked 前端组件/hlsGrid.md
- modified 前端组件/hlsMaskedTextBox.md
- modified 前端组件/hlsPage.md
- modified 前端组件/hlsTlEdit.md
- untracked 后端开发/database-config.md
- untracked 后端开发/database-init.md
- modified 框架功能描述/jad.md
- modified 融租易开发手册.md

Auto commit by GitBook Editor
parent a0edb5e8
Hide whitespace changes
Inline Side-by-side
Showing with 1721 additions and 1395 deletions
codeStyle.md
View file @ b88e3a1f
## [一、后端开发规范](id:backEndDev)
1. 所有的项目文件必须采用UTF-8编码，IDEA及Eclipse需要手动设置项目编码以及编译编码。
- Eclipse中修改项目编码的方法参考：[Eclipse修改编码方法](http://jingyan.baidu.com/article/647f0115b0c9887f2148a822.html)
- IDEA中修改项目编码的方法参考：[IDEA修改编码方法](http://jingyan.baidu.com/article/948f5924e4de57d80ff5f998.html])
2. 提供他人使用的接口，原则上不允许修改**方法签名**，若是不再推荐使用，可以加**@ Deprecated**注解，同时提示新的接口名称。
3. **DTO**类中所有的字段，不允许设置**默认值**，且DTO必须**重写toString()方法**。
4. 原则上不允许使用递归，部分情况可以使用尾递归。
5. 代码中不允许出现魔法值，即未定义的任何常量。错误的用法不限于以下形式：
```java
if(user.getStatus() == 5){
// 5即为魔法值，应当避免使用
// do something
}
// 推荐使用常量
private static final int EXPIRED_USER_STATUS = 5;
if(user.getStatus() == EXPIRED_USER_STATUS){
// do something
}
```
6. 在类中定义的常量、变量及方法，需要严格控制访问修饰符，提供自己使用的设为private，可以供别人使用的可以设为public、protected等。
7. 所有的覆写方法，必须加**@Override**注解，防止错误的拼写导致意外。
8. Long类型的数据在初始化时必须使用大写的字母L, Double类型的数据必须使用大写的字母D。常见形式如
- **Long time=10000L**
- **Double money=12.3D**
9. 所有的数值的包装类型之间的比较不允许使用<、>、==之类的简单运算符，需要使用equals方法或者compareTo方法。
10. 所有方法的引用类型参数，若是未添加**@NotNull**注解，必须先进行null判断。
11. 捕获异常一般不允许直接捕获基类Exception，也不可捕获异常后不进行处理。方法中也不可抛出基类Exception。
12. 部分异常若是上层（调用层）不能解决，则不允许抛出。最外层若是出现异常必须自行处理，不可将异常信息直接展示给用户。
13. 所有的日志信息**不允许使用System.out.println**输出，异常的日志信息使用**log.error**打印时，必须使用重载方法将捕获的异常作为第二个参数。如：
```java
try{
// throw some exceptions
}catch(IOException e){
logger.error(e.getMessage(), e);
}
```
--- ---
## [二、后端命名规范](id:backEndName)
1. 所有的命名不允许使用**拼音或者拼音英文混合**方式，但部分公认的拼音允许使用，如**shanghai,beijing**等。
2. 所有的命名不允许使用**下划线`_`**或者**美元符`$`**作为起始或者结束。错误的情况有不限于以下几种:
- **_param**
- **$param**
- **param_**
- **param$**
- **_param$**
### 包命名规范
1. 包名一般为域名倒序开头，后接项目名，再加上单数形式的名词（项目中一般使用模块代码），且全部为小写字母，如：
- 系统功能模块：**com.hand.hls.sys**
- 合同功能模块：**com.hand.hls.cont**
2. 在功能模块包中一般包含如下几种形式的包：
- 存放SpringMVC的控制层代码： **controllers**
- 存放该模块数据库实体对象： **dto**
- 存放该模块的部分组件： **components**
- 存放该模块的业务接口： **service**
- 存放该模块的业务实现类： **service.impl**
- 存放该模块的Mybatis数据库交互层代码： **mapper**
- 存放该模块的工具类代码： **utils**
- 存放自定义的异常类代码： **exception**
### 类命名规范
1. 一般类名采用Pascal命名法，所有单词的首字母大写，其余字母小写，单词与单词之间不使用**下划线_**分割，常见形式如：
- **HlsClassName**
- **HlsNormalClass**
2. 数据库实体类一般与数据表名称相同并改为Pascal命名规则，以**DTO**结尾，如：
- **SysUserDTO**
- **SysRoleDTO**
3. 抽象类命名使用**Abstract**开头，接口一般以 **I** 开头，Mybatis的mapper对象可不用 **I** 开头但必须使用**Mapper**结尾，如：
- **AbstractClass**
- **ILog**
- **SysUserMapper**
4. 业务逻辑层接口类使用 **I** 开头，且必须以**Service**结尾；业务的实现类在接口的基础上去掉开头的字母 **I**，最后加上**Impl**，如：
- **ISysUserService**
- **SysUserServiceImpl**
5. 自定义的异常类以**Exception**结尾,如：
- **UserNotFoundException**
- **UserDefineException**
6. 项目中的测试类一般以测试对象的类名开头，以**Test**结尾，如：
- **SysUserServiceImplTest**
7. 若是采用了设计模式的类，在命名时，可在最后添加设计模式的名称，如：
- 工厂模式： **LoggerFactory**
- 代理模式： **UserProxy**
- 适配器模式： **ArrayAdapter**
### 变量命名规范
1. 成员变量、局部变量都统一使用lowerCamelCase风格，必须遵从驼峰形式,即**首单词**字母都小写，后面单词的**首字母大写**。如
+ **hlsClassFieldName**
+ **hlsLocalParamName**
2. 数据库对象的成员变量中若是变量的类型为Boolean类型，则变量名不允许使用 **is**开头,错误的命名如下：
- **private Boolean isAdmin**
### 常量命名规范
1. 常量的命名一般所有单词都**大写**，各个单词之间使用下划线`_`分隔,如：
- **PI**
- **PROJECT_PATH**
2. 常量的命名尽量使用单词表达出常量的用途及含义，力求语义清晰,不用担心名字太长,如：
- 周期的第一天：**FIRST_DAY_OF_CYCLE**
- 用户允许的最大错误次数：**USER_ALLOWED_MAX_ERROR_COUNT**
### 方法命名规范
1. 方法的命名规则采用lowerCamelCase风格,方法名的首单词字母全部小写，其余单词首字母大写,如：
- **walkMyWay()**
- **doSomething()**
2. 对数据库进行查询的方法，一般以**select、find、query**开头,后面接查询的对象，若是查询结果为List集合，对象名可变为复数，如：
- `public SysUser selectSysUser()`
- `public List<SysRole> findSysRoles()`
3. 对数据进行数据插入的方法，一般以**insert**开头，后接插入的对象，若是允许批量插入对象，对象名可变为复数，如：
- `public int insertSysUser(SysUser user)`
- `public int insertSysRoles(List<SysRole> roles)`
4. 对数据库进行数据删除的方法，一般以**delete**开头，后接插入的对象，若是允许批量插入对象，对象名可变为复数，如：
- `public int deleteSysUser(SysUser user)`
- `public int deleteSysRoleByIds(List<Long> roleIds)`
5. 对数据库进行数据更新的方法，一般以**update**开头，后接插入的对象，若是允许批量插入对象，对象名可变为复数，如：
- `public SysRole updateSysRole(SysRole role)`
- `public int updateSysUsers(List<SysUser> users)`
## [一、后端开发规范](id:backEndDev)
1. 所有的项目文件必须采用UTF-8编码，IDEA及Eclipse需要手动设置项目编码以及编译编码。
- Eclipse中修改项目编码的方法参考：[Eclipse修改编码方法](http://jingyan.baidu.com/article/647f0115b0c9887f2148a822.html)
- IDEA中修改项目编码的方法参考：[IDEA修改编码方法](http://jingyan.baidu.com/article/948f5924e4de57d80ff5f998.html])
2. 提供他人使用的接口，原则上不允许修改**方法签名**，若是不再推荐使用，可以加**@ Deprecated**注解，同时提示新的接口名称。
3. **DTO**类中所有的字段，不允许设置**默认值**，且DTO必须**重写toString()方法**。
4. 原则上不允许使用递归，部分情况可以使用尾递归。
5. 代码中不允许出现魔法值，即未定义的任何常量。错误的用法不限于以下形式：
```java
if(user.getStatus() == 5){
// 5即为魔法值，应当避免使用
// do something
}
// 推荐使用常量
private static final int EXPIRED_USER_STATUS = 5;
if(user.getStatus() == EXPIRED_USER_STATUS){
// do something
}
```
6. 在类中定义的常量、变量及方法，需要严格控制访问修饰符，提供自己使用的设为private，可以供别人使用的可以设为public、protected等。
7. 所有的覆写方法，必须加**@Override**注解，防止错误的拼写导致意外。
8. Long类型的数据在初始化时必须使用大写的字母L, Double类型的数据必须使用大写的字母D。常见形式如
- **Long time=10000L**
- **Double money=12.3D**
9. 所有的数值的包装类型之间的比较不允许使用<、>、==之类的简单运算符，需要使用equals方法或者compareTo方法。
10. 所有方法的引用类型参数，若是未添加**@NotNull**注解，必须先进行null判断。
11. 捕获异常一般不允许直接捕获基类Exception，也不可捕获异常后不进行处理。方法中也不可抛出基类Exception。
12. 部分异常若是上层（调用层）不能解决，则不允许抛出。最外层若是出现异常必须自行处理，不可将异常信息直接展示给用户。
13. 所有的日志信息**不允许使用System.out.println**输出，异常的日志信息使用**log.error**打印时，必须使用重载方法将捕获的异常作为第二个参数。如：
```java
try{
// throw some exceptions
}catch(IOException e){
logger.error(e.getMessage(), e);
}
```
--- ---
## [二、后端命名规范](id:backEndName)
1. 所有的命名不允许使用**拼音或者拼音英文混合**方式，但部分公认的拼音允许使用，如**shanghai,beijing**等。
2. 所有的命名不允许使用**下划线`_`**或者**美元符`$`**作为起始或者结束。错误的情况有不限于以下几种:
- **_param**
- **$param**
- **param_**
- **param$**
- **_param$**
### 包命名规范
1. 包名一般为域名倒序开头，后接项目名，再加上单数形式的名词（项目中一般使用模块代码），且全部为小写字母，如：
- 系统功能模块：**com.hand.hls.sys**
- 合同功能模块：**com.hand.hls.cont**
2. 在功能模块包中一般包含如下几种形式的包：
- 存放SpringMVC的控制层代码： **controllers**
- 存放该模块数据库实体对象： **dto**
- 存放该模块的部分组件： **components**
- 存放该模块的业务接口： **service**
- 存放该模块的业务实现类： **service.impl**
- 存放该模块的Mybatis数据库交互层代码： **mapper**
- 存放该模块的工具类代码： **utils**
- 存放自定义的异常类代码： **exception**
### 类命名规范
1. 一般类名采用Pascal命名法，所有单词的首字母大写，其余字母小写，单词与单词之间不使用**下划线_**分割，常见形式如：
- **HlsClassName**
- **HlsNormalClass**
2. 数据库实体类一般与数据表名称相同并改为Pascal命名规则，如：
- **SysUser**
- **SysRole**
3. 抽象类命名使用**Abstract**开头，接口一般以 **I** 开头，Mybatis的mapper对象可不用 **I** 开头但必须使用**Mapper**结尾，如：
- **AbstractClass**
- **ILog**
- **SysUserMapper**
4. 业务逻辑层接口类使用 **I** 开头，且必须以**Service**结尾；业务的实现类在接口的基础上去掉开头的字母 **I**，最后加上**Impl**，如：
- **ISysUserService**
- **SysUserServiceImpl**
5. 自定义的异常类以**Exception**结尾,如：
- **UserNotFoundException**
- **UserDefineException**
6. 项目中的测试类一般以测试对象的类名开头，以**Test**结尾，如：
- **SysUserServiceImplTest**
7. 若是采用了设计模式的类，在命名时，可在最后添加设计模式的名称，如：
- 工厂模式： **LoggerFactory**
- 代理模式： **UserProxy**
- 适配器模式： **ArrayAdapter**
### 变量命名规范
1. 成员变量、局部变量都统一使用lowerCamelCase风格，必须遵从驼峰形式,即**首单词**字母都小写，后面单词的**首字母大写**。如
+ **hlsClassFieldName**
+ **hlsLocalParamName**
2. 数据库对象的成员变量中若是变量的类型为Boolean类型，则变量名不允许使用 **is**开头,错误的命名如下：
- **private Boolean isAdmin**
### 常量命名规范
1. 常量的命名一般所有单词都**大写**，各个单词之间使用下划线`_`分隔,如：
- **PI**
- **PROJECT_PATH**
2. 常量的命名尽量使用单词表达出常量的用途及含义，力求语义清晰,不用担心名字太长,如：
- 周期的第一天：**FIRST_DAY_OF_CYCLE**
- 用户允许的最大错误次数：**USER_ALLOWED_MAX_ERROR_COUNT**
### 方法命名规范
1. 方法的命名规则采用lowerCamelCase风格,方法名的首单词字母全部小写，其余单词首字母大写,如：
- **walkMyWay()**
- **doSomething()**
2. 对数据库进行查询的方法，一般以**select、find、query**开头,后面接查询的对象，若是查询结果为List集合，对象名可变为复数，如：
- `public SysUser selectSysUser()`
- `public List<SysRole> findSysRoles()`
3. 对数据进行数据插入的方法，一般以**insert**开头，后接插入的对象，若是允许批量插入对象，对象名可变为复数，如：
- `public int insertSysUser(SysUser user)`
- `public int insertSysRoles(List<SysRole> roles)`
4. 对数据库进行数据删除的方法，一般以**delete**开头，后接插入的对象，若是允许批量插入对象，对象名可变为复数，如：
- `public int deleteSysUser(SysUser user)`
- `public int deleteSysRoleByIds(List<Long> roleIds)`
5. 对数据库进行数据更新的方法，一般以**update**开头，后接插入的对象，若是允许批量插入对象，对象名可变为复数，如：
- `public SysRole updateSysRole(SysRole role)`
- `public int updateSysUsers(List<SysUser> users)`
git-guide.md
View file @ b88e3a1f
# Git简明教程
***
# 1. git四大域
***
git四大域：工作目录，暂存区，仓库，远程仓库。
git对文件的操作都是在四大域上进行的，文件可以在四大域内与四大域间进行各种操作。（有一个例外，进行“git stash”系列操作时，文件可能被保存到四大域外的堆栈中）
![](http://i.imgur.com/UB94Upo.png)
# 2. git常用命令
***
![](http://i.imgur.com/jqW1Odo.png)
## 1. 设置
***
### 1. `config`命令
***
- `git config --global user.name lavor`：配置全局用户名，若不要“--global”或者将“global”改为“local”则表示配置局部用户名
- `git config --global user.email lavor@qq.com`：配置全局电子邮箱
- `git config --global alias.cm commit`:配置别名，为git命令配置别名，还可以配置复合操作，比如 `git config --global alias.pom 'push origin master'`注意复合操作中不可以带`-`与`""`
- `git config --list`：显示所有配置信息
### 2. `help`命令
***
- `git help`：显示帮助信息，会显示一些常见git命令及其意义
## 2. 创建项目
***
### 1. `init`命令
***
- `git init`：在本地初始化一个git仓库
### 2. `clone`命令
***
- `git clone git@github.com:lavor-zl/Github-Git.git`：从远程服务器克隆一个仓库到本地
## 3. 基本操作
***
### 1. `add`命令
***
- `git add README`：添加工作目录的文件到暂存区
### 2. `status`命令
***
- `git status`：显示工作树的状态，一般有三种状态
- `Untracked files`：未被跟踪的文件，表示是工作目录新增加的文件
- `Changes not staged for commit`：工作目录中修改了文件，但是没有被添加到暂存区
- `Changes to be committed`:添加到暂存区的文件，等待提交
### 3. `commit`命令
***
- `git commit -m "提交消息"`：提交暂存区的文件，带有提交消息
- `git commit -a -m "提交消息"`：跳过暂存区，直接提交工作目录中所有改变的文件，但是不能提交工作目录中新增的文件
- `git commit --author=lavor -m "提交消息"`：提交暂存区的文件，并重写提交作者
- `git commit --date=06.13.2016T09:00:00 -m "提交消息"`：提交暂存区的文件，并重写提交日期
- `git commit --amend -m "提交消息"`：通过创建一个新的提交，以替换当前分支的前端。所代表的含义就是在最新一次提交的基础上进行提交。比如我们完成了最新一次提交，并且这次提交完成后我们对工作目录进行了一些修改，但是我们发现某个文件忘了添加到暂存区并提交，我们可以先添加该文件到暂存区，然后利用该命令进行提交。
### 4. `reset`命令
***
- `git reset`：将暂存区的所有文件重置到当前分支的HEAD
- `git reset <commit> files`：将暂存区的指定文件重置到指定的`<commit>`,`<commit>`既可以是commit的hash（或者hash前7位）也可以是`HEAD`及其祖先，`HEAD~1`表示`HEAD`的父亲，是`HEAD`的前一次提交，没有`<commit>`时默认是`HEAD`。
- `git reset [--hard|soft|mixed|merge|keep] [<commit>]`：将当前的分支重设到指定的`<commit>`，并且根据`mode`有可能更新暂存区和工作目录。`mode`的取值可以是hard、soft、mixed、merged、keep。
- `hard`：重置暂存区与工作目录到指定提交，删除`<commit>`之后的所有提交并将`HEAD`指向该提交，此操作危险指数较大（应慎用）
- `soft`：暂存区与工作目录不会变化，仅仅删除`<commit>`之后的所有提交并将`HEAD`指向该提交
- `mixed`：默认的，重置暂存区到指定提交，删除`<commit>`之后的所有提交并将`HEAD`指向该提交
- `merge`与`keep`用的比较少，暂时不讨论
**`HEAD`是指向当前分支引用的指针，该指针指向在该分支上的最后一个提交的指针。这意味着`HEAD`将是下一个创建的提交的父亲。一般来说，把你的`HEAD`作为你最后一次提交的快照，是最简单的。`HEAD~1`表示`HEAD`的前一次提交，`HEAD~2`表示`HEAD`的前两次提交，以此类推**
### 5. `rm`命令
***
- `git rm files`：删除工作目录的文件
- `git rm -f files`：强制删除工作目录的文件，不做更新检查
- `git rm --cached files`：删除暂存区的文件
### 6. `mv`命令
***
- `git mv oldfile newfile`：为文件重命名
- `git mv files dir`：移动文件到指定目录
- `git mv -f oldfile newfile`：强制为文件重命名，即使目标文件已存在
- `git mv -f files dir`：强制移动文件到指定目录名，即使目标文件已存在
## 4. 分支与合并
***
### 1. `branch`命令
***
- `git branch`：查看所有分支
- `git branch branchname`：创建分支
- `git branch branchname <commit>`：以特定提交为基创建分支
- `git branch -d branchname`：删除分支
- `git branch -D branchname`：强制删除分支
- `git branch -m [oldbranchname] newbranchname`：移动或者删除分支
- `git branch -M [oldbranchname] newbranchname`：强制移动或者删除分支
- `git branch -r`：列出所有被跟踪的远程分支
- `git branch -r -d branchname`：删除被跟踪的远程分支
- `git branch -a`：列出所有本地分支与被跟踪的远程分支
### 2. `checkout`命令
***
- `git checkout`:检查本地仓库分支与远程仓库分支的差异
- `git checkout branchname|tagname`：切换分支或切换到指定`tag`，同名时优先切换分支
- `git checkout tags/tagname`：切换到指定`tag`
- `git checkout -b branchname`：新建分支并切换到该分支上
- `git checkout -B branchname`：强制新建分支并切换到该分支上
### 3. `merge`命令
***
- `git merge branchname`：将指定分支合并到当前分支上(默认附带提交操作)，在`merge`后面使用`-m <message>`表示提交消息
- `git merge <commit>`：将指定提交合并到当前分支上
- `git merge oldbranchname newbranchname`：将`oldbranchname`分支合并到`newbranchname`分支上
- `git merge --squash branchname`：将指定分支上所有修改放入当前分支工作目录与暂存区，不提交
- `git merge no--squash branchname`：将指定分支上所有修改放入当前分支工作目录与暂存区，并提交
### 4. `mergetool`命令
***
- `git mergetool`：在“merge”命令执行之后出现冲突时执行该命令，用来解决合并的冲突，冲突解决完了不要忘了提交
### 5. `stash`命令
***
- `git stash`：储藏工作目录与暂存区的状态到堆栈中
- `git stash pop [stash@{id}]`：恢复到指定储藏的状态（默认是最近一次储藏的状态），并从堆栈中移除该储藏
- `git stash apply [stash@{id}]`：恢复到指定储藏的状态（默认是最近一次储藏的状态）
- `git stash drop [stash@{id}]`:并从堆栈中移除指定储藏（默认是最近一次储藏）
- `git stash list`：显示所有储藏信息
### 6. `tag`命令
***
同大多数 VCS 一样，Git 也可以对某一时间点上的版本打上标签。
- `git tag`：列出所有标签
- `git tag -l 'v1.*'`：列出符合一定条件的标签
- `git tag tagname`：新建标签
## 5. 分享与更新项目
***
### 1. `fetch`命令
***
- `git fetch`：下载远程仓库“origin”到本地
- `git fetch remoterepository`：下载指定远程仓库到本地
- `git fetch remoterepository branchname`：下载指定远程仓库指定分支到本地
### 2. `pull`命令
***
- `git pull remoterepository branchname[:localbranch]`：拉取指定远程仓库指定分支到本地仓库指定分支（默认是当前分支）
### 3. `push`命令
***
- `git push remoterepository localbranch[:remotebranch] [--tags]`：推送本地仓库指定分支到远程仓库指定分支（默认是与本地分支同名的远程分支），默认是不推送标签到远程仓库的，加上`--tags`就会推送标签
### 4. `remote`命令
***
- `git remote`：查看所有与本地仓库关联的远程仓库
- `git remote -v`：查看所有与本地仓库关联的远程仓库，并显示`url`
- `git remote add remote-name remote-url`：添加与本地仓库关联的远程仓库
- `git remote rename oldname newname`：为远程仓库重命名
- `git remote remove remote-name`：移除远程仓库
### 5. `submodule`命令
***
- `git submodule add repository-url dir`：添加仓库到指定目录，使之成为本仓库的子模块
- `git submodule init`：初始化子模块
- `git submodule update`：更新子模块
**子模块是本仓库依赖的另一个仓库，但是我们不会对所依赖的仓库（子模块）进行修改，只会在必要的时候进行更新操作。**
## 6. 考察与比较
***
### 1. `show`命令
***
- `git show [-times]`：显示最近`times`次（默认是一次）提交的所有对象信息
### 2. `log`命令
***
- `git log`：查看提交记录
- `git log --all`：查看所有提交记录
- `git log --oneline`：查看提交记录，以`oneline`形式显示，只显示一行，显示的内容时提交hash的前7位与提交消息
- `git log -p -times`：表示查看最近`times`次提交改变的内容
- `git log -stat [-times]`：查看最近`times`次（默认是所有）提交记录，并显示文件的差异分析
### 3. `diff`命令
***
- `git diff`：查看工作目录与暂存区的差异
- `git diff --cached [<commit>]`：查看暂存区与指定提交（默认是HEAD）的差异
- `git diff <commit>`：查看工作目录与指定提交的差异
- `git diff <commit>`：查看工作目录与指定提交的差异
- `git diff <commit> <commit>`：查看两次指定提交的差异
- `git diff branchname`：查看工作目录与指定分支的差异
- `git diff branchname branchname`：查看两个指定分支间的差异
上面的所有操作后面都可以加上`-- dir`表示查看该目录下面的差异，在后面加上`>patchname.patch`表示将差异生成补丁，`patchname`是补丁的名字。
### 4. `shortlog`命令
***
- `git shortlog`：显示总提交次数与每次提交的提交消息
### 5. `describe`命令
***
- `git describe [<commit>|<tag>]`：查看指定提交或者指定标签（默认是最近一次提交）的注解标签信息
- `git desribe --tags [<commit>|<tag>]`：查看指定提交或者指定标签（默认是最近一次提交）的标签信息
- `git desribe --all [<commit>|<tag>]`：查看指定提交或者指定标签（默认是最近一次提交）的引用信息
### 6. `reflog`命令
***
- `git reflog`：显示所有提交，下拉，推送，与切换分支操作
- `git reflog --all`：显示所有提交，下拉，推送操作
## 7. 修补
***　
### 1. `apply`命令
***
- `git apply [--index|--cached] patchname.patch`：在暂存区与工作目录或者暂存区（默认是工作目录）打补丁
- `git apply --reverse|-R patchname.patch`：反向打补丁
- `git apply --reject patchname.patch`：打补丁，将没有冲突的文件合并，将有冲突的文件标记出来，并生成对应的`.rej`文件
### 2. `cherry-pick`命令
***
- `git cherry-pick <commit>`：将另一个分支上面的指定提交应用到当前分支上
- `git cherry-pick banchname`：将指定分支上面的最后一次提交应用到当前分支上
### 3. `rebase`命令
***
- `git rebase branchname`：将指定分支上所有修改应用到当前分支上
- `git rebase branchname branchname`：将第一个指定分支上所有修改应用到第二个分支上
在`rebase`加上`-i`会提供交互式的变基操作，在交互式操作中常用命令：
![](http://i.imgur.com/zD7PgjP.png)
### 4. `revert`命令
***
- `git revert <commit>`：恢复一个指定提交
## 8. 调试
***
### 1. `bisect`命令
***
使用二分查找，找到引入bug的提交
- `git bisect start`：开始二分查找
- `git bisect bad [<commit>]`：设置指定提交（默认是当前分支）为bad
- `git bisect good [<commit>]`：设置指定提交（默认是当前分支）为good
输入了上面三个命令后就会自动开始二分查找，我们之后只需要标记当前提交时bad还是good就行了，如果当前找的的提交时bad就输入`git bisect bad`，否则输入`git bisect good`直到找到有bug的提交。
### 2. `blame`命令
***
显示修改和作者最后修改的文件的每一行，这就是一个“问责”的命令，如果哪里有问题，我们可以很快地找到该问题是谁导致的。
- `git blame filename`：查看指定文件所有的操作者，看看是谁错误地修改了该文件
### 3. `grep`命令
***
- `git grep keys`：在工作目录中所有文件中搜索`keys`
- `git grep --cached keys`：在暂存区中所有文件中搜索`keys`
# Git简明教程
***
# 1. git四大域
***
git四大域：工作目录，暂存区，仓库，远程仓库。
git对文件的操作都是在四大域上进行的，文件可以在四大域内与四大域间进行各种操作。（有一个例外，进行“git stash”系列操作时，文件可能被保存到四大域外的堆栈中）
![](http://i.imgur.com/UB94Upo.png)
# 2. git常用命令
***
![](http://i.imgur.com/jqW1Odo.png)
## 1. 设置
***
### 1. `config`命令
***
- `git config --global user.name lavor`：配置全局用户名，若不要“--global”或者将“global”改为“local”则表示配置局部用户名
- `git config --global user.email lavor@qq.com`：配置全局电子邮箱
- `git config --global alias.cm commit`:配置别名，为git命令配置别名，还可以配置复合操作，比如 `git config --global alias.pom 'push origin master'`注意复合操作中不可以带`-`与`""`
- `git config --list`：显示所有配置信息
### 2. `help`命令
***
- `git help`：显示帮助信息，会显示一些常见git命令及其意义
## 2. 创建项目
***
### 1. `init`命令
***
- `git init`：在本地初始化一个git仓库
### 2. `clone`命令
***
- `git clone git@github.com:lavor-zl/Github-Git.git`：从远程服务器克隆一个仓库到本地，**如果gitlab发现pull或者push出现SSL问题，先在cmd执行git config --global http.sslVerify false**
## 3. 基本操作
***
### 1. `add`命令
***
- `git add README`：添加工作目录的文件到暂存区
### 2. `status`命令
***
- `git status`：显示工作树的状态，一般有三种状态
- `Untracked files`：未被跟踪的文件，表示是工作目录新增加的文件
- `Changes not staged for commit`：工作目录中修改了文件，但是没有被添加到暂存区
- `Changes to be committed`:添加到暂存区的文件，等待提交
### 3. `commit`命令
***
- `git commit -m "提交消息"`：提交暂存区的文件，带有提交消息
- `git commit -a -m "提交消息"`：跳过暂存区，直接提交工作目录中所有改变的文件，但是不能提交工作目录中新增的文件
- `git commit --author=lavor -m "提交消息"`：提交暂存区的文件，并重写提交作者
- `git commit --date=06.13.2016T09:00:00 -m "提交消息"`：提交暂存区的文件，并重写提交日期
- `git commit --amend -m "提交消息"`：通过创建一个新的提交，以替换当前分支的前端。所代表的含义就是在最新一次提交的基础上进行提交。比如我们完成了最新一次提交，并且这次提交完成后我们对工作目录进行了一些修改，但是我们发现某个文件忘了添加到暂存区并提交，我们可以先添加该文件到暂存区，然后利用该命令进行提交。
### 4. `reset`命令
***
- `git reset`：将暂存区的所有文件重置到当前分支的HEAD
- `git reset <commit> files`：将暂存区的指定文件重置到指定的`<commit>`,`<commit>`既可以是commit的hash（或者hash前7位）也可以是`HEAD`及其祖先，`HEAD~1`表示`HEAD`的父亲，是`HEAD`的前一次提交，没有`<commit>`时默认是`HEAD`。
- `git reset [--hard|soft|mixed|merge|keep] [<commit>]`：将当前的分支重设到指定的`<commit>`，并且根据`mode`有可能更新暂存区和工作目录。`mode`的取值可以是hard、soft、mixed、merged、keep。
- `hard`：重置暂存区与工作目录到指定提交，删除`<commit>`之后的所有提交并将`HEAD`指向该提交，此操作危险指数较大（应慎用）
- `soft`：暂存区与工作目录不会变化，仅仅删除`<commit>`之后的所有提交并将`HEAD`指向该提交
- `mixed`：默认的，重置暂存区到指定提交，删除`<commit>`之后的所有提交并将`HEAD`指向该提交
- `merge`与`keep`用的比较少，暂时不讨论
**`HEAD`是指向当前分支引用的指针，该指针指向在该分支上的最后一个提交的指针。这意味着`HEAD`将是下一个创建的提交的父亲。一般来说，把你的`HEAD`作为你最后一次提交的快照，是最简单的。`HEAD~1`表示`HEAD`的前一次提交，`HEAD~2`表示`HEAD`的前两次提交，以此类推**
### 5. `rm`命令
***
- `git rm files`：删除工作目录的文件
- `git rm -f files`：强制删除工作目录的文件，不做更新检查
- `git rm --cached files`：删除暂存区的文件
### 6. `mv`命令
***
- `git mv oldfile newfile`：为文件重命名
- `git mv files dir`：移动文件到指定目录
- `git mv -f oldfile newfile`：强制为文件重命名，即使目标文件已存在
- `git mv -f files dir`：强制移动文件到指定目录名，即使目标文件已存在
## 4. 分支与合并
***
### 1. `branch`命令
***
- `git branch`：查看所有分支
- `git branch branchname`：创建分支
- `git branch branchname <commit>`：以特定提交为基创建分支
- `git branch -d branchname`：删除分支
- `git branch -D branchname`：强制删除分支
- `git branch -m [oldbranchname] newbranchname`：移动或者删除分支
- `git branch -M [oldbranchname] newbranchname`：强制移动或者删除分支
- `git branch -r`：列出所有被跟踪的远程分支
- `git branch -r -d branchname`：删除被跟踪的远程分支
- `git branch -a`：列出所有本地分支与被跟踪的远程分支
### 2. `checkout`命令
***
- `git checkout`:检查本地仓库分支与远程仓库分支的差异
- `git checkout branchname|tagname`：切换分支或切换到指定`tag`，同名时优先切换分支
- `git checkout tags/tagname`：切换到指定`tag`
- `git checkout -b branchname`：新建分支并切换到该分支上
- `git checkout -B branchname`：强制新建分支并切换到该分支上
### 3. `merge`命令
***
- `git merge branchname`：将指定分支合并到当前分支上(默认附带提交操作)，在`merge`后面使用`-m <message>`表示提交消息
- `git merge <commit>`：将指定提交合并到当前分支上
- `git merge oldbranchname newbranchname`：将`oldbranchname`分支合并到`newbranchname`分支上
- `git merge --squash branchname`：将指定分支上所有修改放入当前分支工作目录与暂存区，不提交
- `git merge no--squash branchname`：将指定分支上所有修改放入当前分支工作目录与暂存区，并提交
### 4. `mergetool`命令
***
- `git mergetool`：在“merge”命令执行之后出现冲突时执行该命令，用来解决合并的冲突，冲突解决完了不要忘了提交
### 5. `stash`命令
***
- `git stash`：储藏工作目录与暂存区的状态到堆栈中
- `git stash pop [stash@{id}]`：恢复到指定储藏的状态（默认是最近一次储藏的状态），并从堆栈中移除该储藏
- `git stash apply [stash@{id}]`：恢复到指定储藏的状态（默认是最近一次储藏的状态）
- `git stash drop [stash@{id}]`:并从堆栈中移除指定储藏（默认是最近一次储藏）
- `git stash list`：显示所有储藏信息
### 6. `tag`命令
***
同大多数 VCS 一样，Git 也可以对某一时间点上的版本打上标签。
- `git tag`：列出所有标签
- `git tag -l 'v1.*'`：列出符合一定条件的标签
- `git tag tagname`：新建标签
## 5. 分享与更新项目
***
### 1. `fetch`命令
***
- `git fetch`：下载远程仓库“origin”到本地
- `git fetch remoterepository`：下载指定远程仓库到本地
- `git fetch remoterepository branchname`：下载指定远程仓库指定分支到本地
### 2. `pull`命令
***
- `git pull remoterepository branchname[:localbranch]`：拉取指定远程仓库指定分支到本地仓库指定分支（默认是当前分支）
### 3. `push`命令
***
- `git push remoterepository localbranch[:remotebranch] [--tags]`：推送本地仓库指定分支到远程仓库指定分支（默认是与本地分支同名的远程分支），默认是不推送标签到远程仓库的，加上`--tags`就会推送标签
### 4. `remote`命令
***
- `git remote`：查看所有与本地仓库关联的远程仓库
- `git remote -v`：查看所有与本地仓库关联的远程仓库，并显示`url`
- `git remote add remote-name remote-url`：添加与本地仓库关联的远程仓库
- `git remote rename oldname newname`：为远程仓库重命名
- `git remote remove remote-name`：移除远程仓库
### 5. `submodule`命令
***
- `git submodule add repository-url dir`：添加仓库到指定目录，使之成为本仓库的子模块
- `git submodule init`：初始化子模块
- `git submodule update`：更新子模块
**子模块是本仓库依赖的另一个仓库，但是我们不会对所依赖的仓库（子模块）进行修改，只会在必要的时候进行更新操作。**
## 6. 考察与比较
***
### 1. `show`命令
***
- `git show [-times]`：显示最近`times`次（默认是一次）提交的所有对象信息
### 2. `log`命令
***
- `git log`：查看提交记录
- `git log --all`：查看所有提交记录
- `git log --oneline`：查看提交记录，以`oneline`形式显示，只显示一行，显示的内容时提交hash的前7位与提交消息
- `git log -p -times`：表示查看最近`times`次提交改变的内容
- `git log -stat [-times]`：查看最近`times`次（默认是所有）提交记录，并显示文件的差异分析
### 3. `diff`命令
***
- `git diff`：查看工作目录与暂存区的差异
- `git diff --cached [<commit>]`：查看暂存区与指定提交（默认是HEAD）的差异
- `git diff <commit>`：查看工作目录与指定提交的差异
- `git diff <commit>`：查看工作目录与指定提交的差异
- `git diff <commit> <commit>`：查看两次指定提交的差异
- `git diff branchname`：查看工作目录与指定分支的差异
- `git diff branchname branchname`：查看两个指定分支间的差异
上面的所有操作后面都可以加上`-- dir`表示查看该目录下面的差异，在后面加上`>patchname.patch`表示将差异生成补丁，`patchname`是补丁的名字。
### 4. `shortlog`命令
***
- `git shortlog`：显示总提交次数与每次提交的提交消息
### 5. `describe`命令
***
- `git describe [<commit>|<tag>]`：查看指定提交或者指定标签（默认是最近一次提交）的注解标签信息
- `git desribe --tags [<commit>|<tag>]`：查看指定提交或者指定标签（默认是最近一次提交）的标签信息
- `git desribe --all [<commit>|<tag>]`：查看指定提交或者指定标签（默认是最近一次提交）的引用信息
### 6. `reflog`命令
***
- `git reflog`：显示所有提交，下拉，推送，与切换分支操作
- `git reflog --all`：显示所有提交，下拉，推送操作
## 7. 修补
***　
### 1. `apply`命令
***
- `git apply [--index|--cached] patchname.patch`：在暂存区与工作目录或者暂存区（默认是工作目录）打补丁
- `git apply --reverse|-R patchname.patch`：反向打补丁
- `git apply --reject patchname.patch`：打补丁，将没有冲突的文件合并，将有冲突的文件标记出来，并生成对应的`.rej`文件
### 2. `cherry-pick`命令
***
- `git cherry-pick <commit>`：将另一个分支上面的指定提交应用到当前分支上
- `git cherry-pick banchname`：将指定分支上面的最后一次提交应用到当前分支上
### 3. `rebase`命令
***
- `git rebase branchname`：将指定分支上所有修改应用到当前分支上
- `git rebase branchname branchname`：将第一个指定分支上所有修改应用到第二个分支上
在`rebase`加上`-i`会提供交互式的变基操作，在交互式操作中常用命令：
![](http://i.imgur.com/zD7PgjP.png)
### 4. `revert`命令
***
- `git revert <commit>`：恢复一个指定提交
## 8. 调试
***
### 1. `bisect`命令
***
使用二分查找，找到引入bug的提交
- `git bisect start`：开始二分查找
- `git bisect bad [<commit>]`：设置指定提交（默认是当前分支）为bad
- `git bisect good [<commit>]`：设置指定提交（默认是当前分支）为good
输入了上面三个命令后就会自动开始二分查找，我们之后只需要标记当前提交时bad还是good就行了，如果当前找的的提交时bad就输入`git bisect bad`，否则输入`git bisect good`直到找到有bug的提交。
### 2. `blame`命令
***
显示修改和作者最后修改的文件的每一行，这就是一个“问责”的命令，如果哪里有问题，我们可以很快地找到该问题是谁导致的。
- `git blame filename`：查看指定文件所有的操作者，看看是谁错误地修改了该文件
### 3. `grep`命令
***
- `git grep keys`：在工作目录中所有文件中搜索`keys`
- `git grep --cached keys`：在暂存区中所有文件中搜索`keys`
liquibase-use.md
View file @ b88e3a1f
Liquibase 使用手册
---
本文档主要介绍如何在 hap 开发过程中使用 liquibase 来维护数据库数据。
[参考 Liquibase 官方指令文档](http://www.liquibase.org/documentation/changes/index.html)
在 `core-db` 模块 `hls/core/db/data`目录
有三个版本的数据库脚本：mysql,oracle,sqlserver。
> 旧版的基于 sql 的建表方式已经废弃, 只有第三方的 sql 脚本存在.
## 新建表
---
修改文件 `[yyyy-MM-dd]-init-table-migration.groovy`
> 其他项目上, 应该是根据需要编写至少一个新的 groovy 文件, 命名规则同上.
参考 现有的建表 changeSet 写法, 添加新的 changeSet
注意 `author`,`id`
* 如果是 oracle 数据库, 注意 `sequence` 的创建
* 如果有 tl 表, 写在一个 changeSet 中
其他建表需要注意的内容包括:
* 基础建表语句
* 表描述信息
* 主键设置
* 列描述信息
* 合理的类型，长度
* 是否允许 NULL
* 默认值（如果有）
* 索引（唯一索引，普通索引）
* 主键自增起始 10001
* oracle 是设置 sequence start with
* who 字段（8个）
```
column(name: "OBJECT_VERSION_NUMBER", type: "BIGINT", defaultValue : "1")
column(name: "REQUEST_ID", type: "BIGINT", defaultValue : "-1")
column(name: "PROGRAM_ID", type: "BIGINT", defaultValue : "-1")
column(name: "CREATED_BY", type: "BIGINT", defaultValue : "-1")
column(name: "CREATION_DATE", type: "DATETIME", defaultValueComputed : "CURRENT_TIMESTAMP")
column(name: "LAST_UPDATED_BY", type: "BIGINT", defaultValue : "-1")
column(name: "LAST_UPDATE_DATE", type: "DATETIME", defaultValueComputed : "CURRENT_TIMESTAMP")
column(name: "LAST_UPDATE_LOGIN", type: "BIGINT", defaultValue : "-1")
```
* 扩展字段 16个（可以不要）
> 如果不要，在DTO类上加@ExtensionAttribute\(disable=true\)
> TL 表均为联合主键，没有自增长、sequence 等
**请注意保持脚本格式工整**
## 修改表结构
也是通过添加 changeSet, 顺序添加
## 初始数据
---
HEL1.0中采用了全新的基于 excel 的基础数据维护.
请参考 `hel-db` 中 hls/core/db/data/2016-09-30-init-data.xlsx
excel 数据管理的主要特点有:
* 利用 `公式` 来解决外键依赖问题.
* 可进行 `唯一性检查`, \(重复执行, 不会重复插入\)
* 数据可更新, 可持续维护
excel 更直观, 便于维护, 所有的基础数据, 只需要维护一份 excel 即可.
> excel 在每次执行 mvn process-resoures ... 时 都会解析执行,
> 会插入新的数据, 更改已存在的数据.
使用参数 `-Ddb.skipUpdateTables=SYS_ROLE_B,SYS_USER` 可以禁止更新表中的数据（只插入，不更新）
更具体的用法 请参见 excel 第一 sheet 页的说明.
注意：
* 作者
* 时间
> 可以不通过 maven 命令直接执行 excel 导入, 参考代码
```java
public static void main(String[] args) throws Exception {
System.setProperty("db.url", "jdbc:mysql://127.0.0.1:3306/hel");
System.setProperty("db.user", "hel_dev");
System.setProperty("db.password", "hel_dev");
System.setProperty("db.override", "true");
ExcelDataLoader processor = new ExcelDataLoader();
URL url = ExcelDataLoader.class.getResource("/hls/core/db/data/2016-09-30-init-data.xlsx");
if (url == null) {
throw new FileNotFoundException("excel not found.");
}
processor.setFilePath(new File(url.toURI()).getAbsolutePath());
processor.execute(null);
}
```
## 补丁数据
---
在需要执行比较特殊的数据库操作, 或者不方便归类的操作时 , 可以将脚本写在 patch 中.
patch.groovy 中即可以写 liquibase 命令, 也可以执行 sql 语句.
补丁脚本放在 `patch` 目录。
脚本内容可以包括，但不限于：
* 修改表
* 增删改 表中的数据
> 请注意，这些操作应该都是增量的进行
补丁文件的命名方式：20161212-工号-序号.sql
每次提交都是一个单独的 sql 文件，每天提交多次时，需要指定`序号`加以区分
> 脚本内部注释，写明作者，目的，时间，概要
编写完毕以后，将补丁配置到 patch.groovy 中。
> 补丁将会是用的比较多的方式，主要是增加新的数据，由于主键是手动指定的，请注意不要与他人的重复，必须在本地测试过之后再commit。
Liquibase 使用手册
---
本文档主要介绍如何在 hap 开发过程中使用 liquibase 来维护数据库数据。
[参考 Liquibase 官方指令文档](http://www.liquibase.org/documentation/changes/index.html)
在 `core-db` 模块 `hls/core/db/data`目录
有三个版本的数据库脚本：mysql,oracle,sqlserver。
> 旧版的基于 sql 的建表方式已经废弃, 只有第三方的 sql 脚本存在.
## 新建表
---
修改文件 `[yyyy-MM-dd]-init-table-migration.groovy`
> 其他项目上, 应该是根据需要编写至少一个新的 groovy 文件, 命名规则同上.
参考 现有的建表 changeSet 写法, 添加新的 changeSet
注意 `author`,`id`
* 如果是 oracle 数据库, 注意 `sequence` 的创建
* 如果有 tl 表, 写在一个 changeSet 中
其他建表需要注意的内容包括:
* 基础建表语句
* 表描述信息
* 主键设置
* 列描述信息
* 合理的类型，长度
* 是否允许 NULL
* 默认值（如果有）
* 索引（唯一索引，普通索引）
* 主键自增起始 10001
* oracle 是设置 sequence start with
* who 字段（8个）
```
column(name: "OBJECT_VERSION_NUMBER", type: "BIGINT", defaultValue : "1")
column(name: "REQUEST_ID", type: "BIGINT", defaultValue : "-1")
column(name: "PROGRAM_ID", type: "BIGINT", defaultValue : "-1")
column(name: "CREATED_BY", type: "BIGINT", defaultValue : "-1")
column(name: "CREATION_DATE", type: "DATETIME", defaultValueComputed : "CURRENT_TIMESTAMP")
column(name: "LAST_UPDATED_BY", type: "BIGINT", defaultValue : "-1")
column(name: "LAST_UPDATE_DATE", type: "DATETIME", defaultValueComputed : "CURRENT_TIMESTAMP")
column(name: "LAST_UPDATE_LOGIN", type: "BIGINT", defaultValue : "-1")
```
* 扩展字段 16个（可以不要）
> 如果不要，在DTO类上加@ExtensionAttribute\(disable=true\)
> TL 表均为联合主键，没有自增长、sequence 等
参考示例：
在groovy中创建一张表
```groovy
import com.hand.hap.liquibase.MigrationHelper
def mhi = MigrationHelper.getInstance()
databaseChangeLog(logicalFilePath: "2016-09-26-init-migration.groovy") {
changeSet(author: "作者名", id: "日期-作者-表名") {
createTable(tableName: "HR_EMPLOYEE") {
column(autoIncrement: "true", startWith: "10001", name: "EMPLOYEE_ID", type: "BIGINT", remarks: "员工ID") {
constraints(nullable: "false", primaryKey: "true", primaryKeyName: "HR_EMPLOYEE_PK")
}
column(name: "EMPLOYEE_CODE", remarks: "员工编码", type: "VARCHAR(30)") {
constraints(nullable: "false", unique: "true", uniqueConstraintName: "HR_EMPLOYEE_U1")
}
column(name: "NAME", remarks: "员工姓名", type: "VARCHAR(50)") { constraints(nullable: "false") }
column(name: "BORN_DATE", remarks: "出生日期", type: "DATE")
column(name: "EMAIL", remarks: "电子邮件", type: "VARCHAR(50)")
column(name: "MOBIL", remarks: "移动电话", type: "VARCHAR(50)")
column(name: "JOIN_DATE", remarks: "入职日期", type: "DATE")
column(name: "GENDER", remarks: "性别", type: "VARCHAR(1)")
column(name: "CERTIFICATE_ID", remarks: "ID", type: "VARCHAR(100)") {
constraints(nullable: "false", unique: "true", uniqueConstraintName: "HR_EMPLOYEE_U2")
}
column(name: "STATUS", remarks: "状态", type: "VARCHAR(50)") { constraints(nullable: "false") }
column(name: "ENABLED_FLAG", remarks: "启用状态", type: "VARCHAR(1)", defaultValue: "Y") {
constraints(nullable: "false")
}
column(name: "OBJECT_VERSION_NUMBER", type: "BIGINT", defaultValue: "1")
column(name: "REQUEST_ID", type: "BIGINT", defaultValue: "-1")
column(name: "PROGRAM_ID", type: "BIGINT", defaultValue: "-1")
column(name: "CREATED_BY", type: "BIGINT", defaultValue: "-1")
column(name: "CREATION_DATE", type: "DATETIME", defaultValueComputed: "CURRENT_TIMESTAMP")
column(name: "LAST_UPDATED_BY", type: "BIGINT", defaultValue: "-1")
column(name: "LAST_UPDATE_DATE", type: "DATETIME", defaultValueComputed: "CURRENT_TIMESTAMP")
column(name: "LAST_UPDATE_LOGIN", type: "BIGINT", defaultValue: "-1")
}
}
}
```
**请注意保持脚本格式工整**
## 修改表结构
也是通过添加 changeSet, 顺序添加
修改表结构参考示例：
```groovy
package com.hand.hap.db
import com.hand.hap.liquibase.MigrationHelper
def mhi = MigrationHelper.getInstance()
dbType = MigrationHelper.getInstance().dbType()
databaseChangeLog(logicalFilePath: "patch.groovy") {
changeSet(author: "作者", id: "日期-作者-编号") {
/**
* 新增一列
*/
addColumn(tableName: "SYS_USER") {
column(name: "LAST_LOGIN_DATE", type: "datetime", remarks: "最后一次登录时间")
}
/**
* 修改列名
*/
renameColumn(tableName: "SYS_IF_CONFIG_LINE_TL", columnDataType: "VARCHAR(255)", oldColumnName: "HEADER_ID", newColumnName: "LINE_ID")
/**
* 添加唯一约束
*/
addUniqueConstraint(tableName: "SYS_IF_CONFIG_HEADER_B", columnNames: "INTERFACE_CODE", constraintName: "SYS_IF_CONFIG_HEADER_U1")
/**
* 添加默认值
*/
addDefaultValue(tableName: "SYS_USER", columnName: "FIRST_LOGIN", columnDataType: "varchar", defaultValue: "Y")
/**
* 添加索引
*/
createIndex(tableName: "SYS_RESOURCE_B", indexName: "SYS_RESOURCE_B_N1") {
column(name: "TYPE", type: "varchar(15)")
}
/**
* 可以使用groovy语句进行条件判断
* 修改数据类型
*/
if (true) {
modifyDataType(tableName: "FND_COMPANY_B", columnName: "COMPANY_FULL_NAME", newDataType: "varchar(250)")
}
}
}
```
## 初始数据
---
HEL1.0中采用了全新的基于 excel 的基础数据维护.
请参考 `hel-db` 中 hls/core/db/data/2016-09-30-init-data.xlsx
excel 数据管理的主要特点有:
* 利用 `公式` 来解决外键依赖问题.
* 可进行 `唯一性检查`, \(重复执行, 不会重复插入\)
* 数据可更新, 可持续维护
excel 更直观, 便于维护, 所有的基础数据, 只需要维护一份 excel 即可.
> excel 在每次执行 mvn process-resoures ... 时 都会解析执行,
> 会插入新的数据, 更改已存在的数据.
使用参数 `-Ddb.skipUpdateTables=SYS_ROLE_B,SYS_USER` 可以禁止更新表中的数据（只插入，不更新）
更具体的用法 请参见 excel 第一 sheet 页的说明.
注意：
* 作者
* 时间
> 可以不通过 maven 命令直接执行 excel 导入, 参考代码
```java
public static void main(String[] args) throws Exception {
System.setProperty("db.url", "jdbc:mysql://127.0.0.1:3306/hel");
System.setProperty("db.user", "hel_dev");
System.setProperty("db.password", "hel_dev");
System.setProperty("db.override", "true");
ExcelDataLoader processor = new ExcelDataLoader();
URL url = ExcelDataLoader.class.getResource("/hls/core/db/data/2016-09-30-init-data.xlsx");
if (url == null) {
throw new FileNotFoundException("excel not found.");
}
processor.setFilePath(new File(url.toURI()).getAbsolutePath());
processor.execute(null);
}
```
## 补丁数据
---
在需要执行比较特殊的数据库操作, 或者不方便归类的操作时 , 可以将脚本写在 patch 中.
patch.groovy 中即可以写 liquibase 命令, 也可以执行 sql 语句.
补丁脚本放在 `patch` 目录。
脚本内容可以包括，但不限于：
* 修改表
* 增删改 表中的数据
> 请注意，这些操作应该都是增量的进行
补丁文件的命名方式：20161212-工号-序号.sql
每次提交都是一个单独的 sql 文件，每天提交多次时，需要指定`序号`加以区分
> 脚本内部注释，写明作者，目的，时间，概要
编写完毕以后，将补丁配置到 patch.groovy 中。
> 补丁将会是用的比较多的方式，主要是增加新的数据，由于主键是手动指定的，请注意不要与他人的重复，必须在本地测试过之后再commit。
*补丁数据的脚本编写可参考修改数据库的脚本*
project-create.md
View file @ b88e3a1f
# 新开项目
本章节将引导您从零开始，创建一个可以运行的 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 -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"`
- 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/webapps，运行
### 更新HEL依赖
[更新项目依赖的HEL版本](project-update.md)
# 新开项目
本章节将引导您从零开始，创建一个可以运行的 Demo 工程。此工程基于HEL融租易标准版，包含一个 demo 实例。
## 开发工具准备
- JDK 1.8 及以上
- IntelliJ IDEA 或 Eclipse
- Git
- redis 3.0 及以上
- maven 3.3 及以上
- Tomcat 7+ (**不支持 Tomcat 6**)
- 数据库（任选）
- Mysql server 5.6 及以上
- SqlServer 2012 及以上
- Oracle 9 以上
- Navicat Premium（或其他）
### 软件安装
#### Java 安装
1. 在 [Oracle 官网 ](https://nodejs.orghttp://www.oracle.com/technetwork/cn/java/javase/downloads/index.html)下载对应平台的 JDK 1.8 以上的环境。
2. 本地执行安装文件，安装 JDK 环境。
3. Win 在环境变量系统变量中 path 配置 JDK 的环境变量指向 JDK 安装目录下 ` JDK/bin `。
4. 配置完成后打开 cmd 执行 ` javac `，有提示则说明环境安装成功。
> eclipse 中 JRE 的配置需要指定 JDK 目录，不能是 JRE。(maven 需要 JDK)
#### Git 安装
1. 在 [Git 官网 ](https://git-scm.com/download/)下载对应平台的 Git。
2. 本地执行安装文件， 安装 Git 环境。
3. Win 在环境变量中系统变量的 path 配置 Git 的环境变量指向 Git 安装目录下的 ` /bin `。
4. 配置完成后打开 cmd 执行 ` git `，有提示则说明环境安装成功。
[Git简明教程](git_guide.md)
> 对于 Windows，安装 Git 以后，你可以在任意目录右键，`Git Bash Here`
> 打开的 MINGW 命令窗口可以执行 **兼容 linux 系统** 的命令，如`rm`，`ls` 等
#### Maven 安装
1. 在 [Maven 官网 ](http://mirror.bit.edu.cn/apache/maven/)下载对应平台的合适的 maven 版本的压缩包。
2. 本地解压压缩包。
3. Win 在环境变量中系统变量的 path 配置 maven 的环境变量指向 maven 解压目录下的 ` /bin `。
4. 配置完成后打开 cmd 执行 ` mvn -v `，有提示则说明环境安装成功。
#### Redis 安装
1. 在 [Redis win 官网 ](https://github.com/MSOpenTech/redis/releases)下载最新的 redis 版本的压缩包。
2. 本地解压压缩包。
3. Win 在解压目录下打开 cmd 执行 ` redis-server.exe redis.windows.conf `，有提示则说明 Redis 已经启动。
4. Win 平台下如果启动失败，修改 redis.windows.conf 文件中的 maxheap 为 ` maxheap 1024000000 `。
**注：** 开发需要依赖 Redis 环境，所以在启动后台程序时，请确保 Redis 已经启动，如redis需配置集群，[请参考Redis集群部署](/后端开发/redis.md)
* redis GUI 客户端下载 ：http://redisdesktop.com/
* redis 命令手册：http://doc.redisfans.com/
* redis 清空缓存命令：flushall
> Mac, Linux 用户, 请到 http://redis.io 下载源码，编译安装
### 新建项目 (依赖融租易HEL1.0)
#### 确定项目信息
1. groupId 本项目的代号，比如融租易项目，代号为 hel
2. artifactId 本项目的顶层目录名称，使用项目代号(第一个字母大写) +Parent，如 HelParent
3. package 包名称，使用项目代号 + core ,如 Hel.core
4. archetypeVersion 是指模板项目的版本，可以使用以下版本号
> 1.0-RELEASE
确定上述信息后，可以使用如下命令新建项目：
`注意` 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
> 按照[创建数据库](/后端开发/database-init.md)中的步骤创建数据库
> 请修改 `HelParent/core/src/main/java/hel/core/db/liquibase.groovy` 以适配不同的数据库
### 修改项目配置文件
[修改项目配置文件](/后端开发/database-config.md)
### 编译整个项目
在 HelParent 目录下执行：
```
mvn clean install -Dmaven.test.skip=true
```
### 初始化数据库表结构及基础数据
在 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 -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"`
- 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
```
2. 将项目工程导入 IDE 工具（Eclipse，IntelliJ IDEA）中，并配置服务（tomcat等）后启动运行。
### 更新HEL依赖
[更新项目依赖的HEL版本](project-update.md)
前端组件/hlsDataSource.md
View file @ b88e3a1f
# hlsDataSource标签
数据源组件hlsDataSource
```
<h:hlsDataSource id="hlsDataSource" autoQuery="true" successEnd="successEnd">
<h:transport parameter="parameter">
<h:read url="" type="GET" />
</h:transport>
</h:hlsDataSource>
```
| **属性** | **参数** | **说明** |
| -------- | -------- | -------- |
| id | 唯一英文标识 | 数据源唯一标志，返回数据源对象，包含查询返回的数据 |
| autoQuery | true/false | 自动查询标志，默认为true，true代表自动发送查询请求，false代表不发送查询请求 |
| successEnd | function | 异步请求成功的回调函数，参数:data\(查询返回的数据\) |
| parameter | function | 函数返回一个对象，会自动封装到查询条件中 |
| url | 查询字符串 | 查询字符串，对应后台的数据接口 |
| type | GET/POST | 对应发送GET请求跟POST请求 |
# hlsDataSource标签（数据源控件）
数据源组件hlsDataSource
```
<h:hlsDataSource id="hlsDataSource" autoQuery="true" successEnd="successEnd">
<h:transport parameter="parameter">
<h:read url="" type="GET" />
</h:transport>
</h:hlsDataSource>
```
| **属性** | **参数** | **说明** |
| -------- | -------- | -------- |
| id | 唯一英文标识 | 数据源唯一标志，返回数据源对象，包含查询返回的数据 |
| autoQuery | true/false | 自动查询标志，默认为true，true代表自动发送查询请求，false代表不发送查询请求 |
| successEnd | function | 异步请求成功的回调函数，参数:data\(查询返回的数据\) |
| parameter | function | 函数返回一个对象，会自动封装到查询条件中 |
| url | 查询字符串 | 查询字符串，对应后台的数据接口 |
| type | GET/POST | 对应发送GET请求跟POST请求 |
前端组件/hlsDatePicker.md
View file @ b88e3a1f
# hlsDatePicker标签
# hlsDatePicker标签（时间控件）
日期选择器(不包含时分秒)
......
前端组件/grid.md → 前端组件/hlsGrid.md
View file @ b88e3a1f
## Grid
#### 表格
对于API文档中的所有属性，考虑实际需要，有些属性没必要实现，本文档若未列出，就代表并未实现
#### xml配置
```xml
<!--h:为命名空间,必须要加的，grid为组件名;id可写可不写-->
<h:grid id="grid"/>
```
```xml
<!--grid-->
<h:grid dataSource="dataSource" selectable="multiple, rowbox" editable="true">
<h:pageable pageSizes="5, 10, 20, 50" buttonCount="5" refresh="true">
</h:pageable>
<h:columns>
<h:column field="moduleCode" title='' width="100"/>
<h:column field="functionCode" title='' width="180"/>
</h:columns>
</h:grid>
```
---
对于所有属性，无论是直接属性，还是子标签的属性，都遵循以下原则：
1.若是简单的属性，就添加到当前标签上，若是对象，就创建子标签，这里的简单属性是指能直接被描述在当前标签上的属性，如字符串，函数，\(函数只是一个引用\)，布尔类型，数字类型等等，对象是指这个属性又包含了子属性，所以我们不得不向下创建子标签才能将其子属性描述出来。
2.对于String和Function类型，必须用fn：前缀加以区分，
3.对于数组，有些数组是字符串数组，这种直接当作简单的属性处理，用逗号分隔每个字符串即可，有些数组是list集合数组，这种必须先创建属性子标签，再创建item子标签来描述集合，详情可参考子标签columns
---
### **一般属性 **
> **提示:**
>
> * 属性用法请参考kendoui API文档的grid: [http:\/\/docs.telerik.com\/kendo-ui\/api\/javascript\/ui\/gird](http://docs.telerik.com/kendo-ui/api/javascript/ui/gird)
| 属性名 | 类型 | 描述 |
| :--- | :--- | :--- |
| allowCopy | Boolean | 允许复制 |
| altRowTemplate | String & Function | 呈现交替表行的模板 |
| autoBind | Boolean | 绑定数据源 |
| columnResizeHandleWidth | Integer | 设置列宽度 |
| columnMenu | Boolean | 设置列菜单 |
| dataSource | kendo.data.DataSource\(Function\) | 数据源 |
| detailTemplate | String & Function | 呈现详细的模板 |
| editable | Boolean & String | 设置是否可编辑 |
| groupable | Boolean | 设置分组 |
| height | Integer & String | 设置高度 |
| mobile | Boolean & String | 设置网格 |
| navigatable | Boolean | 导航栏 |
| noRecords | Boolean | 显示类似“没有记录”的标记默认为false |
| pageable | Boolean | 显示网格默认为false |
| reorderable | Boolean | 拖动标题排序默认为false |
| resizable | Boolean | 拖动表格边缘来调大小 |
| rowTemplate | String & Function | 呈现一个行 |
| scrollable | Boolean | 出现滚动条 |
| selectable | Boolean & String | 可以选择默认为false |
| sortable | Boolean | 可以分组 |
| toolbar | String & Function | 表格上面设置按钮 |
| cancel | Function | 取消事件 |
| change | Function | 改变事件 |
| columnHide | Function | 列隐藏函数 |
| columnMenuInit | Function | 列菜单初始化触发事件 |
| columnReorder | Function | 更改列触发事件 |
| columnResize | Function | 可以调整列 |
| columnShow | Function | 展示列 |
| dataBinding | Function | 数据源绑定 |
| dataBound | Function | 数据加载完之后触发 |
| detailCollapse | Function | 折叠表行时触发 |
| detailExpand | Function | 展开表行时触发 |
| detailInit | Function | 表行初始化时触发 |
| edit | Function | 编辑时触发 |
| excelExport | Function | excel导出 |
| filter | Function | 过滤 |
| group | Function | 分组 |
| page | Function | 分页 |
| pdfExport | Function | pdf导出 |
| filterMenuInit | Function | 第一次打开筛选器时触发 |
| remove | Function | 点击删除按钮触发 |
| save | Function | 点击保存时触发 |
| saveChanges | Function | 点击保存时触发 |
| sort | Function | 排序 |
| columnLock | Function | 锁定列时触发 |
| columnUnlock | Function | 接触列锁定触发 |
| navigate | Function | 开启导航栏 |
用法示例：
```javascript
//注意这是写在script标签里的内容
var dataSource = new kendo.data.DataSource({
data: [
{ name: "Jane Doe", age: 30 },
{ name: "John Doe", age: 33 }
]
});
function edit(){
//...
}
function rowTemplate(){
//...
}
```
```xml
<h:grid id="grid" dataSource="dataSource" resizable= "true" height= "100%" edit ="edit" rowTemplate="fn:rowTemplate"/>
```
> **提示:**
>
> * 上述所有属性直接添加在标签内即可，（**\[\*\***属性名\]**\*\* = "..."**）,对于类型是函数的属性，需要另外在script标签中具体定义函数，这里只是一个引用,对于类型**既是函数又是字符串**类型的属性，一定要加**fn:** 来区分，加fn:的代表这是一个函数，对于**既是字符串又是布尔类型**的属性，照常输入就行了。
#### **子标签**
| 属性名 | 类型 | 描述 |
| :--- | :--- | :--- |
| allowCopy | Object | 允许复制 |
| columns | Array | 列 |
| columnMenu | Object | 列菜单 |
| editable | Object | 是否可编辑 |
| messages | Object | 提示 信息 |
| scrollable | Object | 出现滚动条 |
| sortable | Object | 可以排序 |
| toolbar | Array | 按钮 |
#### **allowCopy**子标签
| 属性 | 类型 | 描述 |
| :--- | :--- | :--- |
| delimeter | String & Object | 同一行之间的分节符 |
```xml
<!--delimeter是Object类型-->
<h:grid>
<h:allowCopy>
<h:delimeter />
</h:allowCopy>
</h:grid>
<!--delimeter是String类型-->
<h:grid>
<h:allowCopy delimeter=",">
</h:allowCopy>
</h:grid>
```
#### **columns**子标签
| 属性 | 类型 | 描述 |
| :--- | :--- | :--- |
| attributes | Object | 属性 |
| command | Object | 显示命令按钮 |
| editor | Function | 编辑时触发 |
| encoded | Boolean | 设置编码 |
| field | String | 字段id |
| footerTemplate | String & Function | 页脚表单 |
| format | String | 格式化 |
| sortable | Object | 可排序 |
| template | String & Function | 离开某个输入单元触发 |
| title | String | 标题 |
| width | Integer & String | 宽度 |
| hidden | Boolean | 隐藏 |
| menu | Boolean | 菜单 |
| locked | Boolean | 锁定 |
| columns | Object | 列 |
| filterable | Object | 可过滤 |
| groupable | Boolean | 可分组 |
| values | Array | 设置值 |
#### **columns-filterable**子标签
| 属性 | 类型 | 描述 |
| :--- | :--- | :--- |
| cell | Object | 设置为行时头单元格的选项 |
| dataSource | Function | 数据源 |
| itemTemplate | Function | 允许制定逻辑 |
| operators | Object | 单元格过滤默认运算符 |
| search | Boolean | 查询 |
| ui | Object | ui |
**attributes**用法:
```xml
<h:grid>
<h:columns>
<h:column>
<h:attributes "style"="text-align:center"/>
</h:column>
</h:columns>
</h:grid>
```
**command**用法：
```xml
<!--对于数组来说，有两种形式，一种是直接用逗号分隔，放在标签上的,如 aggregates;另一种是创建子标签，再创建item子标签，再将数组内的内容整合到item子标签上，如command，先创建command子标签，再创建item子标签，再将数组中的每一个集合放在item标签上-->
<h:grid>
<h:columns aggregates="count,min,max">
<h:column template="fn:template"/>
<h:column field="functionId" width="30px/>
<h:column title="列头" locked="true">
<h:command>
<h:item name="edit"></h:item>
<h:item name="destroy"></h:item>
</h:command>
</h:column>
</h:columns>
</h:grid>
```
**editor**用法：
```javascript
function editor(){
//...
}
```
```xml
<h:grid>
<h:columns>
<h:column editor="editor">
</h:column>
</h:coulmns>
</h:grid>
```
**filterable**用法：
```xml
<!--以filterable举例 遇到对象就向下添加子标签-->
<h:grid>
<h:columns>
<h:column>
<h:filterable>
<h:cell dataTextField="name"/>
</h:filterable>
</h:column>
</h:columns>
</h:grid>
```
**headerAtrributes**用法:
```xml
<h:grid>
<h:columns>
<h:column>
<h:headerAttributes "style"="color:red">
</h:column>
</h:columns>
</h:grid>
```
#### **ColumnMenu**子标签
| 属性 | 类型 | 描述 |
| :--- | :--- | :--- |
| columns | Boolean | 列 |
| filterable | Boolean | 允许过滤 |
| sortable | Boolean | 允许排序 |
| messages | Object | 消息内容 |
用法:
```xml
<h:grid id="grid">
<h:columnMenu columns="true" fileterable="false">
<h:messages columns="choose columns"/>
</h:columnMenu>
</h:grid >
```
#### **editable**子标签
| 属性 | 类型 | 描述 |
| :--- | :--- | :--- |
| confirmation | Object | 执行销毁命令时弹出提示框 |
| cancelDelete | String | 执行销毁命令时的提示框用于取消 |
| confirmDelete | String | 执行销毁命令提示框用于确定 |
| destroy | Boolean | 设置删除数据项 |
| mode | String | 设置编辑模式 |
| template | String & Function | 弹出编辑器的模板 |
| update | Boolean | 设为true可以编辑数据项 |
用法:
```xml
<h:grid id="grid">
<h:columnMenu columns="true" fileterable="false">
<h:messages columns="choose columns"/>
</h:columnMenu>
</h:grid >
```
#### **pageable**子标签
| 属性 | 类型 | 描述 |
| :--- | :--- | :--- |
| pageSize | Integer | 设置页大小 |
| previousNext | Boolean | 可以选择上一页 |
| numeric | Boolean | 显示默认按钮 |
| buttonCount | Integer | 按钮总数 |
| input | Boolean | 提供输入任意页码的框 |
| pageSizes | Boolean & Array | 选择每页显示大小 |
| refresh | Boolean | 刷新 |
| info | Boolean | 显示分页情况 |
| messages | Object | 显示文本信息 |
用法:
```xml
<!--pageSizes 为array时-->
<h:grid>
<h:pageable pageSizes="all,5,10,20,50" buttonCount="5" refresh="true">
<h:messages display="show"/>
</h:pageable>
</h:grid>
```
#### **messages**子标签
| 属性 | 类型 | 描述 |
| :--- | :--- | :--- |
| commands | Object | 显示命令按钮的文本，主要用于本地化 |
| noRecords | String | 定义没有数据时的视图 |
用法:
```xml
<h:grid>
<h:messages noRecords="no data">
<h:commands cancel="cancel"/>
</h:messages >
</h:grid>
```
#### **noRecords**子标签
| 属性 | 类型 | 描述 |
| :--- | :--- | :--- |
| template | String & Function | 当前视图无记录时的展示 |
用法:
```xml
<h:grid>
<h:noRecords template="no records">
</h:noRecords>
</h:grid>
```
#### **scrollable**子标签
| 属性名 | 类型 | 描述 |
| :--- | :--- | :--- |
| virtual | String | 显示单页数据 |
用法:
```xml
<h:grid>
<h:scrollable virtual="true"/>
</h:grid>
```
#### **sortable**子标签
| 属性 | 类型 | 描述 |
| :--- | :--- | :--- |
| allowUnsort | Boolean | 设置单行或者多行排序 |
| mode | String | 设置单行或者多行排序 |
用法:
```xml
<h:grid>
<h:sortable allowUnsort="true" mode="multiple"/>
</h:grid>
```
#### **toolbar**子标签
| 属性 | 类型 | 描述 |
| :--- | :--- | :--- |
| name | String | 名字 |
| template | String & Function | 按钮展示模板 |
| text | String | 设置名称 |
```javascript
function template(){
//...
}
```
```xml
<!--toolbar是数组 所以属性都是针对于数组内的集合来说的-->
<h:grid>
<h:toolbar>
<h:item name="create">
<!--当template为String时，由于xml会对标签的封闭符号敏感，所以可以采取下面的方式-->
<h:template>
<![CDATA[<span class=" btn btn-primary k-grid-add">#=text#</span>]]>
</h:template>
</h:item>
</h:toolbar>
</h:grid>
```
> **提示**：
>
> * 遇到**object**类型 就向下添加子标签，当遇到普通类型时，就添加到当前的标签上,就像处理一般属性那样。
## hlsGrid
#### 表格
对于API文档中的所有属性，考虑实际需要，有些属性没必要实现，本文档若未列出，就代表并未实现
#### xml配置
```xml
<!--h:为命名空间,必须要加的，grid为组件名;id可写可不写-->
<h:hlsGrid id="grid"/>
```
```xml
<!--grid-->
<h:hlsGrid dataSource="dataSource" selectable="multiple, rowbox" editable="true">
<h:pageable pageSizes="5, 10, 20, 50" buttonCount="5" refresh="true">
</h:pageable>
<h:columns>
<h:column field="moduleCode" title='' width="100"/>
<h:column field="functionCode" title='' width="180"/>
</h:columns>
</h:hlsGrid>
```
---
对于所有属性，无论是直接属性，还是子标签的属性，都遵循以下原则：
1.若是简单的属性，就添加到当前标签上，若是对象，就创建子标签，这里的简单属性是指能直接被描述在当前标签上的属性，如字符串，函数，\(函数只是一个引用\)，布尔类型，数字类型等等，对象是指这个属性又包含了子属性，所以我们不得不向下创建子标签才能将其子属性描述出来。
2.对于String和Function类型，必须用fn：前缀加以区分，
3.对于数组，有些数组是字符串数组，这种直接当作简单的属性处理，用逗号分隔每个字符串即可，有些数组是list集合数组，这种必须先创建属性子标签，再创建item子标签来描述集合，详情可参考子标签columns
---
### **一般属性 **
> **提示:**
>
> * 属性用法请参考kendoui API文档的grid: [http:\/\/docs.telerik.com\/kendo-ui\/api\/javascript\/ui\/gird](http://docs.telerik.com/kendo-ui/api/javascript/ui/gird)
| 属性名 | 类型 | 描述 |
| :--- | :--- | :--- |
| allowCopy | Boolean | 允许复制 |
| altRowTemplate | String & Function | 呈现交替表行的模板 |
| autoBind | Boolean | 绑定数据源 |
| columnResizeHandleWidth | Integer | 设置列宽度 |
| columnMenu | Boolean | 设置列菜单 |
| dataSource | kendo.data.DataSource\(Function\) | 数据源 |
| detailTemplate | String & Function | 呈现详细的模板 |
| editable | Boolean & String | 设置是否可编辑 |
| groupable | Boolean | 设置分组 |
| height | Integer & String | 设置高度 |
| mobile | Boolean & String | 设置网格 |
| navigatable | Boolean | 导航栏 |
| noRecords | Boolean | 显示类似“没有记录”的标记默认为false |
| pageable | Boolean | 显示网格默认为false |
| reorderable | Boolean | 拖动标题排序默认为false |
| resizable | Boolean | 拖动表格边缘来调大小 |
| rowTemplate | String & Function | 呈现一个行 |
| scrollable | Boolean | 出现滚动条 |
| selectable | Boolean & String | 可以选择默认为false |
| sortable | Boolean | 可以分组 |
| toolbar | String & Function | 表格上面设置按钮 |
| cancel | Function | 取消事件 |
| change | Function | 改变事件 |
| columnHide | Function | 列隐藏函数 |
| columnMenuInit | Function | 列菜单初始化触发事件 |
| columnReorder | Function | 更改列触发事件 |
| columnResize | Function | 可以调整列 |
| columnShow | Function | 展示列 |
| dataBinding | Function | 数据源绑定 |
| dataBound | Function | 数据加载完之后触发 |
| detailCollapse | Function | 折叠表行时触发 |
| detailExpand | Function | 展开表行时触发 |
| detailInit | Function | 表行初始化时触发 |
| edit | Function | 编辑时触发 |
| excelExport | Function | excel导出 |
| filter | Function | 过滤 |
| group | Function | 分组 |
| page | Function | 分页 |
| pdfExport | Function | pdf导出 |
| filterMenuInit | Function | 第一次打开筛选器时触发 |
| remove | Function | 点击删除按钮触发 |
| save | Function | 点击保存时触发 |
| saveChanges | Function | 点击保存时触发 |
| sort | Function | 排序 |
| columnLock | Function | 锁定列时触发 |
| columnUnlock | Function | 接触列锁定触发 |
| navigate | Function | 开启导航栏 |
用法示例：
```javascript
//注意这是写在script标签里的内容
var dataSource = new kendo.data.DataSource({
data: [
{ name: "Jane Doe", age: 30 },
{ name: "John Doe", age: 33 }
]
});
function edit(){
//...
}
function rowTemplate(){
//...
}
```
```xml
<h:grid id="grid" dataSource="dataSource" resizable= "true" height= "100%" edit ="edit" rowTemplate="fn:rowTemplate"/>
```
> **提示:**
>
> * 上述所有属性直接添加在标签内即可，（**\[\*\***属性名\]**\*\* = "..."**）,对于类型是函数的属性，需要另外在script标签中具体定义函数，这里只是一个引用,对于类型**既是函数又是字符串**类型的属性，一定要加**fn:** 来区分，加fn:的代表这是一个函数，对于**既是字符串又是布尔类型**的属性，照常输入就行了。
#### **子标签**
| 属性名 | 类型 | 描述 |
| :--- | :--- | :--- |
| allowCopy | Object | 允许复制 |
| columns | Array | 列 |
| columnMenu | Object | 列菜单 |
| editable | Object | 是否可编辑 |
| messages | Object | 提示 信息 |
| scrollable | Object | 出现滚动条 |
| sortable | Object | 可以排序 |
| toolbar | Array | 按钮 |
#### **allowCopy**子标签
| 属性 | 类型 | 描述 |
| :--- | :--- | :--- |
| delimeter | String & Object | 同一行之间的分节符 |
```xml
<!--delimeter是Object类型-->
<h:hlsGrid>
<h:allowCopy>
<h:delimeter />
</h:allowCopy>
</h:hlsGrid>
<!--delimeter是String类型-->
<h:hlsGrid>
<h:allowCopy delimeter=",">
</h:allowCopy>
</h:hlsGrid>
```
#### **columns**子标签
| 属性 | 类型 | 描述 |
| :--- | :--- | :--- |
| attributes | Object | 属性 |
| command | Object | 显示命令按钮 |
| editor | Function | 编辑时触发 |
| encoded | Boolean | 设置编码 |
| field | String | 字段id |
| footerTemplate | String & Function | 页脚表单 |
| format | String | 格式化 |
| sortable | Object | 可排序 |
| template | String & Function | 离开某个输入单元触发 |
| title | String | 标题 |
| width | Integer & String | 宽度 |
| hidden | Boolean | 隐藏 |
| menu | Boolean | 菜单 |
| locked | Boolean | 锁定 |
| columns | Object | 列 |
| filterable | Object | 可过滤 |
| groupable | Boolean | 可分组 |
| values | Array | 设置值 |
#### **columns-filterable**子标签
| 属性 | 类型 | 描述 |
| :--- | :--- | :--- |
| cell | Object | 设置为行时头单元格的选项 |
| dataSource | Function | 数据源 |
| itemTemplate | Function | 允许制定逻辑 |
| operators | Object | 单元格过滤默认运算符 |
| search | Boolean | 查询 |
| ui | Object | ui |
**attributes**用法:
```xml
<h:hlsGrid>
<h:columns>
<h:column>
<h:attributes "style"="text-align:center"/>
</h:column>
</h:columns>
</h:hlsGrid>
```
**command**用法：
```xml
<!--对于数组来说，有两种形式，一种是直接用逗号分隔，放在标签上的,如 aggregates;另一种是创建子标签，再创建item子标签，再将数组内的内容整合到item子标签上，如command，先创建command子标签，再创建item子标签，再将数组中的每一个集合放在item标签上-->
<h:hlsGrid>
<h:columns aggregates="count,min,max">
<h:column template="fn:template"/>
<h:column field="functionId" width="30px/>
<h:column title="列头" locked="true">
<h:command>
<h:item name="edit"></h:item>
<h:item name="destroy"></h:item>
</h:command>
</h:column>
</h:columns>
</h:hlsGrid>
```
**editor**用法：
```javascript
function editor(){
//...
}
```
```xml
<h:hlsGrid>
<h:columns>
<h:column editor="editor">
</h:column>
</h:coulmns>
</h:hlsGrid>
```
**filterable**用法：
```xml
<!--以filterable举例 遇到对象就向下添加子标签-->
<h:hlsGrid>
<h:columns>
<h:column>
<h:filterable>
<h:cell dataTextField="name"/>
</h:filterable>
</h:column>
</h:columns>
</h:hlsGrid>
```
**headerAtrributes**用法:
```xml
<h:hlsGrid>
<h:columns>
<h:column>
<h:headerAttributes "style"="color:red">
</h:column>
</h:columns>
</h:hlsGrid>
```
#### **ColumnMenu**子标签
| 属性 | 类型 | 描述 |
| :--- | :--- | :--- |
| columns | Boolean | 列 |
| filterable | Boolean | 允许过滤 |
| sortable | Boolean | 允许排序 |
| messages | Object | 消息内容 |
用法:
```xml
<h:hlsGrid id="grid">
<h:columnMenu columns="true" fileterable="false">
<h:messages columns="choose columns"/>
</h:columnMenu>
</h:hlsGrid >
```
#### **editable**子标签
| 属性 | 类型 | 描述 |
| :--- | :--- | :--- |
| confirmation | Object | 执行销毁命令时弹出提示框 |
| cancelDelete | String | 执行销毁命令时的提示框用于取消 |
| confirmDelete | String | 执行销毁命令提示框用于确定 |
| destroy | Boolean | 设置删除数据项 |
| mode | String | 设置编辑模式 |
| template | String & Function | 弹出编辑器的模板 |
| update | Boolean | 设为true可以编辑数据项 |
用法:
```xml
<h:hlsGrid id="grid">
<h:columnMenu columns="true" fileterable="false">
<h:messages columns="choose columns"/>
</h:columnMenu>
</h:hlsGrid >
```
#### **pageable**子标签
| 属性 | 类型 | 描述 |
| :--- | :--- | :--- |
| pageSize | Integer | 设置页大小 |
| previousNext | Boolean | 可以选择上一页 |
| numeric | Boolean | 显示默认按钮 |
| buttonCount | Integer | 按钮总数 |
| input | Boolean | 提供输入任意页码的框 |
| pageSizes | Boolean & Array | 选择每页显示大小 |
| refresh | Boolean | 刷新 |
| info | Boolean | 显示分页情况 |
| messages | Object | 显示文本信息 |
用法:
```xml
<!--pageSizes 为array时-->
<h:hlsGrid>
<h:pageable pageSizes="all,5,10,20,50" buttonCount="5" refresh="true">
<h:messages display="show"/>
</h:pageable>
</h:hlsGrid>
```
#### **messages**子标签
| 属性 | 类型 | 描述 |
| :--- | :--- | :--- |
| commands | Object | 显示命令按钮的文本，主要用于本地化 |
| noRecords | String | 定义没有数据时的视图 |
用法:
```xml
<h:hlsGrid>
<h:messages noRecords="no data">
<h:commands cancel="cancel"/>
</h:messages >
</h:hlsGrid>
```
#### **noRecords**子标签
| 属性 | 类型 | 描述 |
| :--- | :--- | :--- |
| template | String & Function | 当前视图无记录时的展示 |
用法:
```xml
<h:hlsGrid>
<h:noRecords template="no records">
</h:noRecords>
</h:hlsGrid>
```
#### **scrollable**子标签
| 属性名 | 类型 | 描述 |
| :--- | :--- | :--- |
| virtual | String | 显示单页数据 |
用法:
```xml
<h:hlsGrid>
<h:scrollable virtual="true"/>
</h:hlsGrid>
```
#### **sortable**子标签
| 属性 | 类型 | 描述 |
| :--- | :--- | :--- |
| allowUnsort | Boolean | 设置单行或者多行排序 |
| mode | String | 设置单行或者多行排序 |
用法:
```xml
<h:hlsGrid>
<h:sortable allowUnsort="true" mode="multiple"/>
</h:hlsGrid>
```
#### **toolbar**子标签
| 属性 | 类型 | 描述 |
| :--- | :--- | :--- |
| name | String | 名字 |
| template | String & Function | 按钮展示模板 |
| text | String | 设置名称 |
```javascript
function template(){
//...
}
```
```xml
<!--toolbar是数组 所以属性都是针对于数组内的集合来说的-->
<h:hlsGrid>
<h:toolbar>
<h:item name="create">
<!--当template为String时，由于xml会对标签的封闭符号敏感，所以可以采取下面的方式-->
<h:template>
<![CDATA[<span class=" btn btn-primary k-grid-add">#=text#</span>]]>
</h:template>
</h:item>
</h:toolbar>
</h:hlsGrid>
```
> **提示**：
>
> * 遇到**object**类型 就向下添加子标签，当遇到普通类型时，就添加到当前的标签上,就像处理一般属性那样。
前端组件/hlsMaskedTextBox.md
View file @ b88e3a1f
## hlsMaskedTextBox（文本框）
格式框
##### xml配置
```xml
<!--h:为命名空间,必须要加的;maskedTextBox为组件名;id可写可不写-->
<h:hlsMaskedTextBox id="hlsMaskedTextBox"/>
```
#### **一般属性**
> **提示:**
>
> * 属性用法请参考kendoui API文档的maskedTextBox:[http:\/\/docs.telerik.com\/kendo-ui\/api\/javascript\/ui\/maskedtextbox](http://docs.telerik.com/kendo-ui/api/javascript/ui/maskedtextbox)
| 属性名 | 类型 | 说明 |
| --- | --- | --- |
| id | String | 唯一英文标识 |
| promptColspan | number | 该数字将会与col-sm-？进行拼接，替代问号，生成对应bootstrap的css样式，渲染描述的样式 |
| promptClassName | String | 描述的样式名称，会将对应的样式添加到描述中 |
| promptImage | String | 描述前面的一个文本图像，在设置为必填的时候会出现一个红色的* |
| prompt | String | 中文描述 || colspan| number | 该数字会与col-sm-?进行拼接，替代问号，生成对应bootStrap的css样式，渲染文本框的样式 |
| hlsClassName | String | 标签的样式名称 |
| placeholder | String | 占位符 |
| bind | expressions | 绑定数据 |
用法示例：
```xml
<h:hlsMaskedTextBox id="hlsMaskedTextBox" required="true" placeholder="hlsMaskedTextBox" />
```
> **提示:**
>
> * 上述所有属性直接添加在标签内即可，（**\[\*\***属性名\]**\*\* = "..."**）
#### **子标签**
| 属性名 | 类型 |
| --- | --- |
| rules | Object |
```javascript
function rules(){
//...
}
```
```xml
<h:hlsMaskedTextBox id="hlsMaskedtTextBox" placeholder="hlsMaskedTextBox" prompt="hlsMaskedTextBox"
bind="model" bind="enabled: isEnabled, value:data.textBox">
</h:hlsMaskedTextBox>
```
> **提示**：
>
> * 遇到**object**类型 就向下添加子标签，当遇到普通类型时，就添加到当前的标签上。
## hlsMaskedTextBox（文本框）
格式框
##### xml配置
```xml
<!--h:为命名空间,必须要加的;maskedTextBox为组件名;id可写可不写-->
<h:hlsMaskedTextBox id="hlsMaskedTextBox"/>
```
#### **一般属性**
> **提示:**
>
> * 属性用法请参考kendoui API文档的maskedTextBox:[http:\/\/docs.telerik.com\/kendo-ui\/api\/javascript\/ui\/maskedtextbox](http://docs.telerik.com/kendo-ui/api/javascript/ui/maskedtextbox)
| 属性名 | 类型 | 说明 |
| --- | --- | --- |
| id | String | 唯一英文标识 |
| promptColspan | number | 该数字将会与col-sm-？进行拼接，替代问号，生成对应bootstrap的css样式，渲染描述的样式 |
| promptClassName | String | 描述的样式名称，会将对应的样式添加到描述中 |
| promptImage | String | 描述前面的一个文本图像，在设置为必填的时候会出现一个红色的* |
| prompt | String | 中文描述 || colspan| number | 该数字会与col-sm-?进行拼接，替代问号，生成对应bootStrap的css样式，渲染文本框的样式 |
| hlsClassName | String | 标签的样式名称 |
| placeholder | String | 占位符 |
| bind | expressions | 绑定数据 |
用法示例：
```xml
<h:hlsMaskedTextBox id="hlsMaskedTextBox" required="true" placeholder="hlsMaskedTextBox" />
```
> **提示:**
>
> * 上述所有属性直接添加在标签内即可，（**\[\*\***属性名\]**\*\* = "..."**）
#### **子标签**
| 属性名 | 类型 |
| --- | --- |
| rules | Object |
```javascript
function rules(){
//...
}
```
```xml
<h:hlsMaskedTextBox id="hlsMaskedtTextBox" name="hlsMaskedtTextBox" placeholder="hlsMaskedTextBox" prompt="hlsMaskedTextBox"
bind="enabled: isEnabled, value:data.hlsMaskedtTextBox">
</h:hlsMaskedTextBox>
```
> **提示**：
>
> * 遇到**object**类型 就向下添加子标签，当遇到普通类型时，就添加到当前的标签上。
前端组件/hlsPage.md
View file @ b88e3a1f
# hlsPage
代码示例
```xml
<h:hlsPage dataSource="pageDataSource" pageSize="3" titleSearchId="search" inputPlaceholder="项目信息" titleSearchInputId="searchId" id="pageFirst" titleImg="${contextPath!}/resources/images/CONT/contract.png" title="项目">
<h:columns>
<h:column field="divisionDesc" title='<@spring.message "业务模式"/>' >
</h:column>
<h:column field="projectStatusDesc" title='<@spring.message "审批状态"/>'>
</h:column>
<h:column field="tenantName" title='<@spring.message "承租人"/>' >
</h:column>
<h:column field="systemFlag" title='<@spring.message "系统级"/>' template="fn:businessTypeTemplate">
</h:column>
</h:columns>
</h:hlsPage>
```
属性说明
| **属性** | **参数** | **说明** |
| -------- | -------- | -------- |
| id | 唯一标志id | 返回一个名为id的分页对象 |
| dataSource | object | 数据源对象,参考标签hlsPageDataSource |
| pageSize | number | 每页的分页数量，可设置每页显示数据条数 |
| titleSearchId | 唯一标志id | 分页标签title查询框的id，可通过改标志获取数据或其它操作 |
| inputPlaceholder | text | 查询框的提示信息 |
| titleSearchInputId | 唯一标志id | 查询图片的标准id |
| titleImg | String | 标题栏的图片路劲 |
| title | String | 标题栏名称 |
| field | String | 字段的英文标注 |
| title(2) | String | 字段的中文标注 |
# hlsPage（分页控件）
代码示例
```xml
<h:hlsPage dataSource="pageDataSource" pageSize="3" titleSearchId="search" inputPlaceholder="项目信息" titleSearchInputId="searchId" id="pageFirst" titleImg="${contextPath!}/resources/images/CONT/contract.png" title="项目">
<h:columns>
<h:column field="divisionDesc" title='<@spring.message "业务模式"/>' >
</h:column>
<h:column field="projectStatusDesc" title='<@spring.message "审批状态"/>'>
</h:column>
<h:column field="tenantName" title='<@spring.message "承租人"/>' >
</h:column>
<h:column field="systemFlag" title='<@spring.message "系统级"/>' template="fn:businessTypeTemplate">
</h:column>
</h:columns>
</h:hlsPage>
```
属性说明
| **属性** | **参数** | **说明** |
| -------- | -------- | -------- |
| id | 唯一标志id | 返回一个名为id的分页对象 |
| dataSource | object | 数据源对象,参考标签hlsPageDataSource |
| pageSize | number | 每页的分页数量，可设置每页显示数据条数 |
| titleSearchId | 唯一标志id | 分页标签title查询框的id，可通过改标志获取数据或其它操作 |
| inputPlaceholder | text | 查询框的提示信息 |
| titleSearchInputId | 唯一标志id | 查询图片的标准id |
| titleImg | String | 标题栏的图片路劲 |
| title | String | 标题栏名称 |
| field | String | 字段的英文标注 |
| title(2) | String | 字段的中文标注 |
| template | function | 渲染函数，可将返回的html字符串渲染到对应的字段 |
\ No newline at end of file
前端组件/hlsTlEdit.md
View file @ b88e3a1f
## hlsTlEdit
多语言编辑
##### xml配置
```xml
<!--h:为命名空间,必须要加的;hlsTlEdit为组件名;id可写可不写-->
<h:hlsTlEdit id="hlsTlEdit"/>
```
#### **一般属性**
| 属性名 | 类型 | 说明 |
| --- | --- | --- |
| id | String | 唯一英文标识 |
| promptColspan | number | 该数字将会与col-sm-？进行拼接，替代问号，生成对应bootstrap的css样式，渲染描述的样式 |
| promptClassName | String | 描述的样式名称，会将对应的样式添加到描述中 |
| promptImage | String | 描述前面的一个文本图像，在设置为必填的时候会出现一个红色的* |
| prompt | String | 中文描述 |
| colspan| number | 该数字会与col-sm-?进行拼接，替代问号，生成对应bootStrap的css样式，渲染文本框的样式 |
| hlsClassName | String | 标签的样式名称 |
| placeholder | String | 占位符 |
| bind | expressions | 绑定数据 |
用法示例：
```xml
<h:hlsTlEdit id="tl" placeholder="多语言" bind="value:data.name" idField="id" field="name" dto="com.hand.hap.function.dto.Resource" model="viewModel.data">
</h:hlsTlEdit>
```
> **提示：**
>
> * 以上所有属性都直接可以添加到tlEdit标签上，用法皆为\[**属性名**\]="\[**属性值**\]"
## hlsTlEdit（多语言控件）
多语言编辑
##### xml配置
```xml
<!--h:为命名空间,必须要加的;hlsTlEdit为组件名;id可写可不写-->
<h:hlsTlEdit id="hlsTlEdit"/>
```
#### **一般属性**
| 属性名 | 类型 | 说明 |
| --- | --- | --- |
| id | String | 唯一英文标识 |
| promptColspan | number | 该数字将会与col-sm-？进行拼接，替代问号，生成对应bootstrap的css样式，渲染描述的样式 |
| promptClassName | String | 描述的样式名称，会将对应的样式添加到描述中 |
| promptImage | String | 描述前面的一个文本图像，在设置为必填的时候会出现一个红色的* |
| prompt | String | 中文描述 |
| colspan| number | 该数字会与col-sm-?进行拼接，替代问号，生成对应bootStrap的css样式，渲染文本框的样式 |
| hlsClassName | String | 标签的样式名称 |
| placeholder | String | 占位符 |
| bind | expressions | 绑定数据 |
用法示例：
```xml
<h:hlsTlEdit id="tl" placeholder="多语言" bind="value:data.name" idField="id" field="name" dto="com.hand.hap.function.dto.Resource" model="viewModel.data">
</h:hlsTlEdit>
```
> **提示：**
>
> * 以上所有属性都直接可以添加到tlEdit标签上，用法皆为\[**属性名**\]="\[**属性值**\]"
后端开发/database-config.md 0 → 100644
View file @ b88e3a1f
# Oracle,MySql,Sqlserver数据库配置
## 配置文件
1. 服务数据源配置
* 融租易默认使用 JNDI 来配置数据源。数据源的配置独立于项目配置
* 默认使用的 JNDI name 为 `jdbc/hel_dev`
* tomcat 需要配置 context.xml：
- Mysql
```
<Resource auth="Container" driverClassName="com.mysql.jdbc.Driver" url="jdbc:mysql://localhost:3306/hel" name="jdbc/hel_dev" type="javax.sql.DataSource" username="hel_dev" password="hel_dev"/>
```
- Oracle
```
<Resource auth="Container" driverClassName="oracle.jdbc.driver.OracleDriver" name="jdbc/hel_dev" type="javax.sql.DataSource" url="jdbc:oracle:thin:@127.0.0.1:1521:hel" username="hel_dev" password="hel_dev"/>
```
- SqlServer
```
<Resource auth="Container" driverClassName="com.microsoft.sqlserver.jdbc.SQLServerDriver" url="jdbc:sqlserver://127.0.0.1:1433; DatabaseName=hel" name="jdbc/hel_dev" type="javax.sql.DataSource" username="hel_dev" password="hel_dev"/>
```
* 其他[应用服务器weblogic](/框架功能描述/deployment.md)等，需要按其配置方法 配置 JNDI
2. 数据库数据源配置
> 融租易项目根目录的pom.xml中默认包含了 `Oracle`,`Mysql`,`SqlServer` 的 JDBC 驱动，一般不需要改动
* 修改 resources/config.properties
* 当数据库为 oracle 时
```
db.type=oracle
db.jndiName=java:comp/env/jdbc/hel_dev
mybatis.identity=SEQUENCE
```
* 当数据库为mysql时
```
db.type=mysql
db.jndiName=java:comp/env/jdbc/hel_dev
```
* 修改完毕后复制一份放到 resources/profiles/dev (覆盖)
3. redis服务配置
修改resources/config.properties：
* 配置单个redis的时候只需配置
```
redis.ip=172.20.0.115
redis.port=6379
redis.db=1
```
* 当配置redis集群时需配置
```
redis.useSentinel=true --为true时单个redis配置熟悉失效
redis.sentinel=\
10.86.20.183:26379,\
10.86.20.184:26379
```
后端开发/database-init.md 0 → 100644
View file @ b88e3a1f
# 新建数据库
# 1. 创建数据库-Mysql
> 在开始之前最好修改一下 MySQL的配置文件 my.cnf (or my.ini)
,在 [mysqld] 下添加
```
lower_case_table_names=1
character_set_server=utf8
max_connections=500
```
* 用管理员登陆mysql
* 创建数据库hel_dev
```sql
create schema hel_dev default character set utf8;
```
* 创建用户hel_dev,并将密码设置为hel_dev
```sql
CREATE USER hel_dev@'%' IDENTIFIED BY 'hel_dev';
CREATE USER hel_dev@'localhost' IDENTIFIED BY 'hel_dev';
```
* 将上面新建的hel_dev权限赋予用户hel
```sql
GRANT ALL PRIVILEGES ON hel_dev.* TO hel_dev@'%';
GRANT ALL PRIVILEGES ON hel_dev.* TO hel_dev@'localhost';
flush privileges;
```
# 2. 创建数据库-Oracle
* 使用管理员登陆
* 创建表空间
```sql
CREATE BIGFILE TABLESPACE tbs_perm_hel
DATAFILE 'tbs_perm_hel.dat'
SIZE 200M
AUTOEXTEND ON NEXT 20M MAXSIZE 500M;
```
```sql
CREATE TEMPORARY TABLESPACE tbs_temp_hel
TEMPFILE 'tbs_temp_hel.dbf'
SIZE 200M
AUTOEXTEND ON NEXT 20M MAXSIZE 500M;
```
* 创建用户 schema
```sql
CREATE USER hel_dev
IDENTIFIED BY hel_dev
DEFAULT TABLESPACE tbs_perm_hel
TEMPORARY TABLESPACE tbs_temp_hel
QUOTA 200M on tbs_perm_hel;
```
* 授权
```sql
GRANT create session TO hel_dev;
GRANT create table TO hel_dev;
GRANT create view TO hel_dev;
GRANT create any trigger TO hel_dev;
GRANT create any procedure TO hel_dev;
GRANT create sequence TO hel_dev;
GRANT create synonym TO hel_dev;
```
# 3. 创建数据库-sql server
* 使用管理员登陆
* 创建数据库
```sql
CREATE DATABASE hel_dev COLLATE Chinese_PRC_CI_AS;
```
* 创建用户 hel 并授权
```sql
sp_addlogin 'hel','hel_dev';
use hel_dev
go
sp_adduser 'hel_dev','hel_dev'
go
sp_addrolemember 'db_owner','hel'
go
```
\ No newline at end of file
框架功能描述/jad.md
View file @ b88e3a1f
## Excel文件导入
使用poi解析xml方式进行导入，只支持单表导入。
数据库批量导入默认batch为100.
支持多sheet导入，sheet1从第三行开始读取数据，其他sheet页从第一行导入数据。
使用方法：
1. Excel文件上传
```javascript
$("#files").kendoUpload({
async: {
saveUrl: "${base.contextPath}/hls/excel/import?${_csrf.parameterName}=${_csrf.token}&templateCode=HLS_FIN_STATEMENT_LN",
removeUrl: "remove"
},
showFileList: false,
upload: onUpload,
success: onSuccess
});
```
| 参数名 | 描述 |
| :--: | :--: |
| _csrf.token | 防跨域token |
| templateCode | 作为模块标识，会出现先在fnd_interface_header中，供后续业务逻辑进行处理 |
2. 处理数据
经过第一步的文件上传，后台会在fnd_interface_header表中生成一条数据，其中包含了传递的templateCode参数作为code，并且，在fnd_interface_lines表中按照顺序，将Excel文件中的每一行数据保存为一条数据，数据的第一列保存在attributes_1上，依次类推。
![ExcelImport](/assets/excelImport.png)
## Excel文件批量导出
本系统支持Excel文件导出排队处理，支持超大数据量，能实时查询文件生成情况，支持取消导出。
#### 前端使用方法
调用js方法
```javascript
Hel.exportExcel=function(opts){
var contextPath =opts.contextPath,
id=opts.id,
view_model=opts.viewModel,
viewModelData=opts.viewModelData,
controller_name = opts.controller,
fileName = opts.fileName,
temp_div_id=opts.tempDivId,
dataSourceId = opts.dataSourceId,
_csrf_token = opts._csrf_token;
```
| 参数名 | 描述 |
| :--: | :--: |
| contextPath | 项目的url路径 |
| id | 页面上grid的id |
| view_model | grid绑定的model数据模型 |
| viewModelData | model模型中的数据 |
| controller_name | 后端控制器名称 |
| fileName | excel文件名 |
| temp_div_id | 临时div的id |
| dataSourceId | 数据源id |
| _csrf_token | 防跨域的token |
#### 后端使用方法
1. 在代码中注入Excel导出Service
```java
@AutoWired
private ExcelExportServiceImpl excelService;
```
2. 在自己的controller中调用方法
```java
excelService.saveExportInfo(sqlId,iRequest,config,rowMaxNumber);
```
| 参数名 | 类型 | 描述 |
| :--: | :--: | :--: |
| sqlId | String | mybatis对应的数据库查询语句的ID |
| iRequest | IRequest | 带有上下文信息的reuqest对象 |
| config | ExportConfig | 包含Excel各列信息的对象，由前台传递json对象转换而来 |
| rowMaxNumber | int | 生成Excel的最大行数，可使用重载方法，不包含次参数默认为1,000,000 |
3. 运行Excel导出程序(获取该程序，请联系部门相关负责人)
```shell
java -jar hel-batch-parent.jar &
```
4. Excel导出情况查询
用户若是为管理员身份，则查询全部人的导出情况，否则只显示当前用户的导出数据
```java
excelService.queryExportInfo(status, iRequest);
```
| 参数名 | 类型 | 描述 |
| :--: | :--: | :--: |
| status | String | 指定Excel导出的状态，该参数可为空查询全部状态数据<br><ul><li>new->等待</li><li>generating->文件导出中</li><li>finished->导出完成</li><li>failed-> 导出失败</li></ul> |
| iRequest | IRequest | 带有上下文信息的reuqest对象 |
5. 下载已完成的Excel文件
```java
excel.downloadExcel(filePath, fileName, request, response);
```
| 参数名 | 类型 | 描述 |
| :--: | :--: | :--: |
| filePath | String | 需要下载的文件的路径 |
| fileName | String | 想要保存的文件的名称 |
| request | HttpServletRequest | 用户的请求对象 |
| response | HttpServletResponse | 用户的响应对象 |
## Excel文件导入
使用poi解析xml方式进行导入，只支持单表导入。
数据库批量导入默认batch为100.
支持多sheet导入，sheet1从第三行开始读取数据，其他sheet页从第一行导入数据。
使用方法：
1. Excel文件上传
```javascript
$("#files").kendoUpload({
async: {
saveUrl: "${base.contextPath}/hls/excel/import?${_csrf.parameterName}=${_csrf.token}&templateCode=HLS_FIN_STATEMENT_LN",
removeUrl: "remove"
},
showFileList: false,
upload: onUpload,
success: onSuccess
});
```
| 参数名 | 描述 |
| :--: | :--: |
| _csrf.token | 防跨域token |
| templateCode | 作为模块标识，会出现先在fnd_interface_header中，供后续业务逻辑进行处理 |
2. 处理数据
经过第一步的文件上传，后台会在fnd_interface_header表中生成一条数据，其中包含了传递的templateCode参数作为code，并且，在fnd_interface_lines表中按照顺序，将Excel文件中的每一行数据保存为一条数据，数据的第一列保存在attributes_1上，依次类推。
![ExcelImport](/assets/excelImport.png)
## Excel文件批量导出
本系统支持Excel文件导出排队处理，支持超大数据量，能实时查询文件生成情况，支持取消导出。
#### 前端使用方法
调用js方法
* 方法一（针对grid）
```javascript
Hel.exportExcel=function(opts){
var contextPath =opts.contextPath,
id=opts.id,
view_model=opts.viewModel,
viewModelData=opts.viewModelData,
controller_name = opts.controller,
fileName = opts.fileName,
temp_div_id=opts.tempDivId,
dataSourceId = opts.dataSourceId,
_csrf_token = opts._csrf_token;
```
| 参数名 | 描述 |
| :--: | :--: |
| contextPath | 项目的url路径 |
| id | 页面上grid的id |
| view_model | grid绑定的model数据模型 |
| viewModelData | model模型中的数据 |
| controller_name | 后端控制器名称 |
| fileName | excel文件名 |
| temp_div_id | 临时div的id |
| dataSourceId | 数据源id |
| _csrf_token | 防跨域的token |
* 方式二（针对hlsPage）
```javascript
Hel.exportPageExcel({
contextPath:basePath,
param:{},
controller:"/acr/inf/index/excel/export",
fileName:"产品线",
pageConfig:[
{"name":"documentNumber","title":"单据编 号","width":260,"align":"","type":"string"},
{"name":"invoiceDate","title":"开票日期","align":"","type":"string"},
{"name":"invoiceKindDesc","title":"发票种类","width":160,"align":"center","type":"boolean"},
{"name":"bpName","title":"购货单位"},
]
});
```
| 参数名 | 描述 |
| --- | --- |
| contextPath | 项目上的url |
| param| 配合controller添加查询条件 |
| controller | 对应查询url |
| fileName | 文件名 |
| pageConfig | 导出字段名称及样式|
#### 后端使用方法
1. 在代码中注入Excel导出Service
```java
@AutoWired
private ExcelExportServiceImpl excelService;
```
2. 在自己的controller中调用方法
```java
excelService.saveExportInfo(sqlId,iRequest,config,rowMaxNumber);
```
| 参数名 | 类型 | 描述 |
| :--: | :--: | :--: |
| sqlId | String | mybatis对应的数据库查询语句的ID |
| iRequest | IRequest | 带有上下文信息的reuqest对象 |
| config | ExportConfig | 包含Excel各列信息的对象，由前台传递json对象转换而来 |
| rowMaxNumber | int | 生成Excel的最大行数，可使用重载方法，不包含次参数默认为1,000,000 |
3. 运行Excel导出程序(获取该程序，请联系部门相关负责人)
```shell
java -jar hel-batch-parent.jar &
```
4. Excel导出情况查询
用户若是为管理员身份，则查询全部人的导出情况，否则只显示当前用户的导出数据
```java
excelService.queryExportInfo(status, iRequest);
```
| 参数名 | 类型 | 描述 |
| :--: | :--: | :--: |
| status | String | 指定Excel导出的状态，该参数可为空查询全部状态数据<br><ul><li>new->等待</li><li>generating->文件导出中</li><li>finished->导出完成</li><li>failed-> 导出失败</li></ul> |
| iRequest | IRequest | 带有上下文信息的reuqest对象 |
5. 下载已完成的Excel文件
```java
excel.downloadExcel(filePath, fileName, request, response);
```
| 参数名 | 类型 | 描述 |
| :--: | :--: | :--: |
| filePath | String | 需要下载的文件的路径 |
| fileName | String | 想要保存的文件的名称 |
| request | HttpServletRequest | 用户的请求对象 |
| response | HttpServletResponse | 用户的响应对象 |
**下载前，需要检查config.properties文件中的export.offerUrl配置项是否配置正确，且为hel-batch-parent.jar提供的文件下载url**
\ No newline at end of file
融租易开发手册.md
View file @ b88e3a1f
# 融租易开发手册
* [GitBook使用](/gitbook.md)
---
* I. 开发环境准备
* [1.1 Git 使用](/git-guide.md "git指令")
* [1.2 Maven 使用](/maven.md "maven使用")
* [1.3 开发环境搭建](/project-create.md)
* [1.4 更新项目的HEL依赖版本](/project-update.md)
* [1.5 Liquibase](/liquibase-use.md)
* II. 项目开发规范
* [2.1 项目开发规范](/codeStyle.md#backEndDev)
* [2.2 编码规范](/codeStyle.md#backEndName)
* 2.3 Checkstyle
* III. 后端开发
* [3.1 后端开发说明(1.0)](/后端开发/dev-flow.md)
* [3.2 用户安全策略](/后端开发/user-security-strategy.md)
* [3.3 审计](/后端开发/audit.md)
* [3.4 锁机制](/后端开发/lock.md)
* [3.5 日志管理](/后端开发/elk.md)
* [3.6 代码生成器](/后端开发/code-generator.md)
* [3.7 跨域访问](/后端开发/3.24-cors.md)
* IV. 前端JavaScript开发
* [4.1 前端开发说明 \(1.0\)](/front-kendoui.md)
* [4.2 字段级通用方法](/common-field-javascript.md)
* [4.3 窗口级通用方法](/common-window-javascript.md)
* [4.4 锁屏和解屏通用方法](/common-mask-javascript.md)
* V. 前端UI开发
* [5.1 hlsCombobox(下拉框)](/前端组件/hlsCombobox.md)
* [5.2 hlsDataSource](/前端组件/hlsDataSource.md)
* [5.3 hlsMaskedTextBox](/前端组件/hlsMaskedTextBox.md)
* [5.4 hlsPage](/前端组件/hlsPage.md)
* [5.5 hlsTextArea](/前端组件/hlsTextArea.md)
* [5.6 hlsTlEdit](/前端组件/hlsTlEdit.md)
* [5.7 hlsDatePicker(日期选择框)](/前端组件/hlsDatePicker.md)
* [5.8 hlsDateTimePicker(时间选择框)](/前端组件/HlsDateTimePicker.md)
* [5.9 hlsLov(lov选择框)](/前端组件/HlsLov.md)
* [5.10 hlsToolBar(底部菜单栏)](/前端组件/HlsToolBar.md)
* [5.11 TabStrip(sheet页切换卡)](/前端组件/TabStrip.md)
* [5.12 hlsForm(表单)](/前端组件/hlsForm.md)
* [5.13 hlsCombobox](/前端组件/HlsCombobox.md)
* [5.14 hlsCheckBox(复选框)](/前端组件/HlsCheckBox.md)
* [5.15 Grid](/前端组件/Grid.md)
* [5.16 DataSource](/前端组件/DataSource.md)
* [5.17 hlsGridBox](/前端组件/hlsGridBox.md)
* [5.18 NumericTextBx](/前端组件/NumericTextBox.md)
* [5.19 HlsNavigationBar](/前端组件/HlsNavigationBar.md)
* VI. 框架功能描述
* [6.1 计划任务](/框架功能描述/计划任务.md)
* [6.2 RabbitMq消息队列](/后端开发/RabbitMq消息队列.md)
* [6.3 应用服务部署(tomcat/weblogic)](/框架功能描述/deployment.md)
* [6.4 合同文本生成](/框架功能描述/docx4j.md)
* [6.5 Excel导入导出](/框架功能描述/jad.md)
* [6.6 redis安装和部署](/后端开发/redis.md)
# 融租易开发手册
* [GitBook使用](/gitbook.md)
---
* I. 开发环境准备
* [1.1 Git 使用](/git-guide.md "git指令")
* [1.2 Maven 使用](/maven.md "maven使用")
* [1.3 开发环境搭建](/project-create.md)
* [1.4 更新项目的HEL依赖版本](/project-update.md)
* [1.5 Liquibase](/liquibase-use.md)
* II. 项目开发规范
* [2.1 项目开发规范](/codeStyle.md#backEndDev)
* [2.2 编码规范](/codeStyle.md#backEndName)
* 2.3 Checkstyle
* III. 后端开发
* [3.1 后端开发说明\(1.0\)](/后端开发/dev-flow.md)
* [3.2 用户安全策略](/后端开发/user-security-strategy.md)
* [3.3 审计](/后端开发/audit.md)
* [3.4 锁机制](/后端开发/lock.md)
* [3.5 日志管理](/后端开发/elk.md)
* [3.6 代码生成器](/后端开发/code-generator.md)
* [3.7 跨域访问](/后端开发/3.24-cors.md)
* [3.8 消息机制](/后端开发/消息机制.md)
* IV. 前端JavaScript开发
* [4.1 前端开发说明 \(1.0\)](/front-kendoui.md)
* [4.2 字段级通用方法](/common-field-javascript.md)
* [4.3 窗口级通用方法](/common-window-javascript.md)
* [4.4 锁屏和解屏通用方法](/common-mask-javascript.md)
* V. 前端UI开发
* [5.1 hlsCombobox\(下拉框\)](/前端组件/hlsCombobox.md)
* [5.2 hlsDataSource\(数据源\)](/前端组件/hlsDataSource.md)
* [5.3 hlsMaskedTextBox\(文本框\)](/前端组件/hlsMaskedTextBox.md)
* [5.4 hlsPage\(分页控件\)](/前端组件/hlsPage.md)
* [5.5 hlsTextArea\(文本域\)](/前端组件/hlsTextArea.md)
* [5.6 hlsTlEdit\(多语言\)](/前端组件/hlsTlEdit.md)
* [5.7 hlsDatePicker\(日期选择框\)](/前端组件/hlsDatePicker.md)
* [5.8 hlsDateTimePicker\(时间选择框\)](/前端组件/hlsDateTimePicker.md)
* [5.9 hlsLov\(lov选择框\)](/前端组件/hlsLov.md)
* [5.10 hlsToolBar\(底部菜单栏\)](/前端组件/hlsToolBar.md)
* [5.11 TabStrip\(sheet页切换卡\)](/前端组件/tabStrip.md)
* [5.12 hlsForm\(表单\)](/前端组件/hlsForm.md)
* [5.13 hlsCombobox\(下拉框\)](/前端组件/hlsCombobox.md)
* [5.14 hlsCheckBox\(复选框\)](/前端组件/hlsCheckBox.md)
* [5.15 hlsGrid\(表格\)](/前端组件/hlsGrid.md)
* [5.16 dataSource\(数据源\)](/前端组件/dataSource.md)
* [5.17 hlsGridBox\(表格\)](/前端组件/hlsGridBox.md)
* [5.18 hlsNumericTextBox\(数字框\)](/前端组件/hlsNumericTextBox.md)
* [5.19 hlsNavigationBar\(导航栏\)](/前端组件/hlsNavigationBar.md)
* VI. 框架功能描述
* [6.1 计划任务](/框架功能描述/计划任务.md)
* [6.2 RabbitMq消息队列](/后端开发/RabbitMq消息队列.md)
* [6.3 应用服务部署\(tomcat/weblogic\)](/框架功能描述/deployment.md)
* [6.4 合同文本生成](/框架功能描述/docx4j.md)
* [6.5 Excel导入导出](/框架功能描述/jad.md)
* [6.6 redis安装和部署](/后端开发/redis.md)
* [6.7 工作流功能说明](/后端开发/activiti-helper.md)
* [6.8 工作流开发指南](/后端开发/activiti.md)
* [6.9 工作流demo](/后端开发/activiti_demo.md)
* [6.10 流程设计](/后端开发/activiti_editor_helper.md)
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment