SpingMVC 核心技術幫助文檔

</beans> </code></pre>

若要同時使用全局驗證和局部驗證，只需添加一個（或多個）局部驗證器即可：

@Controller
public class MyController {


@InitBinder
protected void initBinder(WebDataBinder binder) {
    binder.addValidators(new FooValidator());
}


}
</code></pre> 
  
做完這個最少的配置之后，任何時候只要方法中有參數注解了 @Valid 或 @Validated ，配置的驗證器就會自動對它們做驗證。任何無法通過的驗證都會被自動報告為錯誤并添加到 BindingResult 對象中去，你可以在方法參數中聲明它并獲取這些錯誤，同時這些錯誤也能在Spring MVC的HTML視圖中被渲染。
 
  
21.16.5 攔截器
 
  
你可以配置處理器攔截器 HandlerInterceptors 或web請求攔截器 WebRequestInterceptors 等攔截器，并配置它們攔截所有進入容器的請求，或限定到符合特定模式的URL路徑。
 
  
在MVC Java編程配置下注冊攔截器的方法：
 
  
@Configuration
@EnableWebMvc
public class WebConfig extends WebMvcConfigurerAdapter {


@Override
public void addInterceptors(InterceptorRegistry registry) {
    registry.addInterceptor(new LocaleInterceptor());
    registry.addInterceptor(new ThemeInterceptor()).addPathPatterns("/**").excludePathPatterns("/admin/**");
    registry.addInterceptor(new SecurityInterceptor()).addPathPatterns("/secure/*");
}


}
</code></pre> 
  
在MVC XML命名空間下，則使用 <mvc:interceptors> 元素：
 
  
<mvc:interceptors>
    <bean class="org.springframework.web.servlet.i18n.LocaleChangeInterceptor"/>
    <mvc:interceptor>
        <mvc:mapping path="/**"/>
        <mvc:exclude-mapping path="/admin/**"/>
        <bean class="org.springframework.web.servlet.theme.ThemeChangeInterceptor"/>
    </mvc:interceptor>
    <mvc:interceptor>
        <mvc:mapping path="/secure/*"/>
        <bean class="org.example.SecurityInterceptor"/>
    </mvc:interceptor>
</mvc:interceptors>
 
  
21.16.6 內容協商
 
  
You can configure how Spring MVC determines the requested media types from the request. The available options are to check the URL path for a file extension, check the "Accept" header, a specific query parameter, or to fall back on a default content type when nothing is requested. By default the path extension in the request URI is checked first and the "Accept" header is checked second.
 
  
The MVC Java config and the MVC namespace register json , xml , rss , atom by default if corresponding dependencies are on the classpath. Additional path extension-to-media type mappings may also be registered explicitly and that also has the effect of whitelisting them as safe extensions for the purpose of RFD attack detection (see the section called "Suffix Pattern Matching and RFD" for more detail).
 
  
Below is an example of customizing content negotiation options through the MVC Java config:
 
  
@Configuration
@EnableWebMvc
public class WebConfig extends WebMvcConfigurerAdapter {


_@Override_
public void configureContentNegotiation(ContentNegotiationConfigurer configurer) {
    configurer.mediaType("json", MediaType.APPLICATION_JSON);
}

}
</code></pre> 
  
In the MVC namespace, the <mvc:annotation-driven> element has a content- negotiation-manager attribute, which expects a ContentNegotiationManager that in turn can be created with a ContentNegotiationManagerFactoryBean :
 
  
<mvc:annotation-driven content-negotiation-manager="contentNegotiationManager"/>

<bean id="contentNegotiationManager" class="org.springframework.web.accept.ContentNegotiationManagerFactoryBean">
    <property name="mediaTypes">
        <value>
            json=application/json
            xml=application/xml
        </value>
    </property>
</bean>
</code></pre> 
  
