SpringMVC使用註解配置方式

Posted on by

SpringMVC註解配置方式

使用配置類和註解代替web.xml和SpringMVC配置文件的功能。

一、創建初始化類

在 Servlet3.0 環境中，容器會在類路徑中查找實現javax.servlet.ServletContainerInitializer接口的類，如果找到的話就用它來配置 Servlet 容器。

Spring 提供瞭這個接口的實現，名為SpringServletContainerInitializer，這個類反過來又會查找實現WebApplicationInitializer的類並將配置的任務交給它們來完成。

Spring3.2 引入瞭一個便利的WebApplicationInitializer基礎實現，名為AbstractAnnotationConfigDispatcherServletInitializer，
當我們的類擴展瞭AbstractAnnotationConfigDispatcherServletInitializer並將其部署到 Servlet3.0 容器的時候，容器會自動發現它，並用它來配置 Servlet 上下文。

這裡新建一個工程來演示。

pom.xml裡的依賴可以復制之前的內容，web.xml 和 SpringMVC 已經不需要再進行創建瞭。

package com.pingguo.mvc.config;
import org.springframework.web.filter.CharacterEncodingFilter;
import org.springframework.web.filter.HiddenHttpMethodFilter;
import org.springframework.web.servlet.support.AbstractAnnotationConfigDispatcherServletInitializer;
import javax.servlet.Filter;
public class WebInit extends AbstractAnnotationConfigDispatcherServletInitializer {
    /**
     * 指定spring的配置類
     * @return
     */
    @Override
    protected Class<?>[] getRootConfigClasses() {
        return new Class[]{SpringConfig.class};
    }
    /**
     * 指定SpringMVC的配置類
     * @return
     */
    @Override
    protected Class<?>[] getServletConfigClasses() {
        return new Class[]{WebConfig.class};
    }
    /**
     * 指定DispatcherServlet的映射規則，即url-pattern
     * @return
     */
    @Override
    protected String[] getServletMappings() {
        return new String[]{"/"};
    }
    /**
     * 添加過濾器
     * @return
     */
    @Override
    protected Filter[] getServletFilters() {
        CharacterEncodingFilter encodingFilter = new CharacterEncodingFilter();
        encodingFilter.setEncoding("UTF-8");
        encodingFilter.setForceRequestEncoding(true);
        HiddenHttpMethodFilter hiddenHttpMethodFilter = new HiddenHttpMethodFilter();
        return new Filter[]{encodingFilter, hiddenHttpMethodFilter};
    }
}

初始化類裡面要指定 spring的配置類、SpringMVC的配置類，給創建出來即可，記得帶上@Configuration註解，標記為配置類。

其實就是把之前各種配置文件裡的內容轉到配置類裡瞭，這些都會在項目啟動時候初始化。另外，返回的都是數組，所以每個類裡都可以返回多個配置。

二、spring的配置類

當使用ssm整合之後，spring的配置信息寫在spring的配置類中，這裡暫時用不到，寫出來無妨。

package com.pingguo.mvc.config;
import org.springframework.context.annotation.Configuration;
@Configuration
public class SpringConfig {
}

三、WebConfig 配置類

這個配置類是代替之前 springMVC.xml 配置文件裡的內容：

  • 掃描組件
  • 視圖解析器
  • view-controller
  • default-servlet-handler
  • mvc註解驅動
  • 文件上傳解析器
  • 異常處理
  • 攔截器
// 標識當前類為配置類
@Configuration
// 掃描組件
@ComponentScan("com.pingguo.mvc")
// mvc 註解驅動
@EnableWebMvc
public class WebConfig {
    //配置生成模板解析器
    @Bean
    public ITemplateResolver templateResolver() {
        WebApplicationContext webApplicationContext = ContextLoader.getCurrentWebApplicationContext();
        // ServletContextTemplateResolver需要一個ServletContext作為構造參數，可通過WebApplicationContext 的方法獲得
        ServletContextTemplateResolver templateResolver = new ServletContextTemplateResolver(
                webApplicationContext.getServletContext());
        templateResolver.setPrefix("/WEB-INF/templates/");
        templateResolver.setSuffix(".html");
        templateResolver.setCharacterEncoding("UTF-8");
        templateResolver.setTemplateMode(TemplateMode.HTML);
        return templateResolver;
    }
    //生成模板引擎並為模板引擎註入模板解析器
    @Bean
    public SpringTemplateEngine templateEngine(ITemplateResolver templateResolver) {
        SpringTemplateEngine templateEngine = new SpringTemplateEngine();
        templateEngine.setTemplateResolver(templateResolver);
        return templateEngine;
    }
    //生成視圖解析器並未解析器註入模板引擎
    @Bean
    public ViewResolver viewResolver(SpringTemplateEngine templateEngine) {
        ThymeleafViewResolver viewResolver = new ThymeleafViewResolver();
        viewResolver.setCharacterEncoding("UTF-8");
        viewResolver.setTemplateEngine(templateEngine);
        return viewResolver;
    }
}

有瞭這幾樣，就可以寫一個index頁面測試一下瞭，寫出頁面和controller類。

<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head>
    <meta charset="UTF-8">
    <title>index首頁</title>
</head>
<body>
<h1>首頁</h1>
</body>
</html>

控制器：

@Controller
public class TestController {
    @RequestMapping("/")
    public String index() {
        return "index";
    }
}

設置下部署，啟動可以打開首頁。

剩餘配置

接下來，需要 WebConfig 類實現一個接口WebMvcConfigurer，來重寫裡面的方法。

配置 default-servlet-handler

@EnableWebMvc
public class WebConfig implements WebMvcConfigurer {
    //使用默認的servlet處理靜態資源 default-servlet-handler
    public void configureDefaultServletHandling(DefaultServletHandlerConfigurer configurer) {
        configurer.enable();
    }
... ...

配置 攔截器

繼續增加。

... ... 
    //配置攔截器
    public void addInterceptors(InterceptorRegistry registry) {
        TestInterceptor firstInterceptor = new TestInterceptor();
        registry.addInterceptor(firstInterceptor).addPathPatterns("/**");
    }
... ...

攔截器還是要像之前的那樣創建，這裡就創建瞭一個攔截器 TestInterceptor ：

public class TestInterceptor implements HandlerInterceptor {
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
        return true;
    }
    public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
    }
    public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {
    }
}

配置 view-controller

當僅做視圖跳轉時候可以使用這個配置。

//配置視圖控制
    public void addViewControllers(ViewControllerRegistry registry) {
        registry.addViewController("/").setViewName("index");
    }

配置文件上傳解析器

... ...
    //配置文件上傳解析器
    @Bean
    public MultipartResolver multipartResolver(){
        CommonsMultipartResolver commonsMultipartResolver = new CommonsMultipartResolver();
        return commonsMultipartResolver;
    }
... ...

配置異常處理

//配置異常映射
    public void configureHandlerExceptionResolvers(List<HandlerExceptionResolver> resolvers) {
        SimpleMappingExceptionResolver exceptionResolver = new SimpleMappingExceptionResolver();
        Properties prop = new Properties();
        prop.setProperty("java.lang.ArithmeticException", "error");
        //設置異常映射
        exceptionResolver.setExceptionMappings(prop);
        //設置共享異常信息的鍵
        exceptionResolver.setExceptionAttribute("ex");
        resolvers.add(exceptionResolver);
    }

裡面的功能與之前使用配置文件實現的一樣，可以逐一測試一下。

以上就是SpringMVC使用註解配置方式的詳細內容，更多關於SpringMVC註解配置的資料請關註WalkonNet其它相關文章！

推薦閱讀：