/*
* _database_ をロックする。ロックに失敗した場合は
* {Groonga::ResourceDeadlockAvoided} 例外が発生する。
*
* @overload lock(options={})
* @!macro [new] database.lock.arguments
* @param [::Hash] options 利用可能なオプションは以下の通り。
* @option options :timeout
* ロックを獲得できなかった場合は _:timeout_ 秒間ロックの獲
* 得を試みる。 _:timeout_ 秒以内にロックを獲得できなかった
* 場合は例外が発生する。
* @!macro database.lock.arguments
* @overload lock(options={})
* @yield ブロックを指定した場合はブロックを抜けたときにunlockする。
* @!macro database.lock.arguments
*/
static VALUE
rb_grn_database_lock (int argc, VALUE *argv, VALUE self)
{
grn_ctx *context;
grn_obj *database;
int timeout = 0;
grn_rc rc;
VALUE options, rb_timeout;
rb_scan_args(argc, argv, "01", &options);
rb_grn_database_deconstruct(SELF(self), &database, &context,
NULL, NULL, NULL, NULL);
rb_grn_scan_options(options,
"timeout", &rb_timeout,
NULL);
if (!NIL_P(rb_timeout))
timeout = NUM2UINT(rb_timeout);
rc = grn_obj_lock(context, database, GRN_ID_NIL, timeout);
rb_grn_context_check(context, self);
rb_grn_rc_check(rc, self);
if (rb_block_given_p()) {
return rb_ensure(rb_yield, Qnil, rb_grn_database_unlock, self);
} else {
return Qnil;
}
}
/*
* Document-method: lock
*
* call-seq:
* column.lock(options={})
* column.lock(options={}) {...}
*
* _column_をロックする。ロックに失敗した場合は
* Groonga::ResourceDeadlockAvoided例外が発生する。
*
* ブロックを指定した場合はブロックを抜けたときにunlockする。
*
* 利用可能なオプションは以下の通り。
*
* [_:timeout_]
* ロックを獲得できなかった場合は_:timeout_秒間ロックの獲
* 得を試みる。_:timeout_秒以内にロックを獲得できなかった
* 場合は例外が発生する。
* [_:id_]
* _:id_で指定したレコードをロックする。（注: groonga側が
* 未実装のため、現在は無視される）
*/
static VALUE
rb_grn_column_lock (int argc, VALUE *argv, VALUE self)
{
grn_id id = GRN_ID_NIL;
grn_ctx *context;
grn_obj *column;
int timeout = 0;
grn_rc rc;
VALUE options, rb_timeout, rb_id;
rb_scan_args(argc, argv, "01", &options);
rb_grn_column_deconstruct(SELF(self), &column, &context,
NULL, NULL,
NULL, NULL, NULL);
rb_grn_scan_options(options,
"timeout", &rb_timeout,
"id", &rb_id,
NULL);
if (!NIL_P(rb_timeout))
timeout = NUM2UINT(rb_timeout);
if (!NIL_P(rb_id))
id = NUM2UINT(rb_id);
rc = grn_obj_lock(context, column, id, timeout);
rb_grn_context_check(context, self);
rb_grn_rc_check(rc, self);
if (rb_block_given_p()) {
return rb_ensure(rb_yield, Qnil, rb_grn_column_unlock_ensure, self);
} else {
return Qnil;
}
}