ZEPETO.Multiplay.DataStorage

8 분

형식	설명
DataStorageError	데이터 스토리지 관련 요청이 실패한 원인을 나타내는 오류 코드입니다.
DataStorage	데이터를 저장, 조회, 삭제하는 메서드를 제공하는 데이터 스토리지 추상화입니다. 이 인터페이스는 단일 및 다중 데이터 조작을 위한 비동기 작업을 정의합니다.

DataStorageError

enum

데이터 스토리지 관련 요청이 실패한 원인을 나타내는 오류 코드입니다.

이름	값	설명
Unknown	-1	오류: 알 수 없는 오류입니다.
NetworkError	0	오류: 연결 끊김이나 불안정한 연결 등 네트워크 문제와 관련된 오류입니다.
KeyConstraintViolated	103	오류: 키 오류입니다.
ValueConstraintViolated	104	오류: 값 오류입니다.

interface

데이터를 저장, 조회, 삭제하는 메서드를 제공하는 데이터 스토리지 추상화입니다. 이 인터페이스는 단일 및 다중 데이터 조작을 위한 비동기 작업을 정의합니다.

set(key: string, value: T) → Promise<boolean>

지정한 키로 값을 저장합니다. DataStorageError를 발생시킵니다.

매개변수	형식	설명
key	string	저장에 사용할 키입니다.
value	T	저장할 데이터입니다.

반환값: Promise<boolean> — 작업 완료 시 이행되는 Promise이며, 성공(true) 또는 실패(false)를 나타냅니다.

get(key: string) → Promise<T>

키로 값을 조회합니다. DataStorageError를 발생시킵니다.

매개변수	형식	설명
key	string	검색할 키입니다.

반환값: Promise<T> — 작업 완료 시 T 형식의 값과 함께 이행되는 Promise입니다.

remove(key: string) → Promise<boolean>

지정한 키의 값을 삭제합니다. DataStorageError를 발생시킵니다.

매개변수	형식	설명
key	string	검색할 키입니다.

반환값: Promise<boolean> — 작업 완료 시 이행되는 Promise이며, 성공(true) 또는 실패(false)를 나타냅니다.

mget(keys: string[]) → Promise<{ [key: string]: T }>

여러 키로 값을 조회합니다. DataStorageError를 발생시킵니다.

매개변수	형식	설명
keys	string[]	검색할 키의 배열입니다.

반환값: Promise<{ [key: string]: T }> — 작업 완료 시 키-값 객체와 함께 이행되는 Promise입니다.

mset(keyValueSet: { key: string; value: T }[]) → Promise<boolean>

지정한 여러 키로 값을 저장합니다. DataStorageError를 발생시킵니다.

매개변수	형식	설명
keyValueSet	{ key: string; value: T }[]	저장할 키-값 객체의 배열입니다.

반환값: Promise<boolean> — 작업 완료 시 이행되는 Promise이며, 성공(true) 또는 실패(false)를 나타냅니다.