【翻译 Spring 5.0.4.RELEASE】7. Null safety

翻译 2018年04月15日 19:54:25

7. Null-safety

尽管Java不允许用类型系统表示null安全,但Spring Framework现在在org.springframework.lang包中提供以下注释来声明API和字段的可空性:

  • @NonNull注解特定参数,返回值或字段不能为null(不需要参数和返回值,其中应用@NonNullApi和@NonNullFields)。

  • @Nullable注解特定参数,返回值或字段可以为null。

  • 包级别的@NonNullApi注释声明非null作为参数和返回值的默认行为。

  • 包级别的@NonNullFields批注声明非空作为字段的默认行为。

Spring框架利用了这些注释,但它们也可用于任何基于Spring的Java项目来声明无效的API和可选的无效字段。 泛型类型参数,可变参数和数组元素可空性尚不受支持,但应在即将发布的版本中,请参见SPR-15942以获取最新信息。 预期可以在Spring Framework发布之间微调可空性声明,包括次要声明。 方法体内使用的类型的可空性超出了此功能的范围。

像Reactor或Spring Data这样的库提供了利用这个特性的无效API。

7.1. Use cases

除了为Spring Framework API可空性提供明确声明之外,IDE还可以使用这些注释(例如IDEA或Eclipse)为Java开发人员提供有关null-safety的有用警告,以避免在运行时出现NullPointerException。

它们也被用来使Kotlin项目中的Spring API无效,因为Kotlin本身支持无效安全。 更多细节可在Kotlin支持文档中找到。

7.2. JSR 305 meta-annotations

Spring注释使用JSR 305注释进行元注释(一种休眠但广泛传播的JSR)。 JSR 305元注释允许像IDEA或Kotlin这样的工具供应商以通用的方式提供空安全支持,而无需为Spring注释提供硬编码支持。

没有必要也不建议在项目类路径中添加JSR 305依赖项以利用Spring的无效API。 只有基于Spring的库在其代码库中使用空安全注释的项目应该添加com.google.code.findbugs:jsr305:3.0.2与compileOnly Gradle配置或Maven提供的范围以避免编译警告。

Spring 框架 web 5.0.4.RELEASE jar

  • 2018年02月25日 22:26
  • 6.34MB
  • 下载

【翻译 Spring 5.0.4.RELEASE】Spring Framework Overview Version 5.0.4.RELEASE

1. What We Mean by “Spring” “Spring”一词在不同情况下意味着不同的事物。 它可以用来引用Spring Framework项目本身,这是它开始的地方。 随着时间的推移...
  • wengcheng_k
  • wengcheng_k
  • 2018-03-08 22:51:37
  • 79

官方原版spring-framework-5.0.4.RELEASE.rar

  • 2018年02月22日 08:42
  • 84.98MB
  • 下载

Spring 框架文档 — 版本5.0.4.RELEASE

原文地址 ,以下为翻译部分。欢迎来到 Spring 框架参考文档!请阅读 Spring框架概述,它包含了 Spring 的基本历史,设计理念,在哪里提问以及入门指南。想了解相关“最新信息”或“以前版本...
  • qq_30185419
  • qq_30185419
  • 2018-03-08 23:38:13
  • 92

【翻译 Spring 5.0.4.RELEASE】9. Appendix

9. Appendix 9.1. XML Schemas 附录的这一部分列出了与核心容器相关的XML模式。 9.1.1. The util schema 顾名思义,util标签处理常见...
  • wengcheng_k
  • wengcheng_k
  • 2018-04-15 19:56:19
  • 12

【Spring 5.0.4.RELEASE 翻译】2. Resources

2. Resources 2.1. Introduction 不幸的是,Java的标准java.net.URL类和各种URL前缀的标准处理程序不足以满足所有对低级资源的访问。 例如,没有标准化...
  • wengcheng_k
  • wengcheng_k
  • 2018-04-15 19:59:55
  • 1

spring-context-5.0.4.RELEASE.jar

  • 2018年03月05日 12:00
  • 1.03MB
  • 下载

【翻译 Spring 5.0.4.RELEASE】6. Spring AOP APIs

6. Spring AOP APIs 6.1. Introduction 上一章介绍了Spring使用@AspectJ和基于模式的方面定义对AOP的支持。 在本章中,我们将讨论Spring 1...
  • wengcheng_k
  • wengcheng_k
  • 2018-04-15 19:53:28
  • 0

Spring5.0.4 AOP 使用AspectJ方式自动代理注解(@EnableAspectJAutoProxy)

本文使用Maven建立的项目 pom.xml 文件内容 <?xml version="1.0" encoding="UTF-8"?&amp...
  • sinat_27938829
  • sinat_27938829
  • 2018-02-27 17:47:07
  • 269

【翻译 Spring 5.0.4.RELEASE】1.The IoC container

其中最重要的是Spring框架的控制反转(IoC)容器。 Spring框架的IoC容器的全面处理紧随其后,全面涵盖了Spring的面向方面编程(AOP)技术。 Spring框架拥有自己的AOP框架,这...
  • wengcheng_k
  • wengcheng_k
  • 2018-03-13 22:25:25
  • 30
收藏助手
不良信息举报
您举报文章:【翻译 Spring 5.0.4.RELEASE】7. Null safety
举报原因:
原因补充:

(最多只允许输入30个字)