객체레디스

Redis 데이터베이스 클라이언트 객체

Redis 데이터베이스를 생성하고 관리하는 데 사용됩니다. 생성 방법:

1
2
var db = require("db");
var test = new db.openRedis("redis-server");

상속관계

구성원 속성

onsuberror

함수, 쿼리 및 오류 처리 기능을 설정합니다. 하위에 오류가 있거나 네트워크가 중단되면 콜백됩니다. 콜백이 발생하면 이 객체의 모든 하위가 종료됩니다.

1
Function Redis.onsuberror;

멤버 함수

command

redis 기본 명령 방법

1
2
Value Redis.command(String cmd,
    ...args);

호출 매개변수:

cmd: 문자열, 보낼 명령을 지정합니다.
args: ..., 전송할 매개변수를 지정합니다.

결과 반환:

Value, 서버에서 반환한 결과를 반환합니다.

set

문자열 값 값을 키에 연결합니다. 키에 이미 다른 값이 있으면 SET은 유형에 관계없이 이전 값을 덮어씁니다.

1
2
3
Redis.set(Buffer key,
    Buffer value,
    Long ttl = 0);

호출 매개변수:

key:Buffer, 연결할 키를 지정하세요
value:Buffer, 연결할 데이터를 지정합니다.
ttl: Long, 키의 생존 시간을 밀리초 단위로 설정합니다. ttl이 0이면 생존 시간이 설정되지 않습니다.

setNX

키가 존재하지 않는 경우에만 키 값을 value로 설정하십시오. 지정된 키가 이미 존재하는 경우 SETNX는 아무런 조치도 취하지 않습니다.

1
2
3
Redis.setNX(Buffer key,
    Buffer value,
    Long ttl = 0);

호출 매개변수:

key:Buffer, 연결할 키를 지정하세요
value:Buffer, 연결할 데이터를 지정합니다.
ttl: Long, 키의 생존 시간을 밀리초 단위로 설정합니다. ttl이 0이면 생존 시간이 설정되지 않습니다.

setXX

키 값을 value로 설정하고, 키가 이미 존재하는 경우에만 키를 설정합니다.

1
2
3
Redis.setXX(Buffer key,
    Buffer value,
    Long ttl = 0);

호출 매개변수:

key:Buffer, 연결할 키를 지정하세요
value:Buffer, 연결할 데이터를 지정합니다.
ttl: Long, 키의 생존 시간을 밀리초 단위로 설정합니다. ttl이 0이면 생존 시간이 설정되지 않습니다.

mset

하나 이상의 키-값 쌍을 동시에 설정합니다. 지정된 키가 이미 존재하는 경우 MSET는 이전 값을 새 값으로 덮어씁니다.

1
Redis.mset(Object kvs);

호출 매개변수:

kvs: 객체, 설정할 키/값 객체를 지정합니다.

하나 이상의 키-값 쌍을 동시에 설정합니다. 지정된 키가 이미 존재하는 경우 MSET는 이전 값을 새 값으로 덮어씁니다.

1Redis.mset(...kvs);

호출 매개변수:

kvs: ..., 설정할 키/값 목록을 지정합니다.

msetNX

주어진 키가 모두 존재하지 않는 경우에만 하나 이상의 키-값 쌍을 동시에 설정하십시오.

1
Redis.msetNX(Object kvs);

호출 매개변수:

kvs: 객체, 설정할 키/값 객체를 지정합니다.

주어진 키가 모두 존재하지 않는 경우에만 하나 이상의 키-값 쌍을 동시에 설정하십시오.

1Redis.msetNX(...kvs);

호출 매개변수:

kvs: ..., 설정할 키/값 목록을 지정합니다.

append

키가 이미 존재하고 문자열인 경우 추가 명령은 키의 원래 값 끝에 값을 추가합니다. 키가 존재하지 않으면 추가는 단순히 주어진 키를 값으로 설정합니다.

1
2
Integer Redis.append(Buffer key,
    Buffer value);

호출 매개변수:

key:Buffer, 추가할 키를 지정합니다.
value:Buffer, 추가할 데이터를 지정합니다.

결과 반환:

Integer, 값을 추가한 후 키의 문자열 길이

setRange

오프셋 offset부터 시작하여 주어진 키에 저장된 문자열 값을 덮어쓰려면 value 매개변수를 사용하십시오.

1
2
3
Integer Redis.setRange(Buffer key,
    Integer offset,
    Buffer value);

