/**
* Copyright (C) 2011 JTalks.org Team
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or (at your option) any later version.
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the Free Software
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
*/
package org.jtalks.jcommune.model.validation.annotations;
import org.hibernate.validator.constraints.NotBlank;
import org.jtalks.jcommune.model.validation.validators.NotBlankSizedValidator;
import javax.validation.Constraint;
import javax.validation.Payload;
import javax.validation.ReportAsSingleViolation;
import java.lang.annotation.Documented;
import java.lang.annotation.Retention;
import java.lang.annotation.Target;
import static java.lang.annotation.ElementType.*;
import static java.lang.annotation.ElementType.PARAMETER;
import static java.lang.annotation.RetentionPolicy.RUNTIME;
/**
* Validate that the annotated string is not {@code null} or empty ignore whitespaces.
* The annotated element size must be between the specified boundaries (included).
*
* We can't annotate field with both of {@link NotBlank} and {@link javax.validation.constraints.Size}
* annotations due they can violates together in some cases and then we get random error because there
* no annotation order in hibernate validator
*
* @see <a href="https://hibernate.atlassian.net/browse/HV-462">HV-462</a>
* @see org.jtalks.jcommune.model.validation.validators.NotBlankSizedValidator
*
* @author Mikhail Stryzhonok
*/
@Constraint(validatedBy = {NotBlankSizedValidator.class})
@Target({ METHOD, FIELD, ANNOTATION_TYPE, CONSTRUCTOR, PARAMETER })
@Retention(RUNTIME)
@ReportAsSingleViolation
@NotBlank
public @interface NotBlankSized {
String message() default "{javax.validation.constraints.Size.message}";
Class<?>[] groups() default {};
Class<? extends Payload>[] payload() default {};
/**
* @return size the element must be higher or equal to
*/
int min() default 0;
/**
* @return size the element must be lower or equal to
*/
int max() default Integer.MAX_VALUE;
/**
* Defines several <code>@NotBlankWithSize</code> annotations on the same element
* @see NotBlankSized
*
*/
@Target({ METHOD, FIELD, ANNOTATION_TYPE, CONSTRUCTOR, PARAMETER })
@Retention(RUNTIME)
@Documented
@interface List {
NotBlankSized[] value();
}
}