If not using the MVC Java config or the MVC namespace, you'll need to create an instance of ContentNegotiationManager and use it to configure RequestMappingHandlerMapping for request mapping purposes, and RequestMappingHandlerAdapter and ExceptionHandlerExceptionResolver for content negotiation purposes.
 
  
Note that ContentNegotiatingViewResolver now can also be configured with a ContentNegotiationManager , so you can use one shared instance throughout Spring MVC.
 
  
In more advanced cases, it may be useful to configure multiple ContentNegotiationManager instances that in turn may contain custom ContentNegotiationStrategy implementations. For example you could configure ExceptionHandlerExceptionResolver with a ContentNegotiationManager that always resolves the requested media type to "application/json" . Or you may want to plug a custom strategy that has some logic to select a default content type (e.g. either XML or JSON) if no content types were requested.
 
  
21.16.7 視圖控制器
 
  
以下的一段代碼相當于定義一個 ParameterizableViewController 視圖控制器的快捷方式，該控制器會立即將一個請求轉發（forwards）給一個視圖。請確保僅在以下情景下才使用這個類：當控制器除了將視圖渲染到響應中外不需要執行任何邏輯時。
 
  
以下是一個例子，展示了如何在MVC Java編程配置方式下將所有 "/" 請求直接轉發給名字為 "home" 的視圖：
 
  
@Configuration
@EnableWebMvc
public class WebConfig extends WebMvcConfigurerAdapter {


@Override
public void addViewControllers(ViewControllerRegistry registry) {
    registry.addViewController("/").setViewName("home");
}


}
</code></pre> 
  
在MVC XML命名空間下完成同樣的配置，則使用 <mvc:view-controller> 元素：
 
  
<mvc:view-controller path="/" view-name="home"/>
 
  
21.16.8 視圖解析器
 
  
MVC提供的配置簡化了視圖解析器的注冊工作。
 
  
以下的代碼展示了在MVC Java編程配置下，如何為內容協商配置FreeMarker HTML模板和Jackson作為JSON數據的默認視圖解析：
 
  
@Configuration
@EnableWebMvc
public class WebConfig extends WebMvcConfigurerAdapter {


@Override
public void configureViewResolvers(ViewResolverRegistry registry) {
    registry.enableContentNegotiation(new MappingJackson2JsonView());
    registry.jsp();
}


}
</code></pre> 
  
在MVC XML命名空間下實現相同配置：
 
  
<mvc:view-resolvers>
    <mvc:content-negotiation>
        <mvc:default-views>
            <bean class="org.springframework.web.servlet.view.json.MappingJackson2JsonView"/>
        </mvc:default-views>
    </mvc:content-negotiation>
    <mvc:jsp/>
</mvc:view-resolvers>
 
  
需要注意的是，使用FreeMarker, Velocity, Tiles, Groovy Markup及script模板作為視圖技術時，仍需要配置一些其他選項。
 
  
MVC命名空間為每種視圖都提供了相應的元素。比如下面代碼是FreeMarker需要的配置：
 
  
<mvc:view-resolvers>
    <mvc:content-negotiation>
        <mvc:default-views>
            <bean class="org.springframework.web.servlet.view.json.MappingJackson2JsonView"/>
        </mvc:default-views>
    </mvc:content-negotiation>
    <mvc:freemarker cache="false"/>
</mvc:view-resolvers>

<mvc:freemarker-configurer>
    <mvc:template-loader-path location="/freemarker"/>
</mvc:freemarker-configurer>
</code></pre> 
  
在MVC Java編程配置方式下，添加一個視圖對應的“配置器”bean即可：
 
  
@Configuration
@EnableWebMvc
public class WebConfig extends WebMvcConfigurerAdapter {


@Override
public void configureViewResolvers(ViewResolverRegistry registry) {
    registry.enableContentNegotiation(new MappingJackson2JsonView());
    registry.freeMarker().cache(false);
}

@Bean
public FreeMarkerConfigurer freeMarkerConfigurer() {
    FreeMarkerConfigurer configurer = new FreeMarkerConfigurer();
    configurer.setTemplateLoaderPath("/WEB-INF/");
    return configurer;
}


}
</code></pre> 
  
資源的服務
 
  
21.16.10 回到默認的Servlet來進行資源服務
 
  
這些配置允許你將 DispatcherServlet 映射到"/"路徑（也即覆蓋了容器默認Servlet的映射），但依然保留容器默認的Servlet以處理靜態資源的請求。這可以通過配置一個URL映射到"/**"的處理器 DefaultServletHttpRequestHandler 來實現，并且該處理器在其他所有URL映射關系中優先級應該是最低的。
 
  
該處理器會將所有請求轉發（forward）到默認的Servlet，因此需要保證它在所有URL處理器映射 HandlerMappings 的最后。如果你是通過 <mvc:annotation-driven> 的方式進行配置，或自己定制了 HandlerMapping 實例，那么你需要確保該處理器 order 屬性的值比 DefaultServletHttpRequestHandler 的次序值 Integer.MAXVALUE 小。
 
  
使用默認的配置啟用該特性，你可以：
 
  
@Configuration
@EnableWebMvc
public class WebConfig extends WebMvcConfigurerAdapter {


@Override
public void configureDefaultServletHandling(DefaultServletHandlerConfigurer configurer) {
    configurer.enable();
}


}
</code></pre> 
  
