Git常用命令

基本概念

• 工作区： 正在编辑文件所在文件夹
• 暂存区：使用git add后会把工作的区的内容加入到暂存区
• 本地仓库：使用git commit会把暂存的内容提交到仓库中。
• 远程仓库：跟本地仓库进行交互，用于代码保护和多人协作开发。
• 指针：在仓库中的文件可以有多个提交版本，每个版本有一个唯一的编号，历史提交以链表形式组织。HEAD指针指向的文件为仓库的当前版本提交，可以修改HEAD指针指向任何一个版本。
• 分支：开发过程中可以以一个位置为起点，分叉并行开发多个模块，分叉后的每个线路就是分支。后面会详细介绍。
  

基本命令

• 初始化git项目
  将一个项目文件夹初始化：
  git init

• 将工作区的文件添加到暂存区
  git add readme.txt

• 将暂存区的文件提交到版本库中
  git commit -m "commit first version"

• 查看当前文件修改情况，是否提交等信息。
  git status

• 查看工作区文件与暂存区或版本库的最新文件的修改。
  git diff readme.txt

• 查看提交的历史
  每次提交都有一个版本号。可以使用git log —pretty=oneline简化输出。
  git log

• 查看命令历史
  git relog

文件恢复回退

• 对工作区文件的操作，把暂存区或版本库的文件的对应最新版本替换掉工作区的文件
  git checkout -- readme.txt

• 对版本库HEAD指针的操作
  git reset --hard HEAD^
  同时会清空暂存区的内容，但不会直接替换工作区的内容，该操作需要checkout完成。可以直接reset到指定的版本号，如git reset --hard 368164

• 从版本库中删除该文件，需要commit
  git rm test.txt

分支管理

HEAD为版本库当前指针的指向，默认为指向master分支。

• 新建分支

git checkout -b dev
在当前的分支上(HEAD所在的分支)建立一个新分支，名字为dev，相当于下面两条命令

1
2

git branch dev
git checkout dev

• 查看当前分支情况
  git branch

• 合并分支

1
2

git checkout master
git merge dev

也可以在特定分支上建立分支，比如在上面建立的dev分支再建立分支：
git checkout -b newBranch dev

将dev合并到master，也就是将master移动到dev。
注意如果两个分支都有不同的提交，merge则会发生冲突，需要maually解决冲突。
默认merge会采用fast-forward方式，也就是直接将master指向dev位置，之后如果删除dev分支则会丢失这个历史信息，也就是看起来像没有做过分支一样，可以通过--no-ff强制做一次commit。

• 查看合并分支图
  git log --graph

• 删除分支
  git branch -d dev

• 保存当前工作区
  git stash

more..参考教程.

远程仓库(版本库)

GitHub为一个免费的远程仓库，提供代码托管服务，不过你的仓库是任何人都可以访问的，另一个提供安全托管的是bitbucket，如果个人或小团队需要开发产品，可以使用bitbucket，当然也可以自己建立git服务器。部分参考git远程操作详解.

git clone

git clone git@..(远程仓库地址) <在本地的名字>
克隆远程仓库到本地。

下面实现的功能是一样的：

1

git clone REMOTEURL foo

1
2
3
4
5

mkdir foo
cd foo
git init
git remote add origin REMOTEURL
git pull origin master

git remote

• git remote <-v>
  列出所有以添加的远程仓库，参数-v可以查看远程仓库的地址。

1
2
3

(env)MacBook-Air-2:xxx chenzb$ git remote -v
origin	https://plusarc@bitbucket.org/xxx/xxx.git (fetch)
origin	https://plusarc@bitbucket.org/xxx/xxx.git (push)

• git remote add <远程仓库在本地的名字> <远程仓库地址>
  添加远程仓库，关联到当前目录的git仓库(一个本地仓库)。
  git remote add origin git@..(远程仓库地址)

