SpringBoot与Mybatis实现SpringMVC Web项目详解

　　一、热身

　　一个现实的场景是：当我们开发一个Web工程时，架构师和开发工程师可能更关心项目技术结构上的设计。而几乎所有结构良好的软件(项目)都使用了分层设计。分层设计是将项目按技术职能分为几个内聚的部分，从而将技术或接口的实现细节隐藏起来。



　　从另一个角度上来看，结构上的分层往往也能促进了技术人员的分工，可以使开发人员更专注于某一层业务与功能的实现，比如前端工程师只关心页面的展示与交互效果(例如专注于HTML，JS等)，而后端工程师只关心数据和业务逻辑的处理(专注于Java，Mysql等)。两者之间通过标准接口(协议)进行沟通。

　　在实现分层的过程中我们会使用一些框架，例如SpringMVC。但利用框架带来了一些使用方面的问题。我们经常要做的工作就是配置各种XML文件，然后还需要搭建配置Tomcat或者Jetty作为容器来运行这个工程。每次构建一个新项目，都要经历这个流程。更为不幸的是有时候前端人员为了能在本地调试或测试程序，也需要先配置这些环境，或者需要后端人员先实现一些服务功能。这就和刚才提到的“良好的分层结构”相冲突。

　　每一种技术和框架都有一定的学习曲线。开发人员需要了解具体细节，才知道如何把项目整合成一个完整的解决方案。事实上，一个整合良好的项目框架不仅仅能实现技术、业务的分离，还应该关注并满足开发人员的“隔离”。

　　为了解决此类问题，便产生了Spring Boot这一全新框架。Spring Boot就是用来简化Spring应用的搭建以及开发过程。该框架致力于实现免XML配置，提供便捷，独立的运行环境，实现“一键运行”满足快速应用开发的需求。

　　与此同时，一个完整的Web应用难免少不了数据库的支持。利用JDBC的API需要编写复杂重复且冗余的代码。而使用O/RM(例如Hibernate)工具需要基于一些假设和规则，例如最普遍的一个假设就是数据库被恰当的规范了。这些规范在现实项目中并非能完美实现。由此，诞生了一种混合型解决方案——Mybatis。Mybatis是一个持久层框架，它从各种数据库访问工具中汲取大量优秀的思想，适用于任何大小和用途的数据库。根据官方文档的描述：MyBatis 是支持定制化 SQL、存储过程以及高级映射的优秀的持久层框架。MyBatis 避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集。MyBatis 可以对配置和原生Map使用简单的 XML 或注解，将接口和 Java 的 POJOs(Plain Old Java Objects，普通的 Java对象)映射成数据库中的记录。

　　最后，再回到技术结构分层上，目前主流倡导的设计模式为MVC，即模型(model)-视图(view)-控制器(controller)。实现该设计模式的框架有很多，例如Struts。而前文提到的SpringMVC是另一个更为优秀，灵活易用的MVC框架。 SpringMVC是一种基于Java的以请求为驱动类型的轻量级Web框架，其目的是将Web层进行解耦，即使用“请求-响应”模型，从工程结构上实现良好的分层，区分职责，简化Web开发。

　　目前，对于如何把这些技术整合起来形成一个完整的解决方案，并没有相关的最佳实践。将Spring Boot和Mybatis两者整合使用的资料和案例较少。因此，本文提供(介绍)一个完整利用SpringBoot和Mybatis来构架Web项目的案例。该案例基于SpringMVC架构提供完整且简洁的实现Demo，便于开发人员根据不同需求和业务进行拓展。

　　补充提示，Spring Boot 推荐采用基于 Java 注解的配置方式，而不是传统的 XML。只需要在主配置 Java 类上添加“@EnableAutoConfiguration”注解就可以启用自动配置。Spring Boot 的自动配置功能是没有侵入性的，只是作为一种基本的默认实现。开发人员可以通过定义其他 bean 来替代自动配置所提供的功能，例如在配置本案例数据源(DataSource)时，可以体会到该用法。

　　二、实践

　　一些说明：

　　项目IDE采用Intellij(主要原因在于Intellij颜值完爆Eclipse，谁叫这是一个看脸的时代)

　　工程依赖管理采用个人比较熟悉的Maven(事实上SpringBoot与Groovy才是天生一对)

　　1.预览：

　　(1)github地址

　　https://github.com/djmpink/springboot-mybatis

