Histórico da Página
Esta classe tem como objetivo disponibilizar um mecanismo seguro de armazenamento de dados do tipo caracter.
Somente o dono do registro que foi guardado de forma segura método ou função + fonte que originou o registro poderá visualizar, alterar ou excluir o registromesmo.
Informações |
---|
Requisitos: Esta classe estará disponível na LIB de versão igual ou superior à 20210405. Versão mínima necessária do appserver para a utilização da classe é 17.3.0.15. Realease do protheus igual ou superior a 12.1.23. |
Métodos:
Put
Sintaxe:
FWSafeVault():Put( cID, cValue )
...
Método responsável por inserir ou alterar um registro, guardando o mesmo de forma segura. Ao informar um valor que já exista na base, este será substituído pelo novo.
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 |
Retorno:
Se verdadeiro, indica que conseguiu guardar o registro
Informações | |||||||
---|---|---|---|---|---|---|---|
Importante!!! O Id informado é exclusivo para o fonte/função utilizado. Mesmo que o mesmo Id seja informado em um fonte/função diferente eles não se influenciarão. Ex
|
...
Get
Sintaxe:
FWSafeVault():Get( cID)
...
Método responsável por retornar o conteúdo armazenado. Somente o método ou função que originou o registro consegue recuperá-lo.
Parâmetro | Tipo | Descrição | Obrigatório |
cID | Caracter | Identificador do registro que foi armazenado | x |
Retorno:
Conteúdo armazenado. Retorna uma string vazia ("") caso não encontre o ID.
...
Delete
Sintaxe:
FWSafeVault():Delete( cID)
...
Método responsável por deletar um dado que foi armazenado. Somente o método ou função que originou o registro consegue deletá-lo.
Parâmetro | Tipo | Descrição | Obrigatório |
cID | Caracter | Identificador do registro que será deletado | x |
Retorno:
Se verdadeiro, indica que conseguiu remover o registro.
Exemplo:
...
Bloco de código | ||||||
---|---|---|---|---|---|---|
| ||||||
User Function TstSafeVault() Local cData := 'Texto com acentuação' Local cID := 'MeuID' Local cDataRet := "" Local oVault := FwSafeVault():New() FwSafeVault() oVault:Put(cID, cData) cDataRet:= FwSafeVault()oVault:Get(cID) ConOut( 'Valor do retorno do Get = ' + cDataRet) FwSafeVault()oVault:Delete(cID) cDataRet:= FwSafeVault()oVault:Get(cID) ConOut( 'Valor do retorno do Get apos executar o Delete = ' + cDataRet) return |
...