Spring Portlet MVC参考文档(中文版)
spring官网在线学习文档翻译5
spring官⽹在线学习⽂档翻译55. Aspect Oriented Programming with Spring(使⽤Spring进⾏⾯向切⾯编程)5.1. Introduction(⼊门)Aspect-Oriented Programming (AOP) complements Object-Oriented Programming (OOP) by providing another way of thinking about program structure. The key unit of modularity in OOP is the class, whereas in AOP the unit of modularity is the aspect. Aspects enable the modularization of concerns such as transaction management that cut across multiple types and objects. (Such concerns are often termed crosscutting concerns in AOP literature.)⾯向⽅⾯程序设计(AOP)通过提供另⼀种考虑程序结构的⽅法来补充⾯向对象程序设计(OOP)。
OOP中模块性的关键单元是类，⽽AOP中模块性的单元是⽅⾯。
⽅⾯⽀持关注点的模块化，例如跨多个类型和对象的事务管理。
(在AOP⽂献中，这样的关注点通常被称为横切关注点。
)One of the key components of Spring is the AOP framework. While the Spring IoC container does not depend on AOP, meaning you do not need to use AOP if you don’t want to, AOP complements Spring IoC to provide a very capable middleware solution.Spring的关键组件之⼀是AOP框架。
Spring MVC完整版
Spring MVC 基于Spring4.xMvc Mode模型View视图Contrllor控制器( Action 动作，抽象用户的一个业务操作, Handler 处理器)SpringMVC的核心控制器DispatcherServlet Servlet实现SpringMVC的配置文件[servlet-name]-servlet.xml 默认WEB-INFO/Struts2的核心控制器StrutsPrepareAndExecuteFilter 过滤器实现Struts2的配置文件默认到类路径下找struts.xmlsession.setAttribute("key",100);render 渲染视图org.springframework.web.servlet.view.InternalResourceView139 把模型数据放到request作用域---- 转到430行exposeModelAsRequestAttributes(model, request);430 行protected void exposeModelAsRequestAttributes(Map<String, Object> model, HttpServletRequest request) throws Exception {for (Map.Entry<String, Object> entry : model.entrySet()) {String modelName = entry.getKey();Object modelValue = entry.getValue();if (modelValue != null) {//放入request作用域request.setAttribute(modelName, modelValue);自己的代码mav.addObject("msg",msg);//添加模型数据视图: org.springframework.web.servlet.view.InternalResourceView168 rd.forward(request, response); 转发RESTful 软件架构把POST请求转换成PUT或DELETE请求1.配置HiddenHttpMethodFilter2.编写一个表单，method=post3.添加一个隐藏域。
Spring中文翻译
Spring中⽂翻译Spring IoC 容器1.1 IoC Container 和 Bean 介绍控制反转（Inversion of Control，IoC ）也被称为依赖注⼊（Dependency Injection，DI）。
这是⼀个，多个对象仅仅通过构造器参数，⼯⼚⽅法参数，或者对象实例在被构造器初始化或者被⼯⼚⽅法创建返回之后设置属性来定义它们之间的依赖关系（对象之间的调⽤关系）的过程。
容器在它创建 bean 之后，注⼊之间的依赖项。
这个过程和 bean 本⾝通过使⽤类的直接构造器或服务定位机制，来控制其依赖项的实例化或位置，基本上是相反的（因此被称为控制反转）。
由⼈为的new新建对象，⾃⾏控制对象的实例和调⽤关系，转为容器控制。
控制⽅发⽣改变所以是控制反转org.springframework.beans和org.springframework.context是 Spring IoC 容器的基础BeanFactory接⼝，提供了管理任何类型对象的⾼级配置机制ApplicationContext是BeanFactory的⼀个⼦接⼝。
补充更简单与 Spring 的 AOP 特性集成信息资源处理（⽤于国际化）事件发布应⽤层特定的上下⽂。
（例如WebApplicationContext在 Web 应⽤程序中的使⽤）简单的说，BeanFacotry提供了配置框架和基础功能。
ApplicationContext增加了更多的企业特定的功能。
ApplicationContext是BeanFactory的⼀个完整的超集。
在 Spring 中，构成应⽤程序主⼲并且被 Spring IoC 容器所管理的，被称为 beans。
⼀个 bean 是被 Spring IoC 容器实例化，组装和管理的⼀个对象。
不然，bean 仅仅只是你应⽤程序中众多对象中的⼀个。
Beans，之间的依赖关系由容器使⽤的配置元素据所体现。
Spring参考手册
第一部分 Spring框架的概述Spring框架是一个轻量级的解决方案和为构建企业级应用程序潜在的一站式服务。
然而，Spring是模块化的，允许你只使用那些你需要的部分，而忽略其他部分。
你可以在使用Struts时用Spring的IoC 容器，但你也可以只使用Hibernate 集成代码或JDBC抽象层。
Spring框架支持声明式事务管理、通过RMI或web服务远程访问你的逻辑,还有多种方式处理数据的持久化。
它还提供一个全能的MVC框架，并且能将AOP移植进你的软件。
Spring被设计为非侵入式的，意味着你的逻辑代码完全不必依赖于此框架。
虽然一些基于数据访问技术和Spring的库会存在于你的集成层（例如数据访问层），但是你的其他代码很容易隔离这些依赖。
1.开始使用Spring这篇手册提供了关于spring框架的详细信息，不仅有全面的特性，还有一些关于spring包含的潜在的概念（例如“依赖注入”）的背景知识。
如果你才刚刚开始，也许你应该从低级版的"Getting Started" 手册开始，从bbb://spring.io.访问。
为了更容易消化，这篇手册是专注于任务式。
2.Spring框架的介绍Spring框架是一个支持开发Java应用程序而提供全面的基础设施的Java平台，Spring处理基础部分从而你可以专注于你的应用。
spring 让你能够通过POJOs和向POJOs应用无侵入的企业服务就可以构建你的应用。
这些不仅能应用到Java SE而且还能应用到Java EE.一些作为一个开发者能够使用spring平台优势的例子●使Java方法可以执行数据库事务而不用去处理事务API●使本地Java方法可以执行远程过程而不用去处理远程API●使本地Java方法可以拥有管理操作而不用去处理JMXAPI●使本地Java方法可以执行消息处理而不用去处理JMSAPI2.1 依赖注入和控制反转Java应用程序——一个宽松的专业术语，小到一个Appletes大到运行在n层服务器上的企业级程序—通常由互相协作的对象而形成的适当的应用程序。
springmvc技术文档
Spring MVC技术文档1.Spring MVC 框架介绍Spring 框架提供了构建Web 应用程序的全功能MVC 模块。
使用Spring 可插入的MVC 架构，可以选择是使用内置的Spring Web 框架还是Struts 这样的Web 框架。
通过策略接口，Spring 框架是高度可配置的，而且包含多种视图技术，例如JavaServer Pages（JSP）技术、Velocity、Tiles、iText 和POI。
Spring MVC 框架并不知道使用的视图，所以不会强迫您只使用JSP 技术。
Spring MVC 分离了控制器、模型对象、分派器以及处理程序对象的角色，这种分离让它们更容易进行定制。
1）Spring MVC中的功能组件划分很细致，采用了面向方面的编程aop 技术更好的降低的程序的耦合度，也使得程序扩展起来非常方便、灵活。
2）Spring MVC性能非常优秀，能与Spring框架无缝集成，相比Struts2效率更快，Struts2由于采用了值栈、OGNL表达式、struts2标签库等，会导致应用的性能下降。
3）Spring MVC的学习难度小于Struts2，Struts2用不上的多余功能太多。
4）Spring MVC很容易就可以写出性能优秀的程序，Struts2要处处小心才可以写出性能优秀的程序（指MVC部分）1)以Controller为中心完成对系统流程的控制管理2)获取请求中提交的数据3)对传入参数进行验证4)根据请求调用相应业务逻辑完成数据处理5)将处理结果返回给视图6)国际化支持7)针对不同视图技术提供不同解析支持方案8)针对JSP视图技术提供标签库9)通过拦截器链实现面向方面编程完成系统级控制10)对文件上传、下载等常用功能的封装实现Spring MVC的方式主要有两种，一种是基于配置的方式来实现，另一种是基于注解的方式实现，重点主要为基于注解的方式来实现Spring MVC。
SpringFrameworkAop参考手册中文版
Spring Framework Aop参考手册中文版6.2. @AspectJ 支持"@AspectJ"使用了Java 5的注解，可以将切面声明为普通的Java类。
AspectJ 5发布的AspectJ project中引入了这种@AspectJ风格。
Spring 2.0 使用了和AspectJ 5一样的注解，使用了AspectJ 提供的一个库来做切点（pointcut）解析和匹配。
但是，AOP在运行时仍旧是纯的Spring AOP，并不依赖于AspectJ 的编译器或者织入器（weaver）。
使用AspectJ的编译器或者织入器（weaver）的话就可以使用完整的AspectJ 语言，我们将在第 6.8 节“在Spring应用中使用Aspec tJ”中讨论这个问题。
6.2.1. 启用@AspectJ支持为了在Spring配置中使用@AspectJ aspects，你必须首先启用Spring对基于@AspectJ aspects的配置支持，自动代理（autoproxying）基于通知是否来自这些切面。
自动代理是指Spring会判断一个bean是否使用了一个或多个切面通知，并据此自动生成相应的代理以拦截其方法调用，并且确认通知是否如期进行。
通过在你的Spring的配置中引入下列元素来启用Spring对@AspectJ的支持：<aop:aspectj-autoproxy/>我们假使你正在使用附录 A, XML Schema-based configuration所描述的schema支持。
关于如何在aop的命名空间中引入这些标签，请参见第 A.2.6 节“The aop schema”如果你正在使用DTD，你仍旧可以通过在你的application context中添加如下定义来启用@AspectJ支持：<beanclass="org.springframework.aop.aspectj.annotation.AnnotationAwareAspe ctJAutoProxyCreator" />你需要在你的应用程序的classpath中引入两个AspectJ库：aspectjweaver.jar 和 aspectjrt.jar。
spring中文API文档
这次发布的Spring Security-3.0.1 是一个bug fix 版，主要是对3.0 中存在的一些问题进行修正。
文档中没有添加新功能的介绍，但是将之前拼写错误的一些类名进行了修正，建议开发者以这一版本的文档为参考。
另：Spring Security 从2010-01-01 以后，版本控制从SVN 换成了GIT，我们在翻译文档的时候，主要是根据SVN 的变化来进行文档内容的比对，这次换成GIT 后，感觉缺少了之前那种文本比对工具，如果有对GIT 熟悉的朋友，还请推荐一下文本比对的工具，谢谢。
序言I. 入门1. 介绍1.1. Spring Security 是什么？1.2. 历史1.3. 发行版本号1.4. 获得Spring Security1.4.1. 项目模块1.4.1.1. Core - spring-security-core.jar1.4.1.2. Web - spring-security-web.jar1.4.1.3. Config - spring-security-config.jar1.4.1.4. LDAP - spring-security-ldap.jar1.4.1.5. ACL - spring-security-acl.jar1.4.1.6. CAS - spring-security-cas-client.jar1.4.1.7. OpenID - spring-security-openid.jar1.4.2. 获得源代码2. Security 命名空间配置2.1. 介绍2.1.1. 命名空间的设计2.2. 开始使用安全命名空间配置2.2.1. 配置web.xml2.2.2. 最小<http> 配置2.2.2.1. auto-config 包含了什么？2.2.2.2. 表单和基本登录选项2.2.3. 使用其他认证提供器2.2.3.1. 添加一个密码编码器2.3. 高级web 特性2.3.1. Remember-Me 认证2.3.2. 添加HTTP/HTTPS 信道安全2.3.3. 会话管理2.3.3.1. 检测超时2.3.3.2. 同步会话控制2.3.3.3. 防止Session 固定攻击2.3.4. 对OpenID 的支持2.3.4.1. 属性交换2.3.5. 添加你自己的filter2.3.5.1. 设置自定义AuthenticationEntryPoint2.4. 保护方法2.4.1. <global-method-security> 元素2.4.1.1. 使用protect-pointcut 添加安全切点2.5. 默认的AccessDecisionManager2.5.1. 自定义AccessDecisionManager2.6. 验证管理器和命名空间3. 示例程序3.1. Tutorial 示例3.2. Contacts3.3. LDAP 例子3.4. CAS 例子3.5. Pre-Authentication 例子4. Spring Security 社区4.1. 任务跟踪4.2. 成为参与者4.3. 更多信息II. 结构和实现5. 技术概述5.1. 运行环境5.2. 核心组件5.2.1. SecurityContextHolder, SecurityContext 和Authentication 对象5.2.1.1. 获得当前用户的信息5.2.2. UserDetailsService5.2.3. GrantedAuthority5.2.4. 小结5.3. 验证5.3.1. 什么是Spring Security 的验证呢？5.3.2. 直接设置SecurityContextHolder 的内容5.4. 在web 应用中验证5.4.1. ExceptionTranslationFilter5.4.2. AuthenticationEntryPoint5.4.3. 验证机制5.4.4. 在请求之间保存SecurityContext 。
spring-mvc 中文文档
Spring框架 参考文档
一个团队
Github
Spring Framework 2.5翻译计 划 Spring Framework 4.x参考文 档 Spring Framework 4.x中文翻 译 Spring 中 文文档3.1
满江红机构
-
waylau
Github
翻译了Spring文档的简介、新特性和容器IOC 部分
1
URI构造 为控制器和方法指定URI 在视图中为控制器和方法指定URI 地区信息 获取时区信息 Accept请求头解析器AcceptHeaderLocaleResolver Cookie解析器CookieLocaleResolver Session解析器SessionLocaleResolver 地区更改拦截器LocaleChangeInterceptor 主题 themes 关于主题：概览 定义主题 主题解析器 Spring的multipart（文件上传）支持 概述 使用MultipartResolver与Commons FileUpload传输文件 Servlet 3.0下的MultipartResolver 处理表单中的文件上传 处理客户端发起的文件上传请求 异常处理 处理器异常解析器HandlerExceptionHandler @ExceptionHandler注解 处理一般的Spring MVC异常 使用@ResponseStatus注解业务异常 Servlet默认容器错误页面的定制化 Web安全 "约定优于配置"的支持 控制器类名-处理器映射ControllerClassNameHandlerMapping 模型ModelMap(ModelAndView) 视图-请求与视图名的映射 HTTP缓存支持 HTTP请求头Cache-Control 对静态资源的HTTP缓存支持 在控制器中设置Cache-Control、ETag和Last-Modified响应头
Spring3.0 MVC 中文教程
Spring3 MVC - 3到Spring MVC框架简介Spring3 MVC框架简介Spring MVC是Spring的框架的Web组件。
它提供了丰富的功能，为建设强大的Web应用程序。
Spring MVC框架的架构，并在这样的高度可配置的方式，每一块的逻辑和功能设计。
此外Spring可以毫不费力地与其他流行的Web框架，如Struts，WebWork的，的Java Server Faces和Tapestry集成。
这意味着，你甚至可以告诉Spring使用Web框架中的任何一个。
比Spring更不紧耦合的servlet或JSP 向客户端呈现视图。
喜欢速度与其他视图技术集成，Freemarker的，Excel或PDF现在也有可能。
Spring3.0 MVC系列∙第1部分：到Spring 3.0 MVC框架简介∙第2部分：在Spring 3.0 MVC创建Hello World应用程序∙第3部分：在Spring 3.0 MVC的形式处理∙第4部分：Spring3 MVC的Tiles Support与Eclipse中的例子插件教程∙第5部分：Spring3 MVC的国际化及本地化教程与范例在Eclipse∙第6部分：Spring3 MVC示例教程Spring主题∙第7部分：创建Spring3 MVC Hibernate 3的示例在Eclipse中使用Maven的在Spring Web MVC，你可以使用任何对象作为命令或表单支持对象，你不需要实现框架特定的接口或基类。
Spring的数据绑定是高度灵活的：例如，将验证错误类型不作为应用系统错误，可以通过评估的不匹配。
因此，你不必重复你的业务对象的属性，简单的无类型的字符串，在表单对象仅仅是为了处理无效的意见，或正确转换的字符串。
相反，它往往是最好直接绑定到业务对象。
请求处理生命周期Spring的Web MVC框架是，像许多其他Web MVC框架，要求为导向，围绕一个中心的servlet，它把请求分派给控制器，提供其他功能，有利于开发Web应用而设计的。
spring文档
spring是一个开源的控制反转（inversion of control）和面向切面（AOP）的容器框架，她主要设计目标是简化开发。
如：public class UserService {private UserDAO userDAO = new UserDAO();public void addUser(User user) {userDAO.add(user);}}userDAO是在应用内部创建和维护，控制反转是应用本身不负责依赖对象的创建及维护，依赖对象的创建及维护由外部容器负责，这种控制权由应用转移到外部容器就称为反转。
当把这种控制权力交给外部容器处理之后代码可以改为public class UserService {private UserDAO userDAO;public void addUser(User user) {userDAO.add(user);}}针对这个属性可以提供构造方法中传递参数或者提供setter方法进行注入。
依赖注入（Dependency Injection）：由容器动态地将依赖对象注入到组件中。
Spring带来的好处1、降低组件之间的耦合度，实现软件各层之间的解耦。
Action →service →DAO2、可以使用容器提供相关服务，如：事务管理服务等，使用spring管理服务之后不再需要手工控制事务。
（hibernate或者是jdbc的事务相关操作代码都可以去掉）Spring的声明式事务管理可以实现复杂的事务操作。
3、容器提供单例模式，开发人员不再编写单例代码。
4、容器提供AOP技术，利用它很容易实现权限拦截、监控、日志等功能。
5、容器提供很多辅助类，利用这些类能够加快应用的开发，如：JdbcTemplate、HibernateTemplate等6、spring对于一些主流的框架提供了集成支持，如hibernate、struts、ibatis等搭建spring开发环境使用spring需要的jar在官网上下载spring的安装包dist\spring.jarlib\jakarta-commons\commons-logging.jar如果使用aop还需要Lib\aspectj\aspectjweaver.jar、aspectjrt.jarLib\cglib\cglib-nodep-2.1.3.jar如果使用JSR-250中的注解还需要使用lib\j2ee\common-annotations.jarspring配置文件，规范参考文档手册实例化spring容器方法一、在类路径下寻找配置文件来实例化容器ApplicationContext ctx = new ClassPathXmlApplicationContext(new String[]{“beans.xml”,”user.xml”});方法二、在文件系统路径下需找配置文件来实例化容器ApplicationContext ctx = new FileSystemXmlApplicationContext(new String[]{“c:\\beans.xml”}); 注意：spring配置文件可以有多个，这时通过string数组传入。
springMVC配置文件详解
web.xml的配置web.xml应该是整个项目最重要的配置文件了，不过servlet3.0中已经支持注解配置方式了。
在servlet3.0以前每个servlet必须要在web.xml中配置servlet及其映射关系。
但是在spring框架中就不用了，因为Spring中是依赖注入（Dependency Injection）的也叫控制反转（Inversion of Control）。
但是也要配置一个重要的servlet，就是前端控制器（DispatcherServlet）。
配置方式与普通的servlet基本相似。
配置内容如下：<!-- 配置前端控制器--><servlet><servlet-name>spring</servlet-name><servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class><init-param><!-- ContextconfigLocation配置springmvc加载的配置文件适配器、处理映射器等--><param-name>contextConfigLocation</param-name><param-value>WEB-INF/classes/spring/springmvc.xml</param-value></init-param></servlet><servlet-mapping><servlet-name>spring</servlet-name><!-- 1、.action访问以.action结尾的由DispatcherServlet进行解析2、/,所有访问都由DispatcherServlet进行解析--><url-pattern>/</url-pattern></servlet-mapping>这里需要注意，springmvc.xml是spring配置文件，将在后面讨论。
Spring框架参考文档-5.0.0-中文完整版
Spring框架参考文档-5.0.0-中文完整版AuthorsRod Johnson , Juergen Hoeller , Keith Donald , Colin Sampaleanu , Rob Harrop , Thomas Risberg , Alef Arendsen , Darren Davison , Dmitriy Kopylenko , Mark Pollack , Thierry Templier , Erwin Vervaet , Portia Tung , Ben Hale , Adrian Colyer , John Lewis , Costin Leau , Mark Fisher , Sam Brannen , Ramnivas Laddad , Arjen Poutsma , Chris Beams , Tareq Abedrabbo , Andy Clement , Dave Syer , Oliver Gierke , Rossen Stoyanchev , Phillip Webb , Rob Winch , Brian Clozel , Stephane Nicoll , Sebastien Deleuze版本号：5.0.0.RELEASECopyright ? 2004-2016Copies of this document may be made for your own use and for distribution to others, provided that you do not charge any fee for such copies and further provided that each copy contains this Copyright Notice, whether distributed in print or electronically.文档官网：https://docs.spring.io/spring/docs/5.0.0.RELEASE/spring-framework-reference/index.html现在官网的5.0.0已经在2017年9月28日出了release版，为此翻译了5.0.0版本（从4.3.10升级到此版本，如果还在使用4.3.10版本，请看本人的前一个版本），翻译前后历时15天，十多次的修改和校对。
SpringMVC的配置文件
SpringMVC的配置⽂件⼀、root标签跟spring配置⼀样，root标签是beans，毕竟springmvc是spring的⼀个模块在springmvc⾥，⾃动扫描主要是配置controller：⼆、⾃动扫描：⼆、⾃动扫描：在<context:component-scan base-package="com.xxx.controller"/>三、解析器Resolver：解析器有很多种，⽐较重要的是ViewResolverViewResolver也有很多种，其中⽐较重要和常⽤的是InternalResourceViewResolver（内部资源视图解析器）代码：<bean id="viewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver"><property name="prefix" value="/WEB-INF/jsp/" /><property name="suffix" value=".jsp" /></bean>如果没有视图解析器，我们在controller⾥⾯的代码是这样的：@Controllerpublic class LoginActionController {@RequestMapping("/index")public String toIndex(HttpServletRequest request, ModelMap map, HttpSession session) {return "/WEB-INF/jsp/index.jsp";}⽽使⽤了视图解析器，我们的代码是这样的：@Controllerpublic class LoginActionController {@RequestMapping("/index")public String toIndex(HttpServletRequest request, ModelMap map, HttpSession session) {return "index";}区别在最后⼀句，我们不需要给出⽬标视图的全路径了。
SpringMVChelloworldexample中英文对照
Spring MVC hello world example （Spring MVC hello world 例子例子）） ------ 大白菜翻译 Blog ：/xiaolincc26/home原文原文出自出自出自：：/文中：viewResolver 我翻译为视图问题解决者，其实无需翻译Spring MVC application, consist of 3 standard MVC (Model, Views, Controllers) components :Spring MVC 的应用，MVC （模型，视图，控制）的标准是由3个组件组成；1. Models – Domain objects that are processed by service layer or persistent layer.模型--对象作用在服务层或者持久层的进程；2. Views – Usually JSP templates written with Java Standard Tag Library (JSTL).视图--通常使用JSTL （java 标准标签库）编写JSP 的模板；3. Controllers – Interact with service layer for business processing and return a Model.控制—作用于服务层处理业务程序并且还回一个模型。
See a figure 1.1, 1.2 to demonstrate how the Spring MVC application handle a web request.看图1.1,1.2 来演示Spring MVC 应用是如何处理网页请求。
Figure 1.1P.S Image copied fromSpring MVC referencewith slightly modification.P.S 图片来源Spring MVC（官方网站），并做了少许修改。
Spring Boot参考文档说明书
Spring Boot Reference Documentation Phillip Webb, Dave Syer, Josh Long, Stéphane Nicoll, Rob Winch, Andy Wilkinson, Marcel Overdijk, Christian Dupuis, Sébastien Deleuze, Michael Simons, Vedran Pavić, Jay Bryant, Madhura Bhave, Eddú Meléndez, ScottFrederick, Moritz HalbritterVersion 3.2.0-SNAPSHOTTable of Contents1. Legal. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22. Getting Help. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33. Documentation Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 3.1. First Steps. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 3.2. Upgrading From an Earlier Version. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 3.3. Developing With Spring Boot. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 3.4. Learning About Spring Boot Features. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 3.5. Web. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 3.6. Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 3.7. Messaging. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 3.8. IO. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 3.9. Container Images. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 3.10. Moving to Production. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 3.11. GraalVM Native Images. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63.12. Advanced Topics. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64. Getting Started. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 4.1. Introducing Spring Boot. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 4.2. System Requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74.2.1. Servlet Containers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74.2.2. GraalVM Native Images. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 4.3. Installing Spring Boot. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84.3.1. Installation Instructions for the Java Developer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8Maven Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 Gradle Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94.3.2. Installing the Spring Boot CLI. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9Manual Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 Installation with SDKMAN!. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 OSX Homebrew Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 MacPorts Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 Command-line Completion. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 Windows Scoop Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 4.4. Developing Your First Spring Boot Application. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114.4.1. Prerequisites. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12Maven. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 Gradle. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124.4.2. Setting up the project with Maven. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134.4.3. Setting up the project with Gradle. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15Gradle. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164.4.5. Writing the Code. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17The @RestController and @RequestMapping Annotations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18 The @SpringBootApplication Annotation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18 The “main” Method. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184.4.6. Running the Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18Maven. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 Gradle. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194.4.7. Creating an Executable Jar. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20Maven. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20 Gradle. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214.5. What to Read Next. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225. Upgrading Spring Boot. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 5.1. Upgrading From 1.x. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 5.2. Upgrading to a New Feature Release. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 5.3. Upgrading the Spring Boot CLI. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235.4. What to Read Next. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236. Developing with Spring Boot. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25 6.1. Build Systems. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256.1.1. Dependency Management. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256.1.2. Maven. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256.1.3. Gradle. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256.1.4. Ant. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266.1.5. Starters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27 6.2. Structuring Your Code. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316.2.1. Using the “default” Package. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316.2.2. Locating the Main Application Class. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31 6.3. Configuration Classes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336.3.1. Importing Additional Configuration Classes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336.3.2. Importing XML Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33 6.4. Auto-configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336.4.1. Gradually Replacing Auto-configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346.4.2. Disabling Specific Auto-configuration Classes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34 6.5. Spring Beans and Dependency Injection. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35 6.6. Using the @SpringBootApplication Annotation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37 6.7. Running Your Application. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 406.7.1. Running From an IDE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 406.7.2. Running as a Packaged Application. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 406.7.3. Using the Maven Plugin. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 406.8. Developer Tools. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 416.8.1. Diagnosing Classloading Issues. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 426.8.2. Property Defaults. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 426.8.3. Automatic Restart. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43Logging Changes in Condition Evaluation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 Excluding Resources. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 Watching Additional Paths. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46 Disabling Restart. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46 Using a Trigger File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47 Customizing the Restart Classloader. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48 Known Limitations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 496.8.4. LiveReload. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 496.8.5. Global Settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49Configuring File System Watcher. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 506.8.6. Remote Applications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51Running the Remote Client Application. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51 Remote Update. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52 6.9. Packaging Your Application for Production. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 536.10. What to Read Next. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 537. Core Features. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54 7.1. SpringApplication. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 547.1.1. Startup Failure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 557.1.2. Lazy Initialization. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 567.1.3. Customizing the Banner. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 577.1.4. Customizing SpringApplication. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 587.1.5. Fluent Builder API. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 597.1.6. Application Availability. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60Liveness State. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60 Readiness State. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60 Managing the Application Availability State. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 607.1.7. Application Events and Listeners. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 647.1.8. Web Environment. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 657.1.9. Accessing Application Arguments. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 657.1.10. Using the ApplicationRunner or CommandLineRunner. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 667.1.11. Application Exit. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 677.1.12. Admin Features. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 697.1.13. Application Startup tracking. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69 7.2. Externalized Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 707.2.1. Accessing Command Line Properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72Profile Specific Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76 Importing Additional Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77 Importing Extensionless Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79 Using Configuration Trees. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79 Property Placeholders. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82 Working With Multi-Document Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82 Activation Properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83 7.2.4. Encrypting Properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84 7.2.5. Working With YAML. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84Mapping YAML to Properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84 Directly Loading YAML. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85 7.2.6. Configuring Random Values. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86 7.2.7. Configuring System Environment Properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86 7.2.8. Type-safe Configuration Properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86JavaBean Properties Binding. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87 Constructor Binding. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90 Enabling @ConfigurationProperties-annotated Types. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93 Using @ConfigurationProperties-annotated Types. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95 Third-party Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97 Relaxed Binding. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98 Merging Complex Types. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101 Properties Conversion. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105 @ConfigurationProperties Validation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112 @ConfigurationProperties vs. @Value. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115 7.3. Profiles. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116 7.3.1. Adding Active Profiles. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118 7.3.2. Profile Groups. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119 7.3.3. Programmatically Setting Profiles. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120 7.3.4. Profile-specific Configuration Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120 7.4. Logging. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120 7.4.1. Log Format. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120 7.4.2. Console Output. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122Color-coded Output. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122 7.4.3. File Output. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123 7.4.4. File Rotation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123 7.4.5. Log Levels. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124 7.4.6. Log Groups. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124Environment Properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129 7.4.10. Log4j2 Extensions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129Profile-specific Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130 Environment Properties Lookup. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130 Log4j2 System Properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131 7.5. Internationalization. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131 7.6. JSON. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132 7.6.1. Jackson. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132Custom Serializers and Deserializers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132 Mixins. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136 7.6.2. Gson. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136 7.6.3. JSON-B. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137 7.7. Task Execution and Scheduling. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137 7.8. Testing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138 7.8.1. Test Scope Dependencies. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139 7.8.2. Testing Spring Applications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139 7.8.3. Testing Spring Boot Applications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140Detecting Web Application Type. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141 Detecting Test Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141 Using the Test Configuration Main Method. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142 Excluding Test Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145 Using Application Arguments. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146 Testing With a Mock Environment. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147 Testing With a Running Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151 Customizing WebTestClient. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153 Using JMX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153 Using Metrics. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155 Using Tracing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155 Mocking and Spying Beans. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155 Auto-configured Tests. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159 Auto-configured JSON Tests. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159 Auto-configured Spring MVC Tests. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162 Auto-configured Spring WebFlux Tests. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166 Auto-configured Spring GraphQL Tests. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169 Auto-configured Data Cassandra Tests. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174 Auto-configured Data Couchbase Tests. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175 Auto-configured Data Elasticsearch Tests. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176。
SpringMVC入门_精品资料（可编辑）
SpringMVC 入门_精品资料2.1、Spring Web MVC是什么Spring Web MVC是一种基于Java的实现了Web MVC设计模式的请求驱动类型的轻量级Web框架,即使用了MVC架构模式的思想,将web层进行职责解耦,基于请求驱动指的就是使用请求-响应模型,框架的目的就是帮助我们简化开发,Spring Web MVC也是要简化我们日常Web开发的。
另外还有一种基于组件的、事件驱动的Web框架在此就不介绍了,如Tapestry、JSF等。
Spring Web MVC也是服务到工作者模式的实现,但进行可优化。
前端控制器是DispatcherServlet;应用控制器其实拆为处理器映射器Handler Mapping进行处理器管理和视图解析器View Resolver进行视图管理;页面控制器/动作/处理器为Controller接口(仅包含ModelAndView handleRequestrequest, response?方法)的实现(也可以是任何的POJO类);支持本地化(Locale)解析、主题(Theme)解析及文件上传等;提供了非常灵活的数据验证、格式化和数据绑定机制;提供了强大的约定大于配置(惯例优先原则)的契约式编程支持。
2.2、Spring Web MVC能帮我们做什么√让我们能非常简单的设计出干净的Web层和薄薄的Web层;√进行更简洁的Web层的开发;√天生与Spring框架集成(如IoC容器、AOP等);√提供强大的约定大于配置的契约式编程支持;√能简单的进行Web层的单元测试;√支持灵活的URL到页面控制器的映射;√非常容易与其他视图技术集成,如Velocity、FreeMarker等等,因为模型数据不放在特定的API里,而是放在一个Model里(Map数据结构实现,因此很容易被其他框架使用);√非常灵活的数据验证、格式化和数据绑定机制,能使用任何对象进行数据绑定,不必实现特定框架的API;√提供一套强大的JSP标签库,简化JSP开发;√支持灵活的本地化、主题等解析;√更加简单的异常处理;√对静态资源的支持;√支持Restful风格。
SpringBoot官方文档中文版-3.构建你的代码
SpringBoot官⽅⽂档中⽂版-3.构建你的代码前⾔这是 SpringBoot 官⽅⽂档中⽂翻译版系列的第三篇⽂章：前两篇⽂章如下：Spring Boot 不需要任何特定的代码布局来⼯作。
然⽽，有⼀些最佳实践是有帮助的。
1.避免使⽤“默认”包当⼀个类不包含包声明时，它被认为是在“默认包”中。
通常不⿎励使⽤“默认包”，应该避免使⽤。
对于使⽤ @ComponentScan、@ConfigurationPropertiesScan、@EntityScan或@SpringBootApplication 注释的 SpringBoot 应⽤程序来说，它可能会导致特定的问题，因为每个 jar 中的每个类都被读取。
我们建议您遵循 Java 推荐的包命名约定并使⽤反向的域名(例如，com.example.project)。
2. 主应⽤程序类的位置我们通常建议您将主应⽤程序类放在其他类之上的根包中。
@SpringBootApplication 注释通常放在主类上，它隐式地为某些项定义了⼀个基本的“搜索包”。
例如，如果您正在编写⼀个 JPA 应⽤程序，则使⽤ @SpringBootApplication 注释类的包来搜索@Entity 项。
使⽤根包还允许只在项⽬上应⽤组件扫描。
如果你不想使⽤ @SpringBootApplication，它导⼊的 @EnableAutoConfiguration 和 @ComponentScan 注释定义了该⾏为，所以你也可以使⽤它们。
下⾯的清单显⽰了⼀个典型的布局:com+- example+- myapplication+- MyApplication.java|+- customer| +- Customer.java| +- CustomerController.java| +- CustomerService.java| +- CustomerRepository.java|+- order+- Order.java+- OrderController.java+- OrderService.java+- OrderRepository.javaMyApplication.java ⽂件将声明 mian ⽅法，以及基本的 @SpringBootApplication，如下所⽰:import org.springframework.boot.SpringApplication;import org.springframework.boot.autoconfigure.SpringBootApplication;@SpringBootApplicationpublic class MyApplication {public static void main(String[] args) {SpringApplication.run(MyApplication.class, args);}}每天学习⼀点点，每天进步⼀点点。
- 1、下载文档前请自行甄别文档内容的完整性，平台不提供额外的编辑、内容补充、找答案等附加服务。
- 2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
- 3、如文档侵犯您的权益，请联系客服反馈,我们会尽快为您处理(人工客服工作时间：9:00-18:30)。
Spring Portlet MVC参考文档版本：0.9版本修订历史记录：目录1 引言 (3)1.1编者的话 (3)1.2面向读者 (3)1.3前提条件 (3)2 Spring Portlet MVC (3)2.1介绍 (3)2.1.1 控制器 (4)2.1.2 视图 (4)2.1.3 基于Web的Bean (4)2.2DispatcherPortlet (4)2.3ViewRendererServlet (6)2.4控制器 (7)2.4.1 AbstractController和PortletContentGenerator (8)2.4.2 其它的简单控制器 (9)2.4.3 命令控制器 (9)2.4.4 PortletWrappingController (10)2.5处理器映射 (10)2.5.1 PortletModeHandlerMapping (11)2.5.2 ParameterHandlerMapping (11)2.5.3 PortletModeParameterHandlerMapping (12)2.5.4 增加HandlerInterceptor (13)2.5.5 HandlerInterceptorAdapter (13)2.5.6 ParameterMappingInterceptor (13)2.6视图与解析 (13)2.7多块（文件上传）支持 (14)2.7.1 使用PortletMultipartResolver (14)2.7.2 在表单里上传文件处理 (15)2.8处理异常 (18)2.9Portlet的应用部署 (18)1引言1.1编者的话Spring Portlet MVC是现在较少支持Portlet开发的框架之一，它不像webwork2/Struts2那样把portlet的处理转换成servlet支持。
本文档是翻译spring参考文档的16章（版本2.0.8），讲述了Spring Portlet MVC概念及原理。
特别到Portlet MVC框架里的一些相关概念与使用的说明。
这个文档有助于读者对其框架深入理解，灵活运用提供参考。
由于本人的知识有限，内容中难免存在有误内容，如果你对文档的内容有任何疑问和不同意见，欢迎跟我联系。
关于本人的WP最新资料请访问：/?oliverchan，更多关于websphere的资料请访问：。
1.2面向读者Portal开发人员1.3前提条件对JSR-168有原理，生命周期有了解，对Spring和Spring Web MVC有一定的了解。
2Spring Portlet MVC2.1介绍Spring框架除了支持传统的Web应用开发外，还支持JSR-168的portlet应用开发。
Spring Portlet MVC是Web MVC的克隆，使用一样的抽象视图和整合技术。
在继续后面内容前请回顾十三章Web MVC框架和十四章整合视图技术。
Portlet与Servlet生命周期最主要的区别在于Portlet的请求分为两个明显的阶段：行动阶段和呈现阶段。
行动阶段只执行一次是由于“后台”有改变或者行动发生，例如修改数据库操作。
呈现阶段是每次显示被刷新，然后产生显示结果给用户。
这里的关键点是在单个全生命周期的请求，行动阶段只被执行一次，但是呈现阶段可能执行多次。
这样就使修改您系统的持久状态的活动和产生显示给用户的活动有一个清晰的分离。
Portlet两个阶段是JSR-168规范的一个功能强大的特性。
例如，动态搜索显示结果可以在显示修改而不需要用户重新运行搜索功能。
很多其它的portlet mvc框架努力对开发人员隐蔽两个阶段使portlet的开发尽可能像开发传统的servlet应用那样-我们认为这种方式减少使用portlet的一个重要好处。
所以Spring的portlet mvc框架是始终保留两个分离的阶段。
这种方式的主要的表现是servlet mvc的版本的类有一个方法处理请求，portlet mvc版本的类有两个方法处理请求：一个是行动阶段和一个呈现阶段。
例如，servlet版本的AbstractCo ntroller有一个handleRequestInternal(..)方法；portlet版本的AbstractController有handleActio nRequestInternal(..)和handleRenderRequestInternal(..)方法。
这个框架围绕着一个分发请求到处理器的DispatcherPortlet设计，通过配置处理器映射与视图决定的，就像web框架里的DispatcherServlet那样，文件上传也是这种方式支持。
Portlet MVC不支持本地化和主题决定－这些是Portal/Portlet-container支持的范围，不适合在Spring容器的范围支持。
然而所有依赖本地化（国际化和消息）的机制仍然是可用的功能，因为DispatcherPortlet使用当前本地化像DispatcherServlet那样。
2.1.1控制器默认的处理器是一个非常简单的Controller接口，提供两个方法：void handleActionRequest(request,response)ModelAndView handleRenderRequest(request,response)这个框架也包含很多跟servlet mvc一样层次的控制器实现，例如AbstractController，SimpleFormController等等。
数据绑定，命令对象使用，模型处理和视图决定都和servlet mvc 一样。
2.1.2视图Servlet框架的视图呈现能力是直接通过一个名为ViewRendererServlet的特殊servlet桥来实现。
使用这个servlet把portlet的请求转换成servlet的请求，完全使用servlet基础来呈现视图。
这就意味着现在现存的呈现，例如JSP，V elocity等等，仍可以在portlet里使用。
2.1.3基于Web的BeanSpring portlet mvc支持当前的在http请求或http会话Beans（常用的和全局的）范围bean的整个生命周期。
这个不是Portlet MVC自己独有的特性，而是Portlet MVC使用的WebApplicationContext容器的。
这些bean的范围细节描述请查阅Spring参考手册的3.4.4章。
2.2DispatcherPortletPortlet MVC是一个请求驱动的Web MVC框架，围绕一个分发请求给控制器和提供其它简化开发portlet程序功能的portlet设计。
但是DispatcherPortlet所做的不止这些，它完全与Spring的ApplicationContext整合在一起，使你可以使用Sring的其它特性。
像一般的portlet那样，DispatcherPortlet在你的Web应用里的portlet.xml声明:DispatcherPortlet是必须配置的。
在Portlet MVC框架，每个DispatcherPortlet有自己的WebApplicationContext，它继承所有已经在根WebApplicationContext里定义的bean。
这些继承的bean能在具体的portlet 里重载，新的portlet bean可以在具体的portlet的实例里定义。
在DispatcherPortlet初始化时，框架会在你的web应用的WEB-INF目录查找一个命名为[portlet名]-portlet.xml的文件，创建定义的bean（可以用相同的名字覆盖在全局范围的定义bean）。
DispatcherPortlet使用的配置文件位置可以通过portlet的初始化参数修改（下面会详细介绍）。
Spring的DispatcherPortlet使用一些专门的bean处理请求和呈现适当的视图。
这些bean 包含在Spring框架里且能被配置到WebApplicationContext，就像其它被配置的bean一样。
这些bean的每一个在下面更详细的描述。
现在我们提及它们，只是为了让你知道它们的存在且能让我们继续说明DispatcherPortlet。
对于大部分的这些bean是默认提供的，所以你不必担心配置它们。
在WebApplicationContex专门的bean表达说明处理器映射(章节2.5 “处理器映射”)列表里的前置后置处理器和控制器匹配某个标准将会被执行（例如一个匹配具体portlet模式的控制器）。
控制器（章节2.4 “控制器”）这些bean提供实际的功能（或至少，访问功能性），是MVC模式中的控制器。
视图解析器（章节2.6 “视图与解析”）解析视图名对应的视图定义。
分块解析器（章节 2.7 “分块（文件上传）支持”）提供从HTML表单上传文件的处理功能。
异常处理解析器（章节2.8 “异常处理”）提供异常映射到视图或其它复杂的处理异常代码实现。
一旦DispatcherPortlet配置好，当请求进入具体的DispatcherPortlet，它开始处理请求。
下面描述DispatcherPortlet处理请求的整个过程。
1.通过PortletRequest.getLocale()方法得到本地化的资源绑定到请求，当处理请求时能够解析这些资源元素（呈现视图，准备数据等等）。
2.如果指定使用分块解析器，它是一个ActionRequest，对请求进行多块检查，如果这些块都能被找到就把它们封装在一个MultipartActionRequest里，以备在处理过程中被其它元素作更深入的处理。
（关于分块处理的详细信息参阅章节2.7 “分块（文件上传）支持”）3.查找适当的处理器。
一旦找到处理器，控制器相关的执行链（前置，后置处理器和控制器）将被执行来准备数据模型。
4.如果返回模型，使用在WebApplicationContex配置的视图解析器呈现视图。
如果没有数据模型返回（可能因为前置或者后置处理器拦截请求，比如安全的原因），不呈现视图，因为请求处理已经完成。
在处理请求时可能抛出异常。
它们会被在WebApplicationContex配置里声明的任何异常解析器获取。
使用异常解析器你能定义定制处理异常抛出的行为。
增加在portlet.xml文件的上下文参数或portlet的初始化参数你能定制Spring的DispatcherPortlet。
参数列表如下：DispatcherPortlet初始化参数参数描述contextClass 这个类实现WebApplicationContex，portlet使用它来初始化上下文，如果这个参数不设置，则使用XmlPortletApplicationContext。