com.biz.verification.annotation.check.BizXCheckDateTimeFormat 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.common.date.DateConstant;
import com.biz.verification.annotation.error.BizXCheckErrorMessage;
import com.biz.verification.error.constant.VerificationErrorConstant;

import java.lang.annotation.*;

/**
 * 检查时间格式的注解。
 * 用于标注字段或方法参数，指定该字段或参数的时间格式是否符合要求。
 * 目前支持字符串类型的时间、java.util.Date和Calendar
 *
 *  * 示例用法：
 * {@code
 * public class Example {
 *     @BizXCheckDateTime(
 *         format = "yyyy-MM-dd HH:mm:ss",
 *         error = @BizXCheckErrorMessage(code = 1001, message = "Invalid date format")
 *     )
 *     private String dateTime;
 * }
 * }
 * 
 *
 * @see DateConstant
 * @see BizXCheckErrorMessage
 * @since 1.0.1
 * @version 1.0.0
 * @author francis
 **/
@Target({ElementType.FIELD, ElementType.PARAMETER})
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface BizXCheckDateTimeFormat {

    /**
     * 时间格式。
     * 默认值为 {@link DateConstant#DEFAULT_DATETIME}。
     *
     * @return 时间格式字符串
     */
    String format() default DateConstant.DEFAULT_DATETIME;

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

}