Comandos

put

Descrição: associa um valor a uma chave, mesmo que ela exista
Sintaxe: put <key> <timeToLive> <timeToIdle> <size> <reserved><CR><LF> <data><CR><LF>
resposta: (replaced | stored)<CR><LF>

O comando put associa um valor a uma chave, mesmo que ela exista. Ele retorna replaced , se existir um valor associado à chave, ou stored , se não existir um valor associado à chave.

  • key: chave associada ao valor;
  • timeToLive: é a quantidade máxima de tempo que um item expira após sua criação;
  • timeToIdle:é a quantidade máxima de tempo que um item expira após o último acesso;
  • size: tamanho em bytes do item a ser inserido;
  • reserved: reservado;
  • data: dados do item a ser inserido. Tem que ser o mesmo que foi informado em size.

replace

Descrição: substitui o valor associado à chave somente se ele existir
Sintaxe: replace <key> <timeToLive> <timeToIdle> <size> <reserved><CR><LF><data><CR><LF>
resposta: (replaced | not_stored)<CR><LF>

O comando replace substitui o valor associado à chave somente se ele existir. Ele retorna replaced , se o valor for substituído, ou not_stored , se o valor não for armazenado.

  • key: chave associada ao valor;
  • timeToLive: é a quantidade máxima de tempo que um item expira após sua criação;
  • timeToIdle:é a quantidade máxima de tempo que um item expira após o último acesso;
  • size: tamanho em bytes do item a ser inserido;
  • reserved: reservado;
  • data: dados do item a ser inserido. Tem que ser o mesmo que foi informado em size.

set

Descrição: associa o valor à chave somente se a chave não estiver associada a um valor
Sintaxe: set <key> <timeToLive> <timeToIdle> <size> <reserved><CR><LF><data><CR><LF>
resposta: (stored | not_stored)<CR><LF>

O comando set associa o valor à chave somente se a chave não estiver associada a um valor. Ele retorna stored , se o valor for inserido, ou not_stored , se o valor não for armazenado. Esse comando tem uma particularidade. Quando existe um valor associado à chave, o mesmo é retornado, mas ocorrerá um error se ele expirar no momento em que for recuperado.

  • key: chave associada ao valor;
  • timeToLive: é a quantidade máxima de tempo que um item expira após sua criação;
  • timeToIdle:é a quantidade máxima de tempo que um item expira após o último acesso;
  • size: tamanho em bytes do item a ser inserido;
  • reserved: reservado;
  • data: dados do item a ser inserido. Tem que ser o mesmo que foi informado em size.

get

Descrição: retorna o valor associado à chave
Sintaxe: get <key> <update> <reserved><CR><LF>
resposta: value <key> <size> <reserved><CR><LF><data><CR><LF>

O comando get retorna o valor associado à chave. Ele também permite o bloqueio da chave em uma transação. A resposta sempre termina com end .

  • key: chave associada ao valor;
  • update: bloqueia a chave para atualização. Se for diferente de 0, ela será bloqueada para outras transações;
  • reserved: reservado;

remove

Descrição: apaga o valor associado à chave
Sintaxe: remove <key> <reserved><CR><LF>
resposta: ok | not_found

O comando remove apaga o valor associado à chave. Ele retorna ok , se o valor for removido, ou not_found , se ele não existir.

  • key: chave associada ao valor;
  • reserved: reservado;

begin

Descrição: inicia uma transação
Sintaxe: begin<CR><LF>
resposta: (ok | ERROR <code> <msg>)<CR><LF>

O comando begin marca o início de uma transação. Será retornado ok se o comando for executado com sucesso ou uma mensagem de erro. Após executado o comando, as operações serão agrupadas em uma transação que deve ser confirmada com o comando commit ou descartadas com o comando rollback.

commit

Descrição: efetiva todas as operações da transação
Sintaxe: commit<CR><LF>
resposta: (ok | ERROR <code> <msg>)<CR><LF>

O comando commit confirma todas as operações da transação atual e libera todos os bloqueios detidos pela atual sessão.

Será retornado ok se o comando for executado com sucesso ou uma mensagem de erro.

rollback

Descrição: desfaz todas as operações da transação
Sintaxe: rollback<CR><LF>
resposta: (ok | ERROR <code> <msg>)<CR><LF>

O comando rollback desfaz todas as operações da transação atual e libera todos os bloqueios detidos pela atual sessão.

Será retornado ok se o comando for executado com sucesso ou uma mensagem de erro.

show_vars

Descrição: exibe todas as variáveis globais e de sessão
Sintaxe: show_vars<CR><LF>
resposta: (<name>: (<var_value> | empty)<CR><LF> ... ) end<CR><LF>

O comando show_vars exibe todas as variáveis globais e de sessão.

Será retornado uma lista de variáveis ou um erro.

show_var

Descrição: exibe uma determinada variável global ou de sessão
Sintaxe: show_var <var_name> <CR><LF>
resposta: <var_name>: (<var_value> | empty)<CR><LF>

O comando show_var exibe uma determinada variável global ou de sessão.

Será retornado a variável ou um erro.

  • var_name: nome da variável;
  • var_value: valor da variável.

set_var

Descrição: define o valor de uma variável global ou de sessão
Sintaxe: set_var <var_name> <var_value> <CR><LF>
resposta: (ok | ERROR <code> <msg>)<CR><LF>

O comando set_var define o valor de uma variável global ou de sessão.

Será retornado a variável ou um erro.

  • var_name: nome da variável;
  • var_value: valor da variável.