简要描述:

  • 生成统一的guid,便于分布式处理
  • 如果提取的数据小于长度,返回的结果为0,在分库分表时候,直接操作原始库

接口版本:

版本号 制定人 制定日期 修订日期
v3 陈碧贵 2021-08-22 xxxx-xx-xx

请求URL:

http://{url参数}/bo/api/v3/db/help/snowflake/guid?ownerId={ownerId}&_sysId={sysId}&ignore=true&id=3949792557034115072

http://localhost:5901/bo/api/v3/db/help/snowflake/guid?ownerId=bt&_sysId=abcded&ignore=true&id=3949792557034115072sdfdssd

请求方式:

  • GET

请求头:

参数名 是否必须 类型 说明
XownerId string 项目唯一ID,对应bo_project {ownerId}
XsysId string 所属系统 对应 bo_system 表
XuserFromFirstShareId string 一级分享用户ID, bo_user user_id
XuserFromSecondShareId string 二级分享用户ID, bo_user user_id
XverifyApi string 加密规则encryptByDES(`${newGuid()}
XfilterAreaCode string 行政区编码, 对应 bo_sys_area area_code
Content-Type: string application/json; charset=utf-8 请求类型

请求参数:

  • 当事件发生时,调用http/https接口,传递参数信息,响应请求结果。
参数名 是否必须 类型 说明
depId string 主键唯一标识值 (名称根据实际进行调整)
_nodejs string common-data 对应/Config/AppNodeJs/Plugins/fn- common-data.js, 通过nodejs插件,对响应结果进行二次处理 common-data 普通数据(小写驼峰)common-data-under 普通数据下划线

返回示例:

正确时返回:

{
    "data": {
        "snowflakeId": 3949792554444444444,
        "originalId": "3949792554444444444444444test",
        "usedId": 3949792554444444444
    },
    "code": "0",
    "retCode": "0",
    "success": true
}

错误时返回:

{
    "code": 0,
    "message": ""
    "error":{
      errorCode:null,
      errorText:null
    }
    "success": false,
}

返回参数说明:

参数名 类型 说明
success bool true 表示数据请求成功(跟code=0一致),调用者优先使用
code int true 表示数据请求成功(跟code=0一致),调用者优先使用
data string 剔除字符剩余数字,如果长度大约19,取最前面的19位
cacheType string redis/sqlite/local 数据来源缓存 的类型(便于开发调试和性能优化)
cacheDate date 最后数据获取时间

后端使用(SnowflakeInfo)

RegexUtil.GetSnowflakeNumValue(string.IsNullOrEmpty(id)?_guid.GetDataGuid(pf.OwnerId, pf.SysId, null):id)

后端源码:

  #region 获取数据值
      /// <summary>
        /// 获取数据值  默认0   用于把数据进行分表存储  19位
        /// </summary>
        /// <param name="data"></param>
        /// <returns></returns>
        public static long GetNumValue(string data, int len = 19)
        {
            Regex rx = new Regex(@"\\D+?", RegexOptions.Compiled | RegexOptions.IgnoreCase);
            if (string.IsNullOrEmpty(data) || data.Length == 0 || data.Length < len)
            {
                return 0;
            }
            return Convert.ToInt64((rx.Replace(data, "") ?? "0").Substring(0, len));
        }
        #endregion
文档更新时间: 2021-08-27 08:00   作者:admin