啃一啃 Spring 的官方文档

2020-01-09   阅读(41)  

学 Spring,最好的资料无疑是它的官方文档了。

 

打开了 Spring 的官网:https://spring.io/

 

首页隆重介绍了

  • Spring Framework 5:重点解决异步无阻塞问题和 Spring WebFlux 新的响应式 Web 堆栈

  • Spring Boot:旨在通过最少的 Spring 前期配置尽快启动并运行

  • Spring Cloud:协调简化分布式系统

  • Spring Cloud Data Flow:连接任何数据,帮助轻松构建和编排云原生数据管道的用例

 

顶部菜单

  • PROJECTS 菜单页,列出了很多主要项目

  • GUIDES 菜单页,列出了很多功能模块的指导手册,如构建 RESTful Web 服务、任务调度...

  • BLOG 菜单页,Srping 的官方博客,产品新版本的发布与重大事件的记录

  • TRAINING & CERTIFICATION:培训与证书

     

网站 logo 的部分显示了 Spring By Pivotal,好奇查了下 Pivotal 这家公司。


2013 年 VMware 和 EMC 联合创建,获取 GE(通用电气) 1.05 亿美元投资
专注开源PaaS和大数据应用的 Cloud Foundry、Greenplum 等业务
提供的产品与服务就包含 Spring
它就是 Spring 幕后的 boss...

 

 

Spring 家族中,我使用最多的就是 Spring Framework、Spring Boot、Spring Cloud

 

Spring Framework

  • 是 Spring 家族中的所有产品的基础

  • 已经发展到 Version 5.2.3.BUILD-SNAPSHOT

  • JDK 要求最低 1.8

  • 对 Kotlin、Groovy 的支持也是很友好

  • 展示的设计哲学也是挺唬人:集成第三方;拥有灵活性;保持强大的向后兼容;注重 API 的设计;高标准代码质量

 

当前版本文档

https://docs.spring.io/spring-framework/docs/current/spring-framework-reference/index.html

历史版本文档

https://docs.spring.io/spring-framework/docs/

 

Spring Framework 的所有功能说明都在这里了。


Overview:history, design philosophy, feedback, getting started.
Core:IoC Container, Events, Resources, i18n, Validation, Data Binding, Type Conversion, SpEL, AOP.
Testing:Mock Objects, TestContext Framework, Spring MVC Test, WebTestClient.
Data Access:Transactions, DAO Support, JDBC, O/R Mapping, XML Marshalling.
Web Servlet:Spring MVC, WebSocket, SockJS, STOMP Messaging.
Web Reactive:Spring WebFlux, WebClient, WebSocket.
Integration:Remoting, JMS, JCA, JMX, Email, Tasks, Scheduling, Caching.
Languages:Kotlin, Groovy, Dynamic Languages.

 

 

Spring Boot

亮点就是提供了一个初始化工具的页面,可以按需选择自己想要的 语言、Spring Boot版本、JDK 版本、项目类库依赖,下载一个整合好的 demo 压缩包。

https://start.spring.io/

 

当前版本文档

https://docs.spring.io/spring-boot/docs/current/reference/html/

历史版本文档

https://docs.spring.io/spring-boot/docs/
The reference documentation consists of the following sections:
Legal:Legal information.
Documentation Overview:About the Documentation, Getting Help, First Steps, and more.
Getting Started:Introducing Spring Boot, System Requirements, Servlet Containers, Installing Spring Boot, Developing Your First Spring Boot Application
Using Spring Boot:Build Systems, Structuring Your Code, Configuration, Spring Beans and Dependency Injection, and more.
Spring Boot Features:Profiles, Logging, Security, Caching, Spring Integration, Testing, and more.
Spring Boot Actuator:Monitoring, Metrics, Auditing, and more.
Deploying Spring Boot Applications:Deploying to the Cloud, Installing as a Unix application.
Spring Boot CLI:Installing the CLI, Using the CLI, Configuring the CLI, and more.
Build Tool Plugins:Maven Plugin, Gradle Plugin, Antlib, and more.
“How-to” Guides:Application Development, Configuration, Embedded Servers, Data Access, and many more.

The reference documentation has the following appendices:
Application Properties:Common application properties that can be used to configure your application.
Configuration Metadata:Metadata used to describe configuration properties.
Auto-configuration Classes:Auto-configuration classes provided by Spring Boot.
Test Auto-configuration Annotations:Test-autoconfiguration annotations used to test slices of your application.
Executable Jars:Spring Boot’s executable jars, their launchers, and their format.
Dependency Versions:Details of the dependencies that are managed by Spring Boot.


译文:
参考文档包括以下部分:
法律:法律信息
文档概述:关于文档,获得帮助,第一步等
入门:介绍Spring Boot,系统要求,Servlet容器,安装Spring Boot,开发第一个Spring Boot应用程序
使用Spring Boot:构建系统,结构化代码,配置,Spring Bean和依赖注入等
Spring Boot功能:配置文件,日志记录,安全性,缓存,Spring集成,测试等
Spring Boot驱动器:监控,指标,审核等
部署Spring Boot应用程序:部署到云,作为Unix应用程序安装
Spring Boot CLI:安装CLI,使用CLI,配置CLI等
生成工具插件:Maven插件,Gradle插件,Antlib等
“使用方法”指南:应用程序开发,配置,嵌入式服务器,数据访问等等

参考文档具有以下附录:
应用属性:可用于配置应用程序的通用应用程序属性
配置元数据:用于描述配置属性的元数据
自动配置类:Spring Boot提供的自动配置类
测试自动配置注释:用于测试应用程序切片的测试自动配置批注
可执行Jars:Spring Boot的可执行jar,其启动器及其格式
依赖版本:Spring Boot管理的依赖项的详细信息

 

 

Spring Cloud

为开发人员提供了工具,以快速构建分布式系统中的某些常见模式(例如,配置管理,服务发现,断路器,智能路由,微代理,控制总线,一次性令牌,全局锁,领导选举,分布式会话,群集状态)

项目介绍与主要工具列表

https://spring.io/projects/spring-cloud

对于 Spring Cloud 相关的集成,也可以在初始化工具的页面勾选

https://start.spring.io/

 

 


 

百度、google 查了那么多年 N 手文档,是时候提升下逼格,玩玩一手货!

 

英文文档的阅读是技术进阶的必经之路...

 

ConstXiong 备案号:苏ICP备16009629号-3