幂等性定义（转发）

HTTP方法的幂等性是指一次和多次请求某一个资源应该具有同样的副作用。幂等性属于语义范畴，正如编译器只能帮助检查语法错误一样，HTTP规范也没有办法通过消息格式等语法手段来定义它，这可能是它不太受到重视的原因之一。但实际上，幂等性是分布式系统设计中十分重要的概念，而HTTP的分布式本质也决定了它在HTTP中具有重要地位。

1. 分布式事务 vs 幂等设计
为什么需要幂等性呢？我们先从一个例子说起，假设有一个从账户取钱的远程API（可以是HTTP的，也可以不是），我们暂时用类函数的方式记为：

bool withdraw(account_id, amount)

• withdraw的语义是从account_id对应的账户中扣除amount数额的钱；如果扣除成功则返回true，账户余额减少amount；如果扣除失败则返回false，账户余额不变。值得注意的是：和本地环境相比，我们不能轻易假设分布式环境的可靠性。一种典型的情况是withdraw请求已经被服务器端正确处理，但服务器端的返回结果由于网络等原因被掉丢了，导致客户端无法得知处理结果。如果是在网页上，一些不恰当的设计可能会使用户认为上一次操作失败了，然后刷新页面，这就导致了withdraw被调用两次，账户也被多扣了一次钱。如图1所示：
  

• 这个问题的解决方案一是采用分布式事务，通过引入支持分布式事务的中间件来保证withdraw功能的事务性。分布式事务的优点是对于调用者很简单，复杂性都交给了中间件来管理。缺点则是一方面架构太重量级，容易被绑在特定的中间件上，不利于异构系统的集成；另一方面分布式事务虽然能保证事务的ACID性质，而但却无法提供性能和可用性的保证。

• 另一种更轻量级的解决方案是幂等设计。我们可以通过一些技巧把withdraw变成幂等的，比如：

int create_ticket()
bool idempotent_withdraw(ticket_id, account_id, amount)

create_ticket的语义是获取一个服务器端生成的唯一的处理号ticket_id，它将用于标识后续的操作。idempotent_withdraw和withdraw的区别在于关联了一个ticket_id，一个ticket_id表示的操作至多只会被处理一次，每次调用都将返回第一次调用时的处理结果。这样，idempotent_withdraw就符合幂等性了，客户端就可以放心地多次调用。

基于幂等性的解决方案中一个完整的取钱流程被分解成了两个步骤：

1.调用create_ticket()获取ticket_id；
2.调用idempotent_withdraw(ticket_id, account_id, amount)。

虽然create_ticket不是幂等的，但在这种设计下，它对系统状态的影响可以忽略，加上idempotent_withdraw是幂等的，所以任何一步由于网络等原因失败或超时，客户端都可以重试，直到获得结果。如图2所示：

和分布式事务相比，幂等设计的优势在于它的轻量级，容易适应异构环境，以及性能和可用性方面。在某些性能要求比较高的应用，幂等设计往往是唯一的选择。

HTTP的幂等性

• HTTP协议本身是一种面向资源的应用层协议，但对HTTP协议的使用实际上存在着两种不同的方式：一种是RESTful的，它把HTTP当成应用层协议，比较忠实地遵守了HTTP协议的各种规定；另一种是SOA的，它并没有完全把HTTP当成应用层协议，而是把HTTP协议作为了传输层协议，然后在HTTP之上建立了自己的应用层协议。本文所讨论的HTTP幂等性主要针对RESTful风格的，不过正如上一节所看到的那样，幂等性并不属于特定的协议，它是分布式系统的一种特性；所以，不论是SOA还是RESTful的Web API设计都应该考虑幂等性。下面将介绍HTTP GET、DELETE、PUT、POST四种主要方法的语义和幂等性。

• HTTP GET方法用于获取资源，不应有副作用，所以是幂等的。比如：GET http://www.bank.com/account/123456，不会改变资源的状态，不论调用一次还是N次都没有副作用。请注意，这里强调的是一次和N次具有相同的副作用，而不是每次GET的结果相同。GET http://www.news.com/latest-news这个HTTP请求可能会每次得到不同的结果，但它本身并没有产生任何副作用，因而是满足幂等性的。

• HTTP DELETE方法用于删除资源，有副作用，但它应该满足幂等性。比如：DELETE http://www.forum.com/article/4231，调用一次和N次对系统产生的副作用是相同的，即删掉id为4231的帖子；因此，调用者可以多次调用或刷新页面而不必担心引起错误。

