Spring集成MyBatis

本文原創，原文地址為http://www.cnblogs.com/fengzheng/p/5045105.html 

如果覺得Hibernate不夠靈活，可以嘗試用Mybatis。相比於Hibernate，Mybatis則顯得更加輕量、更加靈活，對於我這種不喜歡被束縛的人，使用Mybatis更加順手、舒心一些。

MyBatis是什么

MyBatis 是支持定制化 SQL、存儲過程以及高級映射的優秀的持久層框架。MyBatis 避免了幾乎所有的 JDBC 代碼和手動設置參數以及獲取結果集。MyBatis 可以對配置和原生Map使用簡單的 XML 或注解，將接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java對象)映射成數據庫中的記錄。

項目結構及說明

項目最終結構如下圖：

 

項目結構介紹：

• com.springapp.mvc包為mvc結構，分別為視圖、數據訪問層、模型、服務接口。
• resource中分別放置各種配置文件和屬性定義文件
• webapp/WEB-INF/view中為freemarker的模板文件
• mvc-dispatcher-servlet.xml為默認的mvc配置文件
• web.xml是java web項目配置文件

引用MyBatis的支持

之前創建MVC項目的過程不是本文介紹重點，略過不講。此項目采用maven的方式創建，引用MyBatis非常簡單，只需在pom文件中添加如下內容：

<dependency>
    <groupId>org.mybatis</groupId>
    <artifactId>mybatis</artifactId>
    <version>3.3.0</version>
</dependency>

<dependency>
    <groupId>org.mybatis</groupId>
    <artifactId>mybatis-spring</artifactId>
    <version>1.2.3</version>
</dependency>  

