Restricciones incorporadas de validación de beans
Utilice esta información para buscar información sobre las restricciones incorporadas de la API de validación de beans.
La API de validación de beans está soportada por restricciones que se expresan principalmente mediante anotaciones. Las restricciones se añaden a una clase, un campo o un método de un componente de Enterprise JavaBeans (EJB). La restricción comprueba el valor del elemento anotado.
Las restricciones pueden ser incorporadas o definidas por el usuario. Hay varias anotaciones incorporadas disponibles en el paquete de javax.validation.constraints. Se utilizan para definir definiciones de restricción normales y para crear restricciones.
La tabla siguiente es una lista de restricciones y su uso.
Restricción | Uso |
---|---|
@Null | Especifica que la propiedad de configuración decorada con esta anotación debe tener un valor nulo. Esta restricción acepta cualquier tipo. |
@NotNull | Especifica que la propiedad de configuración decorada con esta anotación no debe tener un valor nulo. Es decir, la propiedad es necesaria. Esta restricción acepta cualquier tipo. |
@AssertTrue | Especifica que la propiedad de configuración decorada con esta anotación debe ser verdadera. Los tipos de valor soportados sin boolean y Boolean. Los elementos nulos se consideran válidos. |
@AssertFalse | Especifica que la propiedad de configuración decorada con esta anotación debe ser falsa. Los tipos de valor soportados sin boolean y Boolean. Los elementos nulos se consideran válidos. |
@Min | Especifica que la propiedad de configuración decorada con esta anotación debe tener un valor mayor o igual que el mínimo especificado. Los tipos de valor soportados son BigDecimal, BigInteger, byte, short, int, long y sus respectivos derivadores. Los elementos nulos se consideran válidos. |
@Max | Especifica que la propiedad de configuración decorada con esta anotación debe tener un valor menor o igual que el máximo especificado. Los tipos de valor soportados son BigDecimal, BigInteger, byte, short, int, long y sus respectivos derivadores. Los elementos nulos se consideran válidos. |
@DecimalMin | Especifica que la propiedad de configuración decorada con esta anotación debe tener un valor mayor o igual que el mínimo especificado. Los tipos de valor soportados son BigDecimal, BigInteger, String, byte, short, int, long y sus respectivos derivadores. Los elementos nulos se consideran válidos. |
@DecimalMax | Especifica que la propiedad de configuración decorada con esta anotación debe tener un valor menor o igual que el máximo especificado. Los tipos de valor soportados son BigDecimal, BigInteger, String, byte, short, int, long y sus respectivos derivadores. Los elementos nulos se consideran válidos. |
@Size | Especifica que la propiedad de configuración decorada con esta anotación debe tener un valor entre los límites especificados (inclusive). Los tipos de valor soportados son String (se evalúa la longitud de la serie), Collection (se evalúa el tamaño de la colección), Map (se evalúa el tamaño de la correlación), Array (se evalúa la longitud de la matriz). Los elementos nulos se consideran válidos. |
@Digits | Especifica que la propiedad de configuración decorada con esta anotación debe tener un valor dentro del rango aceptado. Los tipos de valor soportados son BigDecimal, BigInteger, String, byte, short, int, long y sus respectivos derivadores. Los elementos nulos se consideran válidos. |
@Past | Especifica que la propiedad de configuración decorada con esta anotación debe tener una fecha pasada. Ahora se define como la hora actual de acuerdo con la máquina virtual. Se utiliza el calendario si el tipo de comparación es de tipo Calendar y el calendario se basa en el huso horario actual y el entorno local actual. Los tipos de valor soportados son java.util.Date, java.util.Calendar. Los elementos nulos se consideran válidos. |
@Future | Especifica que la propiedad de configuración decorada con esta anotación debe tener una fecha futura. Ahora se define como la hora actual de acuerdo con la máquina virtual. Se utiliza el calendario si el tipo de comparación es de tipo Calendar y el calendario se basa en el huso horario actual y el entorno local actual. Los tipos de valor soportados son java.util.Date, java.util.Calendar. Los elementos nulos se consideran válidos. |
@Pattern | Especifica que la propiedad de configuración decorada con esta anotación debe coincidir con la siguiente expresión regular. La expresión regular sigue los convenios de expresión regular Java™ java.util.regex.Pattern. El tipo de valor soportado es String. Los elementos nulos se consideran válidos. |