Spring注解@NonNull作用 Spring注解@Nullable作用 Spring NonNull 注解作用 Spring Nullable注解作用

Spring注解@NonNull作用 Spring注解@Nullable作用 Spring NonNull 注解作用 Spring Nullable注解作用

一、概述

        在看Spring源码的时候，经常会发现有 @NonNull 或 @Nullable 注解的标记，一般是在方法上，或在 参数中，本着好奇的心里，研究下这2个注解的作用是什么呢？

二、代码理解

        1、@NonNull： org.springframework.lang.NonNull

        2、@Nullable： org.springframework.lang.Nullable

        3、写一段代码测试，验证 NonNull 和 Nullable 注解是否有参数验证功能

  

   

    

     

    
    

     

      @RunWith(SpringRunner.class)
     
    
   

    

     

    
    

     

      @SpringBootTest
     
    
   

    

     

    
    

     

      public 
      class 
      NullableSpringTest {
     
    
   

    

     

    
    

     
 
     
    
   

    

     

    
    

     
    
      @Test
     
    
   

    

     

    
    

     
    
      public 
      void 
      test
      () 
      throws Exception{
     
    
   

    

     

    
    

     

              say(
      "小明",
      "北京市");
     
    
   

    

     

    
    

     

              say(
      null,
      null);
     
    
   

    

     

    
    

     

          }
     
    
   

    

     

    
    

     
 
     
    
   

    

     

    
    

     
    
      public 
      void 
      say
      (@NonNull String name , @Nullable String addr){
     
    
   

    

     

    
    

     

              System.out.println(
      "@NonNull name ="+ name+ 
      " ; @Nullable addr = " + addr);
     
    
   

    

     

    
    

     

          }
     
    
   

    

     

    
    

     

      }
     
    
  

        4、执行完毕后，输出结果如下：

  

   

    

     

    
    

     

      @NonNull name =小明 ; 
      @Nullable  addr = 北京市
     
    
   

    

     

    
    

     

      @NonNull name =
      null ; 
      @Nullable  addr = 
      null
     
    
  

三、总结

        1、根据【二-4】中测试输出的结果可知： @NonNull 或 @Nullable ， 没有参数验证功能，只是一个标记注解，告知调用方：是否允许为null的情况。

• @NonNull ： 表示不能为null
• @Nullable ： 表示允许为null

        2、作用范围是： 方法上、参数、字段（类属性上）

  

   

    

     

    
    

     

      @Target({ElementType.METHOD, ElementType.PARAMETER, ElementType.FIELD})
     
    
   

    

     

    
    

     

      @Retention(RetentionPolicy.RUNTIME)
     
    
   

    

     

    
    

     

      @Documented
     
    
   

    

     

    
    

     

      @Nonnull(when = When.MAYBE)
     
    
   

    

     

    
    

     

      @TypeQualifierNickname
     
    
   

    

     

    
    

     

      public 
      @interface Nullable {
     
    
   

    

     

    
    

     
    
     
    
   

    

     

    
    

     

      }
     
    
  

        3、在阿里技术出品《Java工程师必读手册》 ， 也提到过 @NonNull 和@Nullable 标注参数。