PodamByteValue.java

/**
 * 
 */
package uk.co.jemos.podam.common;

import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

/**
 * Annotation used to customise min and max values of a byte type attribute or
 * constructor parameter.
 * 
 * 
 * @author mtedone
 * 
 */
@Documented
@PodamAnnotation
@Target(value = { ElementType.FIELD, ElementType.PARAMETER })
@Retention(RetentionPolicy.RUNTIME)
public @interface PodamByteValue {

	/**
	 * A precise value for the annotated attribute.
	 * <p>
	 * This attribute defaults to an empty string.
	 * </p>
	 * <p>
	 * Please note that the format should be String to allow for null values for
	 * this annotation attribute. If we set the type to be byte, then to allow
	 * for {@code null} values we should have set something arbitrary as
	 * {@code default 0}. If set, the value must be convertible to the type of
	 * this annotation or a {@link NumberFormatException} will be thrown.
	 * </p>
	 * <p>
	 * If set, it will take precedence over all other annotation attributes
	 * (e.g. min/max)
	 * </p>
	 * 
	 * @return The precise byte value to assign to the annotated attribute
	 */
	String numValue() default "";

	/**
	 * The minimum value for the annotated field.
	 * 
	 * @return The minimum byte value to assign to the annotated attribute
	 */
	byte minValue() default 0;

	/**
	 * The minimum value for the annotated field.
	 * 
	 * @return The maximum byte value to assign to the annotated attribute
	 */
	byte maxValue() default 0;

	/**
	 * It allows clients to make comments.
	 * 
	 * @return A string representing comments for this annotation
	 */
	String comment() default "";

}