Enfileira um comando na fila de comandos para serem processados pelo servidor Redis.
| Bloco de código |
|---|
oRedisAfter := oRedisClient:Append(cCommand [, cParam1 [, cParam2 ... [, cParamN] ]) |
| Nome | Tipo | Descrição | Obrigatório | Referência | Observações |
|---|---|---|---|---|---|
cCommand | Caracter | Comando a ser enfileirado | X | Pode conter ? que será preenchida por parâmetro | |
| cParam1 | Caracter | Complemento do comando | Substituirá a primeira interrogação (ou ?) que houver no comando cCommand. | ||
cParam2 | Caracter | Complemento do comando | Substituirá a segunda interrogação (ou ?) que houver no comando cCommand. | ||
| ... | ... | ... | Quantidade indefinida de parâmetros complementares | ||
cParamN | Caracter | Complemento do comando | Substituirá a n-ésima interrogação (ou ?) que houver no comando cCommand. |
| Nome | Tipo | Descrição | Observações |
|---|---|---|---|
oRedisAfter | objeto tRedisClient | Cópia do objeto sobre o qual foi feita a chamada, alterado por ela.* |
* Isto permite acoplar outros métodos e propriedades à chamada de ::Append()
Por exemplo, oRedisCli:Append(cCommand, @retVal):lOk
testará se o comando foi bem sucedido, sem a necessidade de uma consulta à parte a ::lOk sobre o objeto oRedisClient.
::Append() apenas enfileira comandos para processamento pelo servidor Redis. A resposta a eles deve ser obtida por chamadas ao método ::GetReply() ::Exec() é muito semelhante em propósito ao método ::Append(): ambos disparam a execução de comandos no servidor Redis. ::Append() e ::Exec() é que o programa que dispare ::Append() não precisará aguardar o término de sua execução. E só receberá o resultado do comando quando executar o método ::GetReply(). ::Append() ideal para a programação assíncrona e concorrente do servidor Redis, ao passo que ::Exec() fica limitado à programação sequencial e síncrona. ::Append() altera o estado da propriedade tRedisClient:lOk indicando se o comando foi executado corretamente ou com erro, e neste caso o número do erro é atualizado nas propriedades tRedisClient:nError e tRedisClient:cError. set com string de comando fixa| Toggle Cloak | ||
|---|---|---|
|
| Cloak |
|---|
Nesta listagem, as chamadas a VarInfo() permitem conhecer o estado das propriedades do objeto oRedisClientdepois da chamada aos métodos, e o resultado da chamada a GetReply().
É interessante observar que:
oRedisClient:nReplyType é negativa depois da chamada do método ::Append(), indicando que este comando não teve uma resposta do servidor Redis a ser processada pelo cliente; set x 'aaa', disparado por ::Append() e recebido por ::GetReply(), é .T., indicando que foi bem sucedida a atribuição da string 'aaa' ao campo x; ::GetReply() é marcado como 5, indicando que é variável do tipo Status no contexto do Redis, ou lógica, no contexto do AdvPL. set com| Toggle Cloak | ||
|---|---|---|
|
| Cloak |
|---|
Este outro programa AdvPL é bastante similar ao anterior. Sua maior diferença é o fato de que a chamada ao comando set do AdvPL é parametrizada; ou seja: neste exemplo o comando Redis 'set x "aaa"' é quebrado em duas partes: 'set x ?' e "aaa".
A utilidade deste recurso é permitir que uma parte do comando possa ser mantida fixa, e que outras partes possam ser parametrizadas. Inclusive através de variáveis de programa, que podem ter seus valores obtidos por interação com o usuário, ou através de consulta a bases de dados.
Outro ponto interessante deste programa é o uso do comando 'get x', que recupera o resultado da atribuição ao campo x neste caso confirma que o par 'set x'e "aaa" de fato colocou o valor aaa no campo x.
mset com String de comando parametrizada e múltiplos campos e valores| Toggle Cloak | ||
|---|---|---|
|
| Cloak |
|---|
Nesta listagem são mostrados dois campos sendo afetados por um único comando, no qual os valores são passados como parâmetros. Um ponto importante é que para que os mesmos comandos set e get da listagem anterior possam lidar com múltiplos campos, eles devem ser prefixados por 'm' e transformados em 'mset' e 'mget'.
O comando mset do Redis trabalha de modo similar ao comando set; isto é: devolve verdadeiro (ou .T.) se todos campos foram atribuídos de modo corret, ou .F. caso contrário). Contudo, o comando mget retorna seu resultado como um vetor.