Java校驗注解-jsr303

jsr

簡介

jsr是Java Specification Requests的縮寫,意思是Java 規(guī)范提案

jsr 303

JSR-303 是JAVA EE 6 中的一項子規(guī)范,叫做Bean Validation,Hibernate Validator 是 Bean Validation 的參考實現(xiàn) . Hibernate Validator 提供了 JSR 303 規(guī)范中所有內(nèi)置 constraint(約束) 的實現(xiàn),除此之外還有一些附加的 constraint(約束)枢里。

注解

參考版本2.0.1.Final

注解 說明
AssertFalse 被注釋的元素必須為 false
AssertTrue 被注釋的元素必須為 True
DecimalMax 被注釋的元素必須是一個數(shù)字,其值必須小于等于指定的最大值
DecimalMin 被注釋的元素必須是一個數(shù)字,其值必須大于等于指定的最小值
Digits 其值必須在可接受的范圍內(nèi)淳蔼。integer = 1 , fraction = 2 (整數(shù)最大長度為1,小數(shù)最大長度為2)
Future 被注釋的元素必須是一個將來的日期
Past 被注釋的元素必須是一個過去的日期
Max 被注釋的元素必須是一個數(shù)字裁眯,其值必須小于等于指定的最大值
Min 被注釋的元素必須是一個數(shù)字鹉梨,其值必須大于等于指定的最小值
NotNull 被注釋的元素必須為 notnull
NUll 被注釋的元素必須為 null
Pattern 被注釋的元素必須符合指定的正則表達式
Size 被注釋的元素的大小必須在指定的范圍內(nèi)
Email 校驗是否是郵箱
NotEmpty 驗證對象不為空
NotBlank must contain at least one non-whitespace character

  • @NotEmpty、@Size
  <ul>
  <li>{@code CharSequence} (length of character sequence is evaluated)</li>
  <li>{@code Collection} (collection size is evaluated)</li>
  <li>{@code Map} (map size is evaluated)</li>
  <li>Array (array length is evaluated)</li>
  </ul>
  • @Decimal穿稳、@Digits
  <ul>
      <li>{@code BigDecimal}</li>
      <li>{@code BigInteger}</li>
      <li>{@code CharSequence}</li>(必須是數(shù)字)
      <li>{@code byte}, {@code short}, {@code int}, {@code long}, and their respective
      wrappers</li>
  </ul>

hibernate 自增校驗注解 參考版本6.0.17.Final

注解 說明
EAN 檢測歐洲物品編碼(European Article Number)
Length 驗證字符串長度范圍[min,max
ParameterScriptAssert 驗證參數(shù)級別腳本 jsr223
Range 數(shù)值范圍 eg:1<id<10
SafeHtml 被約束的元素必須是一個HTML
ScriptAssert 驗證類級別腳本存皂,可以對有關(guān)聯(lián)的值進行校驗 jsr223
URL 校驗string是url

...
注意

  • 使用ScriptAssertParameterScriptAssert記得引入對應(yīng)的腳本引擎。比如js腳本引擎可以引入tomcat-embed-el
  • @Range
Apply on numeric values or string representation of the numeric value
例子:
good  1 or "1"
bad : "a"

自定義校驗

有時候在特定的業(yè)務(wù)場景中需要特殊的校驗逢艘。比如你希望實現(xiàn)以下校驗功能旦袋。
bean中所有的字段都為空時校驗不通過。

步驟

  • 聲明自定義注解
@Target({TYPE })
@Retention(RUNTIME)
@Documented
// 1. Marks an annotation as being a Bean Validation constraint
// 2. validatedBy = 具體校驗類
@Constraint(validatedBy = { NotAllNullValidator.class})
public @interface NotAllNull {
    // 校驗不通過的時候打印的信息
    String message() default "屬性值不能全部為null";
    // 校驗組埋虹,用于分組校驗
    Class<?>[] groups() default { };
    //
    Class<? extends Payload>[] payload() default { };
}

  • 實現(xiàn)具體校驗類
public class NotAllNullValidator implements ConstraintValidator<NotAllNull, Object> {
    private NotAllNull notAllNull;

    @Override
    public void initialize(NotAllNull constraintAnnotation) {
        notAllNull = constraintAnnotation;
    }

    /**
     * @param value   被注解的對象
     * @param context
     * @return true 校驗通過   false 校驗失敗
     */
    @Override
    public boolean isValid(Object value, ConstraintValidatorContext context) {

        return notAllNull(value);
    }
    private boolean notAllNull(Object value) {
        Field[] allFileds = value.getClass().getDeclaredFields();
        for (Field field : allFileds) {
            try {
                if (field.get(value) != null) {
                    return true;
                }
            } catch (IllegalAccessException e) {
                e.printStackTrace();
            }
        }
        return false;
    }
}

springmvc 實現(xiàn)校驗

直接使用@Valid進行標(biāo)注
這是入?yún)?/p>

