Rodrigogml: Criou página com 'O RFWDataFormatter é uma interface utilizada para criar implementações de classe que realizam a conversão de dados do sistema (como manipulado no VO ou persistido no banco) e o formato para exibição para o usuário. Por exemplo, no VO temos um valor monetário salvo com o tipo BigDecimal, mas para o usuário precisamos formatar incluindo cifrão, símbolo de moeda e número de casas decimais. O passo contrário, de tratar as entradas do usuário ou de outras fonte...'

2023-07-21T15:02:41Z

Criou página com 'O RFWDataFormatter é uma interface utilizada para criar implementações de classe que realizam a conversão de dados do sistema (como manipulado no VO ou persistido no banco) e o formato para exibição para o usuário. Por exemplo, no VO temos um valor monetário salvo com o tipo BigDecimal, mas para o usuário precisamos formatar incluindo cifrão, símbolo de moeda e número de casas decimais. O passo contrário, de tratar as entradas do usuário ou de outras fonte...'

Página nova

O RFWDataFormatter é uma interface utilizada para criar implementações de classe que realizam a conversão de dados do sistema (como manipulado no VO ou persistido no banco) e o formato para exibição para o usuário. Por exemplo, no VO temos um valor monetário salvo com o tipo BigDecimal, mas para o usuário precisamos formatar incluindo cifrão, símbolo de moeda e número de casas decimais.

O passo contrário, de tratar as entradas do usuário ou de outras fontes, também podem ser tratadas nesta classe e otimizadas por todo o sistema.

= Classes Implementadas =

O RFW já contém diversas classes implementadas que ajudarão no processo de parser e formatação dos dados, por exemplo:
* '''RFWEnumerationDataFormatter''' - Formata uma enumeration de acordo com seu valor no arquivo de bundle. Esta classe não faz o processo de parser.
* '''RFWLongDataFormatter''' - Formata um número Long para exibição, permitindo algumas configurações de formato, número máximo e mínimo, etc. para realização do parser.

Todas as classes seguem o padrão de nome: '''RFW....DataFormatter'''.

= Parser e Conversão =

O parser da informação e a formação são realizadas respectivamente pelos métodos:
* '''toVO()''' - recebe o dados bruto como entrado pelo usuário ou outra fonte e retorna o objeto para ser inserido no VO; e,
* '''toPresentation()''' - recebe o objeto do VO e formata para exibição conforme definições da classe.

= Validação no Parser =

Há o método '''validate()''' na classe. Que tem a função exclusiva de validar se a entrada do usuário pode ser interpretada e convertida pela classe.

Em suma ela tem a mesma validação do '''toVO()''', com a diferença que não retorna nenhum objeto, apenas lança exceção se falhar.

= Tamanho Máximo =

O DataFormatter costuma ter um método de tamanho máximo (maxLenght) para informar o tamanho máximo de entrada de dados para aquela formatação. Que muitas vezes pode diferir do tamanho do VO. Por exemplo, imagine que o formato salvo no VO seja uma data no formato timestamp em String: "20230721", tamanho máximo de 8 caracteres. Já o usuário entrará no formato brasileiro: "21/07/2023", tamanho máximo 10. Outro exemplo seria um CPF, salvo no VO apenas os números, mas para exibição teremos a pontuação.

Este método é muito útil para limitar entradas de campos de UI.

= reformatPresentationContent =

Este método tem uma dinâmica relativamente simples, tem a função de reformatar o dado que um usuário digita para exibi-lo no formato do sistema. Por exemplo, para um valor monetário, o usuário digita "1054,3", a aplicação consegue fazer o parser, mas exibe o valor reformatado para "$ 1.054,30". Este método tem essa finalidade.

Na implementação padrão este método chama o método '''toVO()''' para realizar o parser, e em seguida chama novamente o '''toPresentation()''' para obter o valor formatado.

RFWDataFormatter - Histórico de revisão