Spring MVC整合Mybatis 入门

本文涉及的产品
RDS MySQL Serverless 基础系列,0.5-2RCU 50GB
云数据库 RDS MySQL,集群版 2核4GB 100GB
推荐场景:
搭建个人博客
云数据库 RDS MySQL,高可用版 2核4GB 50GB
简介:

本文记录使用Intellij创建Maven Web工程搭建Spring MVC + Mybatis 的一个非常简单的示例。关于Mybatis的入门使用可参考这篇文章,本文在该文的基础上,引入了Spring MVC功能。首先是创建项目:

打开Intellij,File-->new Project--->选中,Maven--->勾上"Create from archetype"--->选择 Maven web project。如下图:

 

 

一步步Next,等待工程Build成功,如果右下角有提示“Maven project need to be imported“则点击: import change...”

完了之后,整个项目Build Success,会生成如下初始目录:

 

 

在src.main下新建一个文件夹 java, 作为源代码目录。CTRL+ALT+SHIFT+S 打开“project structure配置窗口”,将 java 目录关联成 source目录。

 

在 java 目录下创建四个子目录 controller、mapper、pojo、service

controller,控制器类。DispatcherServlet将拦截到的HTTP请求交给对应的Controller来处理,Controller调用 Service 完成相应的请求任务。

service,业务逻辑实现类。Service 一般都需要DAO类(或者说Mapper类)操作数据库,然后完成相应的业务逻辑处理。

mapper,数据库操作类。定义了一些如何操作数据库的方法。

pojo,实体类。对应数据库中的表,一般pojo类中的每个属性对应数据库中的一个字段。

此外,还有配置文件目录。在 src/main/resources目录下,新建mapper文件夹,与 src/main/java/mapper 对应:一个RoleMapper.java 对应着一个 RoleMapper.xml配置文件,再加上相应的Spring配置就可以实现数据库的操作。在 src/main/resources目录下,新建spring文件夹,里面有三个配置文件:spring-web.xml是web相关配置;spring-dao.xml是数据库相关的配置;spring-service.xml是Service类相关的配置。当然也可以将所有的配置放在一个文件里,比如常见的applicationContext.xml,分开配置的话,可能看起来更清晰。大致目录结构如下:

 

POJO类 Role.java代码和数据库表t_role字段,参考这篇文章前面部分。RoleMapper.java 定义了操作数据库的方法--根据 id字段 来查找 Role,getRole方法配合RoleMapper.xml中定义的数据库操作语句,就可以由Mybatis框架来负责所有的数据库操作事宜了。代码如下:

复制代码
package mapper;
import org.springframework.stereotype.Repository;
import pojo.Role;
@Repository
public interface RoleMapper {
    public Role getRole(long id);
}
复制代码

对应的RoleMapper.xml配置如下:

复制代码
<?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="mapper.RoleMapper">
    <select id="getRole" parameterType="long" resultType="Role">
        select id,
        role_name as roleName, note from t_role where id = #{id}
    </select>
</mapper>
复制代码

 

再来看业务逻辑,很简单:用户从浏览器中发一个查询请求 Role,请求的参数为 id,Service根据 id 去数据库找 Role 记录,返回给用户 id 对应的Role。

RoleService.java代码如下:

复制代码
package service;
import pojo.Role;
/**
 * Created by Administrator on 2017/8/10.
 */
public interface RoleService {
    public Role getRole(long id);
}
复制代码

具体的实现类如下:

复制代码
 1 package service.impl;
 2 
 3 import mapper.RoleMapper;
 4 import org.springframework.beans.factory.annotation.Autowired;
 5 import org.springframework.stereotype.Service;
 6 import pojo.Role;
 7 import service.RoleService;
 8 
 9 /**
10  * Created by Administrator on 2017/8/10.
11  */
12 @Service
13 public class RoleServiceImpl implements RoleService {
14 
15     @Autowired
16     private RoleMapper roleMapper;
17 
18     public Role getRole(long id){
19         Role role = roleMapper.getRole(id);
20         return role;
21     }
22 }
复制代码

第12行,@Service 以Spring注解的方式将RoleServiceImpl定义成Bean,在spring-service.xml中配置:component-scan,让Spring去扫描 service包下带有注解的类,告诉Spring容器 RoleService(Impl)类 是一个Bean对象。在其它类中就可以用 @Autowired 将RoleService注入。

    <!-- 扫描service包下所有使用注解的类型 -->
    <context:component-scan base-package="service" />

完整spring-sevice.xml配置文件:

  View Code

 

 