호출 매개변수:

key:Buffer, 수정할 키를 지정하세요.
offset: 정수, 수정된 바이트 오프셋을 지정합니다.
value:Buffer, 덮어쓸 데이터를 지정하세요

결과 반환:

Integer, 수정된 후의 문자열 길이

getRange

키에 있는 문자열 값의 하위 문자열을 반환합니다. 문자열의 가로채기 범위는 시작과 끝(시작과 끝 포함)의 두 오프셋에 의해 결정됩니다.

1
2
3
Buffer Redis.getRange(Buffer key,
    Integer start,
    Integer end);

호출 매개변수:

key:Buffer, 쿼리할 키를 지정합니다.
start: 정수, 쿼리의 시작 바이트 오프셋을 지정합니다.
end: 정수, 쿼리의 끝 바이트 오프셋을 지정합니다.

결과 반환:

Buffer, 얻은 하위 문자열을 가로채기

strlen

키에 저장된 문자열 값의 길이를 반환합니다. 키에 문자열 값이 아닌 값이 저장되면 오류가 반환됩니다.

1Integer Redis.strlen(Buffer key);

호출 매개변수:

key:Buffer, 계산할 키를 지정합니다.

결과 반환:

Integer, 문자열 값의 길이입니다. 키가 존재하지 않으면 0을 반환

bitcount

주어진 문자열에서 1로 설정된 비트 수를 셉니다.

1
2
3
Integer Redis.bitcount(Buffer key,
    Integer start = 0,
    Integer end = -1);

호출 매개변수:

key:Buffer, 계산할 키를 지정합니다.
start: 정수, 계산할 시작 바이트를 지정합니다. 음수 값을 사용할 수 있습니다. -1은 마지막 바이트를 나타내고 -2는 두 번째에서 마지막 바이트를 나타내는 식입니다.
end: 정수, 계산할 끝 바이트를 지정합니다. 음수 값을 사용할 수 있습니다. -1은 마지막 바이트를 나타내고 -2는 끝에서 두 번째 바이트를 나타냅니다.

결과 반환:

Integer, 비트 수는 1로 설정

get

key와 관련된 문자열 값을 반환합니다. key가 존재하지 않으면 특수 값 Null을 반환합니다.

1Buffer Redis.get(Buffer key);

호출 매개변수:

key:Buffer, 연결할 키를 지정하세요

결과 반환:

Buffer, 키가 존재하지 않으면 Null을 반환하고, 그렇지 않으면 키 값을 반환합니다.

mget

주어진 키에 대한 모든(하나 이상의) 값을 반환합니다. 주어진 키에 키가 없으면 이 키는 특수 값 nil을 반환합니다.

1
NArray Redis.mget(Array keys);

호출 매개변수:

keys: 배열, 쿼리할 키 배열을 지정합니다.

결과 반환:

NArray, 주어진 키에 대한 모든 값을 포함하는 목록

주어진 키에 대한 모든(하나 이상의) 값을 반환합니다. 주어진 키에 키가 없으면 이 키는 특수 값 nil을 반환합니다.

1NArray Redis.mget(...keys);

호출 매개변수:

keys: ..., 쿼리할 키 목록을 지정합니다.

결과 반환:

NArray, 주어진 키에 대한 모든 값을 포함하는 목록

getset

주어진 키의 값을 value로 설정하고 키의 이전 값을 반환합니다.

1
2
Buffer Redis.getset(Buffer key,
    Buffer value);

호출 매개변수:

key:Buffer에서 쿼리하고 수정할 키를 지정합니다.
value:Buffer, 수정된 값을 지정

결과 반환:

Buffer, 주어진 키의 이전 값을 반환합니다.

decr

키에 저장된 값에서 감소분을 뺍니다.

1
2
Long Redis.decr(Buffer key,
    Long num = 1);

호출 매개변수:

key:Buffer, 수정할 키를 지정하세요.
num: Long, 뺄 값을 지정합니다.

결과 반환:

Long, num을 뺀 후 key의 값

incr

키에 저장된 값에 증분을 추가합니다.

1
2
Long Redis.incr(Buffer key,
    Long num = 1);

호출 매개변수:

key:Buffer, 수정할 키를 지정하세요.
num: Long, 추가할 값을 지정합니다.

결과 반환:

Long, num을 추가한 후 키 값

setBit

