在spring boot中配置多個DispatcherServlet
spring boot為我們自動配置了一個開箱即用的DispatcherServlet,對映路徑為‘/’,但是如果專案中有多個服務,為了對不同服務進行不同的配置管理,需要對不同服務設定不同的上下文,比如開啟一個DispatcherServlet專門用於rest服務。
傳統springMVC專案
在傳統的springMVC專案中,配置多個DispatcherServlet很輕鬆,在web.xml中直接配置多個就行:
<servlet>
<servlet-name>restServlet</servlet-name>
<servlet-class >org.springframework.web.servlet.DispatcherServlet</servlet-class>
<init-param>
<param-name>contextConfigLocation</param-name>
<param-value>/WEB-INF/spring2.xml</param-value>
</init-param>
<load-on-startup>1</load-on-startup >
</servlet>
<servlet-mapping>
<servlet-name>ModelRestServlet</servlet-name>
<url-pattern>/service/*</url-pattern>
</servlet-mapping>
通過指定init-param中的contextConfigLocation就能夠為這個DispatcherServlet指定上下文。
spring boot中註冊Servlet的兩種方式
但spring boot把tomcat都給隱藏了,更別說web.xml了。好在提供了另外的方式配置servlet。
這個是javaee的註解,是servlet3.0以後提供的。spring boot會掃描這個註解,並將這個註解註解的類註冊到web容器中作為一個servlet。
但是DispatcherServlet並不是自定義的servlet,而是框架提供的servlet,所以此方法不行。
2.ServletRegistrationBean:
這個bean是由spring boot提供專門來註冊servlet的,可以象註冊bean一樣去配置servlet。
@Bean
public ServletRegistrationBean restServlet(){
//註解掃描上下文
AnnotationConfigWebApplicationContext applicationContext
= new AnnotationConfigWebApplicationContext();
//base package
applicationContext.scan("com.jerryl.rest");
//通過建構函式指定dispatcherServlet的上下文
DispatcherServlet rest_dispatcherServlet
= new DispatcherServlet(applicationContext);
//用ServletRegistrationBean包裝servlet
ServletRegistrationBean registrationBean
= new ServletRegistrationBean(rest_dispatcherServlet);
registrationBean.setLoadOnStartup(1);
//指定urlmapping
registrationBean.addUrlMappings("/rest/*");
//指定name,如果不指定預設為dispatcherServlet
registrationBean.setName("rest");
return registrationBean;
}
其中需要注意的是registration.setName("rest"),這個語句很重要,因為name相同的ServletRegistrationBean只有一個會生效,也就是說,後註冊的會覆蓋掉name相同的ServletRegistrationBean。
如果不指定,預設為“dispatcherServlet”而spring boot提供的DispatcherServlet的name就是“dispatcherServlet”。可以在spring boot的DispatcherServletAutoConfiguration類中找到:
public ServletRegistrationBean dispatcherServletRegistration(DispatcherServlet dispatcherServlet) {
ServletRegistrationBean registration = new ServletRegistrationBean(dispatcherServlet, new String[]{this.serverProperties.getServletMapping()});
registration.setName("dispatcherServlet");
registration.setLoadOnStartup(this.webMvcProperties.getServlet().getLoadOnStartup());
if(this.multipartConfig != null) {
registration.setMultipartConfig(this.multipartConfig);
}
return registration;
}
}
所以為了不覆蓋預設的dispatcherServlet,必須指定一個別的名稱。
同時,在自定義的DispathcerServlet繫結的配置類上,要配置報掃描的話,必須要加上@EnableWebMvc註解,不然不會掃描@Contrller註解。
package com.jerryl.rest;
@Configuration
@ComponentScan("org.activiti.rest.service.api")
@EnableWebMvc
public class Cfg_Rest {
···
}
遮蔽rest服務DispatcherServlet對靜態資源的訪問
最後還有一個小問題,因為想讓額外配置的一個DispatcherServlet專門用於提供rest服務,但是這樣配置之後,訪問localhost/rest/時會訪問到頁面等靜態資源,感覺怪怪的。
因為spring boot預設是對靜態資源做了對映的,但如果不想要訪問到任何靜態的資源,可以修改這個對映。
兩種方式:
1.在application.yml中配置:
spring:
mvc:
#預設為/**
static-path-pattern: /**
resources:
#預設為classpath:/META-INF/resources/,classpath:/resources/,classpath:/static/,classpath:/public/ 。配置多個路徑,中間用逗號隔開。
static-locations:
如果在這裡配置,就會影響整個springboot專案。但預設的DispatcherServlet是需要訪問靜態資源的,所以不能在這裡配置。
2.繼承WebMvcConfigurerAdapter的java類中配置:
@Configuration
@EnableWebMvc
public class Cfg_View extends WebMvcConfigurerAdapter{
@Override
public void addResourceHandlers(ResourceHandlerRegistry registry) {
registry.addResourceHandler("/**");
}
}
重寫addResourceHandlers方法,只指定resourceHandler,不指定resourceLocation,這樣寫就能夠使其攔截掉所有對靜態資源的訪問,並且不會返回任何靜態資源。這裡的配置是可指定的,只需要讓負責rest服務的DispatcherServlet的上下文掃描這個配置類就可以了。不會影響預設的DispatcherServlet。