XML命名空間只需一行：
 
  
 <mvc:default-servlet-handler/>
 
  
不過需要注意，覆寫了"/"的Servlet映射后，默認Servlet的 RequestDispatcher 就必須通過名字而非路徑來取得了。 DefaultServletHttpRequestHandler 會 嘗試在容器初始化的時候自動檢測默認Servlet，這里它使用的是一份主流Servlet容器（包括Tomcat、Jetty、GlassFish、 JBoss、Resin、WebLogic，和WWebSphere）已知的名稱列表。如果默認Servlet被配置了一個其他的名字，或者使用了一個列 表里未提供默認Servlet名稱的容器，那么默認Servlet的名稱必須被顯式指定。正如下面代碼所示：
 
  
  @Configuration
    @EnableWebMvc
    public class WebConfig extends WebMvcConfigurerAdapter {


    @Override
    public void configureDefaultServletHandling(DefaultServletHandlerConfigurer configurer) {
        configurer.enable("myCustomDefaultServlet");
    }

}

</code></pre> 
  
XML命名空間的配置方式：
 
  
  <mvc:default-servlet-handler default-servlet-name="myCustomDefaultServlet"/>
 
  
21.16.11 路徑匹配
 
  
這些配置允許你對許多與URL映射和路徑匹配有關的設置進行定制。關
 
  
下面是采用MVC Java編程配置的一段代碼：
 
  
@Configuration
    @EnableWebMvc
    public class WebConfig extends WebMvcConfigurerAdapter {


    @Override
    public void configurePathMatch(PathMatchConfigurer configurer) {
        configurer
            .setUseSuffixPatternMatch(true)
            .setUseTrailingSlashMatch(false)
            .setUseRegisteredSuffixPatternMatch(true)
            .setPathMatcher(antPathMatcher())
            .setUrlPathHelper(urlPathHelper());
    }

    @Bean
    public UrlPathHelper urlPathHelper() {
        //...
    }

    @Bean
    public PathMatcher antPathMatcher() {
        //...
    }

}

</code></pre> 
  
在XML命名空間下實現同樣的功能，可以使用 <mvc:path-matching> 元素：
 
  
  <mvc:annotation-driven>
        <mvc:path-matching
            suffix-pattern="true"
            trailing-slash="false"
            registered-suffixes-only="true"
            path-helper="pathHelper"
            path-matcher="pathMatcher"/>
    </mvc:annotation-driven>


<bean id="pathHelper" class="org.example.app.MyPathHelper"/>
<bean id="pathMatcher" class="org.example.app.MyPathMatcher"/>

</code></pre> 
  
21.16.12 消息轉換器
 
  
使用MVC Java編程配置方式時，如果你想替換Spring MVC提供的默認轉換器，完全定制自己的 HttpMessageConverter ，這可以通過覆寫 configureMessageConverters() 方法來實現。如果你只是想定制一下，或者想在默認轉換器之外再添加其他的轉換器，那么可以通過覆寫 extendMessageConverters() 方法來實現。
 
  
下面是一段例子，它使用定制的 ObjectMapper 構造了新的Jackson的JSON和XML轉換器，并用它們替換了默認提供的轉換器：
 
  
  @Configuration
    @EnableWebMvc
    public class WebConfiguration extends WebMvcConfigurerAdapter {


    @Override
    public void configureMessageConverters(List<HttpMessageConverter<?>> converters) {
        Jackson2ObjectMapperBuilder builder = new Jackson2ObjectMapperBuilder()
                .indentOutput(true)
                .dateFormat(new SimpleDateFormat("yyyy-MM-dd"))
                .modulesToInstall(new ParameterNamesModule());
        converters.add(new MappingJackson2HttpMessageConverter(builder.build()));
        converters.add(new MappingJackson2XmlHttpMessageConverter(builder.xml().build()));
    }

}

</code></pre> 
  
