Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Conecta um cliente ao servidor Redis.

Sintaxe

Bloco de código
oRedisAfter := oRedisClient:Connect(cServer, nPort [, cAuth)

ou

Bloco de código
oRedisClient:Connect(cServer, nPort)

ou

Bloco de código
oRedisClient:Connect(cServer)

ou ainda

Bloco de código
oRedisClient:Connect()
 ])

Parâmetros

NomeTipoDescriçãoObrigatórioReferênciaDefaultObservações
cServer
Caracter

Endereço do servidor Redis na rede

NãoSimNãolocalhost

nPortInteiroPorta de rede do servidorNãoSimNão6379Se fornecido, deve ser o segundo parâmetro

cParameter
CaracterComplemento do comandoInformações para autenticação no servicorNãoNão""Se fornecido, deve ser o terceiro parâmetro

Retorno

NomeTipoDescriçãoObservações
oRedisAfter
objeto tRedisClientCópia do objeto sobre o qual foi feita a chamada de ::Connect, já afetado pela tentativa de conexão.*

Isto permite acoplar outros métodos e propriedades à chamada de ::Connect()
   Por exemplo,
    oRedisClient:Connect(cServer, nPort, cAuth):lConnected

   testará se a conexão foi bem sucedida, sem a necessidade de uma consulta à parte a ::lConnected sobre o objeto oRedisClient.

Observações

  • O método ::Connect() realiza a conexão a um servidor Redis, de um objeto que apenas foi instanciado através de ::New()


  • Os parâmetros servidor, porta e autenticação permitem a conexão com um servidor remoto (em qualquer ponto da Internet), até mesmo com acesso seguro (ou autenticado) a ele.


  • A propriedade ::lConnected permite detectar se a conexão foi bem sucedida.


  • Depois de uma conexão bem sucedida, deve ser feita a desconexão, antes do final do programa, para informar ao servidor Redis que os recursos usados para a conexão não são mais necessários.

Exemplos

Exemplo 1 - Informação de todos parâmetros 
Toggle Cloak
exclusivetrue

Cloak
cpptrue

Exemplo 2 - Omissão de cAuth terceiro parâmetro  
Toggle Cloak
exclusivetrue

Cloak
cpptrue
Bloco de código
languagecpp
linenumberstrue
#include 'protheus.ch' // Setup Redis Static cRedisHost := "tec-clima" Static nRedisPort := 6379 Static cRedisAuth := "" User Function redTst() Local cMsg := '' oRedisCli := tRedisClient():New() oRedisCli:Connect(cRedisHost, nRedisPort, cRedisAuth) If oRedisCli:lConnected) ConOut("Successful connection.") oRdClient:Disconnect() ConOut("The client disconnected from the server.") Return .T. EndIf cMsg := "Could not connect to the server " + cRedisHost + ", at port " cMsg += cValToChar(nRedisPort) + ", with authentication '" + cRedisAuth + "'"   ConOut(cMsg) Return .F.