키에 저장된 문자열 값의 경우 지정된 오프셋에서 비트를 설정하거나 지웁니다.

1
2
3
Integer Redis.setBit(Buffer key,
    Integer offset,
    Integer value);

호출 매개변수:

key:Buffer, 수정할 키를 지정하세요.
offset: 정수, 수정된 비트 오프셋을 지정합니다.
value: 정수, 설정하거나 지울 매개변수를 지정합니다(0 또는 1일 수 있음).

결과 반환:

Integer, 오프셋이 원래 저장된 비트를 지정합니다.

getBit

키에 저장된 문자열 값의 경우 지정된 오프셋에서 비트를 얻습니다.

1
2
Integer Redis.getBit(Buffer key,
    Integer offset);

호출 매개변수:

key:Buffer, 쿼리할 키를 지정합니다.
offset: 정수, 쿼리의 비트 오프셋을 지정합니다.

결과 반환:

Integer, 문자열 값은 오프셋의 비트를 지정합니다.

exists

주어진 키가 존재하는지 확인

1
Boolean Redis.exists(Buffer key);

호출 매개변수:

key:Buffer, 연결할 키를 지정하세요

결과 반환:

Boolean, 키가 존재하면 True를 반환하고, 그렇지 않으면 False를 반환합니다.

type

키에 저장된 값의 유형을 반환합니다.

1
String Redis.type(Buffer key);

호출 매개변수:

key:Buffer, 쿼리할 키를 지정합니다.

결과 반환:

String, 키에 저장된 값의 유형을 반환합니다. 가능한 값은 없음(키가 존재하지 않음) 문자열(문자열) 목록(목록) 집합(집합) zset(순서 있는 집합)입니다.hash(해시 테이블)

keys

주어진 패턴과 일치하는 모든 키 찾기

1
NArray Redis.keys(String pattern);

호출 매개변수:

pattern: 문자열, 쿼리 모드 지정

결과 반환:

NArray, 주어진 패턴과 일치하는 키 목록

del

하나 이상의 지정된 키를 삭제합니다. 존재하지 않는 키는 무시됩니다.

1
Integer Redis.del(Array keys);

호출 매개변수:

keys: 배열, 삭제할 키 배열을 지정합니다.

결과 반환:

Integer, 삭제된 키 수

하나 이상의 지정된 키를 삭제합니다. 존재하지 않는 키는 무시됩니다.

1Integer Redis.del(...keys);

호출 매개변수:

keys: ..., 삭제할 키 목록을 지정합니다.

결과 반환:

Integer, 삭제된 키 수

expire

특정 키의 수명을 설정합니다. 키가 만료되면 자동으로 삭제됩니다.

1
2
Boolean Redis.expire(Buffer key,
    Long ttl);

호출 매개변수:

key:Buffer, 설정할 키를 지정하세요
ttl: Long, 키의 생존 시간을 밀리초 단위로 설정합니다.

결과 반환:

Boolean, 키가 존재하면 True를 반환하고, 그렇지 않으면 False를 반환합니다.

ttl

주어진 키의 남은 생존 시간을 반환합니다.

1Long Redis.ttl(Buffer key);

호출 매개변수:

key:Buffer, 쿼리할 키를 지정합니다.

결과 반환:

Long는 키의 남은 생존 시간을 밀리초 단위로 반환하며, 키가 존재하지 않는 경우 -2를 반환하고, 키는 있지만 남은 생존 시간이 설정되지 않은 경우 -1을 반환한다.

persist

지정된 키의 수명을 제거하고 이 키를 "휘발성"(수명 기간이 있는 키)에서 "영구"(수명 기간이 없고 만료되지 않는 키)로 변환합니다.

1
Boolean Redis.persist(Buffer key);

호출 매개변수:

key:Buffer, 설정할 키를 지정하세요

결과 반환:

Boolean, 키가 존재하면 True를 반환하고, 그렇지 않으면 False를 반환합니다.

rename

키 이름을 newkey로 변경합니다. 키가 newkey와 동일하거나 키가 존재하지 않으면 오류가 반환됩니다.

1
2
Redis.rename(Buffer key,
    Buffer newkey);

호출 매개변수:

key:Buffer, 이름을 바꿀 키를 지정하세요
newkey:Buffer, 이름을 바꿀 대상 키를 지정합니다.

renameNX

newkey가 존재하지 않는 경우에만 키 이름을 newkey로 바꾸고, 키가 존재하지 않으면 오류를 반환합니다.

