insertKV

  1. int insertKV(const SetKVReq &req)

功能: key不存在时写入,否则返回失败

参数:

  1. struct SetKVReq
  2. {
  3. 1 require string moduleName; //模块名
  4. 2 require SSetKeyValue data;
  5. };
  6. struct SSetKeyValue
  7. {
  8. 1 require string keyItem; //键
  9. 2 require string value; //值
  10. 3 require byte version = 0; //数据版本,缺省为0
  11. 4 require bool dirty = true; //是否设置为脏数据,缺省为true
  12. 5 require int expireTimeSecond = 0; //过期时间,缺省为0,表示永不过期
  13. };

返回值

返回值 含义
ET_DATA_EXIST 数据已存在,禁止写入
ET_MODULE_NAME_INVALID 模块名错误
ET_SERVER_TYPE_ERR SLAVE状态下不提供接口服务
ET_KEY_AREA_ERR 当前key不属于本机服务,需要更新路由表重新访问
ET_PARAM_TOO_LONG key长度超过限制
ET_FORBID_OPT 迁移时禁止写入
ET_DATA_VER_MISMATCH 版本不一致
ET_MEM_FULL 内存满
ET_CACHE_ERR cache错误
ET_INPUT_PARAM_ERROR 参数错误,例如key为空等
ET_SYS_ERR 系统异常
ET_SUCC 写入成功