Skip to content

Commit f24a6c9

Browse files
oliviarlajhpark816
authored andcommitted
DOCS: Add Get And Touch documentation
1 parent 011382e commit f24a6c9

1 file changed

Lines changed: 16 additions & 0 deletions

File tree

docs/user-guide/03-key-value-API.md

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -13,6 +13,7 @@ Key-value item에 대해 수행가능한 연산들은 아래와 같다.
1313
- [Key-Value Item 값의 증감](03-key-value-API.md#key-value-item-incr-decr)
1414
- [Key-Value Item 삭제](03-key-value-API.md#key-value-item-delete)
1515
- [Key-Value Item 만료 시간 갱신](03-key-value-API.md#key-value-item-touch)
16+
- [Key-Value Item 만료 시간 갱신 및 조회](03-key-value-API.md#key-value-item-get-and-touch)
1617

1718
<a id="key-value-item-store"></a>
1819
## Key-Value Item 저장
@@ -224,3 +225,18 @@ future.getStatus().getStatusCode() | 설명
224225
--------------------------------------------| ---------
225226
StatusCode.SUCCESS | 갱신 성공
226227
StatusCode.ERR_NOT_FOUND | 갱신 실패 (Key miss, 주어진 key에 해당하는 item이 없음)
228+
229+
<a id="key-value-item-get-and-touch"></a>
230+
## Key-Value Item 만료 시간 갱신 및 조회
231+
하나의 key에 대한 item의 만료 시간을 갱신하고 값을 조회하는 API를 제공한다.
232+
233+
```java
234+
Future<Object> asyncGetAndTouch(final String key, final int exp)
235+
```
236+
- 주어진 key를 가진 item의 만료 시간을 exp 초 이후 혹은 exp 값이 unixtime인 경우 해당 값으로 갱신하고, value를 조회하여 반환한다.
237+
238+
수행 결과는 future 객체를 통해 얻는다.
239+
240+
future.getStatus().getStatusCode() | 설명
241+
--------------------------------------------| ---------
242+
StatusCode.SUCCESS | 갱신 성공

0 commit comments

Comments
 (0)