SpringBoot 3.1 中文指南:快速入门与升级

2 下载量 170 浏览量 更新于2024-06-13 收藏 17.84MB PDF 举报
"SpringBoot3.1中文文档" SpringBoot是一个流行的Java框架,它简化了创建和配置基于Spring的应用程序。这份文档详细介绍了SpringBoot 3.1.0-SNAPSHOT版本的相关信息,包括获取帮助、文档概览、入门指南、升级流程以及使用SpringBoot进行开发的各个方面。 在文档概览部分,我们了解到SpringBoot的第一步通常是搭建环境,从较早版本升级,以及了解如何利用SpringBoot的各种功能。这些功能包括Web开发、数据处理、消息传递、I/O操作、容器镜像支持、转向生产环境、GraalVM原生镜像的生成以及一系列高级主题。 入门章节详细阐述了SpringBoot的基本概念,如系统要求(包括Servlet容器和GraalVM原生镜像的兼容性),安装步骤(覆盖了Maven、Gradle、SpringBoot CLI等不同方式),以及如何编写和运行你的第一个SpringBoot应用。这个过程涉及创建POM文件,添加依赖,使用@RestController和@RequestMapping注解来处理HTTP请求,使用@SpringBootApplication注解来标识主类,以及编写“main”方法来启动应用。 升级部分指导用户如何从1.x版本升级,并提供了升级到新特性版本的步骤,同时涵盖了SpringBoot CLI的更新。这里还提到了升级后应阅读的相关文档。 在使用SpringBoot进行开发的部分,文档深入探讨了构建系统,包括依赖管理、Maven、Gradle、Ant和Starter的使用。此外,还讨论了代码结构,比如“default”包的约定,启动类的位置,以及如何组织Configuration类,包括导入额外的配置类和XML配置的支持。 这份SpringBoot 3.1.0-SNAPSHOT中文文档是开发者学习和使用SpringBoot的宝贵资源,覆盖了从入门到进阶的各个环节,有助于提升开发效率和应用质量。
294 浏览量
spring3.1中文参考文档,南磊翻译,现在有4章,目录如下: 第一部分 Spring framework概述.......................................................................................................................6 第1章 Spring Framework介绍.......................................................................................................................7 1.1 依赖注入和控制反转 ............................................................................................................................7 1.2 模块............................................................................................................................................................7 1.2.1 核心容器...........................................................................................................................................8 1.2.2 数据访问/整合 ................................................................................................................................9 1.2.3 Web .....................................................................................................................................................9 1.2.4 AOP和基础组件...............................................................................................................................9 1.2.5 测试....................................................................................................................................................9 1.3 使用方案................................................................................................................................................ 10 1.3.1 依赖管理和命名规约 ................................................................................................................. 13 1.3.1.1 Spring依赖和基于Spring ................................................................................................... 14 1.3.1.2 Maven依赖管理 ................................................................................................................... 15 1.3.1.3 Ivy依赖管理........................................................................................................................... 16 1.3.2 日志................................................................................................................................................. 17 1.3.2.1 不使用Commons Logging.................................................................................................. 18 1.3.2.2 使用SLF4J.............................................................................................................................. 18 1.3.2.3 使用Log4J ............................................................................................................................. 20 第二部分 Spring 3的新特性............................................................................................................................. 22 第2章 Spring 3.0的新特性和增强 ............................................................................................................ 22 2.1 Java 5 ........................................................................................................................................................ 22 2.2 改进的文档 ........................................................................................................................................... 22 2.3 新的文章和教程 .................................................................................................................................. 22 2.4 新的模块组织方式和系统构建方式............................................................................................... 23 2.5 新特性概述 ........................................................................................................................................... 23 2.5.1 为Java 5更新的核心API........................................................................................................... 24 2.5.2 Spring表达式语言 ........................................................................................................................ 24 2.5.3 控制反转(IoC)容器 ................................................................................................................ 25 2.5.3.1 基于Java的bean元数据.................................................................................................. 25 2.5.3.2 使用组件定义bean的元数据.......................................................................................... 26 2.5.4 通用的类型转换系统和字段格式化系统 .............................................................................. 26 2.5.5 数据层 ............................................................................................................................................ 26 2.5.6 Web层............................................................................................................................................. 26 2.5.6.1 全面的REST支持 ................................................................................................................ 27 2.5.6.2 @MVC的增加........................................................................................................................ 27 2.5.7 声明式的模型验证 ...................................................................................................................... 27 2.5.8先期对Java EE 6的支持 ............................................................................................................. 27 2.5.9 嵌入式数据库的支持 ................................................................................................................. 27 第3章 Spring 3.1的新特性和增强 ............................................................................................................ 28 3.1 新特性概述 ........................................................................................................................................... 28 第三部分 核心技术............................................................................................................................................. 29 第4章 IoC容器............................................................................................................................................... 30 4.1 Spring IoC容器和bean的介绍 ......................................................................................................... 30 4.2 容器概述................................................................................................................................................ 30 4.2.1 配置元数据 ................................................................................................................................... 31 4.2.2 实例化容器 ................................................................................................................................... 32 4.2.2.1 处理基于XML的配置元数据........................................................................................... 33 4.2.3 使用容器........................................................................................................................................ 34 4.3 Bean概述................................................................................................................................................ 35 4.3.1 命名bean ...................................................................................................................................... 35 4.3.1.1 在bean定义外面起别名................................................................................................... 36 4.3.2 实例化bean .................................................................................................................................. 37 4.3.2.1 使用构造方法实例化 ......................................................................................................... 37 4.3.2.2 使用静态工厂方法来实例化 ............................................................................................ 37 4.3.2.3 使用实例工厂方法来实例化 ............................................................................................ 38 4.4 依赖......................................................................................................................................................... 39 4.4.1 依赖注入........................................................................................................................................ 39 4.4.1.1 基于构造方法的依赖注入 ................................................................................................ 40 4.4.1.2 基于setter方法的依赖注入............................................................................................. 42 4.4.1.3 解决依赖过程....................................................................................................................... 43 4.4.1.4 依赖注入示例....................................................................................................................... 44 4.4.2 深入依赖和配置 .......................................................................................................................... 46 4.4.2.1 直接值(原生类型,String,等) ............................................................................ 46 4.4.2.2 引用其它bean(协作者) ............................................................................................... 48 4.4.2.3 内部bean .............................................................................................................................. 49 4.4.2.4 集合......................................................................................................................................... 49 4.4.2.5 null和空字符串..................................................................................................................... 52 4.4.2.6 使用p-命名空间的XML快捷方式 ................................................................................. 53 4.4.2.7 使用c-命名空间的XML快捷方式 .................................................................................. 54 4.4.2.8 复合属性名称....................................................................................................................... 55 4.4.3 使用depends-on..................................................................................................................... 55 4.4.4 延迟初始化bean ......................................................................................................................... 56 4.4.5 自动装配协作者 .......................................................................................................................... 56 4.4.5.1 自动装配的限制和缺点 ..................................................................................................... 57 4.4.5.2 从自动装配中排除bean.................................................................................................... 58 4.4.6 方法注入........................................................................................................................................ 58 4.4.6.1 查找方法注入....................................................................................................................... 59 4.4.6.2 任意方法的替代 .................................................................................................................. 60 4.5 Bean的范围 ........................................................................................................................................... 61 4.5.1 单例范围........................................................................................................................................ 62 4.5.2 原型范围........................................................................................................................................ 63 4.5.3 单例bean和原型bean依赖 .................................................................................................... 64 4.5.4 请求,会话和全局会话范围 .................................................................................................... 64 4.5.4.1 初始化Web配置................................................................................................................. 64 4.5.4.2 请求范围................................................................................................................................ 65 4.5.4.3 会话范围................................................................................................................................ 65 4.5.4.4 全局会话范围....................................................................................................................... 66 4.5.4.5 各种范围的bean作为依赖 .............................................................................................. 66 4.5.5 自定义范围 ................................................................................................................................... 68 4.5.5.1 创建自定义范围 .................................................................................................................. 68 4.5.5.2 使用自定义范围 .................................................................................................................. 69 4.6 自定义bean的性质............................................................................................................................ 70 4.6.1 生命周期回调............................................................................................................................... 70 4.6.1.1 初始化回调 ........................................................................................................................... 71 4.6.1.2 销毁回调................................................................................................................................ 71 4.6.1.3 默认的初始化和销毁方法 ................................................................................................ 72 4.6.1.4 组合生命周期机制.............................................................................................................. 73 4.6.1.5 启动和关闭回调 .................................................................................................................. 74 4.6.1.6 在非Web应用中,优雅地关闭Spring IoC容器......................................................... 75 4.6.2 ApplicationContextAware和BeanNameAware .................................................... 76 4.6.3 其它Aware接口 ........................................................................................................................ 76 4.7 Bean定义的继承 .................................................................................................................................. 78 4.8 容器扩展点 ........................................................................................................................................... 79 4.8.1 使用BeanPostProcessor来自定义bean ..................................................................... 79 4.8.1.1 示例:BeanPostProcessor风格的Hello World.................................................. 80 4.8.1.2 示例:RequiredAnnotationBeanPostProcessor....................................... 82 4.8.2 使用BeanFactoryPostProcessor自定义配置元数据........................................... 82 4.8.2.1 示例:PropertyPlaceholderConfigurer....................................................... 83 4.8.2.2 示例:PropertyOverrideConfigurer............................................................... 84 4.8.3 使用FactoryBean来自定义实例化逻辑 ......................................................................... 85 4.9 基于注解的容器配置 ......................................................................................................................... 86 4.9.1 @Required................................................................................................................................... 87 4.9.2 @Autowired和@Inject........................................................................................................ 87 4.9.3 使用限定符来微调基于注解的自动装配 .............................................................................. 90 4.9.4 CustomAutowireConfigurer........................................................................................... 95 4.9.5 @Resource................................................................................................................................... 96 4.9.6 @PostConstruct和@PreDestroy .................................................................................. 97 4.10 类路径扫描和管理的组件 .............................................................................................................. 97 4.10.1 @Component和更多典型注解 ............................................................................................. 98 4.10.2 自动检测类和bean的注册 .................................................................................................... 98 4.10.3 使用过滤器来自定义扫描 ...................................................................................................... 99 4.10.4 使用组件定义bean的元数据 ............................................................................................. 100 4.10.5 命名自动检测组件.................................................................................................................. 101 4.10.6 为自动检测组件提供范围 .................................................................................................... 102 4.10.7使用注解提供限定符元数据 ................................................................................................. 103 4.11 使用JSR 330标准注解................................................................................................................... 104 4.11.1 使用@Inject和@Named进行依赖注入 ........................................................................ 104 4.11.2 @Named:@Component注解的标准等同 ....................................................................... 105 4.11.3 标准方法的限制 ...................................................................................................................... 105 4.12 基于Java的容器配置 .................................................................................................................... 106 4.12.1 基本概念:@Configuration和@Bean................................................................................ 106 4.12.2 使用AnnotationConfigApplicationContext实例化Spring容器............ 107 4.12.2.1 简单构造 ........................................................................................................................... 107 4.12.2.2 使用register(Class<?>...)来编程构建容器 ............................................ 107 4.12.2.3 使用scan(String..)开启组件扫描 ................................................................... 108 4.12.2.4 支持Web应用的AnnotationConfigWebApplicationContext ........ 108 4.12.3 构成基于Java的配置 ............................................................................................................ 110 4.12.3.1 使用@Import注解........................................................................................................ 110 4.12.3.2 结合Java和XML配置 ................................................................................................... 113