微服务架构Day03-SpringBoot之web开发配置
2012 年 7 月 23 日
概述
-
SpringBoot开发:
1.创建SpringBoot应用,选中需要的场景模块。
2.SpringBoot已经默认将场景模块配置好,只需要在配置文件中指定少量的配置(数据库地址,用户名,密码)就可以运行起来。
3.只需要编写业务逻辑代码。 -
需要掌握 自动配置原理
:这个场景中SpringBoot默认配置好了什么,能不能修改,能修改哪些配置,能不能扩展。
XxxAutoConfiguration:帮我们给容器中自动配置组件 XxxProperties:配置类,封装配置文件中的内容
SpringBoot对静态资源(static-location)的映射规则
@ConfigurationProperties( prefix = "spring.resources", ignoreUnknownFields = false )
- ResourceProperties可以设置和资源有关的参数,缓存时间等。
/* * ResourceHandlerRegistry存储用于通过Spring MVC服务静态资源的资源处理程序的注册 * 允许设置为在Web浏览器中高效加载而优化的缓存头 * 可以在Web应用的目录下,类路径等位置之外的位置提供资源 */ public void addResourceHandlers(ResourceHandlerRegistry registry) { if (!this.resourceProperties.isAddMappings()) { logger.debug("Default resource handling disabled"); } else { Duration cachePeriod = this.resourceProperties.getCache().getPeriod(); CacheControl cacheControl = this.resourceProperties.getCache().getCachecontrol().toHttpCacheControl(); if (!registry.hasMappingForPattern("/webjars/**")) { this.customizeResourceHandlerRegistration(registry.addResourceHandler(new String[]{"/webjars/**"}).addResourceLocations(new String[]{"classpath:/META-INF/resources/webjars/"}).setCachePeriod(this.getSeconds(cachePeriod)).setCacheControl(cacheControl)); } String staticPathPattern = this.mvcProperties.getStaticPathPattern(); if (!registry.hasMappingForPattern(staticPathPattern)) { this.customizeResourceHandlerRegistration(registry.addResourceHandler(new String[]{staticPathPattern}).addResourceLocations(getResourceLocations(this.resourceProperties.getStaticLocations())).setCachePeriod(this.getSeconds(cachePeriod)).setCacheControl(cacheControl)); } } }
- 所有/web.jars/**中的资源都在classpath:/META-INF/resources/webjars/中寻找。
- web.jars:以jar包的方式引入静态资源: https://www.webjars.org/
- 访问时,只需要写web.jars下面资源的名称。
/**:访问当前项目的任何资源(静态资源的文件夹)
classpath:/META-INF/resources/ classpath:/resources/ classpath:/static/ classpath:/public/ / # 当前项目的根路径
@Bean public WelcomePageHandlerMapping welcomePageHandlerMapping(ApplicationContext applicationContext) { return new WelcomePageHandlerMapping(new TemplateAvailabilityProviders(applicationContext), applicationContext, this.getWelcomePage(), this.mvcProperties.getStaticPathPattern()); }
配置欢迎页的映射:
- 欢迎页:静态资源文件夹下的所有index.xml页面,被 /** 映射。
@Configuration @ConditionalOnProperty( value = {"spring.mvc.favicon.enabled"}, matchIfMissing = true ) /* * ResourceLoaderAware是一个标记接口 * 用于通过ApplicationContext上下文注入ResourceLoader * 有setResourceLoader()方法 */ public static class FaviconConfiguration implements ResourceLoaderAware { private final ResourceProperties resourceProperties; /* * ResourceLoader用于返回Resource对象和ClassLoader对象 * - getResource(String location)方法根据提供的location参数返回相应的Resource对象 * - getClassLoader()方法则返回加载这些Resource的ClassLoader */ private ResourceLoader resourceLoader; public FaviconConfiguration(ResourceProperties resourceProperties) { this.resourceProperties = resourceProperties; } public void setResourceLoader(ResourceLoader resourceLoader) { this.resourceLoader = resourceLoader; } /* * SimpleUrlHandlerMapping是SpringMVC中适应性最强的Handler Mapping类 * 允许明确指定URL模式和Handler的映射关系.有两种声明方式: * - prop: * - key: URL模式 * — value: Handler的ID或者名字 * - value: * - 等号左边是URL模式 * - 等号右边是HandlerID或者名字 */ @Bean public SimpleUrlHandlerMapping faviconHandlerMapping() { SimpleUrlHandlerMapping mapping = new SimpleUrlHandlerMapping(); mapping.setOrder(-2147483647); mapping.setUrlMap(Collections.singletonMap("**/favicon.ico", this.faviconRequestHandler())); return mapping; }
配置喜欢的图标(标签的图标):
- 标签图标:所有的 **/favicon.ico 都是在静态文件夹资源下。
模板引擎
- jsp,velocity,freemarker,thymeleaf
优点 | 缺点 | |
---|---|---|
jsp |
1. 功能强大,可以写 Java 代码 2. 支持 jsp 标签 – jsp tag 3. 支持表达式语言 – EL 表达式 4. 官方标准,使用广泛,丰富的第三方 jsp 标签库 5. 性能良好 ,jsp 编译成 class 文件执行,有很好的性能表现 |
1. jsp没有明显的缺点 2. 由于可以编写Java代码,使用不当容易破坏MVC结构 |
velocity |
1. 不编写 Java 代码,实现严格的 MVC 分离 2. 性能良好,比 jsp 优越 3. 使用表达式语言 – EL 表达式 |
1. 不是官方标准 2. 使用范围小,第三方标签库较少 3. 对 jsp 标签的支持不够友好 |
freemarker |
1. 不编写 Java 代码,实现严格的 MVC 分离 2. 性能非常好 3. 对 jsp 标签支持良好 4. 内置大量常用功能,使用非常方便 5. 宏定义(类似 jsp 标签)非常方便 6. 使用表达式语言 – EL 表达式 |
1.不是官方标准 2. 使用范围小,第三方标签库较少 |
thymeleaf |
1. 静态 html 嵌入标签属性,浏览器可以直接打开模板文件,便于后端联调 2. SpringBoot 框架推荐模板 |
1.模板必须符合 xml 规范 2. 需要加入 js 脚本 |
-
freemarker:
-
freemarker
是一个用 Java
语言编写的模板引擎,基于模板生成文本来输出 -
freemarker
与 Web
容器无关,也就是说,在 Web
运行时,并不知道是 Servlet
还是 HTTP -
不仅可以用作表现层的实现技术,而且还可以用于生成 XML,JSP,
或 Java
等 -
目前企业中主要使用 freemarker
做静态页面或页面展示 -
选择freemarker的原因:
-
性能:
就性能而言 ,velocity
是最好的,其次是 jsp,
普通的页面 freemarker
性能最差.但是在复杂页面,比如包含大量判断,日期金额格式化的页面上 ,freemarker
的性能比使用 tag
和 el
的 jsp
好 -
宏定义比 jsp tag
方便 - 内置大量常用功能. 比如html过滤,日期金额格式化等等,使用方便
-
支持 jsp
标签 -
可以实现严格等 mvc
分离
-
性能:
-
freemarker
-
freemarker与velocity比较:
-
velocity:
- velocity优于freemarker在于有广泛的第三方支持以及庞大的用户社区
- velocity的性能是最好的
-
freemarker:
- freemarker比velocity简单,因为velocity必须编写一些自定义的toolbox以及一遍一遍重复的编写一些比较通用的模版代码
- velocity的做法使得在velocity的模版中大量的与Java对象交互,违背了简单的原则,尽管也可以将代码转入控制器中实现
-
freemarker能做到,而velocity无法做到的:
-
日期和数字的支持:
- 比较和格式化显示日期或者时间值
- 执行运算和比较,对任意数量的类型,包括精度类型,而不仅仅是整数
-
国际化:
- 格式数字区域,各种各样的内置和自定义数字格式模式
- 格式日期地区和时区,各种各样的内置和定制的日期格式模式
- 标识符,即变量名可以包含非英语字母一样的重音字母,阿拉伯字母,汉字等
-
循环处理:
- 退出循环
- 访问控制变量外循环机构的内部循环
- 得知当前是否到了循环的结束位置
-
模版级别的数组处理:
-
使用 [i]
的语法来访问数组元素,包括原始的和非原始的指数 - 获取数组的长度
-
使用 [i]
-
宏定义:
- 宏调用可以通过位置或名称进行参数传递
- 宏的参数可以设定默认值,在调用宏时如果没有指定该参数,则使用默认值代替
-
通过 body
可以支持宏的嵌套 -
通过文本表达的 “宏的名称”
来直接调用某个宏 - 宏允许先使用再定义
- 宏可以定义局部变量
-
命名空间:
- 使用多个名称空间的变数. 这个在建立 “宏库”
- 内置与Java语言无关的字符串,列表,Map的操作方法
-
能提示模版中的拼写错误以及其他错误
- 当访问一个不存在的变量时,freemarker在执行模版时会报错
- 通过配置,可以指定freemarker在发生此类错误时停止执行,还是忽略该错误,同时freemarker会在日志中记录此问题
- 输入错误的指令名称,freemarker将抛出一个异常
-
更高级的文本输出工具:
-
将模版块封装在一组标记中,这样可以应用HTML转义或者XML转义(或者freemarker表达式的其他转换)到 ${foo}
块中 - freemarker具有模版块的转换器,会在渲染时经过转换过滤器.内置的转换器包括空格压缩器,HTML和XML溢出器. 也可以实现自定义的转换器,即如果生成Java源代码,则可以编写Java代码pretty-printer转换并插入到模版中.同时转换也可以嵌套
-
使用内置的 flush-directive
显式刷新输出写入器 -
使用内置的 stop-directive
停止渲染
-
将模版块封装在一组标记中,这样可以应用HTML转义或者XML转义(或者freemarker表达式的其他转换)到 ${foo}
-
文本处理:
- 支持Java的特殊字符处理,比如 \b, \t, \n, \f, \r, \ “, \ ‘, \ , 以及unicode的 \xXXXX
- 除了通常的字符串,数字,布尔常量,也可以自定义列表和地图文字以及内部模版
-
高级的空格删除:
- freemarker将删除一些多余的空格,跳格,换行等字符
- 提供相关指令来删除多余的空格
-
与其他技术集成:
-
提供 JSP
标签库以便在 JSP
中嵌入 freemarker
模版 - 直接和Python对象一起使用
-
提供 JSP
- 更强大的XML转换功能
-
模版元程序:
- 捕捉到输出任意部分范本背景变量
- 任意解释的范围变量,类似一个模版定义
-
日期和数字的支持:
-
velocity:
thymeleaf
thymeleaf基本概念
-
thymeleaf
是一个 XML,XHTML,HTML5
模板引擎,可用于 Web
与非 Web
应用 -
thymeleaf主要目标:
提供一个可被浏览器正确显示的,格式良好的模板创建方式,可以用于静态建模 -
可以使用thymeleaf创建经过验证的XML与HTML模板:
- 相对于编写逻辑代码,开发者只需将标签属性添加到模板中即可
-
这些标签就会在文档对象模型 DOM
上执行预先制定好的逻辑
-
thymeleaf具有良好的扩展性:
-
可以使用 thymeleaf
自定义模板属性集合,用来计算自定义表达式并使用自定义逻辑 -
这样 thymeleaf
可以作为模板引擎框架
-
可以使用 thymeleaf
引入thymeleaf依赖
- 引入SpringBoot中的thymeleaf依赖:
3.0.2.RELEASE 2.1.1 org.springframework.boot spring-boot-starter-thymeleaf
thymeleaf使用和语法
@ConfigurationProperties( prefix = "spring.thymeleaf" ) public class ThymeleafProperties { private static final Charset DEFAULT_ENCODING; public static final String DEFAULT_PREFIX = "classpath:/templates/"; public static final String DEFAULT_SUFFIX = ".html"; private boolean checkTemplate = true; private boolean checkTemplateLocation = true; private String prefix = "classpath:/templates/"; private String suffix = ".html"; private String mode = "HTML"; private Charset encoding;
- 将html页面放在classpath:/templates/中,thymeleaf就能自动渲染了。
-
Thymeleaf的使用
:
1.导入thymeleaf的名称空间
2.使用thymeleaf语法:
-
th:text
– 改变当前元素里面的文本内容 -
th:任意html属性
– 改变原生属性的值
thymeleaf | jsp | |
---|---|---|
片段包含 |
th:insert th:replace |
include |
遍历 | th:each | c:forEach |
条件判断 |
th:if th:unless th:switch th:case |
c:if |
声明变量 |
th:object th:with |
c:set |
任意属性修改 |
th:attr th:attrprepend(前面) th:attrappend(后面) |
|
修改指定属性默认值 |
th:value th:href th:src |
|
修改标签体文本内容 |
th:text(转义) th:utext(不转义) |
|
声明片段 | th:fragment | |
移除声明片段 | th:remove |
-
表达式
:
Simple expressions: (表达式语法) Variable Expressions: ${...} (获取变量值-OGNL) 1.获取对象的属性,调用方法 2.使用内置的基本对象: #ctx : the context object. #vars: the context variables. #locale : the context locale. #request : (only in Web Contexts) the HttpServletRequest object. #response : (only in Web Contexts) the HttpServletResponse object. #session : (only in Web Contexts) the HttpSession object. #servletContext : (only in Web Contexts) the ServletContext object. 3.内置的工具对象: #execInfo : information about the template being processed. #messages : methods for obtaining externalized messages inside variables expressions, in the same way as they would be obtained using #{…} syntax. #uris : methods for escaping parts of URLs/URIs #conversions : methods for executing the configured conversion service (if any). #dates : methods for java.util.Date objects: formatting, component extraction, etc. #calendars : analogous to #dates , but for java.util.Calendar objects. #numbers : methods for formatting numeric objects. #strings : methods for String objects: contains, startsWith, prepending/appending, etc. #objects : methods for objects in general. #bools : methods for boolean evaluation. #arrays : methods for arrays. #lists : methods for lists. #sets : methods for sets. #maps : methods for maps. #aggregates : methods for creating aggregates on arrays or collections. #ids : methods for dealing with id attributes that might be repeated (for example, as a result of an iteration). Selection Variable Expressions: *{...} (选择表达式,和${}在用法上大体一致) 补充:配合th:object="${session.user}"Name: Sebastian. Surname: Pepper. Nationality: Saturn.Which is exactly equivalent to:Name: Sebastian. Surname: Pepper. Nationality: Saturn.Message Expressions: #{...} (获取国际化内容) Link URL Expressions: @{...} (定义url) view view view Fragment Expressions: ~{...} (片段引用表达式) Literals(字面量) Text literals: 'one text' , 'Another one!' ,… Number literals: 0 , 34 , 3.0 , 12.3 ,… Boolean literals: true , false Null literal: null Literal tokens: one , sometext , main ,… Text operations (文本操作) String concatenation: + Literal substitutions: |The name is ${name}| Arithmetic operations (数学运算) Binary operators: + , - , * , / , % Minus sign (unary operator): - Boolean operations (布尔运算) Binary operators: and , or Boolean negation (unary operator): ! , not Comparisons and equality (比较运算) Comparators: > , = , <= ( gt , lt , ge , le ) Equality operators: == , != ( eq , ne ) Conditional operators(条件运算) If-then: (if) ? (then) If-then-else: (if) ? (then) : (else) Default: (value) ?: (defaultvalue) Special tokens(特殊操作) No-Operation: _
SpringBoot对SpringMVC的web主要的自动配置
- SpringBoot默认自动配置了SpringMVC
-
自动配置了 ViewResolver-ContentNegotiatingViewResolver,BeanNameViewResolver
(视图解析器:根据方法的返回值得到视图对象,视图对象决定转发、重定向)
1. ContentNegotiatingViewResolver:
组合所有的视图解析器
1.1:如何定制配置-在容器中添加一个定制的视图解析器,ContentNegotiatingViewResolver会自动将定制的视图解析器组合进来 - 静态资源文件夹路径和 web.jars
- 静态首页访问
- favicon.ico
-
自动注册Converter,GenericConverter,Formatter
1. Converter
:转换器,类型转换使用
2. GenericConverter
:通用转换器,多个源类型和目标类型之间进行转换。
3. Formatter
:格式化器-可以自己定制格式化转换器放在容器中即可以配置 -
HttpMessageConverter:
SpringMVC用来转换Http请求和响应的。从容器中确定HttpMessageConverters值。可以自己将定制配置的HttpMessageConverter放在容器中即可配置。 -
MessageCodeResolver:
定义错误代码生成规则 -
ConfigurableWebBindingInitializer:
初始化web数据绑定器,绑定器把请求数据绑定.可以配置ConfigurableWebBindingInitializer添加到容器中替换默认的
如何修改SpringBoot的默认配置
-
SpringBoot
在自动配置很多组件时,先看容器中有没有已经配置 (@Bean,@Component)
好的组件,如果有,就用已经配置好的,如果没有,才自动配置;如果组件可以有多个,将已经配置的和默认配置的组合起来。
扩展MVC(不能标注@EnableWebMvc)
- 编写一个配置类(@Configuration),继承WebMvcConfigurationSupport,不能标注@EnableWebMvc。既保留了所有的自动配置,也可以使用扩展的配置。在做配置时,会导入
@Import({WebMvcAutoConfiguration.EnableWebMvcConfiguration.class})
EnableWebMvcConfiguration:
@Configuration public static class EnableWebMvcConfiguration extends DelegatingWebMvcConfiguration {
DelegatingWebMvcConfiguration:
// @Autowired( required = false ) public void setConfigurers(List configurers) { if (!CollectionUtils.isEmpty(configurers)) { this.configurers.addWebMvcConfigurers(configurers); } }
参考实现:
//将所有的WebMvcConfigurer相关的配置都调用一遍 public void addViewControllers(ViewControllerRegistry registry) { Iterator var2 = this.delegates.iterator(); while(var2.hasNext()) { WebMvcConfigurer delegate = (WebMvcConfigurer)var2.next(); delegate.addViewControllers(registry); } }
-
容器中所有的WebMvcConfigurer
都会起作用。配置的配置类也会被调用。这样Spring的自动配置和扩展配置都会起作用。
全面接管SpringMVC(@EnableWebMvc)—不推荐使用
- 禁用SpringBoot对SpringMVC的自动配置,全面对SpringMVC进行配置。在配置类中标注@EnableWebMvc。所有的SpringMVC的默认配置都被禁用了。
-
@EnableWebMvc
:
@Import({DelegatingWebMvcConfiguration.class}) public @interface EnableWebMvc { }
DelegatingWebMvcConfiguration:
@Configuration public class DelegatingWebMvcConfiguration extends WebMvcConfigurationSupport {
WebMvcAutoConfiguration:
@Configuration @ConditionalOnWebApplication( type = Type.SERVLET ) @ConditionalOnClass({Servlet.class, DispatcherServlet.class, WebMvcConfigurer.class}) @ConditionalOnMissingBean({WebMvcConfigurationSupport.class}) //当容器中没有此组件时,此自动配置类才生效 @AutoConfigureOrder(-2147483638) @AutoConfigureAfter({DispatcherServletAutoConfiguration.class, TaskExecutionAutoConfiguration.class, ValidationAutoConfiguration.class})
-
@EnableWebMvc将WebMvcAutoConfigurationSupport导入进来,不包括SpringMVC的功能。
总结: - 多多学习SpringBoot中的XxxConfigurer,进行扩展配置