1
2
Boolean Redis.renameNX(Buffer key,
    Buffer newkey);

호출 매개변수:

key:Buffer, 이름을 바꿀 키를 지정하세요
newkey:Buffer, 이름을 바꿀 대상 키를 지정합니다.

결과 반환:

Boolean, 수정이 성공하면 True를 반환하고, 새 키가 이미 존재하면 False를 반환합니다.

sub

특정 채널의 정보를 구독하고 메시지가 발생하면 자동으로 func를 호출합니다. func에는 채널과 메시지라는 두 개의 매개변수가 순서대로 포함되어 있습니다. 동일한 채널의 동일한 함수는 한 번만 호출됩니다.

1
2Redis.sub(Buffer channel,
    Function func);

호출 매개변수:

channel:Buffer, 구독한 채널 이름을 지정하세요.
func: 함수, 콜백 함수 지정

특정 채널 집합의 정보를 구독하고 메시지가 발생하면 해당 콜백 함수를 자동으로 호출합니다. 동일한 채널의 동일한 함수는 한 번만 호출됩니다.

1
Redis.sub(Object map);

호출 매개변수:

map: Object, 채널 매핑 관계를 지정하며, 객체 속성 이름이 채널 이름으로 사용되고 속성 값이 콜백 함수로 사용됩니다.

unsub

해당 채널에 대한 모든 콜백 구독 취소

1Redis.unsub(Buffer channel);

호출 매개변수:

channel:Buffer, 구독 취소할 채널 이름을 지정하세요.

해당 채널의 구독을 취소하기 위해 지정된 콜백 함수

1
2Redis.unsub(Buffer channel,
    Function func);

호출 매개변수:

channel:Buffer, 구독 취소할 채널 이름을 지정하세요.
func: 함수, 구독 취소를 위한 콜백 함수를 지정합니다.

특정 채널 세트에 대한 모든 콜백 구독 취소

1
Redis.unsub(Array channels);

호출 매개변수:

channels: Array, 구독 취소할 채널 배열을 지정합니다.

특정 채널 세트에서 구독을 취소하도록 지정된 콜백 함수

1
Redis.unsub(Object map);

호출 매개변수:

map: Object, 채널 매핑 관계를 지정하며, 객체 속성 이름이 채널 이름으로 사용되고 속성 값이 콜백 함수로 사용됩니다.

psub

템플릿에 따라 채널 정보 그룹을 구독하고 메시지가 발생하면 자동으로 func를 호출합니다. func에는 채널, 메시지, 패턴의 세 가지 매개변수가 순서대로 포함되어 있습니다. 동일한 템플릿의 동일한 함수는 한 번만 호출됩니다.

1
2
Redis.psub(String pattern,
    Function func);

호출 매개변수:

pattern: 문자열, 구독 채널 템플릿을 지정합니다.
func: 함수, 콜백 함수 지정

주어진 채널 템플릿 세트의 정보를 구독하고 메시지가 발생할 때 해당 기능을 자동으로 호출합니다. 동일한 채널의 동일한 기능은 한 번만 다시 호출됩니다.

1
Redis.psub(Object map);

호출 매개변수:

map: 객체, 채널 매핑 관계를 지정합니다. 객체 속성 이름은 채널 템플릿으로 사용되며 속성 값은 콜백 함수로 사용됩니다.

unpsub

지정된 템플릿의 채널에서 모든 콜백 구독 취소

1
Redis.unpsub(String pattern);

호출 매개변수:

pattern: 문자열, 구독 취소 채널 템플릿을 지정합니다.

지정된 템플릿의 채널 구독을 취소하도록 지정된 콜백 함수

1
2
Redis.unpsub(String pattern,
    Function func);

호출 매개변수:

pattern: 문자열, 구독 취소 채널 템플릿을 지정합니다.
func: 함수, 구독 취소를 위한 콜백 함수를 지정합니다.

특정 템플릿을 사용하여 채널 집합에 대한 모든 콜백 구독 취소

1
Redis.unpsub(Array patterns);

호출 매개변수:

patterns: 배열, 게시된 채널 템플릿 배열을 지정합니다.

템플릿 채널 그룹에서 구독을 취소하도록 지정된 콜백 함수

1
Redis.unpsub(Object map);

호출 매개변수:

map: 객체, 채널 매핑 관계를 지정합니다. 객체 속성 이름은 채널 템플릿으로 사용되며 속성 값은 콜백 함수로 사용됩니다.