RoleController.java代码如下:

复制代码
 1 package controller;
 2 
 3 import org.springframework.beans.factory.annotation.Autowired;
 4 import org.springframework.stereotype.Controller;
 5 import org.springframework.web.bind.annotation.RequestMapping;
 6 import org.springframework.web.bind.annotation.RequestParam;
 7 import org.springframework.web.bind.annotation.ResponseBody;
 8 import pojo.Role;
 9 import service.RoleService;
10 
11 /**
12  * Created by Administrator on 2017/8/10.
13  */
14 @Controller
15 public class RoleController {
16     @Autowired
17     private RoleService roleService;
18 
19     @RequestMapping("/role/getRole")
20     @ResponseBody public Role getRole(@RequestParam("id") long id)
21     {
22         long start = System.currentTimeMillis();
23         Role role = roleService.getRole(id);
24         long end = System.currentTimeMillis();
25         System.out.println(end-start);
26         return role;
27     }
28 }
复制代码

14行,@Controller 以Spring注解的方式将 RoleController类定义为Spring容器可管理的Bean。

19行,在web.xml中配置了 servlet-mapping,当浏览器请求的URL带有"role/getRole"时,就会拦截请求将给 RoleController来处理。

20行,@ResponseBody定义了 处理之后的返回值,将 Role 对象以 JSON格式封装起来,返回给浏览器。@RequestParam("id"),定义请求参数。

比如在浏览器中输入:http://localhost:8000/mvc/role/getRole?id=5

数据库中记录如下:

 

这一切到底是如何得到的呢?

①RoleController需要一个RoleService对象,然后在第23行调用 getRole方法,返回一个Role对象。首先第16-17行,使用 @Autowired将 RoleService注入到RoleController中,这样RoleController不需要显示地new RoleService对象,对应的创建过程由Spring容器自动完成----对象的创建 与 “对象的使用” 解耦。“对象的使用其实就是业务逻辑,让开发者不需要关注对象的创建了”

②为什么Spring容器知道 将 RoleService 作为一个Bean注入到 RoleController中去呢?

因为,RoleService类使用 了@Service 注解,并且在spring-service.xml中配置 了<component-scan....> 见上面RoleService源代码部分。

③为什么 roleSevice.getRole(id)就能从数据库中查找相应的记录并返回呢?前面的RoleMapper.java 和 RoleMapper.xml配置文件已经定义好了操作数据库的语句:

select id,role_name as roleName, note from t_role where id = #{id}

 

然后我们又在spring-dao.xml中配置了访问数据库:详细具体解释如下:

<context:component-scan base-package="mapper"/>

告诉Spring容器扫描mapper目录下的 带注解的类,这样RoleService就可以自动注入 RoleMapper对象了,有了RoleMapper对象,通过Mybatis框架,就可以访问数据库了。而Spring与Mybatis的整合依赖包,就需要在pom.xml中给出:

复制代码
    <dependency>
      <groupId>org.mybatis</groupId>
      <artifactId>mybatis-spring</artifactId>
      <version>1.3.0</version>
    </dependency>
    <dependency>
      <groupId>org.mybatis</groupId>
      <artifactId>mybatis</artifactId>
      <version>3.4.0</version>
    </dependency>
复制代码

 

 <context:property-placeholder location="classpath:jdbc.properties"/>

配置数据库连接信息:访问哪个数据库?数据库地址在哪?访问数据库的端口是什么?用户名和密码是什么?这些信息都在jdbc.properties文件中定义好了,<context:property-placeholder>告诉Spring容器去哪里读取jdbc.properties配置文件。jdbc.properties文件如下:

jdbc.driver=com.mysql.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/test
jdbc.username=root
jdbc.password=xxxxx

 

知道了数据库在哪里了,以何种方式连接数据库呢?一般会配置各种连接池

复制代码
    <!-- 2.数据库连接池 -->
    <bean id="dataSource" class="com.mchange.v2.c3p0.ComboPooledDataSource">
        <!-- 配置连接池属性 -->
        <property name="driverClass" value="${jdbc.driver}"/>
        <property name="jdbcUrl" value="${jdbc.url}"/>
        <property name="user" value="${jdbc.username}"/>
        <property name="password" value="${jdbc.password}"/>

        <!-- c3p0连接池的私有属性 -->
        <property name="maxPoolSize" value="30"/>
        <property name="minPoolSize" value="10"/>
        <!-- 关闭连接后不自动commit -->
        <property name="autoCommitOnClose" value="false"/>
        <!-- 获取连接超时时间 -->
        <property name="checkoutTimeout" value="10000"/>
        <!-- 当获取连接失败重试次数 -->
        <property name="acquireRetryAttempts" value="2"/>
    </bean>