• 比较容易混淆的是HTTP POST和PUT。POST和PUT的区别容易被简单地误认为“POST表示创建资源，PUT表示更新资源”；而实际上，二者均可用于创建资源，更为本质的差别是在幂等性方面。在HTTP规范中对POST和PUT是这样定义的：

• POST所对应的URI并非创建的资源本身，而是资源的接收者。比如：POST http://www.forum.com/articles的语义是在http://www.forum.com/articles下创建一篇帖子，HTTP响应中应包含帖子的创建状态以及帖子的URI。两次相同的POST请求会在服务器端创建两份资源，它们具有不同的URI；所以，POST方法不具备幂等性。而PUT所对应的URI是要创建或更新的资源本身。比如：PUT http://www.forum/articles/4231的语义是创建或更新ID为4231的帖子。对同一URI进行多次PUT的副作用和一次PUT是相同的；因此，PUT方法具有幂等性。

• 在介绍了几种操作的语义和幂等性之后，我们来看看如何通过Web API的形式实现前面所提到的取款功能。很简单，用POST /tickets来实现create_ticket；用PUT /accounts/account_id/ticket_id&amount=xxx来实现idempotent_withdraw。值得注意的是严格来讲amount参数不应该作为URI的一部分，真正的URI应该是/accounts/account_id/ticket_id，而amount应该放在请求的body中。这种模式可以应用于很多场合，比如：论坛网站中防止意外的重复发帖。

总结

• 上面简单介绍了幂等性的概念，用幂等设计取代分布式事务的方法，以及HTTP主要方法的语义和幂等性特征。其实，如果要追根溯源，幂等性是数学中的一个概念，表达的是N次变换与1次变换的结果相同，有兴趣的读者可以从Wikipedia上进一步了解。

• 关于git换行符处理的问题，我查了一查，自己的设置中，global-config中设了autocrlf=false，systemwide中将autocrlf设成了true.
• 关于配置的作用域，systemwide>global>local。local没有配置，global会覆盖systemwide的配置，因此最终生效的是“autocrlf=false”。
• 这句的意思是“在提交与检出代码的时候均不对换行符进行转换”，这个设置是在当时入职时，参照wiki上配置的，然后并没有深入了解其作用。现在把根换行符相关的配置说明列在这里：

首先crlf是windows下的换行符，而lf是unix下的换行符。

autocrlf =true 表示要求git在提交时将crlf转换为lf，而在检出时将crlf转换为lf。  
autocrlf = false表示提交和检出代码时均不进行转换  
autocrlf = input 表示在提交时将crlf转换为lf，而检出时不转换  

• 我又检查了一下idea右下角那儿关于文件的换行符，使用的地crlf，，这表明当前使用的是CRLF换行符，而autocrlf又是false，这会使得代码仓库中出现混合换行符，git中另有一个配置项，名叫“safecrlf”默认值是“warn”，因此git在提交时会弹出关于这个问题的提示，然而我无知的忽略了它。。。——在某次操作中顺手将其设为了“不再提示”，这也是导致后来问题的一个原因。因为这么做的话，safecrlf的值就被改为了false.

• 因此，可以单击右下角这个换行符标志，将其改为“LF”，同时把全局配置改为autocrlf=input，以使仓库中只保留Unix换行符。

• 另外，git有一个safecrlf，默认是false，可以改成true，表示拒绝提交混合换行符的代码。当然这可能会造成烦人的提示，但对于windows下的特殊情况可以这样设置。它的具体配置含义如下：

  safecrlf = true 表示 拒绝提交包含混合换行符的文件
  safecrlf = false 表示 允许…
  safecrlf = warn 表示警告

IntelliJ换行CRLF, LF, CR的解释和默认设置

在window下开发有一个大坑，就是换行默认是CRLF，也就是回车换行，但是Linux下只有换行LF，这样代码提交后，会出现编译问题，所以最好的办法是在IntelliJ下设置默认为LF。首先我们先介绍CRLF，LF和CR这三种东西，CR是MAC老版本的做法，就是回车，但是后来的MAC系统统一换成LF了，LF是Linux下的做法，就是换行，这个做法比较自然，为什么要回车换行呢，是吧。微软采用的是CRLF，看上去好像是兼容了CR和LF，但是实际完全不是那么回事，就是回车并换行，好鸡肋啊，微软一直保持这种做法，开发人员大多在Linux下，所以对于开发人员来说还是比较坑的。下面介绍设置详解：

###第一步：File->Settings…

###第二步：Editor->Code Style

可以看到，默认是System-Dependent，这个其实还是很牛叉的，根据系统自动配置，但是你是windows系统，默认是CRLF，服务器是Linux，你就得自己换了。

我们设置成下面这样，保存就好了

创建文件时，就能看到默认是LF了

参考网址是IntelliJ的使用，不熟悉的话，可以看看，这个文档还是写的不错的，就是全是英文，对于英文不好的人来说，略坑。 
参考网址： [https://www.jetbrains.com/idea/help/configuring-line-separators.html](https://www.jetbrains.com/idea/help/configuring-line-separators.html)

Mysql的转义字符是”\”，即反斜杠，在INSERT语句中，如果被插入的文本中包含反斜杠，那么反斜杠会被吃掉。例如：

INSERT INTO tb (id,json) VALUES ('1','"person":"{\"name\":\"yp\",\"age\":\"25\"}"');

插入后，数据库中的记录中不会有“\”出现，它神秘的消失了。

解决方法: 在插入之前将字符串中的"\"替换成:"\\"即可。在Java中可以使用：str.replaceAll("\\\\","\\\\\\\\");

参考Mysql中文册: http://www.yesky.com/imagesnew/software/mysql/manual_Reference.html

git 命令在windows下无法使用pull、fetch、push等命令，提示 “please make sure you have the correct access and the repository exists“，但在git bash窗口却可以正常执行这些命令的解决办法之一：

更换ssh协议为http。

1.变量(1)变量的定义：
#set(\$name = “hello”) 说明：velocity中变量是弱类型的。
当使用#set 指令时，括在双引号中的字面字符串将解析和重新解释，如下所示：
#set(\$directoryRoot = “www” )
#set(\$templateName = “index.vm” )
#set(\$template = “\$directoryRoot/\$templateName” )
\$template
输出将会是：www/index.vm
注：在velocity中使用\$2.5这样的货币标识是没有问题得的，因为velocity中的变量总是以一个大写或者小写的字母开始的。
(2)变量规范的写法
\${name} ，也可以写成：\$name。提倡用前面的写法。
例如：你希望通过一个变量\$vice来动态的组织一个字符串。
Jack is a \$vicemaniac.
本来变量是\$vice现在却变成了\$vicemaniac，这样Veloctiy就不知道您到底要什么了。所以，应该使用规范的格式书写 ： Jack is a \${vice}maniac
现在Velocity知道变量是\$vice而不是\$vicemaniac。
注意：当引用属性的时候不能加{}
(3)变量的赋值:
\$name=”hello”
赋值的左边必须是一个变量或者是属性引用。右边可以是下面六种类型之一：
变量引用,字面字符串,属性引用,方法引用,字面数字,数组列表。
下面的例子演示了上述的每种类型：
#set( \$monkey = \$bill ) ## variable reference
#set( \$monkey.Friend = “monica” ) ## string
#set( \$monkey.Blame = \$whitehouse.Leak ) ## property reference
#set( \$monkey.Plan = \$spindoctor.weave(\$web) ) ## method reference
#set( \$monkey.Number = 123 ) ##number
#set( \$monkey.Say = [“Not”, \$my, “fault”] ) ## ArrayList
注意：①如果上述例子中的右值是null, 则左值不会被赋值，也就是说会保留以前的值。
②velocity模板中未被定义的变量将被认为是一个字符串。例如：
#set(\$foo = “gibbous”)
\$moon = \$foo
输出结果为：
\$moon = gibbous
③velocity模板中不会将reference解释为对象的实例变量。例如：\$foo.Name将被解释为Foo对象的getName（）方法，而不是Foo对象的Name实例变量。例如：
\$foo.getBar() 等同于\$foo.Bar ；
\$data.getUser(“jon”) 等同于\$data.User(“jon”) ；
data.getRequest().getServerName() 等同于
\$data.Request.ServerName等同于\${data.Request.ServerName}
2.循环
#foreach (\$element in \$list)
This is \$element.
\$velocityCount
#end
例子：
#set( \$list = [“pine”, “oak”, “maple”])
#foreach (\$element in \$list)
\$velocityCount
This is \$element.

#end
输出的结果为：
1 This is pine.
2 This is oak.
3 This is maple.
每次循环\$list中的一个值都会赋给\$element变量。
\$list可以是一个Vector、Hashtable或者Array。分配给\$element的值是一个java对象，并且可以通过变量被引用。例如：如果\$element t是一个java的Product类，并且这个产品的名字可以通过调用他的getName（）方法得到。
#foreach ( \$key in \$list.keySet())
Key: \$key -> Value: \$list.get(\$key)

#end
提示：velocity中大小写敏感。
Velocity还特别提供了得到循环次数的方法，\$velocityCount变量的名字是Velocity默认的名字。
例子：
First example:
#foreach ( \$foo in [1..5] )
\$foo
#end
Second example:
#foreach ( \$bar in [2..-2] )
\$bar
#end
Third example:
#set ( \$arr = [0..1] )
#foreach ( \$i in \$arr )
\$i
#end
上面三个例子的输出结果为：
First example：
1 2 3 4 5
Second example：
2 1 0 -1 -2
Third example：
0 1
3.条件语句
#if (condition)
#elseif (condition)
#else
#end
4.语句的嵌套
#foreach (\$element in \$list)
## inner foreach 内循环
#foreach (\$element in \$list)
This is \$element. \$velocityCount
inner

#end
## inner foreach 内循环结束
## outer foreach
This is \$element.
\$velocityCount
outer

#end
语句中也可以嵌套其他的语句，如#if…#else…#end等。
5.注释
(1)单行注释：
## This is a single line comment.
(2)多行注释：
#*
Thus begins a multi-line comment. Online visitors won’t
see this text because the Velocity Templating Engine will
ignore it.
*#
(3)文档格式：
#**
This is a VTL comment block and
may be used to store such information
as the document author and versioning
information:
@version 1.1
@author xiao
*#
6.关系和逻辑操作符
Velocity 也具有逻辑AND, OR 和 NOT 操作符。
如
`
\ example for AND

#if($foo && $bar)
This AND that

#end
`
例子中#if() 指令仅在\$foo 和\$bar 都为真的时候才为真。如果\$foo 为假，则表达式也为假；并且 \$bar将不被求值。如果 \$foo 为真，Velocity 模板引擎将继续检查\$bar的值，如果 \$bar 为真，则整个表达式为真。并且输出This AND that 。如果 \$bar 为假，将没有输出因为整个表达式为假。
7.Velocity 中的宏
Velocity中的宏我们可以理解为函数。
①宏的定义
#macro(宏的名称 \$参数1 \$参数2 …)
语句体(即函数体)
#end
②宏的调用
#宏的名称(\$参数1 \$参数2 …)
说明：参数之间用空格隔开。
8．#stop
停止执行模板引擎并返回,把它应用于debug是很有帮助的。
9．#include与#parse
#include和#parse的作用都是引入本地文件, 为了安全的原因，被引入的本地文件只能在TEMPLATE_ROOT目录下。
区别：
(1) 与#include不同的是，#parse只能指定单个对象。而#include可以有多个
如果您需要引入多个文件，可以用逗号分隔就行：
#include (“one.gif”, “two.txt”, “three.htm” )
在括号内可以是文件名，但是更多的时候是使用变量的：
#include ( “greetings.txt”, \$seasonalstock )
(2) #include被引入文件的内容将不会通过模板引擎解析；
而#parse引入的文件内容Velocity将解析其中的velocity语法并移交给模板，意思就是说相当与把引入的文件copy到文件中。
#parse是可以递归调用的，例如：如果dofoo.vm包含如下行：
Count down.

#set (\$count = 8)
#parse (“parsefoo.vm”)

All done with dofoo.vm!
那么在parsefoo.vm模板中，你可以包含如下VTL：velocity tag laugane
\$count
#set(\$count = \$count - 1)
#if ( \$count > 0 )

#parse( “parsefoo.vm” )
#else

All done with parsefoo.vm!
#end的显示结果为：
Count down.
8
7
6
5
4
3
2
1
0
All done with parsefoo.vm!
All done with dofoo.vm!
注意：在vm中使用#parse来嵌套另外一个vm时的变量共享问题。如：
->a.vm 里嵌套 b.vm；
->a.vm 里定义了变量 \$param；
->b.vm 里可以直接使用\$param，无任何限制。
但需要特别注意的是，如果b.vm里同时定义有变量\$param，则b.vm里将使用b.vm里定义的值。
10．转义字符’\’的使用
如果reference被定义，两个’\’意味着输出一个’\’，如果未被定义，刚按原样输出。如：
#set(\$email = “foo” )
\$email
\$email
\\$email
\\$email
输出：
foo
\$email
\foo
\$email
如果\$email 未定义
\$email
\$email
\\$email
\\$email
输出：
\$email
\$email
\\$email
\\$email (前面三个斜线,这里两个)
11．内置对象
Velocity内置了一些对象，在vm模版里可以直接调用，列举如下：
\$request、\$response、\$session，另外，模板内还可以使用 \$msg内的消息工具访问 Struts 的国际化资源，达到简便实现国际化的方法。
12．数组访问
对数组的访问在Velocity中存在问题，因为Velocity只能访问对象的方法，而数组又是一个特殊的Array，所以虽然数组可以进行循环列举，但却不能定位访问特定位置的元素，如 strs[2]，数组对固定位置元素的访问调用了Array的反射方法get(Object array, int index)，而Velocity没能提供这样的访问，所以数组要么改成List等其他类容器的方式来包装，要么就通过公用Util类的方式来提供，传入数组对象和要访问的位置参数，从而达到返回所需值的目的。

• 统计一组目录下的单词出现情况

for i in {5..8}; do zgrep 'There are 1 records need to update, 0 records update successfully.' machine${i}/201506/xxxx.log.2015-06-14-*.gz; done

• 遍历查询多台服务器上的日志

atnodes 'zgrep /home/yp/app/hello-world/logs/request.log*' machine[a-z] | sort -t '#' -k1,1
atnodes "less /home/yp/app/hello-world/logs/hello-world.log | grep -C 20 '获取到的产品:' --color " machine-name
atnodes "tail -f /home/yp/app/hello-world/logs/error.log" machine[a-c]
atnodes "tail -n50 /home/yp/app/hello-world/logs/hello-world.log" machine[a-b]

• Top-N统计：
  sort +awk+uniq 统计文件中出现次数最多的前10个单词

实例:

cat logt.log|sort -s -t '-' -k1n |awk '{print $1;}'|uniq -c|sort -k1nr|head -100

1. 使用linux命令或者shell实现：文件words存放英文单词，格式为每行一个英文单词（单词可以重复），统计这个文件中出现次数最多的前10个单词。

cat words.txt | sort | uniq -c | sort -k1,1nr | head -10

1. 主要考察对sort、uniq命令的使用，相关解释如下，命令及参数的详细说明请自行通过man查看，简单介绍下以上

2. 指令各部分的功能：

sort: 对单词进行排序
uniq -c: 显示唯一的行，并在每行行首加上本行在文件中出现的次数
sort -k1,1nr: 按照第一个字段，数值排序，且为逆序
head -10: 取前10行数据

• 统计某文件夹下文件的个数

  ls -l |grep "^-"|wc -l

• 统计某文件夹下目录的个数

  ls -l |grep "^ｄ"|wc -l

• 统计文件夹下文件的个数，包括子文件夹里的

  ls -lR|grep "^-"|wc -l

• 如统计/home/han目录(包含子目录)下的所有js文件则：

  ls -lR /home/han|grep js|wc -l 或 ls -l "/home/han"|grep "js"|wc -l

• 统计文件夹下目录的个数，包括子文件夹里的

  ls -lR|grep "^d"|wc -l

• 说明：

  ls -lR

• 长列表输出该目录下文件信息(R代表子目录注意这里的文件，不同于一般的文件，可能是目录、链接、设备文件等)

  grep "^-"

• 这里将长列表输出信息过滤一部分，只保留一般文件，如果只保留目录就是 ^d

  wc -l

• 统计输出信息的行数，因为已经过滤得只剩一般文件了，所以统计结果就是一般文件信息的行数，又由于一行信息对应一个文件，所以也就是文件的个数。

＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝
如果只查看文件夹
ls -d 只能显示一个.
find -type d 可以看到子文件夹
ls -lF |grep / 或 ls -l |grep '^d' 只看当前目录下的文件夹，不包括往下的文件夹

1. 斜体和粗体

使用 和 * 表示斜体和粗体。

示例：

这是 斜体，这是 粗体。

2. 分级标题

使用 === 表示一级标题，使用 — 表示二级标题。

示例：

1
2
3
4
5
6
7

这是一个一级标题
============================

这是一个二级标题
--------------------------------------------------

### 这是一个三级标题

你也可以选择在行首加井号表示不同级别的标题 (H1-H6)，例如：# H1, ## H2, ### H3，#### H4。

3. 外链接

使用 [描述](链接地址) 为文字增加外链接。

示例：

这是去往 本人的QQ空间 的链接。

4. 无序列表

使用 *，+，- 表示无序列表。

示例：

• 无序列表项 一
• 无序列表项 二
• 无序列表项 三

5. 有序列表

使用数字和点表示有序列表。

示例：

1. 有序列表项 一
2. 有序列表项 二
3. 有序列表项 三

6. 文字引用

使用 > 表示文字引用。

示例：

野火烧不尽，春风吹又生。

7. 行内代码块

使用 `代码` 表示行内代码块。

示例：

让我们聊聊 html。

8. 代码块

使用 四个缩进空格 表示代码块。

示例：

这是一个代码块，此行左侧有四个不可见的空格。

9. 插入图像

使用  插入图像。

示例：

Cmd Markdown 高阶语法手册

1. 内容目录

在段落中填写 [TOC] 以显示全文内容的目录结构。

[TOC]

2. 标签分类

在编辑区任意行的列首位置输入以下代码给文稿标签：

标签： 数学 英语 Markdown

或者

Tags： 数学 英语 Markdown

3. 删除线

使用 ~~ 表示删除线。

这是一段错误的文本。

4. 注脚

使用 [^keyword] 表示注脚。

这是一个注脚[^footnote]的样例。

这是第二个注脚[^footnote2]的样例。

5. LaTeX 公式

$ 表示行内公式：

质能守恒方程可以用一个很简洁的方程式 $E=mc^2$ 来表达。

$$ 表示整行公式：

$$\sum_{i=1}^n a_i=0$$

$$f(x_1,x_x,\ldots,x_n) = x_1^2 + x_2^2 + \cdots + x_n^2 $$

$$\sum^{j-1}{k=0}{\widehat{\gamma}{kj} z_k}$$

访问 MathJax 参考更多使用方法。

6. 加强的代码块

支持四十一种编程语言的语法高亮的显示，行号显示。

非代码示例：

1

$ sudo apt-get install vim-gnome

Python 示例：

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

@requires_authorization
def somefunc(param1='', param2=0):
    '''A docstring'''
    if param1 > param2: # interesting
        print 'Greater'
    return (param2 - param1 + 1) or None

class SomeClass:
    pass

>>> message = '''interpreter
... prompt'''

JavaScript 示例：

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

/**
* nth element in the fibonacci series.
* @param n >= 0
* @return the nth element, >= 0.
*/
function fib(n) {
  var a = 1, b = 1;
  var tmp;
  while (--n >= 0) {
    tmp = a;
    a += b;
    b = tmp;
  }
  return a;
}

document.write(fib(10));

7. 流程图

示例

1

st=>start: Start:>https://www.zybuluo.com
io=>inputoutput: verification
op=>operation: Your Operation
cond=>condition: Yes or No?
sub=>subroutine: Your Subroutine
e=>end

st->io->op->cond
cond(yes)->e
cond(no)->sub->io

更多语法参考：流程图语法参考

8. 序列图

示例 1

1

Alice->Bob: Hello Bob, how are you?
Note right of Bob: Bob thinks
Bob-->Alice: I am good thanks!

示例 2

1

Title: Here is a title
A->B: Normal line
B-->C: Dashed line
C->>D: Open arrow
D-->>A: Dashed open arrow

更多语法参考：序列图语法参考

9. 表格支持

10. 定义型列表

名词 1
: 定义 1（左侧有一个可见的冒号和四个不可见的空格）

代码块 2
: 这是代码块的定义（左侧有一个可见的冒号和四个不可见的空格）

代码块（左侧有八个不可见的空格）

11. Html 标签

本站支持在 Markdown 语法中嵌套 Html 标签，譬如，你可以用 Html 写一个纵跨两行的表格：

<table>
    <tr>
        <th rowspan="2">值班人员</th>
        <th>星期一</th>
        <th>星期二</th>
        <th>星期三</th>
    </tr>
    <tr>
        <td>李强</td>
        <td>张明</td>
        <td>王平</td>
    </tr>
</table>

12. 内嵌图标

本站的图标系统对外开放，在文档中输入

<i class="icon-weibo"></i>

即显示微博的图标：

替换 上述 i 标签 内的 icon-weibo 以显示不同的图标，例如：

<i class="icon-renren"></i>

即显示人人的图标：

更多的图标和玩法可以参看 font-awesome 官方网站。

13. 待办事宜 Todo 列表

使用带有 [ ] 或 [x] （未完成或已完成）项的列表语法撰写一个待办事宜列表，并且支持子列表嵌套以及混用Markdown语法，例如：

- [ ] **Cmd Markdown 开发**
    - [ ] 改进 Cmd 渲染算法，使用局部渲染技术提高渲染效率
    - [ ] 支持以 PDF 格式导出文稿
    - [x] 新增Todo列表功能 [语法参考](https://github.com/blog/1375-task-lists-in-gfm-issues-pulls-comments)
    - [x] 改进 LaTex 功能
        - [x] 修复 LaTex 公式渲染问题
        - [x] 新增 LaTex 公式编号功能 [语法参考](http://docs.mathjax.org/en/latest/tex.html#tex-eq-numbers)
- [ ] **七月旅行准备**
    - [ ] 准备邮轮上需要携带的物品
    - [ ] 浏览日本免税店的物品
    - [x] 购买蓝宝石公主号七月一日的船票

对应显示如下待办事宜 Todo 列表：

• [ ] Cmd Markdown 开发
  • [ ] 改进 Cmd 渲染算法，使用局部渲染技术提高渲染效率
  • [ ] 支持以 PDF 格式导出文稿
  • [x] 新增Todo列表功能 语法参考
  • [x] 改进 LaTex 功能
    • [x] 修复 LaTex 公式渲染问题
    • [x] 新增 LaTex 公式编号功能 语法参考
• [ ] 七月旅行准备
  • [ ] 准备邮轮上需要携带的物品
  • [ ] 浏览日本免税店的物品
  • [x] 购买蓝宝石公主号七月一日的船票

[^footnote]: 这是一个 注脚 的 文本。

[^footnote2]: 这是另一个 注脚 的 文本。

自从使用Markdown以来，就开始一直使用Markdown+Github在写文章，整理自己的所学所思。本文亦是通过这种方式完成的。

然而，Markdown自由书写的特性很好，唯独遇到数学公式时就要煞费苦心——每次都是先使用Latex书写(在线的Latex编辑器参考[1])，然后保存为图片，使用img标签进行引用，当公式很多的时候稍显复杂。

本文的方法使用html的语法，调用[1]的公式生成API，在线生成Latex数学公式，免去将公式保存为图片的麻烦。当然，弊端也是有的，公式太多，可能会造成刷新比一般的网页慢一些。

方法一：使用Google Chart的服务器

<img src="http://chart.googleapis.com/chart?cht=tx&chl= 在此插入Latex公式" style="border:none;">

• 一个例子，

<img src="http://chart.googleapis.com/chart?cht=tx&chl=\Large x=\frac{-b\pm\sqrt{b^2-4ac}}{2a}" style="border:none;">

公式显示结果为（如果谷歌被墙，有可能显示不出来）：

适用了下，Google Chart服务器的响应速度还可以，但据说可能复杂一些的Latex公式可能无法解析（参考[2]）。

方法二：使用forkosh服务器

forkosh上提供了关于Latex公式的一份简短而很有用的帮助，参考[1]和[3].

使用forkosh插入公式的方法是

<img src="http://www.forkosh.com/mathtex.cgi? 在此处插入Latex公式">

• 给个例子，

<img src="http://www.forkosh.com/mathtex.cgi? \Large x=\frac{-b\pm\sqrt{b^2-4ac}}{2a}">

显示结果为：

因为网页插入公式的原理是调用“某某网站的服务器”动态生成的，所有保证公式正常显示的前提是该网址能一直存在着为我等小生做些小小的服务。forkosh我是用了快2年了，一直很好，推荐！

方法三：使用MathJax引擎

大家都看过Stackoverflow上的公式吧，漂亮，其生成的不是图片。这就要用到MathJax引擎，在Markdown中添加MathJax引擎也很简单，

<script type="text/javascript" src="http://cdn.mathjax.org/mathjax/latest/MathJax.js?config=default"></script>

然后，再使用Tex写公式。$$公式$$表示行间公式，本来Tex中使用\(公式\)表示行内公式，但因为Markdown中\是转义字符，所以在Markdown中输入行内公式使用\\(公式\\)，如下代码：

$$x=\frac{-b\pm\sqrt{b^2-4ac}}{2a}$$
\\(x=\frac{-b\pm\sqrt{b^2-4ac}}{2a}\\)

分别显示结果（行间公式）：

$$x=\frac{-b\pm\sqrt{b^2-4ac}}{2a}$$

行内公式：

\(x=\frac{-b\pm\sqrt{b^2-4ac}}{2a}\)

不信，你可以试一下，在公式上还可以使用鼠标右键操作。

参考

[1] http://www.forkosh.com/mathtextutorial.html

[2] http://www.ruanyifeng.com/blog/2011/07/formula_online_generator.html

[3] http://www.forkosh.com/mathtex.html

[4] 字符包围，多级无序列表，大标题，中标题，单行文本，多行文本等格式请参考:http://www.tuicool.com/articles/zIJrEjn

介绍

Metrics是一个给JAVA服务的各项指标提供度量工具的包，在JAVA代码中嵌入Metrics代码，可以方便的对业务代码的各个指标进行监控，同时，Metrics能够很好的跟Ganlia、Graphite结合，方便的提供图形化接口。基本使用方式直接将core包（目前稳定版本3.0.1）导入pom文件即可，配置如下：

1
2
3
4
5

<dependency>
    <groupId>com.codahale.metrics</groupId>
    <artifactId>metrics-core</artifactId>
    <version>3.0.1</version>
</dependency>

core包主要提供如下核心功能：

Metrics Registries类似一个metrics容器，维护一个Map，可以是一个服务一个实例。

支持五种metric类型：Gauges、Counters、Meters、Histograms和Timers。

可以将metrics值通过JMX、Console，CSV文件和SLF4J loggers发布出来。

五种Metrics类型：

1. Gauges
   Gauges是一个最简单的计量，一般用来统计瞬时状态的数据信息，比如系统中处于pending状态的job。
2. Counter
   Counter是Gauge的一个特例，维护一个计数器，可以通过inc()和dec()方法对计数器做修改。使用步骤与Gauge基本类似，在MetricRegistry中提供了静态方法可以直接实例化一个Counter。
3. Meters
   Meters用来度量某个时间段的平均处理次数（request per second），每1、5、15分钟的TPS。比如一个service的请求数，通过metrics.meter()实例化一个Meter之后，然后通过meter.mark()方法就能将本次请求记录下来。统计结果有总的请求数，平均每秒的请求数，以及最近的1、5、15分钟的平均TPS。
4. Histograms
   Histograms主要使用来统计数据的分布情况，最大值、最小值、平均值、中位数，百分比（75%、90%、95%、98%、99%和99.9%）。例如，需要统计某个页面的请求响应时间分布情况，可以使用该种类型的Metrics进行统计。
5. Timers
   Timers主要是用来统计某一块代码段的执行时间以及其分布情况，具体是基于Histograms和Meters来实现的。

Health Checks

Metrics提供了一个独立的模块：Health Checks，用于对Application、其子模块或者关联模块的运行是否正常做检测。该模块是独立metrics-core模块的，使用时则导入metrics-healthchecks包。

1
2
3
4
5

<dependency>                                    
	<groupId>com.codahale.metrics</groupId>       
	<artifactId>metrics-healthchecks</artifactId> 
	<version>3.0.1</version>         
</dependency>

使用起来和与上述几种类型的Metrics有点类似，但是需要重新实例化一个Metrics容器HealthCheckRegistry，待检测模块继承抽象类HealthCheck并实现check()方法即可，然后将该模块注册到HealthCheckRegistry中，判断的时候通过isHealthy()接口即可。

其他支持

metrics提供了对Ehcache、Apache HttpClient、JDBI、Jersey、Jetty、Log4J、Logback、JVM等的集成，可以方便地将Metrics输出到Ganglia、Graphite中，供用户图形化展示。

参考资料

http://metrics.codahale.com/

https://github.com/dropwizard/metrics

http://blog.csdn.net/scutshuxue/article/details/8350135

http://blog.synyx.de/2013/09/yammer-metrics-made-easy-part-i/

http://blog.synyx.de/2013/09/yammer-metrics-made-easy-part-ii/

http://wiki.apache.org/hadoop/HADOOP-6728-MetricsV2