Frameworksp

Atalhos

Páginas filhas
  • Classe FWSafeVault

Esta classe tem como objetivo disponibilizar um mecanismo seguro de armazenamento de dados do tipo caracter. 

Somente o método ou função + fonte que originou o registro poderá visualizar, alterar ou excluir o mesmo.

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 )

Descrição:

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

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

fonte1.prw 
User Function teste1()

    Local cData   	 := 'Texto com acentuação'
    Local cID      	:= 'MeuID'
    Local cDataRet	 := ""
	Local oVault   := FwSafeVault():New()
    
    oVault   :Put(cID, cData) //Valor exclusivo para o fonte1 função teste1
 
return

User Function teste2()
    Local cID      	:= 'MeuID'
    Local cDataRet	 := ""
	Local oVault   := FwSafeVault():New()
    
    oVault   :Get(cID) //Valor retornado aqui será vazio ( "" ) pq não houve gravação nessa função
 
return

Get

Sintaxe:

FWSafeVault():Get( 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. 

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)

Descrição:

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
User Function TstSafeVault()

    Local cData   	 := 'Texto com acentuação'
    Local cID      	:= 'MeuID'
    Local cDataRet	 := ""
	Local oVault   := FwSafeVault():New()
    
    oVault:Put(cID, cData)
    cDataRet:= oVault:Get(cID)
    ConOut( 'Valor do retorno do Get = ' + cDataRet)
    oVault:Delete(cID)
    cDataRet:= oVault:Get(cID)
    ConOut( 'Valor do retorno do Get apos executar o Delete = ' + cDataRet)
 
return