最近在公司實習期間的培訓交流中有機會接觸到SSM,然後自己花費1周的時間投入學習。談不上深刻理解其中原理,所以沒有涉及理論知識,只是淺層次的學習如何使用,在此將學習過程記錄整理出來,一方面自己備用;另一方面,分享出來和做技術的各位討論交流。 現階段的我還做不到知行合一,所以決定先學會用,然後再去深究 ...
最近在公司實習期間的培訓交流中有機會接觸到SSM,然後自己花費1周的時間投入學習。談不上深刻理解其中原理,所以沒有涉及理論知識,只是淺層次的學習如何使用,在此將學習過程記錄整理出來,一方面自己備用;另一方面,分享出來和做技術的各位討論交流。
現階段的我還做不到知行合一,所以決定先學會用,然後再去深究原理。若有不足以及錯誤之處,望多多包涵、指教,謝謝。
廢話不多說,直接開乾!
1、開發環境搭建
推薦博客地址:
MyEclipse+Tomcat+MAVEN+SVN項目完整環境搭建
2、Maven Web 項目創建
推薦博客地址:
使用maven創建web項目
3、SSM整合
下麵主要介紹三大框架的整合,至於環境的搭建以及項目的創建,參看上面的推薦博文。
這次整合分了2個配置文件,一個是spring-mybatis.xml,包含spring和mybatis的配置文件;還有一個是spring-mvc的配置文件。
此外有2個資源文件:jdbc.propertis和log4j.properties。
完整目錄結構如下(最後附上源碼下載地址,但不建議直接使用源碼,因為本文已經貼出全部代碼):
使用的框架:
Spring 4.0.2 RELEASE
Spring MVC 4.0.2 RELEASE
MyBatis 3.2.6
4、Maven引入需要的JAR包
這裡直接給出所有需要的JAR包,都是基本的JAR包,每個包是乾什麼的都有註釋,就不再多說了。請看配置文件。
pom.xml
1 <properties> 2 <!-- spring版本號 --> 3 <spring.version>4.0.2.RELEASE</spring.version> 4 <!-- mybatis版本號 --> 5 <mybatis.version>3.2.6</mybatis.version> 6 <!-- log4j日誌文件管理包版本 --> 7 <slf4j.version>1.7.7</slf4j.version> 8 <log4j.version>1.2.17</log4j.version> 9 </properties> 10 11 <dependencies> 12 <dependency> 13 <groupId>junit</groupId> 14 <artifactId>junit</artifactId> 15 <version>4.11</version> 16 <!-- 表示開發的時候引入,發佈的時候不會載入此包 --> 17 <scope>test</scope> 18 </dependency> 19 <!-- spring核心包 --> 20 <dependency> 21 <groupId>org.springframework</groupId> 22 <artifactId>spring-core</artifactId> 23 <version>${spring.version}</version> 24 </dependency> 25 26 <dependency> 27 <groupId>org.springframework</groupId> 28 <artifactId>spring-web</artifactId> 29 <version>${spring.version}</version> 30 </dependency> 31 <dependency> 32 <groupId>org.springframework</groupId> 33 <artifactId>spring-oxm</artifactId> 34 <version>${spring.version}</version> 35 </dependency> 36 <dependency> 37 <groupId>org.springframework</groupId> 38 <artifactId>spring-tx</artifactId> 39 <version>${spring.version}</version> 40 </dependency> 41 42 <dependency> 43 <groupId>org.springframework</groupId> 44 <artifactId>spring-jdbc</artifactId> 45 <version>${spring.version}</version> 46 </dependency> 47 48 <dependency> 49 <groupId>org.springframework</groupId> 50 <artifactId>spring-webmvc</artifactId> 51 <version>${spring.version}</version> 52 </dependency> 53 <dependency> 54 <groupId>org.springframework</groupId> 55 <artifactId>spring-aop</artifactId> 56 <version>${spring.version}</version> 57 </dependency> 58 59 <dependency> 60 <groupId>org.springframework</groupId> 61 <artifactId>spring-context-support</artifactId> 62 <version>${spring.version}</version> 63 </dependency> 64 65 <dependency> 66 <groupId>org.springframework</groupId> 67 <artifactId>spring-test</artifactId> 68 <version>${spring.version}</version> 69 </dependency> 70 <!-- mybatis核心包 --> 71 <dependency> 72 <groupId>org.mybatis</groupId> 73 <artifactId>mybatis</artifactId> 74 <version>${mybatis.version}</version> 75 </dependency> 76 <!-- mybatis/spring包 --> 77 <dependency> 78 <groupId>org.mybatis</groupId> 79 <artifactId>mybatis-spring</artifactId> 80 <version>1.2.2</version> 81 </dependency> 82 <!-- 導入java ee jar 包 --> 83 <dependency> 84 <groupId>javax</groupId> 85 <artifactId>javaee-api</artifactId> 86 <version>7.0</version> 87 </dependency> 88 <!-- 導入Mysql資料庫鏈接jar包 --> 89 <dependency> 90 <groupId>mysql</groupId> 91 <artifactId>mysql-connector-java</artifactId> 92 <version>5.1.30</version> 93 </dependency> 94 <!-- 導入dbcp的jar包,用來在applicationContext.xml中配置資料庫 --> 95 <dependency> 96 <groupId>commons-dbcp</groupId> 97 <artifactId>commons-dbcp</artifactId> 98 <version>1.2.2</version> 99 </dependency> 100 <!-- JSTL標簽類 --> 101 <dependency> 102 <groupId>jstl</groupId> 103 <artifactId>jstl</artifactId> 104 <version>1.2</version> 105 </dependency> 106 <!-- 日誌文件管理包 --> 107 <!-- log start --> 108 <dependency> 109 <groupId>log4j</groupId> 110 <artifactId>log4j</artifactId> 111 <version>${log4j.version}</version> 112 </dependency> 113 114 115 <!-- 格式化對象,方便輸出日誌 --> 116 <dependency> 117 <groupId>com.alibaba</groupId> 118 <artifactId>fastjson</artifactId> 119 <version>1.1.41</version> 120 </dependency> 121 122 123 <dependency> 124 <groupId>org.slf4j</groupId> 125 <artifactId>slf4j-api</artifactId> 126 <version>${slf4j.version}</version> 127 </dependency> 128 129 <dependency> 130 <groupId>org.slf4j</groupId> 131 <artifactId>slf4j-log4j12</artifactId> 132 <version>${slf4j.version}</version> 133 </dependency> 134 <!-- log end --> 135 <!-- 映入JSON --> 136 <dependency> 137 <groupId>org.codehaus.jackson</groupId> 138 <artifactId>jackson-mapper-asl</artifactId> 139 <version>1.9.13</version> 140 </dependency> 141 <!-- 上傳組件包 --> 142 <dependency> 143 <groupId>commons-fileupload</groupId> 144 <artifactId>commons-fileupload</artifactId> 145 <version>1.3.1</version> 146 </dependency> 147 <dependency> 148 <groupId>commons-io</groupId> 149 <artifactId>commons-io</artifactId> 150 <version>2.4</version> 151 </dependency> 152 <dependency> 153 <groupId>commons-codec</groupId> 154 <artifactId>commons-codec</artifactId> 155 <version>1.9</version> 156 </dependency> 157 158 159 </dependencies>
5、Spring與MyBatis整合
首先進行Spring與MyBatis的整合,然後再進行JUnit測試。
5.1 建立JDBC屬性文件
jdbc.properties(文件編碼修改為utf-8)
1 driver=com.mysql.jdbc.Driver 2 url=jdbc:mysql://localhost:3306/mybatis 3 username=dev 4 password=devlop 5 #定義初始連接數 6 initialSize=0 7 #定義最大連接數 8 maxActive=20 9 #定義最大空閑 10 maxIdle=20 11 #定義最小空閑 12 minIdle=1 13 #定義最長等待時間 14 maxWait=60000
需要自行修改的地方:
- url裡面mybatis改為自己的資料庫名
- username和password改為自己mysql資料庫的用戶名和密碼
5.2 建立spring-mybatis.xml配置文件
這個文件就是用來完成spring和mybatis整合的。裡面也沒多少行配置,主要的就是自動掃描,自動註入,配置資料庫。註釋也很詳細,大家看看就明白了。
spring-mybatis.xml
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:p="http://www.springframework.org/schema/p" 4 xmlns:context="http://www.springframework.org/schema/context" 5 xmlns:mvc="http://www.springframework.org/schema/mvc" 6 xsi:schemaLocation="http://www.springframework.org/schema/beans 7 http://www.springframework.org/schema/beans/spring-beans-3.1.xsd 8 http://www.springframework.org/schema/context 9 http://www.springframework.org/schema/context/spring-context-3.1.xsd 10 http://www.springframework.org/schema/mvc 11 http://www.springframework.org/schema/mvc/spring-mvc-4.0.xsd"> 12 <!-- 自動掃描 --> 13 <context:component-scan base-package="com.wlgg" /> 14 <!-- 引入配置文件 --> 15 <bean id="propertyConfigurer" 16 class="org.springframework.beans.factory.config.PropertyPlaceholderConfigurer"> 17 <property name="location" value="classpath:jdbc.properties" /> 18 </bean> 19 20 <bean id="dataSource" class="org.apache.commons.dbcp.BasicDataSource" 21 destroy-method="close"> 22 <property name="driverClassName" value="${driver}" /> 23 <property name="url" value="${url}" /> 24 <property name="username" value="${username}" /> 25 <property name="password" value="${password}" /> 26 <!-- 初始化連接大小 --> 27 <property name="initialSize" value="${initialSize}"></property> 28 <!-- 連接池最大數量 --> 29 <property name="maxActive" value="${maxActive}"></property> 30 <!-- 連接池最大空閑 --> 31 <property name="maxIdle" value="${maxIdle}"></property> 32 <!-- 連接池最小空閑 --> 33 <property name="minIdle" value="${minIdle}"></property> 34 <!-- 獲取連接最大等待時間 --> 35 <property name="maxWait" value="${maxWait}"></property> 36 </bean> 37 38 <!-- spring和MyBatis完美整合,不需要mybatis的配置映射文件 --> 39 <bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean"> 40 <property name="dataSource" ref="dataSource" /> 41 <!-- 自動掃描mapping.xml文件 --> 42 <property name="mapperLocations" value="classpath:com/wlgg/mapping/*.xml"></property> 43 </bean> 44 45 <!-- DAO介面所在包名,Spring會自動查找其下的類 --> 46 <bean class="org.mybatis.spring.mapper.MapperScannerConfigurer"> 47 <property name="basePackage" value="com.wlgg.dao" /> 48 <property name="sqlSessionFactoryBeanName" value="sqlSessionFactory"></property> 49 </bean> 50 51 <!-- (事務管理)transaction manager, use JtaTransactionManager for global tx --> 52 <bean id="transactionManager" 53 class="org.springframework.jdbc.datasource.DataSourceTransactionManager"> 54 <property name="dataSource" ref="dataSource" /> 55 </bean> 56 57 </beans>
5.3 Log4j的配置
為了方便調試,一般都會使用日誌來輸出信息。
Log4j的配置很簡單,而且也是通用的,下麵給出一個基本的配置,換到其他項目中也無需做多大的調整。
log4j.properties
#定義LOG輸出級別 log4j.rootLogger=INFO,Console,File #定義日誌輸出目的地為控制台 log4j.appender.Console=org.apache.log4j.ConsoleAppender log4j.appender.Console.Target=System.out #可以靈活地指定日誌輸出格式,下麵一行是指定具體的格式 log4j.appender.Console.layout = org.apache.log4j.PatternLayout log4j.appender.Console.layout.ConversionPattern=[%c] - %m%n #文件大小到達指定尺寸的時候產生一個新的文件 log4j.appender.File = org.apache.log4j.RollingFileAppender #指定輸出目錄 log4j.appender.File.File = logs/ssm.log #定義文件最大大小 log4j.appender.File.MaxFileSize = 10MB # 輸出所以日誌,如果換成DEBUG表示輸出DEBUG以上級別日誌 log4j.appender.File.Threshold = ALL log4j.appender.File.layout = org.apache.log4j.PatternLayout log4j.appender.File.layout.ConversionPattern =[%p] [%d{yyyy-MM-dd HH\:mm\:ss}][%c]%m%n
5.4 JUnit測試
經過以上步驟,已經完成了Spring和Mybatis的整合,這樣我們就可以編寫一段測試代碼來試試是否成功了。
(1)創建測試用表
此時需要在mysql資料庫中建立一個測試表,建表的SQL語句如下:
1 DROP TABLE IF EXISTS `user_t`; 2 3 CREATE TABLE `user_t` ( 4 `id` int(11) NOT NULL AUTO_INCREMENT, 5 `user_name` varchar(40) NOT NULL, 6 `password` varchar(255) NOT NULL, 7 `age` int(4) NOT NULL, 8 PRIMARY KEY (`id`) 9 ) ENGINE=InnoDB AUTO_INCREMENT=2 DEFAULT CHARSET=utf8; 10 11 /*Data for the table `user_t` */ 12 13 insert into `user_t`(`id`,`user_name`,`password`,`age`) values (1,'測試','123456',23);
(2)利用MyBatis Generator自動創建代碼
推薦博客地址:
使用MyBatis Generator自動創建代碼
使用這種方式可以根據表自動創建實體類、MyBatis映射文件以及DAO介面。
這裡建議將生成的介面名改為IUserDao,而不是直接使用它生成的UserMapper。如果不想麻煩也可以不改。完成後將文件複製到工程中。如下圖:
(3)建立Service介面和實現類
目錄結構:
下麵貼出具體代碼:
IUserService.java
1 package com.wlgg.service; 2 3 import com.wlgg.entity.User; 4 5 public interface IUserService { 6 public User getUserById(int userId); 7 }
UserServiceImpl.java
1 package com.wlgg.service.impl; 2 3 import javax.annotation.Resource; 4 5 import org.springframework.stereotype.Service; 6 7 import com.wlgg.dao.IUserDao; 8 import com.wlgg.entity.User; 9 import com.wlgg.service.IUserService; 10 11 @Service("userService") 12 public class UserServiceImpl implements IUserService { 13 @Resource 14 private IUserDao userDao; 15 public User getUserById(int userId) { 16 // TODO Auto-generated method stub 17 return this.userDao.selectByPrimaryKey(userId); 18 } 19 20 }
(4)建立測試類
測試類在src/test/java中建立。如果測試成功,表示Spring和Mybatis已經整合成功了。使用Log4j輸出信息列印到控制台。
測試代碼如下:
1 import javax.annotation.Resource; 2 3 import org.apache.log4j.Logger; 4 import org.junit.Before; 5 import org.junit.Test; 6 import org.junit.runner.RunWith; 7 import org.springframework.context.ApplicationContext; 8 import org.springframework.context.support.ClassPathXmlApplicationContext; 9 import org.springframework.test.context.ContextConfiguration; 10 import org.springframework.test.context.junit4.SpringJUnit4ClassRunner; 11 12 import com.alibaba.fastjson.JSON; 13 import com.wlgg.entity.User; 14 import com.wlgg.service.IUserService; 15 16 @RunWith(SpringJUnit4ClassRunner.class) //表示繼承了SpringJUnit4ClassRunner類 17 @ContextConfiguration(locations = {"classpath:spring-mybatis.xml"}) 18 19 public class TestMyBatis { 20 private static Logger logger = Logger.getLogger(TestMyBatis.class); 21 // private ApplicationContext ac = null; 22 @Resource 23 private IUserService userService = null; 24 25 // @Before 26 // public void before() { 27 // ac = new ClassPathXmlApplicationContext("applicationContext.xml"); 28 // userService = (IUserService) ac.getBean("userService"); 29 // } 30 31 @Test 32 public void test1() { 33 User user = userService.getUserById(1); 34 // System.out.println(user.getUserName()); 35 // logger.info("值:"+user.getUserName()); 36 logger.info(JSON.toJSONString(user)); 37 } 38 }
測試結果:
至此,完成Spring和Mybatis這兩大框架的整合,下麵繼續進行與SpringMVC的整合。
6、整合SpringMVC
上面已經完成了2大框架的整合,SpringMVC的配置文件單獨放,然後在web.xml中配置整合。
6.1 配置spring-mvc.xml
配置裡面的註釋很詳細,在此就不說了,主要是自動掃描控制器,視圖模式,註解的啟動這三個。直接貼出代碼如下:
spring-mvc.xml
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:p="http://www.springframework.org/schema/p" 4 xmlns:context="http://www.springframework.org/schema/context" 5 xmlns:mvc="http://www.springframework.org/schema/mvc" 6 xsi:schemaLocation="http://www.springframework.org/schema/beans 7 http://www.springframework.org/schema/beans/spring-beans-3.1.xsd 8 http://www.springframework.org/schema/context 9 http://www.springframework.org/schema/context/spring-context-3.1.xsd 10 http://www.springframework.org/schema/mvc 11 http://www.springframework.org/schema/mvc/spring-mvc-4.0.xsd"> 12 <!-- 自動掃描該包,使SpringMVC認為包下用了@controller註解的類是控制器 --> 13 <context:component-scan base-package="com.wlgg.controller" /> 14 <!--避免IE執行AJAX時,返回JSON出現下載文件 --> 15 <bean id="mappingJacksonHttpMessageConverter" 16 class="org.springframework.http.converter.json.MappingJacksonHttpMessageConverter"> 17 <property name="supportedMediaTypes"> 18 <list> 19 <value>text/html;charset=UTF-8</value> 20 </list> 21 </property> 22 </bean> 23 <!-- 啟動SpringMVC的註解功能,完成請求和註解Entity的映射 --> 24 <bean 25 class="org.springframework.web.servlet.mvc.annotation.AnnotationMethodHandlerAdapter"> 26 <property name="messageConverters"> 27 <list> 28 <ref bean="mappingJacksonHttpMessageConverter" /> <!-- JSON轉換器 --> 29 </list> 30 </property> 31 </bean> 32 <!-- 定義跳轉的文件的前尾碼 ,視圖模式配置--> 33 <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver"> 34 <!-- 這裡的配置我的理解是自動給後面action的方法return的字元串加上首碼和尾碼,變成一個 可用的url地址 --> 35 <property name="prefix" value="/WEB-INF/jsp/" /> 36 <property name="suffix" value=".jsp" /> 37 </bean> 38 39 <!-- 配置文件上傳,如果沒有使用文件上傳可以不用配置,當然如果不配,那麼配置文件中也不必引入上傳組件包 --> 40 <bean id="multipartResolver" 41 class="org.springframework.web.multipart.commons.CommonsMultipartResolver"> 42 <!-- 預設編碼 --> 43 <property name="defaultEncoding" value="utf-8" /> 44 <!-- 文件大小最大值 --> 45 <property name="maxUploadSize" value="10485760000" /> 46 <!-- 記憶體中的最大值 --> 47 <property name="maxInMemorySize" value="40960" /> 48 </bean> 49 50 </beans>
6.2 配置web.xml
這裡面對spring-mybatis.xml的引入以及配置spring-mvc的Servlet就是為了完成SSM整合。之前已完成的2個框架整合不需要在此處進行任何配置。配置一樣有詳細註釋,不多解釋了。
web.xml
1 <?xml version="1.0" encoding="UTF-8"?> 2 <web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 3 xmlns="http://java.sun.com/xml/ns/javaee" 4 xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd" 5 version="3.0"> 6 <display-name>SSMTest</display-name> 7 <!-- Spring和mybatis的配置文件 --> 8 <context-param> 9 <param-name>contextConfigLocation</param-name> 10 <param-value>classpath:spring-mybatis.xml</param-value> 11 </context-param> 12 <!-- 編碼過濾器 --> 13 <filter> 14 <filter-name>encodingFilter</filter-name> 15 <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class> 16 <async-supported>true</async-supported> 17 <init-param> 18 <param-name>encoding</param-name> 19 <param-value>UTF-8</param-value> 20 </init-param> 21 </filter> 22 <filter-mapping> 23 <filter-name>encodingFilter</filter-name