Usando ConvertNumbers no JSF

Natal DevMedia: Assine hoje e ganhe 3 meses gr�tis

No mundo de desenvolvimento de software � extremamente comum lidar com valida��es e convers�es o tempo inteiro. Valores necessitam ser convertidos nos mais diversos tipos de sistemas, principalmente se os mesmos tiverem opera��es financeiras ou c�lculos sendo efetuados. Diante desta realidade, alguns dos mais famosos frameworks criam cada vez mais recursos para facilitar a vida do desenvolvedor, bem como flexibilizar o uso de tais tecnologias, abstraindo certas funcionalidades que a pr�pria ferramenta possa realizar por completo ou parcialmente.

O JSF (Java Server Pages) � um framework Java totalmente focado em componentes web (front side) em comunica��o direta com o back end, no caso o Java. Baseado em blibliotecas de tags, com uma gama alta de componentes padr�o para telas web, ele � capaz de fornecer a quem o utiliza in�meros recursos para flexibilizar o trabalho de desenvolver telas e conect�-las com valores, neste caso representados pela figura de um ManagedBean.

Dentro deste framework � poss�vel encontrar v�rias tags que lidam com valida��o e convers�o de valores (Figura 1). Neste artigo iremos tratar, na teoria e na pr�tica, atrav� de exemplos, como o JSF lida com esses recursos. Ser� tratado como implementar as chamadas �s tags de convers�o, especialmente focadas na convers�o de n�meros.

Figura 1: JSF e ConvetNumber

Em JSF, a tag "f: convertNumber" � um dos conversores padr�o que converte String em um formato espec�fico, neste caso um "N�mero". Al�m disso, ele tamb�m � usado como um validador para verificar se o valor de entrada no backing bean, isto �, na classe Java de valores para a tela, � um n�mero v�lido. Veja a seguir exemplos comuns e bastante usados:

Nota: Assumiremos que �#{meuBean.valor}� cont�m um valor de "0.1".

O primeiro exemplo mostra como podemos usar a tag citada para configurar um n�mero m�nimo de d�gitos nas casas decimais para quando os valores do mesmo forem decimais. O nome do atributo � �minFractionDigits� e voc� pode conferir seu uso na Listagem 1.

Listagem 1: Uso do atributo �minFractionDigits� em listagem JSF

<h:outputText value="#{meuBean.valor}" >
	<f:convertNumber minFractionDigits="2" />
</h:outputText>

O valor que a Listagem 1 ir� exibir no final ser�: �0.10�.

Outro atributo bastante utilizado para a tag � o atributo �pattern�. Para desenvolvedores que j� tem conhecimento de Java ou linguagens OO, esse tipo de recurso � amplamente usado e de f�cil percep��o. Serve nada mais nada menos que para configurar como o valor ser� formatado para ser exibido no browser.

Nota: Esses tipos de recursos podem (e devem) ser usados dentro de tags que tem um atributo �value� e que possua valores num�ricos. Caso contr�rio, exce��es ser�o lan�adas em tempo de execu��o.

Veja na Listagem 2 um exemplo de uso do mesmo.

Listagem 2: Uso do atributo �pattern� na tag convertNumber.

<h:outputText value="#{meuBean.valor}" >
	<f:convertNumber pattern="#0.000" />
</h:outputText>

O resultado ser� exibido como: �0.100�.

Nota: Os valores s�o formatados baseando-se nas defini��es da classe java.text.DecimalFormat.

Da mesma forma que a formata��o de valores com pattern�s definidos exige a inclus�o de certes regras, algumas outras bem semelhantes tamb�m se aplicam, tal como a formata��o de valores monet�rios. O atributo �currencyCode� � usado para definir o tipo de c�digo monet�rio que ser� utilizado junto com o atributo �type� (valor �currency�). A Listagem 3 mostra como fazer esse tipo de formata��o.

Listagem 3: Formata��o de valores monet�rios.

<h:outputText value="#{meuBean.valor}" >
	<f:convertNumber currencyCode="R$" type="currency" />
</h:outputText>

O valor que ser� exibido ser�: �R$0.10�.

Nota: Os padr�es de defini��o do currency s�o baseados na ISO 4217. Veja na se��o Links o link para a mesma.

O atributo �type� tamb�m pode ser usado para outras finalidades, como, por exemplo, para inferir formata��es de percentuais para valores num�ricos. Na Listagem 4 � poss�vel verificar o uso do atributo.

Listagem 4. Uso do atributo �type=percent� para formata��o de valores percentuais.

<h:outputText value="#{meuBean.valor}" >
	<f:convertNumber type="percent" />
</h:outputText>

O valor exibido no final ser�: �10%�.

Observa��o: Outras op��es de atributos e formatadores podem ser encontrados na documenta��o oficial do JSF. Visite a se��o de Links e confira.

Exemplo

Os exemplos demonstrados nas listagens anteriores podem ser implementados seguindo a seguinte linha de codifica��o.

ManagedBean

Um ManagedBean simples com uma propriedade valor. Atente para o uso das anota��es de mapeamento para o JSF 2.0 (Listagem 5).

Listagem 5: ManagedBean para integra��o com tela


