Versões comparadas

Chave

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

...

Registra um par de chave e valor. Ao informar um valor que já exista na base, este será substituído pelo novo.  Somente o método ou função que originou o registro consegue alterá-lo. 

Como a cahve é única para o sistema, recomendamos o uso de identificadores nas chaves ( ex: framework_meuId, gpe_senha_do_portal ) 

Parâmetro

Tipo

Descrição

Obrigatório

cID

Caracter

Identificador do registro que será armazenado

x

cValue

Caracter

Valor a ser armazenado. O limite de valor deste parâmetro é 175.

x

...

Informações

Importante!!!

O Id informado NÃO é exclusivo para o fonte/função utilizado. Se o mesmo Id for informado em um fonte/função diferente, poderá existir um conflito.

Bloco de código
titlefonte1.prw
collapsetrue
User Function teste1()

    Local cSenha:= 'minhasenha'
    Local cID      	:= 'MeuID'
    Local cDataRet	 := ""
    Local lSucesso := .T.

    lSucesso := FwSecretVault():Put(cID, cSenha) // retorno .T.
 
return

User Function teste2()
	Local cSenha:= 'minhasenha'
    Local cID      	:= 'MeuID'
    Local cNovaSenha:= "novasenha"
    Local lSucesso := .T.
    
    lSucesso := FwSecretVault():Put(cID, cNovaSenha) // retorno .F., pois já foi cadastrado
    lSucesso := FwSecretVault():Delete(cID)  // retorno .F., pois só pode ser deletado por outro fonte.
    lSucesso := FwSecretVault():Check(cID, cNovaSenha) // retorno .F., pois a senha cadastrada é outra
    lSucesso := FwSecretVault():Check(cID, cSenha) // retorno .T., pois a senha cadastrada foi essa
 
return

...

Check

Sintaxe:

FwSecretVault():Check( cID)

Descrição:

Método responsável por retornar o conteúdo armazenado.  Somente o método ou função que originou o registro consegue recuperá-lo. Confere se o par chave e valor informado é o mesmo que já foi cadastrado anteriormente.  Não há restrição de origem da chamada para conferir uma chave.

Parâmetro

Tipo

Descrição

Obrigatório

cID

Caracter

Identificador do registro que foi armazenado

x

cValue

Caracter

Valor a ser conferido

x

Retorno:

Conteúdo armazenado. Retorna uma string vazia ("") caso não encontre o ID.

...

Método responsável por deletar um dado par chave e valor que foi armazenado. Somente o método ou função que originou o registro consegue deletá-lo.

...

Bloco de código
languagedelphi
themeMidnight
titleExemplo
User Function TstSafeVault()

    Local cDatacSenha   	 := 'Textomeu valor secreto com acentuação'
    Local cID      	:= 'MeuID'
    Local cDataRet	lSucesso  := "".F. 
    
    lSucesso := FwSecretVault():Put(cID, cData)
cSenha) // lSucesso := .T.
    lSucesso cDataRet:= FwSecretVault():Check(cID, cSenha)
 // lSucesso  ConOut( 'Valor do retorno do Check = ' + cDataRet)
   := .T.
	lSucesso := FwSecretVault():Check(cID, "senhaerrada") // lSucesso := .F.
    lSucesso := FwSecretVault():Delete(cID) // lSucesso := .T.
    lSucesso cDataRet:= FwSecretVault():Check(cID)
 // lSucesso  ConOut( 'Valor do retorno do Check apos executar:= .F., o Deleteregistro = ' + cDataRet)foi deletado
 
return