在上面的例子中， Jackson2ObjectMapperBuilder 用于為 MappingJackson2HttpMessageConverter 和 MappingJackson2XmlHttpMessageConverter 轉換器創建公共的配置，比如啟用tab縮進、定制的日期格式，并注冊了一個模塊 jackson-module-parameter-names 用于獲取參數名（Java 8新增的特性）
 
  
除了 jackson- dataformat-xml ，要啟用Jackson XML的tab縮進支持，還需要一個 woodstox-core-asl 依賴。
 
  
還有其他有用的Jackson模塊可以使用：
 
  
 
   
jackson-datatype-money ：提供了對 javax.money 類型的支持（非官方模塊）
 
   
jackson-datatype-hibernate ：提供了Hibernate相關的類型和屬性支持（包含懶加載aspects）
 
  
 
  
在XML做同樣的事也是可能的：
 
  
<mvc:annotation-driven>
    <mvc:message-converters>
        <bean class="org.springframework.http.converter.json.MappingJackson2HttpMessageConverter">
            <property name="objectMapper" ref="objectMapper"/>
        </bean>
        <bean class="org.springframework.http.converter.xml.MappingJackson2XmlHttpMessageConverter">
            <property name="objectMapper" ref="xmlMapper"/>
        </bean>
    </mvc:message-converters>
</mvc:annotation-driven>

<bean id="objectMapper" class="org.springframework.http.converter.json.Jackson2ObjectMapperFactoryBean"
      p:indentOutput="true"
      p:simpleDateFormat="yyyy-MM-dd"
      p:modulesToInstall="com.fasterxml.jackson.module.paramnames.ParameterNamesModule"/>
<bean id="xmlMapper" parent="objectMapper" p:createXmlMapper="true"/>
</code></pre> 
  
21.16.13 使用MVC Java編程進行高級定制
 
  
從 上面許多例子你可以看到，MVC Java編程配置和MVC命名空間的方式都提供了更高抽象層級的應用配置，它不需要你對底下創建的bean有非常深入的了解，相反，這使得你能僅專注于應 用需要的配置。不過，有時你可能希望對應用的更精細控制，或你就是單純希望理解底下的配置和機制。
 
  
要做到更精細的控制，你要做的第一步就是看看底層都為你創建了哪些bean。若你使用MVC Java編程的方式進行配置，你可以看看java文檔，以及 WebMvcConfigurationSupport 類的 @Bean 方法。這個類有的配置都會自動被 @EnableWebMvc 注解導入。事實上，如果你打開 @EnableWebMvc 的聲明，你就會看到應用于其上的 @Import 注解。
 
  
精細控制的下一步是選擇一個 WebMvcConfigurationSupport 創建的bean，定制它的屬性，或你可以提供自己的一個實例。這確保做到以下兩步：移除 @EnableWebMvc 注解以避免默認配置被自動導入，然后繼承 DelegatingWebMvcConfiguration 類，它是 WebMvcConfigurationSupport 的一個子類。以下是一個例子：
 
  
@Configuration
public class WebConfig extends DelegatingWebMvcConfiguration {


@Override
public void addInterceptors(InterceptorRegistry registry){
    // ...
}

@Override
@Bean
public RequestMappingHandlerAdapter requestMappingHandlerAdapter() {
    // 自己創建適配器，或者調用super讓基類處理
    // 然后在這里定制bean的一些屬性
}


}
</code></pre> 
  
應用應該只有一個繼承 DelegatingWebMvcConfiguration 的配置類，或只有一個 @EnableWebMvc 注解的類，因為它們背后注冊的bean都是相同的。
 
  
使用這個方式修改bean的屬性，與這節前面展示的任何高抽象層級的配置方式并不沖突。 WebMvcConfigurerAdapter 的子類和 WebMvcConfigurer 的實現都還是會被使用。
 
  
21.16.14 使用MVC命名空間進行高級的定制化
 
  
如果使用MVC命名空間，要在默認配置的基礎上實現粒度更細的控制，則要比使用MVC Java編程配置的方式難一些。
 
  
如果你確實需要這么做，那也盡量不要復制默認提供的配置，請嘗試配置一個 BeanPostProcessor 后置處理器，用它來檢測你要定制的bean。可以通過bean的類型來找，找到以后再修改需要定制的屬性值。比如這樣：
 
  
@Component
public class MyPostProcessor implements BeanPostProcessor {


public Object postProcessBeforeInitialization(Object bean, String name) throws BeansException {
    if (bean instanceof RequestMappingHandlerAdapter) {
        // 修改適配器的屬性
    }
}


}
</code></pre> 
  
注意， MyPostProcessor 需要被包含在 <component scan/> 的路徑下，這樣它才能被自動檢測到；或者你也可以手動顯式地用一個XML的bean定義來聲明它。
 
  
歡迎加群JAVA編程交流群 574337670
 
  
 
 
  
來自：http://www.cnblogs.com/yxh1008/p/6058479.html