package br.edu.devmedia;
 
import java.io.Serializable;
import javax.faces.bean.ManagedBean;
import javax.faces.bean.SessionScoped;
 
@ManagedBean(name="meuBean")
@SessionScoped
public class MeuBean implements Serializable{ 
	double valor; 
	public double getValor() {
		return valor;
	}
 
	public void setValor(double valor) {
		this.valor = valor;
	} 
}

Exemplo ConvertNumber (xhtml)

Na p�gina valor.xhtml (Listagem 6), � poss�vel visualizar o uso dos exemplos anteriores em um s� local, tal como dever� constar no seu modelo de projeto.

Listagem 6: P�gina valor.xhtml


<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml"   
      xmlns:h="http://java.sun.com/jsf/html"
      xmlns:f="http://java.sun.com/jsf/core"
      xmlns:c="http://java.sun.com/jsp/jstl/core">
    <h:body> 
    	<h1>Exemplos ConvertNumber</h1>
 	  <ol>
		<li>
			Valor [minFractionDigits="2"] : 
			<h:outputText value="#{meuBean.valor}" >
				<f:convertNumber minFractionDigits="2" />
			</h:outputText>
		</li>
		<li>
			Valor [pattern="#0.000"] : 
			<h:outputText value="#{meuBean.valor}" >
				<f:convertNumber pattern="#0.000" />
			</h:outputText>
		</li>
		<li>
			Valor [currencySymbol="$"] : 
			<h:outputText value="#{meuBean.valor}">
				<f:convertNumber currencySymbol="$" type="currency" />
			</h:outputText>
		</li>
		<li>
			Valor [currencyCode="R$"] : 
			<h:outputText value="#{meuBean.valor}" >
				<f:convertNumber currencyCode="R$" type="currency" />
			</h:outputText>
		</li>
		<li>
			Valor [type="percent"] : 
			<h:outputText value="#{meuBean.valor}" >
				<f:convertNumber type="percent" />
			</h:outputText>
		</li>
	   </ol> 
    </h:body>
</html>

Pronto. S� criar o projeto JSF e incluir os arquivos no mesmo. N�o esquecer das configura��es do JSF.

Conclus�o

N�s cobrimos um pouco sobre o assunto neste artigo quando se trata de convers�o e valida��o JSF. Na verdade, cobrimos a maioria do que voc� realmente precisa saber sobre esses processos para faz�-los trabalhar em suas aplica��es (pelo menos para esta vers�o do JSF)!

Claro, n�o poder�amos ver tudo. Por exemplo, voc� pode querer verificar as mesmas funcionalidades fora do MyFaces (implementa��o padr�o do JSF, logo, consulte outros recursos) para os componentes de valida��o n�o oferecidos eno JSF ou discutidos aqui. Al�m disso, em rela��o �s convers�es discutidas e mais comuns e t�cnicas de valida��o, h� algumas que n�o podia estar inclusas aqui, para que n�o perd�ssemos o foco do artigo. Por exemplo, ao escrever componentes personalizados voc� pode lidar com a convers�o e/ou valida��o diretamente na decodifica��o do componente/processo de codifica��o (dependendo do tipo de componente e sua funcionalidade), mas n�s vamos ter que salvar uma discuss�o mais aprofundada do desenvolvimento de componentes personalizada para um momento posterior.

Outra coisa a se ter em mente � que a convers�o e valida��o, n�o necessariamente funcionam bem juntas. Convers�o converte strings em objetos, enquanto a maioria dos validadores padr�o trabalham em conex�o. Portanto, voc� deve ter cuidado ao usar conversores personalizados e validadores juntos. Por exemplo, os nossos campos de texto n�o iriam funcionar com um determinado conversor de validador. Neste caso, voc� teria que escrever um validador personalizado, bem como, ou simplesmente incluir qualquer l�gica de valida��o especial no conversor personalizado. N�s preferimos a segunda op��o, pois permite simplesmente associar um conversor personalizado (com built-in � l�gica de valida��o) com um tipo de objeto espec�fico e o JSF lida bem com esse tipo de objeto. O JSF faz isso por n�s automaticamente, sem ter que especificar quaisquer id's de conversor no JSP. (Claro, alguns podem chamar isso de programa��o pregui�osa, e n�o � necessariamente a melhor solu��o para todos os casos de uso.)

A discuss�o em artigo mostra, mais uma vez, que o JSF fornece uma estrutura flex�vel, poderosa e conect�vel para o desenvolvimento de aplica��es web. Al�m de conversores padr�o e validadores, ele facilita implementa��es personalizadas para acomodar tanto os desenvolvedores de aplicativos como estruturas semelhantes. Em �ltima an�lise, a estrat�gia de convers�o e valida��o voc� escolhe. O JSF permite que voc� facilmente e rapidamente comece (conversores padr�o , validadores , valida��o de linha) durante a prototipagem, a migrar para solu��es de produ��o mais sofisticadas (objetos personalizados, mensagens personalizadas), durante as fases de desenvolvimento posteriores. E ao longo de tudo isso, o ciclo de vida do aplicativo JSF fornece uma infra-estrutura confi�vel para garantir permanentemente a integridade do modelo de dados.