复制代码

连接池的依赖包,又在哪里呢?因为我们使用的是Maven POM管理依赖,在pom.xml文件中就需要配置:

复制代码
    <dependency>
      <groupId>mysql</groupId>
      <artifactId>mysql-connector-java</artifactId>
      <version>5.1.37</version>
      <scope>runtime</scope>
    </dependency>
    <dependency>
      <groupId>c3p0</groupId>
      <artifactId>c3p0</artifactId>
      <version>0.9.1.2</version>
    </dependency>
复制代码

 

配置好了访问数据库的环境,还需要访问数据库的具体实例,这就是SqlSession。于是继续在spring-dao.xml添加配置:

复制代码
    <!-- 3.配置SqlSessionFactory对象 -->
    <bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
        <!-- 注入数据库连接池 -->
        <property name="dataSource" ref="dataSource"/>
        <!-- 配置MyBaties全局配置文件:mybatisConfig.xml -->
        <property name="configLocation" value="classpath:mybatisConfig.xml"/>
        <!-- 扫描entity包 使用别名 -->
        <property name="typeAliasesPackage" value="pojo"/>
        <!-- 扫描sql配置文件:mapper需要的xml文件 -->
        <property name="mapperLocations" value="classpath:mapper/*.xml"/>
    </bean>
复制代码

 

接下来再把SqlSession 告诉RoleMapper对象,让它拿着SqlSession去操作数据库。

复制代码
    <!-- 4.配置扫描Dao接口包,动态实现Dao接口,注入到spring容器中 -->
    <bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
        <!-- 注入sqlSessionFactory -->
        <property name="sqlSessionFactoryBeanName" value="sqlSessionFactory"/>
        <!-- 给出需要扫描mapper接口包 -->
        <property name="basePackage" value="mapper"/>
    </bean>
复制代码

因此,这也是为什么 我们只需要通过Spring将RoleMapper能够访问数据库的原因。而当 Service需要访问数据库时,只需要将RoleMapper注入进来,就可以执行getRole方法查询数据库了。

完整的spring-dao.xml配置文件:

  View Code

 

前面介绍的都是Spring应用上下文,而这里的 HTTP请求牵涉到 web应用上下文,二者是如何结合的呢?在web.xml中进行配置:

复制代码
 <servlet>
    <servlet-name>mvc</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <!-- 配置springMVC需要加载的配置文件
        spring-dao.xml,spring-service.xml,spring-web.xml
        Mybatis - > spring -> springmvc
     -->
    <init-param>
      <param-name>contextConfigLocation</param-name>
      <param-value>classpath:spring/spring-*.xml</param-value>
    </init-param>
  </servlet>
复制代码

通过contextConfigLocation将 spring上下文中的配置文件加载进来,实现二者的结合。

发起请求--->请求拦截--->返回请求 是如何实现的呢?在web.xml中配置了servlet-mapping,其中的<servlet-name>mvc</servlet-name>这也是请求URL中 有 mvc 前缀的原因。<url-pattern>将匹配的请求交给DispatcherServlet,由DispatcherServlet转发给相应的 Controller,在RoleController.java中使用 @RequestMapping配置了 请求的路径role/getRole,这样 http://localhost:8000/mvc/role/getRole?id=5  就会交给RoleController来处理了。

最后,还需要启动web应用程序,在 pom.xml中配置 jetty 容器,来运行web应用:

复制代码
<!-- jetty插件 -->
      <plugin>
        <groupId>org.mortbay.jetty</groupId>
        <artifactId>maven-jetty-plugin</artifactId>
        <version>6.1.25</version>
        <configuration>
          <connectors>
            <connector implementation="org.mortbay.jetty.nio.SelectChannelConnector">
              <port>8000</port>
              <maxIdleTime>60000</maxIdleTime>
            </connector>
          </connectors>
          <contextPath>/mvc</contextPath>
          <scanIntervalSeconds>0</scanIntervalSeconds>
        </configuration>
      </plugin>
复制代码

 

就可以在IDEA右侧,maven project中点击 jetty run 来运行了。

附完整的:mybatisConfig.xml  

  View Code

spring-web.xml

  View Code

pom.xml配置文件

  View Code

 

RoleService的调试:

在src目录下,新建 test 文件夹,用来作测试目录。然后在test目录下,建一个java目录,并将该目录关联为 “测试目录”。然后,在java目录下,src/main/java 一 一 对应的文件夹,作为mapper、controller、service类的测试类存放的文件夹。