　　git : https://github.com/djmpink/springboot-mybatis.git

　　(2)完整项目结构



　　(3)数据库

　　数据库名：test

　　【user.sql】

　　SET FOREIGN_KEY_CHECKS=0;

　　-- ----------------------------

　　-- Table structure for user

　　-- ----------------------------

　　DROP TABLE IF EXISTS `user`;

　　CREATE TABLE `user` (

　　`id` int(11) NOT NULL,

　　`name` varchar(255) DEFAULT NULL,

　　`age` int(11) DEFAULT NULL,

　　`password` varchar(255) DEFAULT NULL,

　　PRIMARY KEY (`id`)

　　) ENGINE=InnoDB DEFAULT CHARSET=latin1;

　　-- ----------------------------

　　-- Records of user

　　-- ----------------------------

　　INSERT INTO `user` VALUES ('1', '7player', '18', '123456');

　　2.Maven配置

　　完整的【pom.xml】配置如下：

　　xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

　　xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">

　　4.0.0

　　cn.7player.framework

　　springboot-mybatis

　　1.0-SNAPSHOT

　　org.springframework.boot

　　spring-boot-starter-parent

　　1.2.5.RELEASE

　　UTF-8

　　1.7

　　org.springframework.boot

　　spring-boot-starter-web

　　org.springframework.boot

　　spring-boot-starter-thymeleaf

　　org.springframework.boot

　　spring-boot-starter-jdbc

　　org.springframework.boot

　　spring-boot-starter-actuator

　　org.mybatis

　　mybatis-spring

　　1.2.2

　　org.mybatis

　　mybatis

　　3.2.8

　　org.apache.tomcat

　　tomcat-jdbc

　　mysql

　　mysql-connector-java

　　com.alibaba

　　fastjson

　　1.1.43

　　com.mangofactory

　　swagger-springmvc

　　0.9.5

　　org.springframework.boot

　　spring-boot-maven-plugin

　　spring-milestone

　　https://repo.spring.io/libs-release

　　spring-milestone

　　https://repo.spring.io/libs-release

　　3.主函数

　　【Application.java】包含main函数，像普通java程序启动即可。

　　此外，该类中还包含和数据库相关的DataSource，SqlSeesion配置内容。

　　注：@MapperScan(“cn.no7player.mapper”) 表示Mybatis的映射路径(package路径)

　　package cn.no7player;

　　import org.apache.ibatis.session.SqlSessionFactory;

　　import org.apache.log4j.Logger;

　　import org.mybatis.spring.SqlSessionFactoryBean;

　　import org.mybatis.spring.annotation.MapperScan;

　　import org.springframework.boot.SpringApplication;

　　import org.springframework.boot.autoconfigure.EnableAutoConfiguration;

　　import org.springframework.boot.autoconfigure.SpringBootApplication;

　　import org.springframework.boot.context.properties.ConfigurationProperties;

　　import org.springframework.context.annotation.Bean;

　　import org.springframework.context.annotation.ComponentScan;

　　import org.springframework.core.io.support.PathMatchingResourcePatternResolver;

　　import org.springframework.jdbc.datasource.DataSourceTransactionManager;

　　import org.springframework.transaction.PlatformTransactionManager;

　　import javax.sql.DataSource;

　　@EnableAutoConfiguration

　　@SpringBootApplication

　　@ComponentScan

　　@MapperScan("cn.no7player.mapper")

　　public class Application {

　　private static Logger logger = Logger.getLogger(Application.class);

　　//DataSource配置

　　@Bean

　　@ConfigurationProperties(prefix="spring.datasource")

　　public DataSource dataSource() {

　　return new org.apache.tomcat.jdbc.pool.DataSource();

　　}

　　//提供SqlSeesion

　　@Bean

　　public SqlSessionFactory sqlSessionFactoryBean() throws Exception {

　　SqlSessionFactoryBean sqlSessionFactoryBean = new SqlSessionFactoryBean();

　　sqlSessionFactoryBean.setDataSource(dataSource());

　　PathMatchingResourcePatternResolver resolver = new PathMatchingResourcePatternResolver();

　　sqlSessionFactoryBean.setMapperLocations(resolver.getResources("classpath:/mybatis/*.xml"));

　　return sqlSessionFactoryBean.getObject();

　　}

　　@Bean

　　public PlatformTransactionManager transactionManager() {

　　return new DataSourceTransactionManager(dataSource());

　　}

　　/**

　　* Main Start

　　*/

　　public static void main(String[] args) {

　　SpringApplication.run(Application.class, args);

　　logger.info("============= SpringBoot Start Success =============");

　　}

　　}

