com.biz.verification.annotation.check.BizXCheckSize Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of biz-all Show documentation

BizX 是一个灵活而高效的业务开发框架, 其中也有很多为业务开发所需要的工具类的提供。

The newest version!

package com.biz.verification.annotation.check;

import com.biz.verification.annotation.error.BizXCheckErrorMessage;
import com.biz.verification.error.constant.VerificationErrorConstant;

import java.lang.annotation.*;

/**
 * 检查长度的注解。
 * 用于标注字段或方法参数，指定该字段或参数的长度范围。
 *
 *  * 示例用法：
 * {@code
 * public class Example {
 *     @BizXCheckSize(
 *         min = 1,
 *         max = 10,
 *         error = @BizXCheckErrorMessage(code = 1013, message = "Length must be between 1 and 10")
 *     )
 *     private String value;
 * }
 * }
 * 
 *
 * @see BizXCheckErrorMessage
 * @since 1.0.1
 * @version 1.0.0
 * @author francis
 **/
@Target({ElementType.FIELD, ElementType.PARAMETER})
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface BizXCheckSize {

    /**
     * 指定的最小长度。
     *
     * @return 最小长度，默认为 {@link Long#MIN_VALUE}
     */
    long min() default Long.MIN_VALUE;

    /**
     * 指定的最大长度。
     *
     * @return 最大长度，默认为 {@link Long#MAX_VALUE}
     */
    long max() default Long.MAX_VALUE;

    /**
     * 自定义异常信息。
     *
     * @return 异常信息
     */
    BizXCheckErrorMessage error() default @BizXCheckErrorMessage(
            code = VerificationErrorConstant.CheckSizeError.CODE,
            message = VerificationErrorConstant.CheckSizeError.MESSAGE);

}