org.hibernate.validator.constraints

Annotation Type URL

@Documented
 @Constraint(validatedBy={})
 @Target(value={METHOD,FIELD,ANNOTATION_TYPE,CONSTRUCTOR,PARAMETER})
 @Retention(value=RUNTIME)
 @Pattern(regexp="")
public @interface URL

Validates the annotated string is an URL.

The parameters protocol, host and port are matched against the corresponding parts of the URL. and an additional regular expression can be specified using regexp and flags to further restrict the matching criteria.

Note: Per default the constraint validator for this constraint uses the java.net.URL constructor to validate the string. This means that a matching protocol handler needs to be available. Handlers for the following protocols are guaranteed to exist within a default JVM - http, https, ftp, file, and jar. See also the Javadoc for URL.

In case URLs with non default protocol handlers need to be validated, Hibernate Validator can be configured to use a regular expression based URL validator only. This can be done programmatically via a ConstraintDefinitionContributor:

 
 HibernateValidatorConfiguration configuration = Validation
         .byProvider( HibernateValidator.class )
         .configure();

 configuration.addConstraintDefinitionContributor(
     new ConstraintDefinitionContributor() {
         public void collectConstraintDefinitions(ConstraintDefinitionBuilder builder) {
             builder.constraint( URL.class )
                 .includeExistingValidators( false )
                 .validatedBy( RegexpURLValidator.class );
         }
     }
 );
 
 

or via a constraint mapping configuration:

 
 <constraint-mappings
     xmlns="http://jboss.org/xml/ns/javax/validation/mapping"
     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     xsi:schemaLocation="http://jboss.org/xml/ns/javax/validation/mapping validation-mapping-1.0.xsd">

     <constraint-definition annotation="org.hibernate.validator.constraints.URL">
         <validated-by include-existing-validators="false">
             <value>org.hibernate.validator.constraintvalidators.RegexpURLValidator</value>
         </validated-by>
     </constraint-definition>
 </constraint-mappings>
 
 

Author:

Hardy Ferentschik

See Also:

RFC2396, ConstraintDefinitionContributor

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
Pattern.Flag[]	flags
Class<?>[]	groups
String	host
String	message
Class<? extends Payload>[]	payload
int	port
String	protocol
String	regexp

Element Detail

message

public abstract String message

Default:

"{org.hibernate.validator.constraints.URL.message}"

groups

public abstract Class<?>[] groups

Default:

{}

payload

public abstract Class<? extends Payload>[] payload

Default:

{}

protocol

public abstract String protocol

Returns:

the protocol (scheme) the annotated string must match, eg ftp or http. Per default any protocol is allowed

Default:

""

host

public abstract String host

Returns:

the host the annotated string must match, eg localhost. Per default any host is allowed

Default:

""

port

public abstract int port

Returns:

the port the annotated string must match, eg 80. Per default any port is allowed

Default:

-1

regexp

public abstract String regexp

Returns:

an additional regular expression the annotated URL must match. The default is any string ('.*')

Default:

".*"

flags

public abstract Pattern.Flag[] flags

Returns:

used in combination with regexp() in order to specify a regular expression option

Default:

{}