第一章 企業專案開發--maven+springmvc+spring+mybatis+velocity整合
說明:本系列文章主要是對自己在一家大型網際網路公司實習的過程中對所學知識的總結!參與的是實際中使用的上線專案。
一、ssmm簡介
- ssmm是當下企業最常用的開發框架架構
- maven:管理專案jar包,構建專案
- spring:IOC容器,事務管理
- springmvc:mvc框架
- myBatis:持久層框架
- velocity:前端檢視模板(相較於jsp,速度非常快,而且不需要佔據jvm的永久代記憶體)
上述這些框架再加上版本控制工具(git)、自動化部署工具(jenkins),就組成了當下中大型企業最常用的專案開發部署架構;以上各種框架以後我也會依次做筆記去寫的,所以在下邊不會做詳細介紹。還有,在以下的整合過程中會有一些細節方面的內容,我會在後續的本系列部落格中仔細去說。
二、下面介紹怎樣整合ssmm
環境:
- eclipse-jee-indigo-SR2-win32(新出的一些eclipse不支援jdk1.6)
- jdk1.6.45(當下企業最常用的jdk版本)
- spring3.2.6
- mybatis3.1.1
- mybatis-spring1.1.1(mybatis與spring整合的一個工具jar)
- mysql5.1.27
- maven3.0.5
- velocity1.5
2.1、構建maven專案
步驟:
2.1.1、手工建立maven專案(整個過程就是建立一個符合maven格式的目錄結構)
注意:這裡使用手工建立,而不是在eclipse中使用maven外掛去建立,是因為個人感覺eclipse的maven外掛不好用。
首先自己建立一個資料夾ssmm(這個資料夾名稱就是我們的專案名稱),然後在ssmm下建立src資料夾和pom.xml檔案。
其中,pom.xml檔案中的內容如下:
1 <?xml version="1.0" encoding="UTF-8"?> 2 <project xmlns="http://maven.apache.org/POM/4.0.0" 3 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 4 xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd"View Code> 5 6 <modelVersion>4.0.0</modelVersion> 7 8 <groupId>com.xxx</groupId> 9 <artifactId>ssmm</artifactId> 10 <version>1.0-SNAPSHOT</version> 11 12 <name>ssm</name> 13 <packaging>war</packaging> 14 15 </project>
以上內容,會在之後的maven模組中講解。
然後,在src下建立main、test兩個資料夾;在main資料夾下建立java、resources、webapp三個資料夾,在test資料夾下建立java、resources兩個資料夾;之後在webapp下建立META-INF和WEB-INF兩個資料夾,在META-INF資料夾下建立MANIFEST.MF檔案,該檔案內容如下:
Manifest-Version:1.0
在WEB-INF資料夾下建立templates(該資料夾將來用於存放模板檔案)和web.xml檔案,web.xml檔案內容如下:
1 <?xml version="1.0" encoding="utf-8"?> 2 <web-app version="2.5" xmlns="http://java.sun.com/xml/ns/javaee" 3 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 4 xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"> 5 6 </web-app>View Code
當構建好以上目錄結構後,在src/main/java下建立一個TestMaven.java檔案,檔案內容如下:
public class TestMaven { public static void main(String[] args) { System.out.println("hello zhaojigang!!!"); } }
2.1.2、使用命令視窗編譯該專案
在ssmm資料夾下(即pom.xml所在的目錄)使用開啟命令視窗(shift+滑鼠右鍵),使用"mvn compile"編譯該專案(前提:電腦安裝了maven)。編譯成功出現"BUILD SUCCESS"。
2.1.3、引入eclipse
在eclipse中"import"-->"Existing Maven Projects"即可(執行此步之前,需要安裝eclipse的maven外掛)。
引入專案後,在ssmm專案上右擊-->"Properties"-->Text file encoding改為UTF-8
然後對專案進行測試(在webapp目錄下建立index.jsp,然後執行專案,在我這裡,是使用jetty來執行的,然後通過訪問瀏覽器檢視專案是否建立成功)。
2.2、引入spring與springmvc
2.2.1、引入jar包
在這裡為了方便,我直接給出這些框架整合的完整的pom.xml(具體引入的每個包做什麼用,看pom.xml的註釋),之後其他框架的整合就不再討論jar包問題了。
1 <?xml version="1.0" encoding="UTF-8"?> 2 <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 3 xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd"> 4 5 <modelVersion>4.0.0</modelVersion> 6 7 <groupId>com.xxx</groupId> 8 <artifactId>ssmm</artifactId> 9 <version>1.0-SNAPSHOT</version> 10 11 <name>ssmm</name> 12 <packaging>war</packaging> 13 14 <properties> 15 <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> 16 <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding> 17 </properties> 18 19 <!-- 引入實際依賴 --> 20 <dependencies> 21 <!-- json --> 22 <dependency> 23 <groupId>com.alibaba</groupId> 24 <artifactId>fastjson</artifactId> 25 <version>1.1.39</version> 26 </dependency> 27 <!-- servlet --> 28 <dependency> 29 <groupId>javax.servlet</groupId> 30 <artifactId>servlet-api</artifactId> 31 <version>2.5</version> 32 <scope>provided</scope> 33 </dependency> 34 <!-- spring --> 35 <dependency> 36 <groupId>org.springframework</groupId> 37 <artifactId>spring-core</artifactId> 38 <version>3.2.6.RELEASE</version> 39 </dependency> 40 <dependency> 41 <groupId>org.springframework</groupId> 42 <artifactId>spring-beans</artifactId> 43 <version>3.2.6.RELEASE</version> 44 </dependency> 45 <dependency> 46 <groupId>org.springframework</groupId> 47 <artifactId>spring-context</artifactId> 48 <version>3.2.6.RELEASE</version> 49 </dependency> 50 <dependency> 51 <groupId>org.springframework</groupId> 52 <artifactId>spring-web</artifactId> 53 <version>3.2.6.RELEASE</version> 54 </dependency> 55 <dependency> 56 <groupId>org.springframework</groupId> 57 <artifactId>spring-webmvc</artifactId> 58 <version>3.2.6.RELEASE</version> 59 </dependency> 60 <!-- 這個是使用velocity的必備包 --> 61 <dependency> 62 <groupId>org.springframework</groupId> 63 <artifactId>spring-context-support</artifactId> 64 <version>3.2.6.RELEASE</version> 65 <scope>compile</scope> 66 </dependency> 67 <!-- mysql --> 68 <dependency> 69 <groupId>mysql</groupId> 70 <artifactId>mysql-connector-java</artifactId> 71 <version>5.1.27</version> 72 <scope>runtime</scope> 73 </dependency> 74 <!-- 資料來源 --> 75 <dependency> 76 <groupId>org.apache.tomcat</groupId> 77 <artifactId>tomcat-jdbc</artifactId> 78 <version>7.0.47</version> 79 </dependency> 80 <!-- mybatis --> 81 <dependency> 82 <groupId>org.mybatis</groupId> 83 <artifactId>mybatis</artifactId> 84 <version>3.1.1</version> 85 </dependency> 86 <dependency> 87 <groupId>org.mybatis</groupId> 88 <artifactId>mybatis-spring</artifactId> 89 <version>1.1.1</version> 90 </dependency> 91 <!-- velocity --> 92 <dependency> 93 <groupId>org.apache.velocity</groupId> 94 <artifactId>velocity</artifactId> 95 <version>1.5</version> 96 </dependency> 97 <dependency> 98 <groupId>velocity-tools</groupId> 99 <artifactId>velocity-tools-generic</artifactId> 100 <version>1.2</version> 101 </dependency> 102 </dependencies> 103 </project>View Code
2.2.2、配置spring.xml檔案
這裡直接列出spring.xml的完整版,包括讀取屬性檔案、配置資料來源、配置fastjson轉換器、配置mybatis、配置velocity。
1 <?xml version="1.0" encoding="UTF-8"?> 2 <beans xmlns="http://www.springframework.org/schema/beans" 3 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:context="http://www.springframework.org/schema/context" 4 xmlns:mvc="http://www.springframework.org/schema/mvc" 5 xsi:schemaLocation="http://www.springframework.org/schema/beans 6 http://www.springframework.org/schema/beans/spring-beans-3.2.xsd 7 http://www.springframework.org/schema/context 8 http://www.springframework.org/schema/context/spring-context-3.2.xsd 9 http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc-3.2.xsd"> 10 11 <!-- 註解掃描 --> 12 <context:component-scan base-package="com.xxx" /> 13 14 <!-- 引入屬性檔案 --> 15 <context:property-placeholder location="classpath:jdbc.properties"/> 16 17 <!-- 配置fastjson轉換器 --> 18 <mvc:annotation-driven> 19 <mvc:message-converters register-defaults="true"> 20 <bean class="com.alibaba.fastjson.support.spring.FastJsonHttpMessageConverter"></bean> 21 </mvc:message-converters> 22 </mvc:annotation-driven> 23 24 <!-- 引入資料來源 --> 25 <bean id="xxxDataSource" class="org.apache.tomcat.jdbc.pool.DataSource" destroy-method="close"> 26 <property name="driverClassName" value="${jdbc.driverClassName}" /> 27 <property name="url" value="${jdbc.url}" /> 28 <property name="username" value="${jdbc.username}" /> 29 <property name="password" value="${jdbc.password}" /> 30 </bean> 31 32 <!-- 引入mybatis --> 33 <bean id="xxxSqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean"> 34 <property name="dataSource" ref="xxxDataSource" /> 35 </bean> 36 <bean id="xxxMapperScannerConfigurer" class="org.mybatis.spring.mapper.MapperScannerConfigurer"> 37 <property name="basePackage" value="com.xxx.mapper" /> 38 <property name="sqlSessionFactoryBeanName" value="xxxSqlSessionFactory" /> 39 </bean> 40 41 <!-- 配置velocity --> 42 <bean id="velocityConfigurer" class="org.springframework.web.servlet.view.velocity.VelocityConfigurer"> 43 <property name="resourceLoaderPath"> 44 <value>WEB-INF/templates/</value> 45 </property> 46 <property name="velocityProperties"> 47 <props> 48 <prop key="input.encoding">UTF-8</prop> 49 <prop key="output.encoding">UTF-8</prop> 50 </props> 51 </property> 52 </bean> 53 <bean id="viewResolver" class="org.springframework.web.servlet.view.velocity.VelocityViewResolver"> 54 <property name="suffix" value=".vm" /> 55 <property name="contentType" value="text/html;charset=utf-8" /> 56 <property name="dateToolAttribute" value="date"/> 57 <property name="numberToolAttribute" value="number"/> 58 </bean> 59 </beans>View Code
在讀取資料來源的時候,用一個jdbc.properties檔案來存放所有的資訊。
1 jdbc.driverClassName = com.mysql.jdbc.Driver 2 jdbc.url = jdbc:mysql://localhost:3306/blog?zeroDateTimeBehavior=convertToNull&useUnicode=true&characterEncoding=utf-8 3 jdbc.username = root 4 jdbc.password = 123456View Code
注意:上述屬性檔案中有一些細節,之後會講。
2.2.3、配置web.xml檔案
這裡直接給出web.xml的完整版,包括配置DispatcherServlet、CharacterEncodingFilter與歡迎頁面。
注意:不需要配置spring的ContextLoaderListener了。
1 <?xml version="1.0" encoding="utf-8"?> 2 <web-app version="2.5" xmlns="http://java.sun.com/xml/ns/javaee" 3 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 4 xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"> 5 6 <servlet> 7 <servlet-name>dispatcherServlet</servlet-name> 8 <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class> 9 <init-param> 10 <param-name>contextConfigLocation</param-name> 11 <param-value>classpath*:spring*.xml</param-value> 12 </init-param> 13 <load-on-startup>1</load-on-startup> 14 </servlet> 15 <servlet-mapping> 16 <servlet-name>dispatcherServlet</servlet-name> 17 <url-pattern>/</url-pattern> 18 </servlet-mapping> 19 20 <filter> 21 <filter-name>encodingFilter</filter-name> 22 <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class> 23 <init-param> 24 <param-name>encoding</param-name> 25 <param-value>UTF-8</param-value> 26 </init-param> 27 <init-param> 28 <param-name>forceEncoding</param-name> 29 <param-value>true</param-value> 30 </init-param> 31 </filter> 32 <filter-mapping> 33 <filter-name>encodingFilter</filter-name> 34 <url-pattern>/*</url-pattern> 35 </filter-mapping> 36 37 <welcome-file-list> 38 <welcome-file>/index.jsp</welcome-file> 39 </welcome-file-list> 40 </web-app>View Code
2.3、引入mybatis
引入jar在pom.xml中搞定了;配置mybatis在spring.xml中搞定了。
注意:這裡對於mybatis的配置並不完全,因為這裡我只用到了mybatis的註解,並沒有用到xml形式,關於註解與xml的使用場景以及mybatis的一些其他方面的知識,以後再做記錄。
2.4、引入velocity
引入jar在pom.xml中搞定了;配置mybatis在spring.xml中搞定了。具體的配置資訊在以後會做記錄。
2.5、測試
在以上程式搭建完成後