除此之外還要包括mysql驅動器包、freemarker等，完整的pom文件配置如下：

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.springapp</groupId>
    <artifactId>springmvc_mybatis</artifactId>
    <packaging>war</packaging>
    <version>1.0-SNAPSHOT</version>
    <name>springmvc_mybatis</name>

    <properties>
        <spring.version>4.1.6.RELEASE</spring.version>
    </properties>

    <!--Spring mvc -->
    <dependencies>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-core</artifactId>
            <version>${spring.version}</version>
        </dependency>

        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-web</artifactId>
            <version>${spring.version}</version>
        </dependency>

        <dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>servlet-api</artifactId>
            <version>2.5</version>
        </dependency>

        <dependency>
            <groupId>javax.servlet.jsp</groupId>
            <artifactId>jsp-api</artifactId>
            <version>2.1</version>
            <scope>provided</scope>
        </dependency>

        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-webmvc</artifactId>
            <version>${spring.version}</version>
        </dependency>

        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-test</artifactId>
            <version>${spring.version}</version>
            <scope>test</scope>
        </dependency>

        <dependency>
            <groupId>org.freemarker</groupId>
            <artifactId>freemarker</artifactId>
            <version>2.3.23</version>
        </dependency>


        <!--freemarker依賴此包 -->
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-context-support</artifactId>
            <version>${spring.version}</version>
        </dependency>

        <!-- myBatis-->
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>3.3.0</version>
        </dependency>

        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis-spring</artifactId>
            <version>1.2.3</version>
        </dependency>

        <!-- mysql驅動包 -->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>5.1.29</version>
        </dependency>

        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-jdbc</artifactId>
            <version>4.2.3.RELEASE</version>
        </dependency>

        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.11</version>
            <scope>test</scope>
        </dependency>
    </dependencies>

    <build>
        <finalName>springmvc_mybatis</finalName>
        <plugins>
            <plugin>
                <artifactId>maven-compiler-plugin</artifactId>
                <configuration>
                    <source>1.6</source>
                    <target>1.6</target>
                </configuration>
            </plugin>
            <plugin>
                <artifactId>maven-surefire-plugin</artifactId>
                <configuration>
                    <includes>
                        <include>**/*Tests.java</include>
                    </includes>
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>

如果項目采用非maven方式創建，可下載MyBatis的相關的jar包，引用到項目中。包括mybatis和mybatis-spring這兩個jar包，其中mybatis-spring是mybatis對spring的支持。

開始使用MyBatis

創建數據庫test，並添加表tt_user,創建表的sql如下：

DROP TABLE IF EXISTS `tt_user`;
CREATE TABLE `tt_user` (
  `id` int(11) NOT NULL AUTO_INCREMENT,
  `age` int(11) DEFAULT NULL,
  `name` varchar(255) DEFAULT NULL,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB AUTO_INCREMENT=2 DEFAULT CHARSET=utf8;　

在resource/conf中添加jdbc配置文件，設置相關屬性，屬性內容如下：

jdbc_driverClassName=com.mysql.jdbc.Driver
jdbc_url=jdbc:mysql://localhost:3306/test?useUnicode=true&characterEncoding=utf-8
jdbc_username=root
jdbc_password=root

在dao中添加user的數據訪問層接口，內容如下，其中接口定義了getUserById()和getUserCount()兩個方法：

public interface UserDao {
    public User getUserById(int id);

    public int getUserCount();
}

在model中添加user的對象模型類，這里定義的字段名和數據庫字段名相同，方便MyBatis查詢結果和對象實體做映射，不用再定義resultmap：

public class User {

    private int id;

    private int age;

    private String name;

    public int getId() {
        return id;
    }

    public void setId(int id) {
        this.id = id;
    }

    public int getAge() {
        return age;
    }

    public void setAge(int age) {
        this.age = age;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }
}

在service中定義服務接口和接口實現：

接口定義如下：

public interface UserService {
    public User getUserById(int id);

    public int getUserCount();
}

接口實現如下：

public class UserServiceImpl implements UserService {


    @Resource(name = "userDao")
    private UserDao userDao;

    public User getUserById(int id){
        return userDao.getUserById(id);
    }

    public int getUserCount(){
        return userDao.getUserCount();
    }
}

以上這些定義了關於User對象的一系列mvc層次代碼，接下來定義UserMapper文件，此文件是MyBatis中SQL定義文件，需要在此配置文件中定義dao數據訪問接口中需要用到的sql語句，本例比較簡單只有兩個方法，分別是getUserById和getUserCount，命名為UserMapper.xml，並存放在resource/mapper文件夾中，內容如下：

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper
 PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.springapp.mvc.dao.UserDao">
    <select id="getUserById" resultType="com.springapp.mvc.model.User">
        SELECT * FROM tt_user WHERE id = #{id}
    </select>

    <select id="getUserCount" resultType="int">
        SELECT COUNT(*) FROM tt_user
    </select>
</mapper>

其中id為dao數據訪問接口中方法名稱，resultType為返回值類型，參數需要用#{參數名}表示。

配置mybatis-config，指定mapper文件以及給實體設定別名，在resource/conf文件夾中創建mybatis-config.xml，內容如下：

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration
        PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
        "http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
    <!-- 命名空間 設置別名-->
    <typeAliases>
        <typeAlias alias="User" type="com.springapp.mvc.model.User"/>
    </typeAliases>

    <!-- 映射map 指定映射文件-->
    <mappers>
        <mapper resource="mapper/UserMapper.xml"></mapper>
    </mappers>
</configuration>

通過設置mappers，設置數據訪問接口對應的映射文件，通過設置typeAlias，指定實體模型的別名，例如，這里講com.springapp.mvc.model.User設置別名為User，那么在UserMapper.xml中，可以將getUserById的resultType直接指定為User,就不需要加包前綴了。

最后，在mvc-dispatcher-servlet.xml中配置相關的bean、freemarker等配置，內容如下：

<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:context="http://www.springframework.org/schema/context"
       xsi:schemaLocation="http://www.springframework.org/schema/beans
        http://www.springframework.org/schema/beans/spring-beans.xsd
        http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context.xsd">

    <context:component-scan base-package="com.springapp.mvc"/>

    <!-- 導入屬性配置文件 -->
    <context:property-placeholder location="classpath:conf/jdbc.properties" />

    <!--配置數據源-->
    <bean id="dataSource" class="org.springframework.jdbc.datasource.DriverManagerDataSource">
        <property name="driverClassName">
            <value>${jdbc_driverClassName}</value>
        </property>
        <property name="url">
            <value>${jdbc_url}</value>
        </property>
        <property name="username">
            <value>${jdbc_username}</value>
        </property>
        <property name="password">
            <value>${jdbc_password}</value>
        </property>
    </bean>

    <bean id="transactionManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
        <property name="dataSource" ref="dataSource" />
    </bean>

    <bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
        <property name="configLocation" value="classpath:conf/mybatis-config.xml" />
        <property name="dataSource" ref="dataSource" />
    </bean>

    <!-- mapper bean -->
    <bean id="userDao" class="org.mybatis.spring.mapper.MapperFactoryBean">
        <property name="mapperInterface" value="com.springapp.mvc.dao.UserDao" />
        <property name="sqlSessionFactory" ref="sqlSessionFactory" />
    </bean>

    <bean id="userService" class="com.springapp.mvc.service.impl.UserServiceImpl">
        <!--<property name="userDao" ref="userDao"></property>  若啟用此配置 UserServiceImpl類中的userDao必須具有setter和getter-->
    </bean>


    <!-- freemarker的配置 -->
    <bean id="freemarkerConfigurer"
          class="org.springframework.web.servlet.view.freemarker.FreeMarkerConfigurer">
        <property name="templateLoaderPath" value="/WEB-INF/view/" />
        <property name="defaultEncoding" value="utf-8" />
        <property name="freemarkerSettings">
            <props>
                <prop key="template_update_delay">10</prop>
                <prop key="locale">zh_CN</prop>
                <prop key="datetime_format">yyyy-MM-dd HH:mm:ss</prop>
                <prop key="date_format">yyyy-MM-dd</prop>
                <prop key="number_format">#.##</prop>
            </props>
        </property>
    </bean>
    <!-- FreeMarker視圖解析 如返回userinfo。。在這里配置后綴名ftl和視圖解析器。。 -->
    <bean id="viewResolver"
          class="org.springframework.web.servlet.view.freemarker.FreeMarkerViewResolver">
        <property name="viewClass"
                  value="org.springframework.web.servlet.view.freemarker.FreeMarkerView" />
        <property name="suffix" value=".ftl" />
        <property name="contentType" value="text/html;charset=utf-8" />
        <property name="exposeRequestAttributes" value="true" />
        <property name="exposeSessionAttributes" value="true" />
        <property name="exposeSpringMacroHelpers" value="true" />
    </bean>

    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="prefix" value="/WEB-INF/pages/"/>
        <property name="suffix" value=".jsp"/>
    </bean>

</beans>

之后在controller中加入視圖方法，輸出查詢內容：

import com.springapp.mvc.dao.UserDao;
import com.springapp.mvc.model.User;
import com.springapp.mvc.service.UserService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.ui.ModelMap;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;

import javax.annotation.Resource;

@Controller
@RequestMapping("/restful")
public class HelloController {

	@Resource(name = "userService")
	private UserService userService;

	@RequestMapping(value = "/userinfo/{id}",method = RequestMethod.GET)
	public String showUserInfo(@PathVariable int id, ModelMap model){
		User user = userService.getUserById(id);
		if(user!=null) {
			model.addAttribute("name", user.getName());
		}else{
			model.addAttribute("name","查無此用戶");
		}
		return "home";
	}



	@RequestMapping(value = "/home",method = RequestMethod.GET)
	public String showHome(ModelMap model){
		int count = userService.getUserCount();
		model.addAttribute("count",count);
		return "count";
	}
}

通過瀏覽器訪問頁面，即可輸出內容：

　　

demo下載