比如,对RoleService进行测试如下:

复制代码
package service;

import org.springframework.context.ApplicationContext;
import org.springframework.context.support.ClassPathXmlApplicationContext;
import pojo.Role;

/**
 * Created by Administrator on 2017/8/12.
 */
public class RoleServiceImplTest {
    public static void main(String[] args) {
        ApplicationContext applicationContext = new ClassPathXmlApplicationContext("classpath:spring/spring-service.xml");
        RoleService roleService = (RoleService) applicationContext.getBean(RoleService.class);
        Role role = roleService.getRole(5);
        System.out.println(role);
    }
}
复制代码

或者使用 TestNg等测试工具进行测试。

 

参考文献:

IntelliJ IDEA 创建 hello world Java web Maven项目从头到尾都有图有真相2017版本

本文转自hapjin博客园博客,原文链接:http://www.cnblogs.com/hapjin/p/7351258.html,如需转载请自行联系原作者

 

相关实践学习
基于CentOS快速搭建LAMP环境
本教程介绍如何搭建LAMP环境,其中LAMP分别代表Linux、Apache、MySQL和PHP。
全面了解阿里云能为你做什么
阿里云在全球各地部署高效节能的绿色数据中心,利用清洁计算为万物互联的新世界提供源源不断的能源动力,目前开服的区域包括中国(华北、华东、华南、香港)、新加坡、美国(美东、美西)、欧洲、中东、澳大利亚、日本。目前阿里云的产品涵盖弹性计算、数据库、存储与CDN、分析与搜索、云通信、网络、管理与监控、应用服务、互联网中间件、移动服务、视频服务等。通过本课程,来了解阿里云能够为你的业务带来哪些帮助 &nbsp; &nbsp; 相关的阿里云产品:云服务器ECS 云服务器 ECS(Elastic Compute Service)是一种弹性可伸缩的计算服务,助您降低 IT 成本,提升运维效率,使您更专注于核心业务创新。产品详情: https://www.aliyun.com/product/ecs
相关文章
|
24天前
|
Java 数据库连接 数据库
大事件后端项目05-----springboot整合mybatis
大事件后端项目05-----springboot整合mybatis
大事件后端项目05-----springboot整合mybatis
|
12天前
|
前端开发 Java 应用服务中间件
我以为我对Spring MVC很了解,直到我遇到了...
所有人都知道Spring MVC是是开发的,却鲜有人知道Spring MVC的理论基础来自于1978 年提出MVC模式的一个老头子,他就是Trygve Mikkjel Heyerdahl Reenskaug,挪威计算机科学家,名誉教授。Trygve Reenskaug的MVC架构思想早期用于图形用户界面(GUI) 的软件设计,他对MVC是这样解释的。MVC 被认为是解决用户控制大型复杂数据集问题的通用解决方案。最困难的部分是为不同的架构组件想出好的名字。模型-视图-编辑器是第一个。
我以为我对Spring MVC很了解,直到我遇到了...
|
14天前
|
监控 安全 Java
Spring Boot最佳实践:从入门到精通
Spring Boot最佳实践:从入门到精通
|
19天前
|
Java 数据库连接 Maven
文本,使用SpringBoot工程创建一个Mybatis-plus项目,Mybatis-plus在编写数据层接口,用extends BaseMapper<User>继承实体类
文本,使用SpringBoot工程创建一个Mybatis-plus项目,Mybatis-plus在编写数据层接口,用extends BaseMapper<User>继承实体类
|
20天前
|
Java 数据库连接 mybatis
SpringBoot配置Mybatis注意事项,mappers层下的name命名空间,要落实到Dao的video类,resultType要落到bean,配置好mybatis的对应依赖。
SpringBoot配置Mybatis注意事项,mappers层下的name命名空间,要落实到Dao的video类,resultType要落到bean,配置好mybatis的对应依赖。
|
22天前
|
前端开发 Java Spring
Spring MVC中使用ModelAndView传递数据
Spring MVC中使用ModelAndView传递数据
|
14天前
|
XML 前端开发 Java
Spring Boot与Spring MVC的区别和联系
Spring Boot与Spring MVC的区别和联系
|
20天前
|
前端开发 Java 数据库连接
Spring6(一):入门案例
Spring6(一):入门案例
11 0
|
21天前
|
监控 安全 Java
Spring Boot最佳实践:从入门到精通
Spring Boot最佳实践:从入门到精通
|
25天前
|
XML Java 数据库连接