Java EE/Restrições Embutidas: diferenças entre revisões
[edição verificada] | [edição verificada] |
Linha 95: | Linha 95: | ||
As flags abaixo listadas são as mesmas constantes no objeto <code> [https://docs.oracle.com/javase/8/docs/api/java/util/regex/Pattern.html java.util.regex.Pattern] </code> do Java SE 8. |
As flags abaixo listadas são as mesmas constantes no objeto <code> [https://docs.oracle.com/javase/8/docs/api/java/util/regex/Pattern.html java.util.regex.Pattern] </code> do Java SE 8. |
||
====Pattern.Flag.CANON_EQ==== |
|||
<hr/> |
|||
<code>Pattern.Flag.CANON_EQ </code> sinaliza que um caractere Unicode na expressão regular pode corresponder à sua forma canonicamente decomposta. |
<code>Pattern.Flag.CANON_EQ </code> sinaliza que um caractere Unicode na expressão regular pode corresponder à sua forma canonicamente decomposta. |
||
Linha 108: | Linha 108: | ||
String s = "é"; |
String s = "é"; |
||
</source> |
</source> |
||
<hr/> |
|||
====Pattern.Flag.CASE_INSENSITIVE==== |
|||
A flag <code>Pattern.Flag.CASE_INSENSITIVE</code> permite que os caracteres na expressão regular correspondam em sua forma maiúscula ou minúscula. |
A flag <code>Pattern.Flag.CASE_INSENSITIVE</code> permite que os caracteres na expressão regular correspondam em sua forma maiúscula ou minúscula. |
||
Linha 119: | Linha 119: | ||
String categoriaCNH = "a"; |
String categoriaCNH = "a"; |
||
</source> |
</source> |
||
<hr/> |
|||
====Pattern.Flag.COMMENTS==== |
|||
<code>Pattern.Flag.COMMENTS</code> permite que espaços em branco e comentários na expressão regular sejam ignorados na correspondência. <code>#</code> inicia os comentários na expressão regular. |
<code>Pattern.Flag.COMMENTS</code> permite que espaços em branco e comentários na expressão regular sejam ignorados na correspondência. <code>#</code> inicia os comentários na expressão regular. |
||
Linha 133: | Linha 133: | ||
String sigla = "ABC"; |
String sigla = "ABC"; |
||
</source> |
</source> |
||
<hr/> |
|||
====Pattern.Flag.DOTALL==== |
|||
<code>Pattern.Flag.DOTALL</code> |
<code>Pattern.Flag.DOTALL</code> |
||
<hr/> |
|||
====Pattern.Flag.LITERAL==== |
|||
<code>Pattern.Flag.LITERAL</code> |
<code>Pattern.Flag.LITERAL</code> |
||
<hr/> |
|||
====Pattern.Flag.MULTILINE==== |
|||
<code>Pattern.Flag.MULTILINE</code> |
<code>Pattern.Flag.MULTILINE</code> |
||
<hr/> |
|||
====Pattern.Flag.UNICODE_CASE==== |
|||
<code>Pattern.Flag.UNICODE_CASE</code> |
<code>Pattern.Flag.UNICODE_CASE</code> |
||
<hr/> |
|||
====Pattern.Flag.UNICODE_CHARACTER_CLASS==== |
|||
<code>Pattern.Flag.UNICODE_CHARACTER_CLASS</code> |
<code>Pattern.Flag.UNICODE_CHARACTER_CLASS</code> |
||
<hr/> |
|||
====Pattern.Flag.UNIX_LINES==== |
|||
<code>Pattern.Flag.UNIX_LINES</code> |
<code>Pattern.Flag.UNIX_LINES</code> |
||
Revisão das 13h55min de 28 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
@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 e AssertFalse
@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 e Min
@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
@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
@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
@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
@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
Pattern.Flag.CANON_EQ
sinaliza que um caractere Unicode na expressão regular 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 = "é";
Pattern.Flag.CASE_INSENSITIVE
A flag Pattern.Flag.CASE_INSENSITIVE
permite que os caracteres na expressão regular correspondam em sua forma maiúscula ou minúscula.
No código abaixo, categoriaCNH
é aceito pela validação por conta da flag.
//O mesmo que definir "[A-Ea-e]" em regexp
@Pattern(regexp = "[A-E]", flags = Pattern.Flag.CASE_INSENSITIVE)
String categoriaCNH = "a";
Pattern.Flag.COMMENTS
Pattern.Flag.COMMENTS
permite que espaços em branco e comentários na expressão regular sejam ignorados na correspondência. #
inicia os comentários na expressão regular.
A String a
é aceita pela validação já que os caracteres após #
na expressão regular são ignorados bem como o espaço em branco na expressão regular da anotação na variável sigla
.
//O mesmo que definir "[A-Ea-e]" em regexp
@Pattern(regexp = "a#comentario", flags = Pattern.Flag.COMMENTS)
String palavra = "a";
@Pattern(regexp = "A B C", flags = Pattern.Flag.COMMENTS)
String sigla = "ABC";
Pattern.Flag.DOTALL
Pattern.Flag.DOTALL
Pattern.Flag.LITERAL
Pattern.Flag.LITERAL
Pattern.Flag.MULTILINE
Pattern.Flag.MULTILINE
Pattern.Flag.UNICODE_CASE
Pattern.Flag.UNICODE_CASE
Pattern.Flag.UNICODE_CHARACTER_CLASS
Pattern.Flag.UNICODE_CHARACTER_CLASS
Pattern.Flag.UNIX_LINES
Pattern.Flag.UNIX_LINES
Future e Past
@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).