get 获取一条记录

get 根据主键获取一条记录。

Luwak >= 3.0.0, asm.so >= 0.1.4

API

公共参数 metas 对象

名称	类型	描述
token	string	访问令牌，当需要授权才能访问时为必填
signature	string	签名
appKey	string	当需要签名时为必填
timestamp	string, number	时间戳，当校验时间误差范围时为必填

请求参数

名称	类型	描述
method	string	API 名称
params	number, string	API 参数

method 命名规范是 $entity.get

params 参数是一个值时对应一个单字段主键。

多列主键的场景可以使用 getByUK 获取一条数据。

弃用

params 参数是一个对象时，引擎内部自动转换为调用 getByUK 方法。

响应结果

如果找到则返回数据对象。

如果没找到则返回一个 {} 对象。

示例

场景描述

获取品牌表中主键 id 为 1 的数据。

请求

{
  "jsonrpc": "2.0",
  "method": "smartPanda.mdh.brand.get",
  "params": 1,
  "metas": {
    "token": "44ea16b7-3aa1-41a5-81da-8ee9d2b840c2",
    "signature": "3a8e1bf9039352e1aa6cd82c7edfcc74",
    "appKey": "NSEA4ETIpBlyB2l9",
    "timestamp": 1740555294793
  },
  "id": "c8d4170d-5240-482e-bc9b-8df0efe20021"
}

响应

{
  "jsonrpc": "2.0",
  "result": {
    "id": 1,
    "name": "Luwak"
  },
  "id": "c8d4170d-5240-482e-bc9b-8df0efe20021"
}

实体定义

smart_panda 库中 brand 表的定义如下

CREATE TABLE `brand`
(
    `id`   int AUTO_INCREMENT,
    `name` varchar(20),
    PRIMARY KEY (`id`)
);

entity 名称是 smartPanda.mdh.brand

实际执行的 SQL

Prepare   SELECT * FROM smart_panda.brand WHERE id = ?
Execute   SELECT * FROM smart_panda.brand WHERE id = 1