　　4.Controller

　　请求入口Controller部分提供三种接口样例：视图模板，Json，restful风格

　　(1)视图模板

　　返回结果为视图文件路径。视图相关文件默认放置在路径 resource/templates下：

　　package cn.no7player.controller;

　　import org.apache.log4j.Logger;

　　import org.springframework.stereotype.Controller;

　　import org.springframework.ui.Model;

　　import org.springframework.web.bind.annotation.RequestMapping;

　　import org.springframework.web.bind.annotation.RequestParam;

　　@Controller

　　public class HelloController {

　　private Logger logger = Logger.getLogger(HelloController.class);

　　/*

　　* http://localhost:8080/hello?name=cn.7player

　　*/

　　@RequestMapping("/hello")

　　public String greeting(@RequestParam(value="name", required=false, defaultValue="World") String name, Model model) {

　　logger.info("hello");

　　model.addAttribute("name", name);

　　return "hello";

　　}

　　}

　　(2)Json

　　返回Json格式数据，多用于Ajax请求。

　　package cn.no7player.controller;

　　import cn.no7player.model.User;

　　import cn.no7player.service.UserService;

　　import org.apache.log4j.Logger;

　　import org.springframework.beans.factory.annotation.Autowired;

　　import org.springframework.stereotype.Controller;

　　import org.springframework.web.bind.annotation.RequestMapping;

　　import org.springframework.web.bind.annotation.ResponseBody;

　　@Controller

　　public class UserController {

　　private Logger logger = Logger.getLogger(UserController.class);

　　@Autowired

　　private UserService userService;

　　/*

　　* http://localhost:8080/getUserInfo

　　*/

　　@RequestMapping("/getUserInfo")

　　@ResponseBody

　　public User getUserInfo() {

　　User user = userService.getUserInfo();

　　if(user!=null){

　　System.out.println("user.getName():"+user.getName());

　　logger.info("user.getAge():"+user.getAge());

　　}

　　return user;

　　}

　　}

　　(3)restful

　　REST 指的是一组架构约束条件和原则。满足这些约束条件和原则的应用程序或设计就是 RESTful。

　　此外，有一款RESTFUL接口的文档在线自动生成+功能测试功能软件——Swagger UI，具体配置过程可移步《Spring Boot 利用 Swagger 实现restful测试》

　　package cn.no7player.controller;

　　import cn.no7player.model.User;

　　import com.wordnik.swagger.annotations.ApiOperation;

　　import org.springframework.web.bind.annotation.PathVariable;

　　import org.springframework.web.bind.annotation.RequestMapping;

　　import org.springframework.web.bind.annotation.RequestMethod;

　　import org.springframework.web.bind.annotation.RestController;

　　import java.util.ArrayList;

　　import java.util.List;

　　@RestController

　　@RequestMapping(value="/users")

　　public class SwaggerController {

　　/*

　　* http://localhost:8080/swagger/index.html

　　*/

　　@ApiOperation(value="Get all users",notes="requires noting")

　　@RequestMapping(method=RequestMethod.GET)

　　public List getUsers(){

　　List list=new ArrayList();

　　User user=new User();

　　user.setName("hello");

　　list.add(user);

　　User user2=new User();

　　user.setName("world");

　　list.add(user2);

　　return list;

　　}

　　@ApiOperation(value="Get user with id",notes="requires the id of user")

　　@RequestMapping(value="/{name}",method=RequestMethod.GET)

　　public User getUserById(@PathVariable String name){

　　User user=new User();

　　user.setName("hello world");

　　return user;

　　}

　　}

　　5.Mybatis

　　配置相关代码在Application.java中体现。

　　(1)【application.properties】

　　spring.datasource.url=jdbc:mysql://127.0.0.1:3306/test?useUnicode=true&characterEncoding=gbk&zeroDateTimeBehavior=convertToNull

　　spring.datasource.username=root

　　spring.datasource.password=123456

　　spring.datasource.driver-class-name=com.mysql.jdbc.Driver

　　注意，在Application.java代码中，配置DataSource时的注解

　　@ConfigurationProperties(prefix=“spring.datasource”)

