碼上快樂

相關內容    簡體    繁體

搭建Spring4+Spring MVC web工程的最佳實踐

本文轉載自   查看原文   2017-09-13 10:16   1411 

Spring是個非常非常非常優秀的java框架，主要是用它的IOC容器幫我們依賴注入和管理一些程序中的Bean組件，實現低耦合關聯，最終提高系統可擴展性和可維護性，用它來輔助我們構建web工程將會感覺非常非常非常地愉悅。

Spring旗下的Spring MVC又是后來居上，設計得非常非常非常的優雅，可以用來替代Struts來做界面視圖的控制(Controller)等。

現在我們就來搭建一個利用Spring和Spring MVC結合的web工程最佳實踐的例子。以Spring Framework 4.2.0為例，IDE為Myeclipse。

 

首先，New一個Dynamic Web Project

 

加入spring-context及其依賴的jar包

加入Spring MVC相關jar包

完整的jar包如下

 

現在開始准備配置Spring和Spring MVC的IOC容器，理論上說，可以只需要Spring MVC的IOC容器即可，所有的bean都放到里面讓Spring MVC容器來管理，但是這樣做並不優雅，我們可以讓Spring MVC容器只管理和它本身相關的東西，像數據源、事務管理以及自己程序中需要用到的Bean等可以用Spring的IOC容器來管理。

 

在web.xml中配置以啟動Spring的IOC容器：

 

[html]  view plain  copy
 
  1. <!-- 啟動 Spring 的IOC容器 -->  
  2.   
  3. <context-param>  
  4.   
  5.     <param-name>contextConfigLocation</param-name>  
  6.   
  7.     <param-value>/WEB-INF/beans.xml</param-value>  
  8.   
  9. </context-param>  
  10.   
  11. <listener>  
  12.   
  13.     <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>  
  14.   
  15. </listener>  

 

 

 

 

這段配置的意思是給ServletContext傳入一個名為“contextConfigLocation”的配置信息，然后添加一個Spring為我們提供好的用來啟動Spring容器的監聽器，web應用啟動的時候這個監聽器就會從ServletContext中取名”contextConfigLocation”的配置信息，即Spring配置文件的所在路徑，如果有就會從指定路徑讀取配置文件啟動Spring容器，如果沒有就從默認路徑讀取，這里我們指定為WEB-INF下的beans.xml文件，下面是一個最基本的beans.xml配置文件的例子：

 

[html]  view plain  copy
 
  1. <?xml version="1.0" encoding="UTF-8"?>  
  2.   
  3. <beans xmlns="http://www.springframework.org/schema/beans"  
  4.   
  5.     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  
  6.   
  7.     xmlns:context="http://www.springframework.org/schema/context"  
  8.   
  9.     xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd  
  10.   
  11.         http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-4.2.xsd">  
  12.   
  13.    
  14.   
  15.     <context:component-scan base-package="com.cpwl">  
  16.   
  17.    
  18.   
  19. </context:component-scan>  
  20.   
  21.    
  22.   
  23. </beans>  

 

 

 

 

以上配置指定了需要掃描組件的包，base-package表示需要掃描的包，Spring會掃描它及其所有子包中的組件（加了某些注解的類，如：@Component、@Controller、@Service、@Repository等），然后將其創建實例並放入IOC容器。

 

然后我們再來配置一下啟動Spring MVC容器的必要配置，回到web.xml，將下面的配置粘貼進去：

 

[html]  view plain  copy
 
  1. <!-- 啟動 Spring MVC 的IOC容器 -->  
  2.   
  3. <servlet>  
  4.   
  5.   <servlet-name>springDispatcherServlet</servlet-name>  
  6.   
  7.   <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>  
  8.   
  9.   <init-param>  
  10.   
  11.     <param-name>contextConfigLocation</param-name>  
  12.   
  13.     <param-value>/WEB-INF/spring-mvc.xml</param-value>  
  14.   
  15.   </init-param>  
  16.   
  17.   <load-on-startup>1</load-on-startup>  
  18.   
  19. </servlet>  
  20.   
  21. <servlet-mapping>  
  22.   
  23.   <servlet-name>springDispatcherServlet</servlet-name>  
  24.   
  25.   <url-pattern>/</url-pattern>  
  26.   
  27. </servlet-mapping>  

 

 

 

 

