Spring Boot提供了spring-boot-starter-web为Web开发予以支持。其中提供了Tomcat及Spring MVC的依赖。而Web相关的自动配置存储在org.springframework.boot.autoconfigure.web里面
1.Web相关配置
可以通过查看WebMvcAutoConfiguration及WebMvcProperties的源码
1.1自动配置的ViewResolver
1.2自动配置的静态资源
把类路径下的/static 、/public 、/resources和/META-INF/resources文件夹下的静态文件直接映射为/**,可以通过http://localhost:8080
- webjar
webjar就是将我们常用的脚本框架封装在jar包中的jar对象。
1.3自动配置的Formatter和Converter
Spring Converter的作用就是将一个类型转化为另一个类型。Formatter是对输入输出的信息格式化。
详情参考我之前写的文章Spring MVC的数据转换及数据格式化
1.4 自动配置HttpMessageConverts
1.5静态首页的支持
把静态index.html放在以下目录会被自动映射
classpath:/META-INF/resources/index.html
classpath:/resources/index.html
classpath:/resources/static/index.html
classpath:/resources/public/index.html
1.6重写WebMVC的配置
public class WebMvcConfig extends WebMvcConfigurerAdapter {
/**
* {@inheritDoc}
* <p>This implementation is empty.
*
* @param registry
*/
@Override
public void addViewControllers(ViewControllerRegistry registry) {
registry.addViewController("/xx").setViewName("/xx");
}
}
1.7注册Servlet、Filter、Listener
2.Tomcat配置
对于Spring Boot而言,这里的Tomcat其实指的是servelt容器的配置。因为Spring Boot默认内嵌的Tomcat为servlet容器。
2.1配置Tomcat
关于Tomcat的所有属性的配置在org.springframework.boot.autoconfigure.web.ServerProperties里。我们只需要在application.properties配置属性做下配置即可。
通用的Servelet容器配置都以"server"作为前缀,而Tomcat特有配置都以"server.tomcat"作为前缀。
- 配置Servelet容器
server.port=xx 默认为8080
server.session-timeout= xx 用户会话session过期时间,以秒为单位
server.context-path= xx 配置访问路径,默认为/
- 配置Tomcat
server.tomcat.uri-encoding=# 配置Tomcat编码,默认为uft-8
server.tomcat.compression=# tomcat是否开启压缩,默认为关闭off
2.2代码配置通用Servlet属性
- 方式一
该CustomerServletContainer是单独的创建的类
@Component
public class CustomerServletContainer implements EmbeddedServletContainerCustomizer {
/**
* Customize the specified {@link ConfigurableEmbeddedServletContainer}.
*
* @param container the container to customize
*/
@Override
public void customize(ConfigurableEmbeddedServletContainer container) {
container.setPort(9000);
container.addErrorPages(new ErrorPage(HttpStatus.NOT_FOUND, "/404.html"));
container.setSessionTimeout(10, TimeUnit.MINUTES);//设置过期时间
}
}
注意:404页面需要放在resources/static目录下。
- 方式二
在Application启动类里面进行使用内部类方式
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
@Component
public class CustomerServletContainer implements EmbeddedServletContainerCustomizer {
@Override
public void customize(ConfigurableEmbeddedServletContainer container) {
container.setPort(9000);
container.addErrorPages(new ErrorPage(HttpStatus.NOT_FOUND, "/404.html"));
container.setSessionTimeout(10, TimeUnit.MINUTES);//设置过期时间
}
}
}
2.3 代码特殊配置Servlet属性(以Tomcat为例)
/**
* 对于不同的Servlet的不同配置,比如下面我们配置Tomcat的特殊配置
*
*/
@Component
public class SpecificCustomerServletContainer {
@Bean
public EmbeddedServletContainerFactory servletContainerFactory(){
TomcatEmbeddedServletContainerFactory tomcatFactory=new TomcatEmbeddedServletContainerFactory();
tomcatFactory.setPort(9200);
tomcatFactory.addErrorPages(new ErrorPage(HttpStatus.NOT_FOUND,"/404.html"));
tomcatFactory.setSessionTimeout(10, TimeUnit.MINUTES);
return tomcatFactory;
}
}
3.替换Servlet容器
Spring Boot默认使用Tomcat为内嵌Servlet容器。可以看spring-boot-starter-web的pom文件
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starters</artifactId>
<version>1.5.7.RELEASE</version>
</parent>
<artifactId>spring-boot-starter-web</artifactId>
<name>Spring Boot Web Starter</name>
<description>Starter for building web, including RESTful, applications using Spring
MVC. Uses Tomcat as the default embedded container</description>
<url>http://projects.spring.io/spring-boot/</url>
<organization>
<name>Pivotal Software, Inc.</name>
<url>http://www.spring.io</url>
</organization>
<properties>
<main.basedir>${basedir}/../..</main.basedir>
</properties>
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-tomcat</artifactId>
</dependency>
<dependency>
<groupId>org.hibernate</groupId>
<artifactId>hibernate-validator</artifactId>
</dependency>
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-databind</artifactId>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-web</artifactId>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-webmvc</artifactId>
</dependency>
</dependencies>
</project>
- 使用jetty为servlet容器
dependencies {
compile('org.springframework.boot:spring-boot-starter-web'){
exclude module: 'spring-boot-starter-tomcat'//排除tomcat servlet
}
compile('org.springframework.boot:spring-boot-starter-jetty')
compile('org.springframework.boot:spring-boot-configuration-processor')
testCompile('org.springframework.boot:spring-boot-starter-test')
}
4.Https配置
对比一些应用,要求访问的域名必须是https。比如小程序访问的地址,必须是Https。所以对于Spring Boot配置Https很重要。
- 使用jdk自带的生成证书
jdk的安装目录bin文件夹中有个keytool.exe。它可以生成签名的证书。
按照提示输入完,会在当前目录下生成一个.keystore的文件。
- spring boot代码配置
将.keystore的文件拷贝到resources文件下。
server.ssl.key-store=classpath:.keystore
server.ssl.key-store-password=xxx
#JKS Java Key Store
server.ssl.key-store-type=JKS
server.ssl.key-alias=stalkers
一般自定义的证书chrome浏览器是不认的,会报客户端和服务器不支持一般 SSL 协议版本或加密套件。 错误。需要用IE打开。
5.http自动跳转https
很多时候,我们输入url地址并不会特地输入http或者https。而浏览器默认的是http。但是我们网站是https所以需要自动跳转。
处理方式:
一:用nginx反向代理tomcat,然后把nginx配置为https访问,并且nginx与tomcat之间配置为普通的http协议即可。(今天不介绍)
二:把tomcat配置为支持ssl。以下为改方法的处理方式
@Bean
public EmbeddedServletContainerFactory servletContainer(){
TomcatEmbeddedServletContainerFactory tomcat = new TomcatEmbeddedServletContainerFactory(){
@Override
protected void postProcessContext(Context context) {
SecurityConstraint securityConstraint = new SecurityConstraint();
securityConstraint.setUserConstraint("CONFIDENTIAL");
SecurityCollection collection = new SecurityCollection();
collection.addPattern("/*");
securityConstraint.addCollection(collection);
context.addConstraint(securityConstraint);
}
};
tomcat.addAdditionalTomcatConnectors(httpConnector());
return tomcat;
}
@Bean
public Connector httpConnector(){
Connector connector = new Connector("org.apache.coyote.http11.Http11NioProtocol");
connector.setScheme("http");
connector.setPort(80);
connector.setSecure(false);
connector.setRedirectPort(443);
return connector;
}
6.Favicon配置
Spring Boot默认是开启图标的,我们关闭只需要在application.properties里面进行配置
spring.mvc.favicon.enabled=false
将自己的favicon放在以下目录
classpath:/META-INF/resources/xx
classpath:/resources/xx
classpath:/resources/static/xx
classpath:/resources/public/xx