pub

지정된 채널에 정보 메시지 보내기

1
2
Integer Redis.pub(Buffer channel,
    Buffer message);

호출 매개변수:

channel:Buffer, 게시 채널 지정
message:Buffer, 게시할 메시지를 지정합니다.

결과 반환:

Integer, 이 메시지를 받는 클라이언트 수

getHash

지정된 키의 Hash 객체를 가져옵니다. 이 객체는 지정된 키를 포함하는 클라이언트입니다. 해당 메소드를 호출해야만 데이터베이스가 작동됩니다.

1RedisHash Redis.getHash(Buffer key);

호출 매개변수:

key:Buffer, 획득할 키를 지정합니다.

결과 반환:

RedisHash, 지정된 키를 포함하는 Hash 객체를 반환합니다.

getList

지정된 키의 List 객체를 가져옵니다. 이 객체는 지정된 키를 포함하는 클라이언트이며 해당 메소드를 호출해야만 데이터베이스가 작동됩니다.

1RedisList Redis.getList(Buffer key);

호출 매개변수:

key:Buffer, 획득할 키를 지정합니다.

결과 반환:

RedisList, 지정된 키를 포함하는 List 객체를 반환합니다.

getSet

지정된 키의 Set 객체를 가져옵니다. 이 객체는 지정된 키를 포함하는 클라이언트이며 해당 메소드를 호출해야만 데이터베이스가 작동됩니다.

1RedisSet Redis.getSet(Buffer key);

호출 매개변수:

key:Buffer, 획득할 키를 지정합니다.

결과 반환:

RedisSet, 지정된 키를 포함하는 Set 객체를 반환합니다.

getSortedSet

지정된 키의 SortedSet 객체를 가져옵니다. 이 객체는 지정된 키를 포함하는 클라이언트입니다. 해당 메소드를 호출해야만 데이터베이스가 작동됩니다.

1RedisSortedSet Redis.getSortedSet(Buffer key);

호출 매개변수:

key:Buffer, 획득할 키를 지정합니다.

결과 반환:

RedisSortedSet, 지정된 키를 포함하는 SortedSet 객체를 반환합니다.

dump

지정된 키를 직렬화하고 직렬화된 값을 반환합니다. 이 값을 Redis 키로 역직렬화하려면 복원 명령을 사용하세요.

1Buffer Redis.dump(Buffer key);

호출 매개변수:

key:Buffer, 직렬화할 키를 지정합니다.

결과 반환:

Buffer, 직렬화 후 값을 반환하고, 키가 존재하지 않으면 null을 반환합니다.

restore

주어진 직렬화된 값을 역직렬화하고 이를 주어진 키와 연결합니다.

1
2
3
Redis.restore(Buffer key,
    Buffer data,
    Long ttl = 0);

호출 매개변수:

key:Buffer, 역직렬화할 키를 지정합니다.
data:Buffer, 역직렬화할 데이터를 지정합니다.
ttl: Long, 키의 생존 시간을 밀리초 단위로 설정합니다. ttl이 0이면 생존 시간이 설정되지 않습니다.

close

현재 데이터베이스 연결 또는 트랜잭션을 닫습니다.

1Redis.close();

toString

객체의 문자열 표현을 반환하며 일반적으로 "[Native Object]"를 반환하며 객체 자체의 특성에 따라 다시 구현될 수 있습니다.

1
String Redis.toString();

결과 반환:

String, 객체의 문자열 표현을 반환합니다.

toJSON

객체의 JSON 형식 표현을 반환하며 일반적으로 객체에 의해 정의된 읽을 수 있는 속성 컬렉션을 반환합니다.

1
Value Redis.toJSON(String key = "");

호출 매개변수:

key: 문자열, 사용되지 않음

결과 반환:

Value, 직렬화 가능한 JSON을 포함하는 값을 반환합니다.

개발 가이드

기본 모듈

내장 객체

커뮤니티 모듈

객체레디스

상속관계

구성원 속성

onsuberror

멤버 함수

command

set

setNX

setXX

mset

msetNX

append

setRange

getRange

strlen

bitcount

get

mget

getset

decr

incr

setBit

getBit

exists

type

keys

del

expire

ttl

persist

rename

renameNX

sub

unsub

psub

unpsub

pub

getHash

getList

getSet

getSortedSet

dump

restore

close

toString

toJSON