　　表示将根据前缀“spring.datasource”从application.properties中匹配相关属性值。

　　(2)【UserMapper.xml】

　　Mybatis的sql映射文件。Mybatis同样支持注解方式，在此不予举例了。

　　select name, age,password from user;

　　(3)接口UserMapper

　　package cn.no7player.mapper;

　　import cn.no7player.model.User;

　　public interface UserMapper {

　　public User findUserInfo();

　　}

　　三、总结

　　(1)运行 Application.java

　　(2)控制台输出：



　　…..(略过无数内容)



　　(3)访问：

　　针对三种控制器的访问分别为：

　　视图：

　　http://localhost:8080/hello?name=7player



　　Json：

　　http://localhost:8080/getUserInfo



　　Restful(使用了swagger)：

　　http://localhost:8080/swagger/index.html



　　四、参阅

　　《Spring Boot – Quick Start》

　　http://projects.spring.io/spring-boot/#quick-start

　　《mybatis》

　　http://mybatis.github.io/mybatis-3/

　　《使用 Spring Boot 快速构建 Spring 框架应用》

　　http://www.ibm.com/developerworks/cn/java/j-lo-spring-boot/

　　《Using @ConfigurationProperties in Spring Boot》

　　http://www.javacodegeeks.com/2014/09/using-configurationproperties-in-spring-boot.html?utm_source=tuicool

　　《Springboot-Mybatis-Mysample》

　　https://github.com/mizukyf/springboot-mybatis-mysample

　　《Serving Web Content with Spring MVC》

　　http://spring.io/guides/gs/serving-web-content/

　　《理解RESTful架构》

　　http://www.ruanyifeng.com/blog/2011/09/restful

　　附录：

　　Spring Boot 推荐的基础 POM 文件

赞 (0)

相关推荐

  • Linux Web服务器配置详解

    Linux Web服务器配置详解 操作方法 01 Apache是Linux下的Web服务器,Apache用的是静态页面,需要加载模块来支持动态页面,会动态实时的调整进程来处理,最合理的使用多核CPU资 ...

  • window 7系统中开机启动项目详解

    一、具体的位置是window 7系统“开始”菜单中的“启动”选项 在电脑硬盘上的位置是：C:/Documents andSettings/Administrator/“开始”菜单/程序/启动; 在系统 ...

  • eclipse建立springMVC 简单项目

    如何通过eclipse建立springMVC的简单项目,现在简单介绍一下. 操作方法 01 新建一个动态web项目,选择 Dynamic Web Project 点击 NEXT  填写项目名称,点NE ...

  • win7 64位系统web项目导出excel问题分析及解决方法汇总

    最近在web项目中做了一个导出Excel功能。在导出的时候报错：检索 COM 类工厂中 CLSID 为 {00024500-0000-0000-C000-000000000046} 的组件时失败。 一 ...

  • 将Eclipse中的Web项目部署到Eclipse的方法[图文]

    记得开始学习Java Web的时候，首先用的是Eclipse开发，但是有一个问题始终没有弄明白，做好的Web项目是如何发布到Tomcat服务器上的呢？最后得到了一个结论，那就是Eclipse这个软件可 ...

  • eclipse中如何发布web项目

    eclipse中如何发布web项目步骤如下: 1.打开工具,选择javaEE,点击'File--New' 2.选择Dynamic web Project,输入工程名:javaweb,选择web服务器, ...

  • ZendStudio 13.5怎么运行web项目?

    今天我们就来看看Zend Studio 13.5中运行web项目的两种方法,都很简单,喜欢的朋友可以进来参考一下. 首先新建一个或者使用之前创建的web项目 (我这里就使用之前创建的了) 方法一: 1 ...

  • Eclipse如何导入web项目 Eclipse导入web项目详细攻略教程

    Eclipse 是一个开放源代码的.基于Java的可扩展开发平台.就其本身而言,它只是一个框架和一组服务,用于通过插件组件构建开发环境.幸运的是,Eclipse 附带了一个标准的插件集,包括Java开 ...

  • myeclipse2014导入web项目后页面中文显示乱码怎么办?

    经常出现在别的电脑没有问题的项目导入自己电脑有报错,这通常是由于环境默认编码不同而产生的错误,只要修改该项目编码即可解决问题. 1.导入web项目后出现错误提示,打开一看是中文乱码 2.对项目右键,点 ...