redis transactions(事务)

MULTI

MULTI：标记一个事务块的开始。
事务块内的多条命令会按照先后顺序被放进一个队列当中，最后由 EXEC 命令原子性(atomic)地执行。

可用版本：>= 1.2.0

时间复杂度：O(1)。

返回值：总是返回 OK。

    redis> MULTI            # 标记事务开始
    OK

    redis> INCR user_id     # 多条命令按顺序入队
    QUEUED

    redis> INCR user_id
    QUEUED

    redis> INCR user_id
    QUEUED

    redis> PING
    QUEUED

    redis> EXEC             # 执行
    ) (integer)
    ) (integer)
    ) (integer)
    ) PONG

EXEC

EXEC

执行所有事务块内的命令。

假如某个(或某些) key 正处于 WATCH 命令的监视之下，且事务块中有和这个(或这些) key 相关的命令，那么 EXEC 命令只在这个(或这些) key 没有被其他命令所改动的情况下执行并生效，否则该事务被打断(abort)。

可用版本：

>= 1.2.0

时间复杂度：

事务块内所有命令的时间复杂度的总和。

返回值：

事务块内所有命令的返回值，按命令执行的先后顺序排列。

当操作被打断时，返回空值 nil 。

# 事务被成功执行

redis> MULTI
OK

redis> INCR user_id
QUEUED

redis> INCR user_id
QUEUED

redis> INCR user_id
QUEUED

redis> PING
QUEUED

redis> EXEC
) (integer)
) (integer)
) (integer)
) PONG

# 监视 key ，且事务成功执行

redis> WATCH lock lock_times
OK

redis> MULTI
OK

redis> SET lock "huangz"
QUEUED

redis> INCR lock_times
QUEUED

redis> EXEC
) OK
) (integer) 

# 监视 key ，且事务被打断

redis> WATCH lock lock_times
OK

redis> MULTI
OK

redis> SET lock "joe"        # 就在这时，另一个客户端修改了 lock_times 的值
QUEUED

redis> INCR lock_times
QUEUED

redis> EXEC                  # 因为 lock_times 被修改， joe 的事务执行失败
(nil)

DISCARD

DISCARD

取消事务，放弃执行事务块内的所有命令。

如果正在使用 WATCH 命令监视某个(或某些) key，那么取消所有监视，等同于执行命令 UNWATCH 。

可用版本：

>= 2.0.0

时间复杂度：

O(1)。

返回值：

总是返回 OK 。

redis> MULTI
OK

redis> PING
QUEUED

redis> SET greeting "hello"
QUEUED

redis> DISCARD
OK

WATCH

WATCH key [key ...]

监视一个(或多个) key ，如果在事务执行之前这个(或这些) key 被其他命令所改动，那么事务将被打断。

可用版本：

>= 2.2.0

时间复杂度：

O(1)。

返回值：

总是返回 OK 。

redis> WATCH lock lock_times
OK

UNWATCH

UNWATCH

取消 WATCH 命令对所有 key 的监视。

如果在执行 WATCH 命令之后， EXEC 命令或 DISCARD 命令先被执行了的话，那么就不需要再执行 UNWATCH 了。

因为 EXEC 命令会执行事务，因此 WATCH 命令的效果已经产生了；而 DISCARD 命令在取消事务的同时也会取消所有对 key 的监视，因此这两个命令执行之后，就没有必要执行 UNWATCH 了。

可用版本：

>= 2.2.0

时间复杂度：

O(1)

返回值：

总是 OK 。

redis> WATCH lock lock_times
OK

redis> UNWATCH
OK

在前面的基础上，我们来看下使用node_redis与ioredis的例子：

首先来看下使用node_redis的例子：

node_redis篇

client.multi([commands])

MULTI命令让我们执行的其他命令排队直到执行EXEC命令后，排队的命令才会被自动执行。在node_redis中这个接口通过调用client.multi()来产生一个Multi对象。如果其中有一个命令失败，排队的所有命令都会被回滚，没有命令会执行。

var redis  = require("./index"),
    client = redis.createClient(), set_size = 20;

client.sadd("bigset", "a member");
client.sadd("bigset", "another member");

while (set_size > 0) {
    client.sadd("bigset", "member " + set_size);
    set_size -= 1;
}

// multi chain with an individual callback
client.multi()
    .scard("bigset")
    .smembers("bigset")
    .keys("*", function (err, replies) {
        // NOTE: code in this callback is NOT atomic
        // this only happens after the the .exec call finishes.
        client.mget(replies, redis.print);
    })
    .dbsize()
    .exec(function (err, replies) {
        console.log("MULTI got " + replies.length + " replies");
        replies.forEach(function (reply, index) {
            console.log("Reply " + index + ": " + reply.toString());
        });
    });

Multi.exec([callback])

client.multi()返回一个Multi对象结构，Multi具有和client对象同样的执行命令的方法。要执行的命令在Multi对象中排队知道执行Multi.exec()方法。

如果你的执行，命令中包含了语法错误或者是抛出了EXECABORT错误，那么所有的命令将会停止执行。错误中包含了.errors属性，这个属性中包含了具体的错误信息。如果所有的命令都成功入队，当在执行一条命令的时候redis抛出一个错误，这个错误将会被返回给最终的结果数组！，尽管队列中有一条失败了那么并没有命令会停止（试过几次，确实没有命令会停止，错误的命令并不会引起其他命令退出执行）。

上面我们使用了MULTI命令进行链式调用。我们也可以吧命令放入单独的MULTI构成的队列中，同时也可以用client命令。

var redis  = require("redis"),
    client = redis.createClient(), multi;

// start a separate multi command queue
multi = client.multi();
multi.incr("incr thing", redis.print);
multi.incr("incr other thing", redis.print);

// runs immediately
client.mset("incr thing", 100, "incr other thing", 1, redis.print);

// drains multi queue and runs atomically
multi.exec(function (err, replies) {
    console.log(replies); // 101, 2
});

除了单独添加命令到MULTI队列，你也可以传递一个包含命令和参数的数组。

var redis  = require("redis"),
    client = redis.createClient(), multi;

client.multi([
    ["mget", "multifoo", "multibar", redis.print],
    ["incr", "multifoo"],
    ["incr", "multibar"]
]).exec(function (err, replies) {
    console.log(replies);
});