Object 内置对象

对象 Lock

Lock 是一个内建对象,它可以用来控制纤程并发访问, 可以通过一个纤程获取锁,来阻止其他纤程同时获取。Lock 可以通过 coroutine.Lock() 函数创建

常见情况是,在一个多线程的场景中,当多个线程都想修改同一份数据时,就会出现数据不一致。比如,两个线程都想修改同一份数据中的同一个值,在控制不当的情况下,可能会产生结果的不一致。这时使用 Lock 对象,就可以实现对同一份数据的互斥访问。

下面是一个简单的例子,使用 Lock 实现两个纤程交替执行,并且共享变量 v 的值不为 300。

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20
var coroutine = require("coroutine") var l = new coroutine.Lock() var v = 100 function f() { l.acquire() v = 200 coroutine.sleep(1) v = 300 l.release() } coroutine.start(f) coroutine.sleep(1) l.acquire() assert.notEqual(300, v) assert.equal(200, v) l.release()

首先创建了一个Lock对象,并进入纤程 f,获取锁后修改变量 v,然后释放锁。在主线程中,先等待纤程 f 完成……当纤程 f 释放了 Lock 后,主线程开始获取 Lock,确保变量 v 的值被改为 300。

继承关系

%0 object object toString() toJSON() Lock Lock new Lock() acquire() release() count() object->Lock Condition Condition Lock->Condition Event Event Lock->Event Semaphore Semaphore Lock->Semaphore

构造函数

Lock

构造函数

1
new Lock();

成员函数

acquire

获取锁的拥有权

1
Boolean Lock.acquire(Boolean blocking = true);

调用参数:

  • blocking: Boolean, 指定是否等待,为 true 时等待,缺省为真

返回结果:

  • Boolean, 返回是否成功获取锁,为 true 表示成功获取

acquire 方法用于获取锁的拥有权,当锁处于可获取状态时,此方法立即返回 true。

当锁不可获取,且 blocking 为 true,则当前纤程进入休眠,当其他纤程释放锁后,此方法返回 true。

当锁不可获取,且 blocking 为 false,则方法返回 false。


release

释放锁的拥有权

1
Lock.release();

此方法将释放对锁的拥有权,如果当前纤程未拥有锁,此方法将抛出错误。


count

查询当前等待任务数

1
Integer Lock.count();

返回结果:

  • Integer, 返回任务数

toString

返回对象的字符串表示,一般返回 "[Native Object]",对象可以根据自己的特性重新实现

1
String Lock.toString();

返回结果:

  • String, 返回对象的字符串表示

toJSON

返回对象的 JSON 格式表示,一般返回对象定义的可读属性集合

1
Value Lock.toJSON(String key = "");

调用参数:

  • key: String, 未使用

返回结果:

  • Value, 返回包含可 JSON 序列化的值