Commit 34d30489 authored by JingChao's avatar JingChao

'wjc'

parents c2cfb939 d010e340
# 安卓环境配置
## 开发工具准备
### android-studio(安卓打包环境)
**注:**前期开发可不必安装
#### android-studio(安卓打包环境)
* 1.1android-studio下载
[官网下载android-studio](https://developer.android.com/studio/index.html)
**注:**访问不通请访问http://android-studio.org/
* 1.2安装android-studio
参照此网站进行安装https://jingyan.baidu.com/article/7082dc1c707976e40b89bd5b.html
**注:** 安卓sdk的安装路径
![安卓sdk安装路径](/picture/android-sdk-path.png)
* 1.3配置安卓环境变量
在用户变量下配置 ANDROID_HOME ,PATH
![ANDROID_HOME](/picture/android-home.png)
![PATH](/picture/android-path.png)
* 1.4验证环境
cmd命令窗口输入`android`弹出如下图片所示,表上安装成功
![android](/picture/android.png)
* 1.5安装安卓不同版本的SDK
![](/picture/android-platform-1.png)
![](/picture/android-platform-2.png)
![](/picture/android-platform-3.png)
![](/picture/android-platform-4.png)
![](/picture/android-platform-5.png)
以及android6.0~4.0的`SDK Platform`,`Sources for Android SDK`
\ No newline at end of file
# 前端开发搭建
---
### I. 技术掌握
**注:APP项目采用Ionic+Angular1.0+Cordova进行开发,开发前请先熟悉下对应的语法**
* ionic 查看文档 http://www.runoob.com/ionic/ionic-tutorial.html
**注:**部分组件介绍不正确,具体查看官网
* angular 查看文档 http://www.runoob.com/angularjs/angularjs-tutorial.html
**注:**建议查看官网
* Cordova 插件使用 http://ngcordova.com/docs/plugins/
**注:**插件具体用法参照[github](https://github.com/),部分插件可能会出现版本兼容问题
### II. 环境搭建
* 1.0`git clone`下载对应的源码
```
│ .bowerrc
│ .editorconfig
│ .gitignore (git忽略文件)
│ bower.json (bower配置)
│ gulpfile.js (gulp集成工具配置)
│ ionic.config.json (ionic项目配置)
│ ionic.project
│ package.json
│ README.md (项目README,请在此处写上项目开发的注意信息,方便团队协同)
├─app
│ │ app.js (app核心js)
│ ├─config (配置文件)
│ ├─img (图片资源)
│ ├─pages (功能页面)
│ │ ├─applications (主页功能)
│ │ ├─charts (报表)
│ │ ├─login (登录页)
│ │ ├─myInfo (我的)
│ │ ├─tab (tab)
│ │ └─tools (工具)
│ ├─scripts (公用js)
│ ├─scss (公用sscc)
│ └─theme
│ app.core.scss (页面全部sscc)
├─hooks
├─plugins(插件)
├─publish
├─res
├─resources(图表和启动页)
└─www
index.html
```
* 2.0 搭建环境
* 项目根目录下执行`cnpm install`,出现以下内容表示下载成功
![](/picture/cnpm-install.png)
此时文件夹中会新增`node_modules`文件夹 此文件夹下包含node.js的资源文件
* 项目根目录下执行`bower install`,出现以下内容表示下载成功
![](/picture/bower-install.png)
此时`app`文件夹中会新增`lib`文件夹,里面包函了本次项目使用的资源
* 项目根目录下执行`gulp build-dev`,构建开发环境(项目代码会进行合拼压缩进入`www`文件夹下)
**注:** gulp命令的使用请查考 [gulpfile.js](/ionic/gulpjs.md)
![](/picture/gulp-build-dev2.png)
* 项目根目录下执行`ionic serve`运行代码 出现一下则表示成功
![](/picture/ionic-serve.png)
浏览器端访问`http://localhost:8100/#/login`即可
\ No newline at end of file
# node环境配置
---
## 开发工具准备
### [node 6.0 及以上](/APP环境搭建/node.md#node)
### [android-studio(安卓打包环境)](/APP环境搭建/node.md#android)
**注:**前期开发可不必安装
## 软件安装
### [node安装及配置](id:node)
* 1.1.node官网下载对应版本
访问 https://nodejs.org/en/download/
![node下载](/picture/node.png)
* 1.2.安装node
参照地址 http://www.runoob.com/nodejs/nodejs-install-setup.html
![检查环境](/picture/node-v.png)
* 1.3.检查node环境配置
设置`NODE_PATH`,在系统变量值增加如下环境变量,变量值为nodejs安装目录下的`node_modules`
![环境变量](/picture/node-path.png)
* 1.4.检查npm是否安装
![npm环境](/picture/npm-v.png)
npm的使用请参参考 http://www.runoob.com/nodejs/nodejs-npm.html
**注:** *npm会从国外网站上下载资源,由于国内网络限制有些资源无法下载下来,我们采用淘宝的镜像解决此问题*
**运行`npm install -g cnpm registry=https://registry.npm.taobao.org`**
此后的**npm**命令可以使用 **cnpm**代替
* 1.5.安装全局的ionic
在cmd窗口执行 `npm install -g ionic@1.7.16`
安装完成后检查版本号
![ionic -v](/picture/ionic-v.png)
* 1.6.安装全局的gulp,bower,cordova
在cmd窗口执行 `npm install -g gulp bower@1.8.0 cordova@6.2.0`
![检查版本](/picture/gulp-bower-cordova.png)
\ No newline at end of file
# [车租易从这里开始](//车租易APP开发.md) # [车租易从这里开始](//车租易APP开发.md)
Git 地址 [http://hel.hand-china.com/app/hel-app-web.git](http://hel.hand-china.com/app/hel-app-web.git) Git 中台地址 [https://hel.hand-china.com/app/hel-app-service.git](https://hel.hand-china.com/app/hel-app-service.git)
Git 前台地址 [http://hel.hand-china.com/app/hel-app-web.git](http://hel.hand-china.com/app/hel-app-web.git)
## [一、后端开发规范](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)`
# 新开项目
本章节将引导您从零开始,创建一个可以运行的 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 下载源码,编译安装
\ No newline at end of file
<<<<<<< HEAD
# Git简明教程 # Git简明教程
*** ***
# 1. git四大域 # 1. git四大域
...@@ -248,3 +249,255 @@ git对文件的操作都是在四大域上进行的,文件可以在四大域 ...@@ -248,3 +249,255 @@ git对文件的操作都是在四大域上进行的,文件可以在四大域
- `git grep --cached 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`
>>>>>>> d010e34028884823ffc7d1e7a2456f2bda1ab7b5
# SVC及接口开发规范
***
* ### I. SVC文件创建
***
* 1.1 创建svc文件所在位置
***
SVC文件创建的所在位置是在项目的web目录下modules文件夹下创建。这里为了方便与便捷,可以直接复制现有的SVC文件,粘贴到指定目录下,然后rename一下即可进行开发编写。
![](/picture/svc.png)
* 1.2 svc文件命名规范
***
统一用小写的英文字母,数字和下划线的组合,不得包含汉字空格和特殊字符。
原则: 1)方便理解,见名之意。
​ 2)方便查找。
如图所示:
![](/picture/svc1.png)
***
* ### II. BM文件创建
***
* 2.1 创建BM文件所在位置
***
bm文件创建的所在位置是在项目的WEB-INF目录下classes文件夹下创建。这里为了方便与便捷,可以直接复制现有的bm文件,粘贴到指定目录下,然后rename一下即可进行开发编写。(ps:bm文件所在classes目录下位置要和svc所在modules目录下位置相同)
![](/picture/bm.png)
* 2.2 BM文件命名规范
***
统一用小写的英文字母,数字和下划线的组合,不得包含汉字空格和特殊字符。
原则: 1)方便理解,见名之意。
​ 2)方便查找。
如图所示:
![](/picture/bm1.png)
* ### III. SVC及接口开发
***
* 3.1 svc文件主要编写的内容
***
svc文件主要编写的内容是大致是关联对应的bm文件,执行对应的sql语句,如果有返回数据,则对返回的数据进行相关的处理和展示。
如图所示:![](/picture/svc2.png)
* 3.2 bm文件主要编写的内容
***
BM文件关联数据库,接口通过调用BM文件访问到数据库,执行脚本对数据进行处理,并返回相关数据。(个人感觉类似于hibernate)
BM 文件 可以是一个查表语句,也可以是一个调用数据库存储过程。
![](/picture/svc3.png)
parameters和fields用法:
1)parameters 用来传参的从svc传到bm里,如图:![](/picture/bm2.png)
2)fields 用来从bm传到svc,如图:![](/picture/bm3.png)
![](/picture/svc4.png)
* ### IV. 页面注册
***
当接口写完时,需要写一个注册脚本目录如图下所示:![](/picture/sql.png)
注册脚本写法如图下所示:![](/picture/sql1.png)
写完之后需要将脚本语句在拿到数据库中执行并且commit步骤如图下所示:![](/picture/sql2.png)
# Maven 使用手册
## 开发环境
1. ```JDK 1.8```
2. ```Maven 3.2.5```
## 下载及安装
1. 下载 [jdk1.8](http://www.oracle.com/technetwork/java/javase/downloads/index.html) 并安装
2. 下载 [Maven 3.2.5](http://maven.apache.org/download.html) 并解压
## 配置环境变量
### 配置jdk环境变量
1. 将字符串“`;C:\Program Files\Java\jdk1.8\bin`”添加到系统变量“Path”的末尾
2. 用户变量新建一个classpath变量并赋值"`.`"
3. 在cmd控制台中通过`java -version`来测试java环境变量是否配置正确
### 配置maven环境变量
1. 添加 M2_HOME、M2、MAVEN_OPTS 到环境变量中,使用系统属性设置环境变量。
* `M2_HOME=C:\Program Files\Apache Software Foundation\apache-maven-3.2.5`
* `M2=%M2_HOME%\bin`
* `MAVEN_OPTS=-Xms256m -Xmx512m`
2. 添加 M2 变量到系统“Path”变量中,添加字符串 “`;%M2%`” 到系统“Path”变量末尾
3. 在cmd控制台中通过`mvn --version`来测试mvn环境变量是否配置正确
## 常用命令
> | 命令 | 解释 |
> | -------- | -------- |
> | `mvn archetype:create` | 创建 Maven 项目 |
> | `mvn clean` | 清除目标目录中的生成结果 |
> | `mvn compile` | 编译源代码 |
> | `mvn test-compile` | 编译测试代码 |
> | `mvn test` | 运行应用程序中的单元测试 |
> | `mvn package` | 依据项目生成 jar,war 文件 |
> | `mvn install` | 在本地 Repository 中安装 jar,war |
> | `mvn eclipse:eclipse` | 生成 Eclipse 项目文件 |
> | `mvn site` | 生成项目相关信息的网站 |
## 创建maven项目
### 创建Maven的普通java项目
``` mvn archetype:generate -DgroupId=com.hand.app -DartifactId=项目名 -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false ```
### 创建Maven的Web项目
1. 进入命令行输入以下内容创建webapp项目:
* ``` mvn archetype:generate -DgroupId=com.hand.app -DartifactId=项目名 -DarchetypeArtifactId=maven-archetype-webapp -DinteractiveMode=false ```
* (补充:在该命令行后面加上`-X`可查看创建web项目的进度)
2. 进入工程目录(cd 项目名),使用以下命令将项目生产为eclipse项目`mvn eclipse:eclipse`
> | 命令 | 解释 |
> | -------- | -------- |
> | `mvn archetype:generate` | 固定格式 |
> | `-DgroupId` | 组织标识(包名) |
> | `-DartifactId` | 项目名称 |
> | `-DarchetypeArtifactId` | 指定ArchetypeId,maven-archetype-quickstart,创建一个Java Project;maven-archetype-webapp,创建一个Web Project |
> | `-DinteractiveMode` | 是否使用交互模式 |
## mvn编译执行项目
### 普通项目
* main目录的class:在项目根目录下运行命令`mvn clean compile`进行项目编译
* test目录下class:在项目根目录下运行`mvn clean test`进行测试
* 编译完成后在项目根目录下生成了`target`文件夹,里面存放了`class`文件
* 使用`mvn exec:java -Dexec.mainClass="com.hand.app.App"`运行App这个mainClass
### web项目
* `mvn tomcat:run` 启动tomcat,根据给定的端口号,在浏览器上输入`localhost:端口号/项目名/index.jsp`运行项目
## POM.xml文件
`<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
<modelVersion>4.0.0</modelVersion>` //当前POM模型的版本<br/>
`<groupId>SpringMVC</groupId>` //项目或者组织的唯一标志<br/>
`<artifactId>JspExam10105</artifactId>` //项目的通用名称<br/>
`<packaging>war</packaging>` //打包机制<br/>
`<version>0.0.1-SNAPSHOT</version>` //项目版本<br/>
`<name>JspExam10105 Maven Webapp</name>` //用户描述项目的名称<br/>
`<url>http://maven.apache.org</url>` //只是写明开发团队的网站,无关紧要<br/>
`<dependencies>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>3.8.1</version>
<scope>test</scope>` //指定当前依赖范围<br/>
`</dependency>
</dependencies>` //依赖关系<br/>
`<properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>` //项目字符为UTF-8<br/>
`</properties>` //为pom定义一些常量,在pom中的其它地方可以直接引用<br/>
`<build>
<finalName>SpringMVC</finalName>` //指定去掉后缀的工程名字<br/>
`<pluginManagement>
<plugins>
<plugin>
<groupId>org.apache.tomcat.maven</groupId>
<artifactId>tomcat8-maven-plugin</artifactId>
<version>2.3-SNAPSHOT</version>
</plugin>` //配置maven插件<br/>
`</plugins>
</pluginManagement>` //用于管理plugin<br/>
`<resources>
<resource>
<directory>src/main/java</directory>` //用于管理plugin<br/>
`<includes>
<include>**/*.properties</include>` //指定包含文件的patterns,符合样式并且在directory目录下的文件将会包含进project的资源文件<br/>
`<include>**/*.xml</include>
</includes>
<filtering>false</filtering>` //指定是否将filter文件(即上面说的filters里定义的```*.property```文件)的变量值在这个resource文件有效<br/>
`</resource>
<resource>
<directory>src/main/resources</directory>
<includes>
<include>**/*.properties</include>
<include>**/*.xml</include>
</includes>
<filtering>false</filtering>
</resource>
</resources>` //描述工程中资源的位置<br/>
`</build>
</project>`
...@@ -4,70 +4,51 @@ ...@@ -4,70 +4,51 @@
--- ---
* I. 开发环境准备 * ### I. 开发环境准备
* [1.1.git的使用](/git-guide.md)
* [1.1 Git 使用](/git-guide.md "git指令") * [1.2.Maven的使用](/maven.md)
* [1.2 Maven 使用](/maven.md "maven使用") * [1.3.中台开发环境的搭建](/create-project.md)
* [1.3 开发环境搭建](/project-create.md) * [1.4.node的安装及配置](/APP环境搭建/node.md)
* [1.4 更新项目的HEL依赖版本](/project-update.md) * [1.5.android-studio的安卓](/APP环境搭建/android-studio.md)
* [1.5 Liquibase](/liquibase-use.md) ** 注:**前期开发可不必安装
* [1.6.前段开发环境的搭建](/APP环境搭建/ionic-project.md)
* II. 项目开发规范
* [2.1 项目开发规范](/codeStyle.md#backEndDev) * ### II. 项目开发规范
* [2.2 编码规范](/codeStyle.md#backEndName)
* 2.3 Checkstyle * [2.1 后端开发规范](/codeStyle.md)
* [2.2 前端开发规范](/ionic/ionic-code-style.md)
* III. 后端开发
* ### III. 后端开发
* [3.1 后端开发说明\(1.0\)](/后端开发/dev-flow.md)
* [3.2 用户安全策略](/后端开发/user-security-strategy.md) * [3.1 后端开发说明\(1.0\)](/hmap.md)
* [3.3 审计](/后端开发/audit.md) * [3.2 SVC及接口开发规范\(1.0)](/ionic/svc.md)
* [3.4 锁机制](/后端开发/lock.md)
* [3.5 日志管理](/后端开发/elk.md) * ### IV. 前端页面开发
* [3.6 代码生成器](/后端开发/code-generator.md)
* [3.7 跨域访问](/后端开发/3.24-cors.md) * [4.1 前端开发说明](/前端开发/ionic-instruction.md)
* [3.8 消息机制](/后端开发/消息机制.md) * 4.2 字段级通用方法
* 4.3 窗口级通用方法
* IV. 前端JavaScript开发 * 4.4 锁屏和解屏通用方法
* 4.5 头行保存
* [4.1 前端开发说明 \(1.0\)](/front-kendoui.md) * ### V. 前端框架配置讲解(目录)
* [4.2 字段级通用方法](/common-field-javascript.md)
* [4.3 窗口级通用方法](/common-window-javascript.md) * [5.1 app目录](/ionic/app.md)
* [4.4 锁屏和解屏通用方法](/common-mask-javascript.md) * [5.2 hooks](/ionic/hooks.md)
* [4.5 头行保存](/前端组件/头行保存.md) * [5.3 node_modules](/ionic/node-modules.md)
* [5.4 platforms](/ionic/platforms.md)
* V. 前端UI开发 * [5.5 plugins](/ionic/plugins)
* [5.6 publish](/ionic/publish.md)
* [5.1 hlsCombobox\(下拉框\)](/前端组件/hlsCombobox.md) * [5.7 resources](ionic/resources)
* [5.2 hlsDataSource\(数据源\)](/前端组件/hlsDataSource.md) * [5.8 gulpfile.js](ionic/gulpfile.md)
* [5.3 hlsMaskedTextBox\(文本框\)](/前端组件/hlsMaskedTextBox.md)
* [5.4 hlsPage\(分页控件\)](/前端组件/hlsPage.md) * ###VI. APP打包及发布
* [5.5 hlsTextArea\(文本域\)](/前端组件/hlsTextArea.md)
* [5.6 hlsTlEdit\(多语言\)](/前端组件/hlsTlEdit.md) * [6.1 修改配置文件](/ionic/profile.md)
* [5.7 hlsDatePicker\(日期选择框\)](/前端组件/hlsDatePicker.md) * [6.2 更换APP图标及启动页](/ionic/start.md)
* [5.8 hlsDateTimePicker\(时间选择框\)](/前端组件/hlsDateTimePicker.md) * [6.3 安卓打包](/ionic/android.md)
* [5.9 hlsLov\(lov选择框\)](/前端组件/hlsLov.md) * [6.4 IOS打包](/ionic/ios.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.9 工作流开发指南](/后端开发/activiti_demo.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