public static class Params {
        @NotNull(message = "id不能為空")
        private Integer id;

        public Integer getId() {
            return id;
        }

        public void setId(Integer id) {
            this.id = id;
        }
    }

前端訪問接口

  @RequestMapping("/test")
    public void test(@Valid Params params) {
        System.out.println(params.getId());
    }

dubbo 實現(xiàn)校驗

在提供者上添加validation="true"屬性猜憎。

<dubbo:service ref="orderReadService"
                   interface="com.order.service.OrderReadService"
                   protocol="dubbo" version="${dubbo_trade_provider_version}"
                   timeout="60000" retries="0" 
                   //只需要增加這個屬性
                   validation="true">
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市搔课,隨后出現(xiàn)的幾起案子胰柑,更是在濱河造成了極大的恐慌,老刑警劉巖爬泥,帶你破解...
    沈念sama閱讀 216,692評論 6 501
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件柬讨,死亡現(xiàn)場離奇詭異,居然都是意外死亡袍啡,警方通過查閱死者的電腦和手機踩官,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 92,482評論 3 392
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來境输,“玉大人蔗牡,你說我怎么就攤上這事颖系。” “怎么了辩越?”我有些...
    開封第一講書人閱讀 162,995評論 0 353
  • 文/不壞的土叔 我叫張陵嘁扼,是天一觀的道長。 經(jīng)常有香客問我黔攒,道長趁啸,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 58,223評論 1 292
  • 正文 為了忘掉前任督惰,我火速辦了婚禮不傅,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘赏胚。我一直安慰自己访娶,他們只是感情好,可當(dāng)我...
    茶點故事閱讀 67,245評論 6 388
  • 文/花漫 我一把揭開白布栅哀。 她就那樣靜靜地躺著震肮,像睡著了一般称龙。 火紅的嫁衣襯著肌膚如雪留拾。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 51,208評論 1 299
  • 那天鲫尊,我揣著相機與錄音痴柔,去河邊找鬼。 笑死疫向,一個胖子當(dāng)著我的面吹牛咳蔚,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播搔驼,決...
    沈念sama閱讀 40,091評論 3 418
  • 文/蒼蘭香墨 我猛地睜開眼谈火,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了舌涨?” 一聲冷哼從身側(cè)響起糯耍,我...
    開封第一講書人閱讀 38,929評論 0 274
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎囊嘉,沒想到半個月后温技,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 45,346評論 1 311
  • 正文 獨居荒郊野嶺守林人離奇死亡扭粱,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 37,570評論 2 333
  • 正文 我和宋清朗相戀三年舵鳞,在試婚紗的時候發(fā)現(xiàn)自己被綠了。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片琢蛤。...
    茶點故事閱讀 39,739評論 1 348
  • 序言:一個原本活蹦亂跳的男人離奇死亡蜓堕,死狀恐怖抛虏,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情套才,我是刑警寧澤嘉蕾,帶...
    沈念sama閱讀 35,437評論 5 344
  • 正文 年R本政府宣布,位于F島的核電站霜旧,受9級特大地震影響错忱,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜挂据,卻給世界環(huán)境...
    茶點故事閱讀 41,037評論 3 326
  • 文/蒙蒙 一以清、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧崎逃,春花似錦掷倔、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,677評論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至巴柿,卻和暖如春凛虽,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背广恢。 一陣腳步聲響...
    開封第一講書人閱讀 32,833評論 1 269
  • 我被黑心中介騙來泰國打工凯旋, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人钉迷。 一個月前我還...
    沈念sama閱讀 47,760評論 2 369
  • 正文 我出身青樓至非,卻偏偏與公主長得像,于是被迫代替她去往敵國和親糠聪。 傳聞我的和親對象是個殘疾皇子荒椭,可洞房花燭夜當(dāng)晚...
    茶點故事閱讀 44,647評論 2 354

推薦閱讀更多精彩內(nèi)容