因為Spring MVC主要是用來作為前端控制器，所以它底層自然是Servlet實現的咯，上面配置的意思是配置一個Spring為我們提供好的用來啟動Spring MVC的Servlet，讀取指定路徑的Spring MVC配置文件，並指定它攔截所有請求（Spring MVC會將請求交給指定請求路徑的Controller去處理）。這里我們指定的路徑為WEB-INF目錄下的spring-mvc.xml文件作為Spring MVC的配置文件。

 

來到WEB-INF目錄，新建一個spring-mvc.xml文件，和beans.xml文件一樣的格式。

 

我們主要利用Spring MVC來寫Controller，每個Controller可以映射任意多個路徑，利用注解來標注Controller非常方便和優雅，我們需要用到@Controller注解來指定Controller對象，用@RequestMapping來指定某方法映射某路徑，這時只需要在spring-mvc.xml中加入<mvc:annotation-driven></mvc:annotation-driven>即可。

 

但是攔截所有請求，一些靜態資源外界就不好訪問，這時我們希望讓服務器自身默認的Servlet去幫我們處理靜態資源的響應，只需要再spring-mvc.xml文件里面配個<mvc:default-servlet-handler/>就行，用到了mvc命名空間，自然也就需要導入mvc命名空間了。

 

別急，還需要指定Spring MVC掃描組件的包，在spring-mvc.xml中加入類似這種的配置：<context:component-scanbase-package="com.cpwl"use-default-filters="false"></context:component-scan>

注意，use-default-filters置為false。

 

這時完整的spring-mvc.xml是這個樣子的：

 

[html]  view plain  copy
 
  1. <?xml version="1.0" encoding="UTF-8"?>  
  2.   
  3. <beans xmlns="http://www.springframework.org/schema/beans"  
  4.   
  5.     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  
  6.   
  7.     xmlns:mvc="http://www.springframework.org/schema/mvc"  
  8.   
  9.     xmlns:context="http://www.springframework.org/schema/context"  
  10.   
  11.     xsi:schemaLocation="http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc-4.2.xsd  
  12.   
  13.         http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd  
  14.   
  15.         http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-4.2.xsd">  
  16.   
  17.    
  18.   
  19.     <mvc:default-servlet-handler/>  
  20.   
  21. <mvc:annotation-driven></mvc:annotation-driven>  
  22.   
  23.     <context:component-scan base-package="com.cpwl" use-default-filters="false">  
  24.   
  25. </context:component-scan>  
  26.   
  27.    
  28.   
  29. </beans>  

 

 

 

 

現在，我們可以來寫一個Controller了：

 

 

[java]  view plain  copy
 
  1. package com.cpwl.springtest.controller;  
  2.   
  3.    
  4.   
  5. import org.springframework.stereotype.Controller;  
  6.   
  7. import org.springframework.web.bind.annotation.RequestMapping;  
  8.   
  9. import org.springframework.web.bind.annotation.RequestMethod;  
  10.   
  11. import org.springframework.web.servlet.ModelAndView;  
  12.   
  13.    
  14.   
  15. @Controller  
  16.   
  17. public class TestController {  
  18.   
  19.       
  20.   
  21.     public TestController() {  
  22.   
  23.         System.out.println("TestController constructed......");  
  24.   
  25.     }  
  26.   
  27.       
  28.   
  29.     @RequestMapping(value="/test",method=RequestMethod.GET)  
  30.   
  31.     public ModelAndView testMVC(){  
  32.   
  33.         ModelAndView modelAndView = new ModelAndView("/WEB-INF/views/test.jsp");  
  34.   
  35.         modelAndView.addObject("info", "陳鵬萬里");  
  36.   
  37.         return modelAndView;  
  38.   
  39.     }  
  40.   
  41.    
  42.   
  43. }  

 

 

 

 

該Controller的testMVC方法映射了”/test”的路徑，訪問它的時候它將設置一個信息，然后轉發給/WEB-INF/views/test.jsp來顯示輸出頁面給客戶端。

在WEB-INF目錄下新建一個views目錄，進入該目錄再新建一個test.jsp，如下：

 