• git remote rm <远程仓库在本地的名字>
  删除远程仓库关联。

• git remote rename <原远程仓库在本地的名字> <新名字>
  重命名远程仓库。

git fetch

这里要注意远程分支，远程分支跟本地分支是独立的没有直接的关联关系，名字不同与本地分支为远程仓库在本地的名字/分支名。远程分支和本地分支可以有相同的名字，如origin/dev和dev，但它们没有直接的关系，除非把它们关联起来。

前面使用git branch查看分支情况，直接只用只是获得本地的分支。
git branch <-r> # 查看远程分支
git branch <-a> # 查看所有分支

1
2
3
4
5
6
7
8
9

git branch
* master

chenzb$ git branch -a
* master
  remotes/origin/xxx -> origin/master
  remotes/origin/xxx
  remotes/origin/xxx
  remotes/origin/xxx

我们可以通过git fetch将远程分支取回本地，一般用来查看其他人的进程，取回代码对本地都存在于origin/***分支中，对本地开发的代码没有影响。
git fetch <远程仓库名(在本地的)>，这个命令会将取回远程仓库所有分支的更新。
git fetch <远程仓库名(在本地的)> <分支名>，可以取回特定分支的更新：

git fetch origin master，取回origin仓库的master分支，在本地为origin/master分支，不影响本地的master分支。所取回的远程分支在本地仓库都是用远程仓库名/分支名的形式读取。

在取回远程仓库的更新以后，可以在它的基础上，使用git checkout命令建立一个新的分支。
git checkout -b newBranch origin/master

另外还可以使用git merge或git rebase在本地分支上合并远程分支（合并到当前分支，也就是HEAD所在的分支）。

git merge origin/master，表示在当前分支上合并origin/master远程分支。

git pull

git pull命令的作用是，取回远程仓库的某个分支的更新，再与本地的指定分支合并。
git pull <远程仓库名> <远程分支名>:<本地分支名>
比如取回origin仓库的next分支，与本地的master分支合并：
git pull origin next:master
如果是与当前分支合并，则可以省略本地分支名。
git pull orign next

git pull其实相当于git fetch取回分支更新，然后进行merge。

1
2

git fetch origin
git merge origin/next

本地分支和远程分支可以建立关联，也就是追踪关系(tracking)。
在git clone的时候，所有本地分支默认与远程仓库的同名分支建立追踪关系，也就是本地的master分支会自动追踪origin/master分支。

我们可以手动建立追踪关系：
git branch --set-upstream master origin/next

如果当前分支与远程分支存在追踪关系，git pull可以省略远程分支名：
git pull origin
上面命令表示当前本地分支自动与对应的origin仓库的追踪分支（remote-tracking branch）进行合并。

如果当前分支只有一个追踪分支，连远程仓库名都可以省略。
git pull

如果合并需要采用rebase模式，可以shiyong--rebase选项。

默认情况下，远程仓库删除了某个分支后，本地git pull不会删除对应的本地分支。可以通过-p参数删除本地对于远程分支。
git pull -p

git push

git push用于将本地分支的更新推送到远程仓库，格式与git pull类似。
git pull <远程仓库名> <本地分支名>:<远程分支名>
格式都为<来源>:<目的地>

如果省略远程分支(不是本地的哪个远程分支，而是真正在远程仓库的分支)名，同样会推送到存在追踪关系的远程分支，如果该远程分支不存在，则会被新建。
git push origin master
表示将本地的master分支推送到origin仓库的master分支。

如果省略本地分支名，则表示删除指定的远程分支。
git push origin :master
等同于git push origin --delete master

如果当前分支与远程分支存在追踪关系，则本地分支和远程分支都可以省略。
git push origin
如果当前分支只有一个追踪分支，那么仓库名都可以省略：
git push

如果当前分支与多个仓库存在追踪关系，则可以使用-u选项指定一个默认仓库，这样后面就可以添加不任何参数进行git push，这样默认只推送当前分支。
git push -u origin master
上面命令将本地master分支推送到origin主机上的追踪分支，同时指定origin为默认主机。

多人协作

参考多人协作.

命令清单

参考常用 Git 命令清单

新建代码库

1
2
3
4
5
6
7
8

# 在当前目录新建一个Git代码库
$ git init

# 新建一个目录，将其初始化为Git代码库
$ git init [project-name]

# 下载一个项目和它的整个代码历史
$ git clone [url]

配置

Git的设置文件为.gitconfig，它可以在用户主目录下（全局配置），也可以在项目目录下（项目配置）。

1
2
3
4
5
6
7
8
9

# 显示当前的Git配置
$ git config --list

# 编辑Git配置文件
$ git config -e [--global]

# 设置提交代码时的用户信息
$ git config [--global] user.name "[name]"
$ git config [--global] user.email "[email address]"

增加/删除文件

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

# 添加指定文件到暂存区
$ git add [file1] [file2] ...

# 添加指定目录到暂存区，包括子目录
$ git add [dir]

# 添加当前目录的所有文件到暂存区
$ git add .

# 删除工作区文件，并且将这次删除放入暂存区
$ git rm [file1] [file2] ...

# 停止追踪指定文件，但该文件会保留在工作区
$ git rm --cached [file]

# 改名文件，并且将这个改名放入暂存区
$ git mv [file-original] [file-renamed]

代码提交

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

# 提交暂存区到仓库区
$ git commit -m [message]

# 提交暂存区的指定文件到仓库区
$ git commit [file1] [file2] ... -m [message]

# 提交工作区自上次commit之后的变化，直接到仓库区
$ git commit -a

# 提交时显示所有diff信息
$ git commit -v

# 使用一次新的commit，替代上一次提交
# 如果代码没有任何新变化，则用来改写上一次commit的提交信息
$ git commit --amend -m [message]

# 重做上一次commit，并包括指定文件的新变化
$ git commit --amend [file1] [file2] ...

分支

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39

# 列出所有本地分支
$ git branch

# 列出所有远程分支
$ git branch -r

# 列出所有本地分支和远程分支
$ git branch -a

# 新建一个分支，但依然停留在当前分支
$ git branch [branch-name]

# 新建一个分支，并切换到该分支
$ git checkout -b [branch]

# 新建一个分支，指向指定commit
$ git branch [branch] [commit]

# 新建一个分支，与指定的远程分支建立追踪关系
$ git branch --track [branch] [remote-branch]

# 切换到指定分支，并更新工作区
$ git checkout [branch-name]

# 建立追踪关系，在现有分支与指定的远程分支之间
$ git branch --set-upstream [branch] [remote-branch]

# 合并指定分支到当前分支
$ git merge [branch]

# 选择一个commit，合并进当前分支
$ git cherry-pick [commit]

# 删除分支
$ git branch -d [branch-name]

# 删除远程分支
$ git push origin --delete [branch-name]
$ git branch -dr [remote/branch]

标签

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

# 列出所有tag
$ git tag

# 新建一个tag在当前commit
$ git tag [tag]

# 新建一个tag在指定commit
$ git tag [tag] [commit]

# 删除本地tag
$ git tag -d [tag]

# 删除远程tag
$ git push origin :refs/tags/[tagName]

# 查看tag信息
$ git show [tag]

# 提交指定tag
$ git push [remote] [tag]

# 提交所有tag
$ git push [remote] --tags

# 新建一个分支，指向某个tag
$ git checkout -b [branch] [tag]

查看信息

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48

# 显示有变更的文件
$ git status

# 显示当前分支的版本历史
$ git log

# 显示commit历史，以及每次commit发生变更的文件
$ git log --stat

# 显示某个commit之后的所有变动，每个commit占据一行
$ git log [tag] HEAD --pretty=format:%s

# 显示某个commit之后的所有变动，其"提交说明"必须符合搜索条件
$ git log [tag] HEAD --grep feature

# 显示某个文件的版本历史，包括文件改名
$ git log --follow [file]
$ git whatchanged [file]

# 显示指定文件相关的每一次diff
$ git log -p [file]

# 显示指定文件是什么人在什么时间修改过
$ git blame [file]

# 显示暂存区和工作区的差异
$ git diff

# 显示暂存区和上一个commit的差异
$ git diff --cached [file]

# 显示工作区与当前分支最新commit之间的差异
$ git diff HEAD

# 显示两次提交之间的差异
$ git diff [first-branch]...[second-branch]

# 显示某次提交的元数据和内容变化
$ git show [commit]

# 显示某次提交发生变化的文件
$ git show --name-only [commit]

# 显示某次提交时，某个文件的内容
$ git show [commit]:[filename]

# 显示当前分支的最近几次提交
$ git reflog

远程同步

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

# 下载远程仓库的所有变动
$ git fetch [remote]

# 显示所有远程仓库
$ git remote -v

# 显示某个远程仓库的信息
$ git remote show [remote]

# 增加一个新的远程仓库，并命名
$ git remote add [shortname] [url]

# 取回远程仓库的变化，并与本地分支合并
$ git pull [remote] [branch]

# 上传本地指定分支到远程仓库
$ git push [remote] [branch]

# 强行推送当前分支到远程仓库，即使有冲突
$ git push [remote] --force

# 推送所有分支到远程仓库
$ git push [remote] --all

撤销

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27

# 恢复暂存区的指定文件到工作区
$ git checkout [file]

# 恢复某个commit的指定文件到工作区
$ git checkout [commit] [file]

# 恢复上一个commit的所有文件到工作区
$ git checkout .

# 重置暂存区的指定文件，与上一次commit保持一致，但工作区不变
$ git reset [file]

# 重置暂存区与工作区，与上一次commit保持一致
$ git reset --hard

# 重置当前分支的指针为指定commit，同时重置暂存区，但工作区不变
$ git reset [commit]

# 重置当前分支的HEAD为指定commit，同时重置暂存区和工作区，与指定commit一致
$ git reset --hard [commit]

# 重置当前HEAD为指定commit，但保持暂存区和工作区不变
$ git reset --keep [commit]

# 新建一个commit，用来撤销指定commit
# 后者的所有变化都将被前者抵消，并且应用到当前分支
$ git revert [commit]

classpath指定多个路径

遇到java项目运行时classpath指定的问题，记录一下，运行java程序时通过-cp指定引用的class的路径，包括pacakage和jar包，需要注意的是：

• 如果需要添加多个路径是，需要使用-cp "path1:path2"这样把路径包装起来，注意linux下分隔符为:，windows下分隔符为;。
• 如果需要引用多个jar包，通配符要用*，而不是*.jar。

Windows下：

1

java -cp "./bin;./lib/*" suggestion.Main

Linux下：

1

java -cp "./bin:./lib/*" suggestion.Main

下面的命令是无效的：

1
2
3
4
5

# 多个路径时需要包装起来，下面是非法的表述
java -cp ./bin:./lib/*.jar suggestion.Main

# 无法引入所需要的jar包
java -cp "./bin:./lib/*.jar" suggestion.Main

Java中的时间格式化

通过java.util.Date我们可以简单的获取当前时间：
Data date = new Date()
通过Data对象我们可以获取很多关于目前时间的信息和操作方法，其中getTime()方法可以获得当前时间的毫秒数，与System.currentTimeMills()方法相同。

Date类提供的一些方法：

1
2
3
4

boolean after(Date date)
boolean before(Date date)
int compareTo(Date date) // equal-0, before-minus
long getTime()

很多时候我们需要将时间以某种特定格式输出或使用，这是我们可以使用java.text.SimpleDateFormat类。

1
2

SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd-HH:mm:ss.SSS");
String currentTime = sdf.format(new Date());

其中yyyy等对应着时间里的元素，具体如下：

SimpleDateFormat除了可以将Date时间格式化，还提供parse()方法将字符串解析为Date。

1
2
3

SimpleDateFormat sdf = new SimpleDateFormat ("yyyy-MM-dd:hh:mm");
String time = "2015-02-02:08:23";
Date date = sdf.parse(time);

另外如果需要设置时间等操作，可以使用Calendar类，这里不再进行扩展。

参考《重构—改善既有代码的设计》(《Refactoring—Improving the Design of Existing Code》).

重构(Refactoring)

所谓重构是这样一个过程：在不改变代码外在行为的前提下，对代码做出修改，以改进程序的内部结构。本质上说，重构就是在代码写好之后改进它的设计。

『在代码写好后改进它的设计』，似乎不是合理的方式，按照目前对软件开发的理解，我们要相信先设计再编码。但是在开始是很难完全预测后面可能会出现的变更，在设计前期使用模式常常导致过度工程(over-engineering)，随着时间流逝，人们不断修改代码，则会导致系统原来的设计不可避免的混乱。

重构则与此相反。即使目前是一堆混乱的代码，我们也可以借由重构将其加工成设计良好的代码。重构的目的是使软件更容易被理解和修改。

重构定义：

• 名词：对软件内部结构的一种调整，目的是在不改变软件可观察行为的前提下，提高其可理解性，降低其修改成本。
• 动词：使用一系列重构手法，在不改变软件可观察行为的前提下，调整其结构。

使用重构技术开发软件时，你应该把时间分配给两种截然不同的行为：添加新功能，以及重构。添加新功能时，你不应该修改既有代码，只管添加新功能，通过测试。重构时就不能同时添加新功能。

Why refactoring

• 重构改进软件设计
  如果没有重构，程序的设计会逐渐腐败变质。

• 重构是代码更容易理解
  所谓程序设计，很大程度上就是与计算机交谈。很多时候我们需要补上或修改想要它做什么。而这种编程模式的核心就是『准确说出我想要的』，让代码更易读。

• 重构帮助找到bug

• 重构提高编程速度

系统当下的行为，只是故事的一部分。如果只是为今天工作，明天可能无法继续下去。重构是一条摆脱困境的道路。

下面的程序将会使改动困难重重，导致代码僵化并死亡：

• 难以阅读的程序，难以修改
• 逻辑重复的程序，难以修改
• 添加新行为时需要修改已有代码的程序，难以修改
• 带复杂条件逻辑的程序，难以修改

我们希望程序：（1）容易阅读 （2）所有逻辑都只在唯一的位置指定，没有重复 （3）新的改动不会危及现有行为 （4）尽可能简单表达条件逻辑、

重构可以帮助我们在不改变程序行为的前期下使其具有上述美好性质，使我们更能够继续保持高速开发。

When refactoring

第一次做某件事尽管去做；第二次做类似的事如果产生反感，但还是可以去做；第三次再做类似的事，你就应该重构，

• 添加功能时重构
  如果不能轻松天骄所需要的新功能

• 修补错误时重构
  如果难以找出程序的bug。

• 复审代码时重构

Refactoring and Design

重构肩负一项特殊使命：它和设计彼此互补。如果没有重构，你就必须保证预先做出的设计正确无误，但这个难度太大了，过度的预先设计往往反而会导致程序的难以编写。如果选择重构，问题的重点就转变了。你仍然可以预先设计，但是不必找到正确的解决方案（事实上也是不可能的），而是一个足够合理的解决方案就够了。

预先设计往往要预测后面可能的变化，力求得到灵活的解决方案。但是很难预测所有的变化，变化其实可能出现系统各处，如果在所有可能出现变化的地方都建立起灵活性，则往往需要建立许多中间层，反而使系统复杂且难以理解和维护。如果最后发现所有这些灵活性其实毫无必要，才是最大的失败。

重构可以带来更简单的设计，同时不损失灵活性，这也降低了设计过程的难度，减轻设计压力。

Some pricinples:

• 如果你发现自己需要为程序添加一个特性，而代码结构使你无法很方便地达成目的，那就先重构哪个程序，是特性的添加比较容易进行，然后在添加特性。
• 重构的第一步：建立一组可靠的测试机制，这些测试必须有自我校验能力。
• 好的代码应该清楚表达出自己的功能，变量名称是代码清晰的关键。
• 尽量不要使用临时变量，它们会导致大量参数传来传去，难以追踪，导致冗长的函数。

基本介绍

Log4j基本的jar包为log4j-core-版本.jar和log4j-api-版本.jar，一般导入这两个jar包足以满足基本使用，其他jar包的功能参考官网。

在程序中我们可以通过下面的方式获得一个logger,

1

Logger logger = LogManager.getLogger("name of logger");

其中logger_name是在配置文件中指定的，如果没有配置文件或者没有找到对应名字的logger，则会使用默认的logger: 日志级别为ERROR，输出为控制台。

重点要说明的是日志的级别以及如果配置Logger。Log4j默认有如下级别：trace, debug, info, warn, error, fatal，重要级别依次增加。当然也可以自定义级别，不过一般这些默认级别足够使用，而且也利于扩展和迁移。

• trace一般用于记录程序进行所有的进展信息，数量一般比较多。
• debug一般用于调试输出调试部分所需要查看的信息。
• info一般用于输出重要的关注的信息。
• warn一般用于输出程序可能存在潜在的问题和提示。
• error用于输出错误信息。
• fatal同样用于输出错误信息，一般是程序遇到致命错误需要停止，输出相关信息。

基本使用如下：

1
2
3
4
5
6
7
8
9
10
11
12

import org.apache.logging.log4j.LogManager;
import org.apache.logging.log4j.Logger;

public class LogTest {
	private Logger logger = LogManager.getLogger(this.class.getName());
	
	public void testLog() {
		logger.trace("this is trace");
		logger.info("important info");
		logger.error("some error happen");
	}
}

如果直接运行上面的代码，trace和info的信息将被丢弃，error及以上信息会被输出到控制台，这时Log4jD的默认配置。

配置文件

我们可以通过配置文件配置logger按照我们所需要的方式工作。配置文件可以为xml,ymal和json格式，一般放在src目录下，如log4j2-test.xml。这里我们介绍基于xml的配置文件，其他文件格式也是类似的，一个简单的配置文件如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51

<?xml version="1.0" encoding="UTF-8"?>

<configuration status="error">
    <!--定义appenders-->
    <appenders>
        <!--appender 1-->
        <Console name="Console" target="SYSTEM_OUT">
        	<ThresholdFilter level="info" onMatch="ACCEPT" onMismatch="DENY"/>
            <PatternLayout pattern="%msg%xEx%n"/>
        </Console>
        
        <!--appender 2-->
        <Console name="allConsole" target="SYSTEM_OUT">
            <PatternLayout pattern="%msg%xEx%n"/>
        </Console>
        
        <!--appender 3-->
        <File name="alllog" fileName="/Users/chenzb/Desktop/logtest/alllog.log" append="false">
            <PatternLayout pattern="%msg%xEx%n"/>
        </File>
        
        <!--appender 4-->
        <File name="keyinfo" fileName="/Users/chenzb/Desktop/logtest/keyinfo.log" append="true">
        	<ThresholdFilter level="info" onMatch="ACCEPT" onMismatch="DENY"/>
            <PatternLayout pattern="%msg%xEx%n"/>
        </File>
        
        <RollingFile name="rolllog" fileName="Users/chenzb/Desktop/logtest/keyinfo.log" append="true""
                     filePattern="log/$${date:yyyy-MM}/app-%d{MM-dd-yyyy}-%i.log.gz">
            <PatternLayout pattern="%d{yyyy-MM-dd 'at' HH:mm:ss z} %-5level %class{36} %L %M - %msg%xEx%n"/>
            <SizeBasedTriggeringPolicy size="10MB"/>
        </RollingFile>
    </appenders>
    
    <!--定义logger-->
    <loggers>
        <!--默认logger-->
        <root level="trace">
        	<!--这个logger的appender-->
            <appender-ref ref="alllog"/>
        </root>
        
        <!--一个带名字的特定的logger-->
        <logger name="suggestion" level="trace" additivity="false">
        	<!--这个logger的appender-->
        	<appender-ref ref="alllog"/>
            <appender-ref ref="keyinfo"/>
            <appender-ref ref="Console"/>
        </logger>
    </loggers>
</configuration>

标签声明这是一个配置文件。

定义appenders

首先我们定义所需要的appenders，可以声明任意数量的所需要的appenders，appender记录了日志的输出形式，输出地点，格式，级别过滤等信息。如：

常用的几种输出形式有Console（输出到控制台），File（输出到文件），RollingFile（超过size自动存为压缩文件）。

1
2
3
4

<Console name="Console" target="SYSTEM_OUT">
        	<ThresholdFilter level="info" onMatch="ACCEPT" onMismatch="DENY"/>
            <PatternLayout pattern="%msg%xEx%n"/>
</Console>

这时一个输出到控制台的appender，名字是Console，我们在程序中用于通过logger名字获得logger所使用的参数即是这个参数，目的地是SYSTEM_OUT。另外我们可以通过<ThresholdFilter>定义过滤器，这里我们希望过滤掉info以下的信息，也就是onMismatch，操作是直接拒绝，info及以上的信息accept。也就是只会有info以上的信息会被输出到SYSTEM_OUT。输出的格式为可以通过定义，info，error的参数标签为%msg。更多的可以定义输出代码位置、时间、级别等信息：

1

<PatternLayout pattern="%d{yyyy-MM-dd 'at' HH:mm:ss z} %-5level %class{36} %L %M - %msg%xEx%n"/>

下面是另一个输出到文件的appender：

1
2
3
4

<File name="keyinfo" fileName="/Users/chenzb/Desktop/logtest/keyinfo.log" append="true">
        	<ThresholdFilter level="info" onMatch="ACCEPT" onMismatch="DENY"/>
            <PatternLayout pattern="%msg%xEx%n"/>
</File>

可以通过append属性指定是否为追加方式。

定义loggers

定义appender后，我们可以定义logger，也就是将会在程序中直接使用的logger的配置。

1
2
3
4
5
6

<logger name="suggestion" level="trace" additivity="false">
        	<!--这个logger的appender-->
        	<appender-ref ref="alllog"/>
            <appender-ref ref="keyinfo"/>
            <appender-ref ref="Console"/>
</logger>

这里定义了一个logger，名字为suggestion(用来在程序获得这个logger的实例)，level用于制定这个logger的基本级别，additivity用来指定是否重叠输出，需要注意的是info信息由于级别高于trace，所以它同时也是trace信息，如果additivity为true，则这个info信息将会被输出两次，一次作为info信息，一次trace信息。将additivity设置为false则该信息则只会以其满足的最高级别输出一次。

对于这个logger，我们使用了三个appender，也就是这个logger所获得信息将会被输出到这个三个appender，再由appender具体根据其配置过滤以及格式等信息输出。

最终在程序我们可以通过获得该logger的实例：

1

private Logger logger = LogManager.getLogger("suggestion");

另外如果在配置文件中没有名字为”suggestion”的logger，如果定义了root logger(也就是默认logger)，则会使用root logger，如果没有定义，则会使用Log4j默认配置(只输出error及以上信息到控制台)。

更多使用参考Apache Log4j官网。