Java EE/Restrições Embutidas: diferenças entre revisões
[edição verificada] | [edição verificada] |
Sem resumo de edição |
|||
Linha 1: | Linha 1: | ||
__TOC__ |
|||
==Integração JSF e Bean Validation == |
==Integração JSF e Bean Validation == |
||
A especificação [http://download.oracle.com/otndocs/jcp/jsf-2_2-fr-eval-spec/index.html JSR 344 - Java Server Faces 2.2] em sua seção 3.5.6 especifica a integração com o [http://download.oracle.com/otndocs/jcp/bean_validation-1.0-fr-oth-JSpec/ JSR 303 - Bean Validation 1.0] versão anterior à [http://download.oracle.com/otndocs/jcp/bean_validation-1_1-fr-eval-spec/ JSR 349 - Bean Validation 1.1]. |
A especificação [http://download.oracle.com/otndocs/jcp/jsf-2_2-fr-eval-spec/index.html JSR 344 - Java Server Faces 2.2] em sua seção 3.5.6 especifica a integração com o [http://download.oracle.com/otndocs/jcp/bean_validation-1.0-fr-oth-JSpec/ JSR 303 - Bean Validation 1.0] versão anterior à [http://download.oracle.com/otndocs/jcp/bean_validation-1_1-fr-eval-spec/ JSR 349 - Bean Validation 1.1]. |
Revisão das 23h30min de 11 de dezembro de 2015
Integração JSF e Bean Validation
A especificação JSR 344 - Java Server Faces 2.2 em sua seção 3.5.6 especifica a integração com o JSR 303 - Bean Validation 1.0 versão anterior à JSR 349 - Bean Validation 1.1.
Apenas os valores dos componentes JSF que implementam EditableValueHolder
são validados e tem a mensagem de violação exibida automaticamente, ou seja, sem uma instância de javax.validation.Validator
e sem a adição de uma mensagem em FacesContext
.
Constraints
O pacote javax.validation.constraints
contém as restrições definidas pela API.
Abaixo são descritas todas as anotações contidas no pacote citado.
@NotNull
, conforme vista na seção anterior, define que a variável anotada não pode ser nula. Qualquer tipo de variável de referência pode ser utilizado.
@Null
restringe de forma oposta à @NotNull
, definindo que a variável anotada deve apenas ser null
.
@Null
Object obj;
@AssertTrue
define que a variável deve ser true
. Já @AssertFalse
define o contrário. Obviamente apenas os tipos Boolean
e boolean
podem ser utilizados.
@AssertFalse
Boolean ligado;
@AssertTrue
boolean funcionando;
@Max
restringe a variável a armazenar valor igual ou menor ao que essa anotação define. @Min
restringe de forma inversa. Apenas valores do tipo long
são suportados no elemento value
dessas anotações.
BigDecimal
, BigInteger
, long
, int
, short
, byte
e seus objetos wrapper respectivos são suportados pelas anotações. double
e float
não são suportados devido ao seu erro de arredondamento.
Adicionalmente o tipo String
também é suportado apesar de não constar na especificação.
@Max(42)
BigDecimal num;
@Min(50)
int valor; //Será inicializado com 0 caso vinculado com <h:inputText>, porém a validação só ocorrerá na primeira submissão dos dados para o servidor.
@DecimalMax
e @DecimalMin
são similares às de @Max
e @Min
, com a diferença de que seus elementos value
são de tipo String
e suportam valores decimais (na implementação esse elemento é convertido em BigDecimal).
@DecimalMax("200.77")
long num;
@DecimalMin(".5")
Short valor;
@Digits
restringe a quantidade máxima de dígitos que uma variável pode conter. O elemento int integer
restringe os dígitos inteiros e o int fraction
os decimais. Ambos os elementos são obrigatórios.
BigDecimal
, BigInteger
, CharSequence
(StringBuilder
e String
p. ex.), long
, int
, short
, byte
e seus objetos wrapper respectivos são suportados pela anotação.
Note que ao utilizar alguma classe que implemente CharSequence
como tipo de uma variável anotada com @Digits
somente números serão valores válidos.
@Digits(integer = 2, fraction = 1)
String valor;
@Digits(integer = 2, fraction = 1)
Long numero; //Obviamente fraction é despropositado aqui, mas a funcionalidade de integer permanece.
@Size
restringe a quantidade mínima e/ou máxima de caracteres que a variável anotada pode conter e de elementos que uma coleção pode ter. O elemento int min
define o a quantidade mínima e o int max
a máxima. Ambos os elementos são opcionais, seus valores padrão são 0 e Integer.MAX_VALUE
respectivamente.
CharSequence
, Collection
(ArrayList
e p. ex.),
Map
e vetores são tipos suportados.
@Size(min = 1, max = 5)
ArrayList<SelectItem> vetor;
@Size(min = 1, max = 5)
String palavra;
@Pattern
restringe o conteúdo da variável a obedecer à uma expressão regular. O elemento obrigatório String regexp
define a expressão regular.
@Pattern(regexp = "[A-Ea-e]")
String categoriaCNH;
O elemento opcional opcional Pattern.Flag[] flags
define alterações sobre a expressão regular especificada. Seu padrão é vazio.
As flags abaixo listadas são as mesmas constantes no objeto java.util.regex.Pattern
do Java SE 8.
Pattern.Flag.CANON_EQ
sinaliza que um caractere Unicode pode corresponder à sua forma canonicamente decomposta.
No exemplo abaixo o caracter é (\u00e9)
foi decomposto em ´ (\u0301)
e e (\u0065)
para a definição da expressão regular.
//Valores abaixo dependem da flag para que não haja violação das restrições.
@Pattern(regexp = "e\u0301", flags = Pattern.Flag.CANON_EQ)
char c = "\u00e9";
@Pattern(regexp = "\u0065\u0301", flags = Pattern.Flag.CANON_EQ)
String s = "é";
A flag Pattern.Flag.CASE_INSENSITIVE
permite que as letras sejam válidas maiúsculas ou não..
@Pattern(regexp = "[A-E]", flags = Pattern.Flag.CASE_INSENSITIVE)
String categoriaCNH;
Pattern.Flag.COMMENTS
Pattern.Flag.DOTALL
Pattern.Flag.LITERAL
Pattern.Flag.MULTILINE
Pattern.Flag.UNICODE_CASE
Pattern.Flag.UNICODE_CHARACTER_CLASS
Pattern.Flag.UNIX_LINES
@Future
e @Past
definem que a variável represente apenas data futura ou passada, respectivamente.
Apenas java.util.Date
e Calendar
são tipos suportados para essas anotações. Provavelmente na próxima versão da especificação Bean Validation os tipos LocalDate
e LocalDateTime
serão suportados.
@Future
Date previsaoFormacao;
@Past
Calendar aniversario;
Duplicação de restrições
É possível utilizar diversas restrições para um mesmo campo.
@NotNull
@Digits(integer = 1, fraction = 3)
@Max(5)
BigDecimal precoLitroCombustivel;
No entanto uma anotação não pode ser duplicada em um campo sem a utilização da anotação interna List
presente em todas as anotações embutidas (que vêm junto da API).