[html]  view plain  copy
 
  1. <%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>  
  2.   
  3. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">  
  4.   
  5. <html>  
  6.   
  7.   <head>  
  8.   
  9.     <title>Spring MVC Test</title>  
  10.   
  11.   </head>  
  12.   
  13.   <body>  
  14.   
  15.     Hello ${info} !!!!!  
  16.   
  17.   </body>  
  18.   
  19. </html>  

 

 

 

 

現在web工程的項目結構如下：

 

OK，現在我們將其部署到服務器，啟動服務器后用瀏覽器訪問testMVC()所映射的路徑:

 

哎喲，不錯喲。

 

但是！我們看下控制台輸出的信息：

TestConstructor被創建了兩次，Why？？？

這是因為我們用了兩個容器，一個Spring一個SpringMVC，給它們所指定掃描的包都相同，所以所有組件都會被創建兩次。

怎么解決？兩種方案。

 

方案一：把Spring MVC容器需要掃描的組件單獨放到一個包下，比如：com.cpwl.springtest.controller，然后在component-scan的base-package屬性指定為改包的包名，Spring容器也類似這樣做。但是這樣並不是很好，實際開發中有時很難做到這樣。

 

方案二：component-scan中指定filter，舉個栗子，

 

spring-mvc.xml中的component-scan這樣寫：

 

[html]  view plain  copy
 
  1. <context:component-scan base-package="com.cpwl"  
  2.   
  3.     use-default-filters="false">  
  4.   
  5.     <context:include-filter type="annotation"  
  6.   
  7.         expression="org.springframework.stereotype.Controller" />  
  8.   
  9.     <context:include-filter type="annotation"  
  10.   
  11.         expression="org.springframework.web.bind.annotation.ControllerAdvice" />  
  12.   
  13. </context:component-scan>  

 

 

 

 

beans.xml中的component-scan這樣寫：

 

[html]  view plain  copy
 
  1. <context:component-scan base-package="com.cpwl">  
  2.   
  3.     <context:exclude-filter type="annotation"  
  4.   
  5.         expression="org.springframework.stereotype.Controller" />  
  6.   
  7.     <context:exclude-filter type="annotation"  
  8.   
  9.         expression="org.springframework.web.bind.annotation.ControllerAdvice"/>  
  10.   
  11. </context:component-scan>  

 

 

 

 

意思是讓Spring MVC的容器只掃描和Controller相關的注解，Spring的容器就只不掃描和Controller相關的注解，這樣它們就相安無事，可以一起愉快地為我們服務了。

 

其實還可以改進一些，在spring-mvc.xml中加入如下配置：

 

 

[html]  view plain  copy
 
  1. <bean  
  2.   
  3.     class="org.springframework.web.servlet.view.InternalResourceViewResolver">  
  4.   
  5.     <property name="prefix" value="/WEB-INF/views/"></property>  
  6.   
  7.     <property name="suffix" value=".jsp"></property>  
  8.   
  9. </bean>  

 

 

 

 

配置一個內部資源視圖解析器，假如你在Controller里返回一個視圖，它的路徑就可以簡寫了，省略前綴和后綴，之前我們寫的是：/WEB-INF/views/test.jsp，現在可以簡寫成：test

我們只需要返回一個簡寫的內部資源路徑的字符串就行，這樣，我們也沒必要創建ModelAndView了，直接讓方法的參數給我們提供一個Map，我們向里面寫點數據然后交給視圖去顯示就行了，testMVC方法改寫如下：

 

 

[java]  view plain  copy
 
  1. @RequestMapping(value="/test",method=RequestMethod.GET)  
  2.   
  3. public String testMVC(Map<String,Object> map){  
  4.   
  5.     map.put("info", "陳鵬萬里");  
  6.   
  7.     return "test";  
  8.   
  9. }  


免責聲明！

本站轉載的文章為個人學習借鑒使用，本站對版權不負任何法律責任。如果侵犯了您的隱私權益，請聯系本站郵箱yoyou2525@163.com刪除。



猜您在找 spring mvc工程骨架搭建 spring web mvc環境搭建 spring mvc 使用注解實現excle導出 最佳實踐 spring + spring mvc + mybatis + react + reflux + webpack Web工程例子 Maven工程搭建spring boot+spring mvc+JPA Spring Boot快速搭建Web工程 web框架之Spring-MVC環境搭建 Spring Boot Admin最佳實踐 Maven Spring MVC 實踐 web工程使用spring mvc+shiro進行權限控制
 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM