将C样式API转换为使用带有块的libdispatch的灵活方法是什么?

时间:2015-11-24 17:06:17

标签: grand-central-dispatch libdispatch

我有一个用C编写的现有C API,它大量使用从函数返回的状态代码来进行错误处理。我试图了解使用libdispatch处理此类情况的首选方法。

这是一个示例功能。 RETURN_ERROR和相关的宏只调用一个返回错误代码并打印消息的函数。

int
mport_db_prepare(sqlite3 *db, sqlite3_stmt **stmt, const char * fmt, ...)
{
  va_list args;
  char *sql;

  va_start(args, fmt);
  sql = sqlite3_vmprintf(fmt, args);
  va_end(args);

  if (sql == NULL)
    RETURN_ERROR(MPORT_ERR_FATAL, "Couldn't allocate memory for sql statement");

  if (sqlite3_prepare_v2(db, sql, -1, stmt, NULL) != SQLITE_OK) {
    SET_ERRORX(MPORT_ERR_FATAL, "sql error preparing '%s': %s", sql, sqlite3_errmsg(db));
    sqlite3_free(sql);
    RETURN_CURRENT_ERROR;
  }

  sqlite3_free(sql);

  return MPORT_OK;
}

我想在sql访问位周围使用串行队列,并且我知道我可以使用dispatch_sync来返回值。但是,我还读到,很多同步调用很容易陷入死锁。

这种界面的最佳做法是什么?通过带有处理程序的块成功/失败?我是否会提供dispatch_queue_t参数来让完成块在用户指定的队列上运行?

1 个答案:

答案 0 :(得分:1)

这是您可以使用的示例模板。这是我的首选方法。我直接在浏览器中输入这个,所以可能会有一些小错误(请编辑):

typedef void (^completion_block_t)(int error_code);

static dispatch_once_t init_once;
static dispatch_queue_t db_queue;

void perform_init(void __unused *ctx) {
    db_queue = dispatch_queue_create("com.mycompany.db_queue", DISPATCH_QUEUE_SERIAL);
}

void perform_some_async_operation(dispatch_queue_t completion_queue, completion_block_t completion_block) {
    dispatch_once_f(&init_once, NULL, perform_init);

    if (completion_block) {
        completion_block = Block_copy(completion_block)

        if (!completion_queue) {
            completion_queue = dispatch_get_global_queue(qos_class_self(), 0);
        }
    }

    dispatch_async(db_queue, ^{
        int error_code = 0;

        ...

        if (completion_block) {
            dispatch_async(completion_queue, ^{
                completion_block(error_code);
            });
        }
    });
}

请注意,如果您还想提供API的同步版本,最好使用它来实现异步版本,而不是相反。这样,系统可以更好地跟踪优先级继承的依赖关系。例如:

int perform_some_sync_operation() {
    dispatch_once_f(&init_once, NULL, perform_init);

    __block int error_code = 0;

    dispatch_sync(db_queue, ^{
        ...
    });

    return error_code;
}

void perform_some_async_operation(dispatch_queue_t completion_queue, completion_block_t completion_block) {
    dispatch_queue_t execution_queue = dispatch_get_global_queue(qos_class_self(), 0);

    if (completion_block) {
        completion_block = Block_copy(completion_block)

        if (!completion_queue) {
            completion_queue = execution_queue;
        }
    }

    dispatch_async(execution_queue, ^{
        int error_code = perform_some_sync_operation();

        if (completion_block) {
            dispatch_async(completion_queue, ^{
                completion_block(error_code);
            });
        }
    });
}

如果您的代码预计在早于Yosemite或iOS 8的系统上运行,那么当qos_class_self()不可用时,您将需要回退。例如:

completion_queue = dispatch_get_global_queue(&qos_class_self ? qos_class_self() : DISPATCH_QUEUE_PRIORITY_DEFAULT, 0);