Java EE/Restrições Embutidas: diferenças entre revisões

===NotNull===

<code>@NotNull</code> define que a variável anotada não pode conter <code>null</code>. Enquanto <code>@Null</code> define que apenas <code>null</code> seja referenciado pela variável.

@Null

Throwable erroOuExcecao;

@NotNull

Integer numero;

 

===AssertTrue e AssertFalse===

<code>@AssertTrue</code> define que a variável deve ser <code>true</code>. Já <code>@AssertFalse</code> define o contrário. Obviamente apenas os tipos <code>Boolean</code> e <code>boolean</code> podem ser utilizados.

@AssertFalse

Boolean ligado;

@AssertTrue

boolean funcionando;

 

===Max e Min===

 

Adicionalmente o tipo <code>String</code> 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===

<code>@DecimalMax</code> e <code>@DecimalMin</code> são similares às de <code>@Max</code> e <code>@Min</code>, com a diferença de que seus elementos <code>value</code> são de tipo <code>String</code> e suportam valores decimais (na implementação esse elemento é convertido em BigDecimal).

 

@DecimalMax("200.77")

long num;

@DecimalMin(".5")

Short valor;

 

===Digits===

Note que ao utilizar alguma classe que implemente <code>CharSequence</code> como tipo de uma variável anotada com <code>@Digits</code> 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===

<code>CharSequence</code>, <code>Collection</code> (<code>ArrayList</code> e <code></code> p. ex.), <code>Map</code> e vetores são tipos suportados.

 

@Size(min = 1, max = 5)

ArrayList<SelectItem> vetor;

@Size(min = 1, max = 5)

String palavra;

 

===Pattern===

<code>@Pattern</code> restringe o conteúdo da variável a obedecer à uma expressão regular. O elemento obrigatório <code>String regexp</code> define a expressão regular.

 

@Pattern(regexp = "[A-Ea-e]")

String categoriaCNH;

 

O elemento opcional opcional <code>Pattern.Flag[] flags</code> define alterações sobre a expressão regular especificada. Seu padrão é vazio.

No exemplo abaixo o caracter <code>é (\u00e9)</code> foi decomposto em <code>´ (\u0301)</code> e <code>e (\u0065)</code> 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)

@Pattern(regexp = "\u0065\u0301", flags = Pattern.Flag.CANON_EQ)

String s = "é";

 

====Pattern.Flag.CASE_INSENSITIVE====

No código abaixo, <code>categoriaCNH</code> é 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====

A String <code>a</code> é aceita pela validação já que os caracteres após <code>#</code> na expressão regular são ignorados bem como o espaço em branco na expressão regular da anotação na variável <code>sigla</code>.

 

//O mesmo que definir "[A-Ea-e]" em regexp

@Pattern(regexp = "a#comentario", flags = Pattern.Flag.COMMENTS)

@Pattern(regexp = "A B C", flags = Pattern.Flag.COMMENTS)

String sigla = "ABC";

 

====Pattern.Flag.DOTALL====

A flag <code>Pattern.Flag.DOTALL</code> possibilita que a expressão regular <code>.</code> possa corresponder com [[w:en:Newline | caracteres de terminação de linha]].

 

@Pattern(regexp = "..", flags = Pattern.Flag.DOTALL)

String quebraDeLinha = "\n";

 

 

====Pattern.Flag.LITERAL====

Apenas <code>java.util.Date</code> e <code>Calendar</code> são tipos suportados para essas anotações. Provavelmente na próxima versão da especificação Bean Validation os tipos <code>LocalDate</code> e <code>LocalDateTime</code> 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 <code>List</code> presente em todas as anotações embutidas (que vêm junto da API).