# item

#### 1.Notes

Item是GDB存储数据的单元,是group的内容,一个group里面可以有 N个Item,每个Item的属性在添加group的时候已经通过Column定义

#### 2.Api

## &#x20;添加Item

<mark style="color:green;">`POST`</mark> `/item/addItems`

向指定的group添加item

#### Request Body

| Name      | Type   | Description                           |
| --------- | ------ | ------------------------------------- |
| groupName | string |                                       |
| values    | array  | \[{"column1": s1, "column1": s2..}..] |

{% tabs %}
{% tab title="200 " %}

```
{"effectedRows": int}
```

{% endtab %}
{% endtabs %}

## &#x20;删除Item

<mark style="color:green;">`POST`</mark> `/item/deleteItems`

#### Request Body

| Name      | Type   | Description     |
| --------- | ------ | --------------- |
| groupName | string |                 |
| condition | string | 删除SQL语句的where条件 |

{% tabs %}
{% tab title="200 " %}

```
{"effectedRows", int}
```

{% endtab %}
{% endtabs %}

## &#x20;获取Item

<mark style="color:green;">`POST`</mark> `/item/getItems`

获取指定的item,如果startRow为-1则意味着查询全部,此时不需要提供rowCount参数,否则需要同时提供 startRow和rowCount两个参数来进行Limit分页查询,column表示要查询的列,以逗号分割,\*表示所有 可以参见SQLite的查询语句

#### Request Body

| Name      | Type    | Description |
| --------- | ------- | ----------- |
| groupName | string  |             |
| column    | string  |             |
| condition | string  |             |
| startRow  | integer |             |
| rowCount  | string  |             |

{% tabs %}
{% tab title="200 " %}

```
[{column: ...},{}]
```

{% endtab %}
{% endtabs %}

## &#x20;更新Item

<mark style="color:green;">`POST`</mark> `/item/updateItems`

#### Request Body

| Name      | Type   | Description               |
| --------- | ------ | ------------------------- |
| groupName | string |                           |
| clause    | string | 更新的SQL语句,eg: column1='c1' |

{% tabs %}
{% tab title="200 " %}

```
{"effectedRows": int}
```

{% endtab %}
{% endtabs %}

&#x20;                                                                        [fork me on github](https://github.com/JustKeepSilence/gdb)
