Métodos de Validação em JSF � Parte V

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

M�todos de Valida��o em JSF � Parte V

Criando um componente de valida��o personalizado

Quando a valida��o n�o esta amarrada a l�gica de neg�cio da aplica��o, mas nenhum dos validadores padr�o do JSF n�o � o suficiente.

Vamos implementar um componente personalizado de valida��o, para isso precisaremos de uma classe que implemente a interface Validator e possua um m�todo chamado validate, �nico m�todo definido pela interface.

void validate(FacesContext context, UIComponent componente,Object value)

Quando uma valida��o falha, devemos gerar uma FacesMessage que descreva o erro, construa uma ValidadorException e apresente-a:

if (vlPgto < vlMinimo) {

FacesMessage message = new FacesMessage(

"Pagamento abaixo do valor minimo aceit�vel:"

+ " (R$"

+ vlMinimo + ").");

throw new ValidatorException(message);

}

Crie um pacote chamado fatura.model e nele crie a classe FaturaBean conforme mostrado a seguir:

package fatura.model;

public class FaturaBean {

private String clienteNome;

private double valorPagto;

public String getClienteNome() {

return (clienteNome);

}

public void setClienteNome(String nome) {

this.clienteNome = nome;

}

public double getValorPagto() {

return (valorPagto);

}

public void setValorPagto(double valorPg) {

this.valorPagto = valorPg;

}

public String efetuarPagto() {

return ("success");

}

A classe FaturaBean tem dois atributos definidos como private e seus m�todos de acesso (getters e setters) al�m do m�todo efetuarPagto() que retorna uma string.

package fatura.control;

import javax.faces.application.FacesMessage;

import javax.faces.component.UIComponent;

import javax.faces.context.FacesContext;

import javax.faces.validator.Validator;

import javax.faces.validator.ValidatorException;

public class Validacao implements Validator {

@Override //comente essa linha se estive usando jdk 1.4

public void validate(FacesContext context, UIComponent componente,Object value)

throws ValidatorException {

//Em uma situa��o real estes campos deveriam estar definidos como privados

double vlPgto = ((Double) value).doubleValue();

double vlMinimo = vlMinimoPgto();

if (vlPgto < vlMinimo) {

FacesMessage message = new FacesMessage(

"Pagamento abaixo do valor minimo aceit�vel:"

+ " (R$"

+ vlMinimo + ").");

throw new ValidatorException(message);

}

public double vlMinimoPgto() {

/** Em uma situa��o real este valor retornado seria

* originado de uma consulta ao banco de dados

return (10.00);

}

Al�m disso, precisaremos de uma classe auxiliar ao validator para que atrav�s dela o validador seja reconhecido, nesse momento ela instancia a classe Validacao.

Crie em fatura.control a classe TagValidacao:

package fatura.control;

import javax.faces.validator.Validator;

import javax.faces.webapp.ValidatorTag;

import javax.servlet.jsp.JspException;

@SuppressWarnings("serial") //comente essa linha se estive usando jdk 1.4

public class TagValidacao extends ValidatorTag {

public TagValidacao() {

super();

setId("Validacao");

}

protected Validator createValidator() throws JspException{

return new Validacao();

}

No arquivo faces-config.xml vamos registrar a classe Valida��o no item validator, conforme o arquivo abaixo:

<?xml version="1.0"?>

<!DOCTYPE faces-config PUBLIC "-//Sun Microsystems, Inc.//DTD JavaServer Faces Config 1.1//EN" "http://java.sun.com/dtd/web-facesconfig_1_1.dtd">

<faces-config>

<!�Configurando o Back Bean FaturaBean -->

<managed-bean>

<managed-bean-name>faturaBean</managed-bean-name>

<managed-bean-class>fatura.model.FaturaBean</managed-bean-class>

<managed-bean-scope>request</managed-bean-scope>

</managed-bean>

<!� Regras de valida��o -->

<navigation-rule>

<navigation-case>

<from-outcome>success</from-outcome>

<to-view-id>/respostas/confirmacao.jsp</to-view-id>

</navigation-case>

</navigation-rule>

<validator-id>valida</validator-id>

<validator-class>fatura.control.Validacao</validator-class>

</validator>

</faces-config>

A arquivo a seguir � o web.xml, se voc� estiver usando o NetBeans ou o Eclipse com algum algum plugin voc� n�o precisar� fazer muitas modifica��es, contudo, caso seja necess�rio, altere o servlet-mapping:

<servlet-mapping>

<servlet-name>FacesServlet</servlet-name>

<url-pattern>*.faces</url-pattern>

</servlet-mapping>

<?xml version="1.0" encoding="UTF-8"?>

<web-app xmlns="http://java.sun.com/xml/ns/j2ee"

xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd"

version="2.4">

<display-name>MyFaces Application</display-name>

<servlet-name>FacesServlet</servlet-name>

<servlet-class>javax.faces.webapp.FacesServlet</servlet-class>

<load-on-startup>1</load-on-startup>

</servlet>

<servlet-mapping>

<servlet-name>FacesServlet</servlet-name>

<url-pattern>*.faces</url-pattern>

</servlet-mapping>

<welcome-file-list>

<welcome-file>index.jsp</welcome-file>

</welcome-file-list>

</web-app>

A seguir c�digo do arquivo index.jsp :

<%@page pageEncoding="UTF-8" contentType="text/html; charset=UTF-8" %>

<html>

<head>

</head>

<body>

<% response.sendRedirect("main.faces"); %>

</body>

</html>

A seguir vemos o c�digo do arquivo main.jsp que ser� usado para entrada de dados do usu�rio para pagamento das faturas, vale destacar no c�digo abaixo:

<h:inputText value="#{faturaBean.valorPagto}" id="valorPagto" required="true" >

<f:validator validatorId="valida" />

</h:inputText>

Explicando o c�digo acima:

Na Tag <h:inputText> temos o campo required="true" como vimos no artigo anterior, esse campo faz com que o prenchimento do campo seja exigido, em value="#{faturaBean.valorPagto}" fazemos refer�ncia ao Back Bean FaturaBean e o atributo valorPagto mas o que realmente � novo pra n�s � a linha:

<f:validator validatorId="valida" />

Informamos que o validatorId=�valida�, como pode ver no arquivo faces-config.xml n�s registramos o nosso validator e informamos que o seu id seria: valida.

<%@ taglib uri="http://java.sun.com/jsf/core" prefix="f" %>

<%@ taglib uri="http://java.sun.com/jsf/html" prefix="h" %>

<f:view>

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">

<HTML>

<HEAD><TITLE>Pagamento de Faturas</TITLE>

</HEAD>

<BODY>

<h2>Pagamento de Fatura</h2>

<h:form>

<TABLE>

<TR>

<TD>Cliente: </TD>

<TD><h:inputText value="#{faturaBean.clienteNome}"

id="clienteNome" required="true">

</h:inputText>

<h:message for="clienteNome" styleClass="destaque"/></TD>

</TR>

<TR>

<TD>Valor a Pagar(R$):</TD>

<TD><h:inputText value="#{faturaBean.valorPagto}"

id="valorPagto" required="true" >

<f:validator validatorId="valida" />

</h:inputText><br />

</TD>

</TR>

<h:message for="valorPagto" styleClass="destaque"/>

</td>

</TR>

<TR>

<h:commandButton value="Confirmar"

action="#{faturaBean.efetuarPagto}"/>

</td>

</TR>

</TABLE>

</h:form>

</BODY>

</HTML>

</f:view>

Observe a Figura 2.

Crie o arquivo estilo.css em web/estilos:

.destaque {

font-weight: bold;

font-size:small;

font-family:arial,helvetica;

color: red;

background-color: yellow;

}

Crie em web/respostas o arquivo confirmacao.jsp (Figura 2)

<%@ taglib uri="http://java.sun.com/jsf/core" prefix="f" %>

<%@ taglib uri="http://java.sun.com/jsf/html" prefix="h" %>

<f:view>

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">

<HTML>

<HEAD><TITLE>Pagamento Recebido</TITLE>

</HEAD>

<BODY>

<H2>Pagamento Efetuado com Sucesso!</H2>

Caro(a) <b><h:outputText value="#{faturaBean.clienteNome}"/> </b> o seu pagamento no valor de <b>R$<h:outputText value="#{faturaBean.valorPagto}"/></b><br />

foi recebido com sucesso.

<p/>Obrigado.

</BODY>

</HTML>

</f:view>