/**
 * 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();
    }
}