天天看点

Spring+Velocity+Mybatis整合笔记(step by step)

本文是我对自己学习过程的一个回顾,应该还有不少问题待改进,例如目录的设置、编码习惯和配置文件的处理等,请大家多多指正。

文中用到的开发工具列举如下:

jdk 1.7.0_79

intellij idea ultimate 14

mysql 5.6.25

maven 3

git、sourcetree

第一步新建工程,选择maven工程,如图1所示。注意,“create from archetype”是一些maven的工程模板,在这里我们为了学习要从头开始自己配置。

Spring+Velocity+Mybatis整合笔记(step by step)

图1 新建maven工程

点击next,出现设置工程坐标的页面,如图2所示。groupid 是公司组织的标号;artifactid是项目名称;综合来看,在src/main/java目录下会新建对应的包结构:groupid.artifactid。

Spring+Velocity+Mybatis整合笔记(step by step)

图2 设置工程坐标

点击next,出现设置工程名字的界面,如图3所示。这里跟之前的artifactid一样就可以,设置完后选择finish完成工程构建。我们这个示例项目采用的是单模块项目,我猜这里是设置模块相关的吧,还需继续学习。

Spring+Velocity+Mybatis整合笔记(step by step)

图3 设置工程名字

我们不需要从头开始写.gitignore文件,已经有人为我们准备好了模板文件,只需要在模板文件的基础上稍作修改即可。

首先要给idea安装.gitignore插件,然后在工程名字上右击建立.gitignore文件,通过插件可以根据项目的内容选择需要忽略的文件或者文件夹。在这里我选择了三个类型:java、jetbrains、osx三个模板的组合文件。因为maven编译生成的目录名为target,我又增加了target文件夹的忽略,如图4所示。

Spring+Velocity+Mybatis整合笔记(step by step)

图4 .gitignore文件内容

通过sourcetree,创建本地仓库,将目标路径设置为usersdemo工程的根目录,如图5所示。仓库初始化完成后,我们的项目就在git管理之下了,可以开始下一步了。

Spring+Velocity+Mybatis整合笔记(step by step)

图5 使用sourcetree

三个月后补充:极力推荐大家使用idea自带的git插件,非常棒,可以可视化解决冲突。

首先在pom.xml文件中修改配置,通过properties标签统一管理依赖库的版本,方便后续更新;通过dependencies标签管理所有的库依赖,本次增加的配置代码如下所示:

接下来为项目增加spring mvc框架支持,也就是每个web项目都应该有的web文件夹等等。具体操作如图6和图7所示。其中spring mvc框架的库已经不用下载,使用我们之前在pom中下载好的库即可。

Spring+Velocity+Mybatis整合笔记(step by step)

图6 add framework support

选择相应的web框架和库文件

Spring+Velocity+Mybatis整合笔记(step by step)

图7 add framework support

添加完成后,要对项目的目录结构做一些调整:将web文件夹移动到src/main/目录下,并重命名为webapp,调整后的目录结构如图8所示。

Spring+Velocity+Mybatis整合笔记(step by step)

图8 调整后的目录结构

web.xml的作用是配置dispatcherservlet,在springmvc项目中dispatcherservlet作为前端控制器。服务器给用户的接口名并不是真正的servlet类的名字,只是一个逻辑名称,由dispatcherservlet完成这个逻辑名称到真正的servlet类的映射过程。

在web.xml的代码中,org.springframework.web.servlet.dispatcherservlet的实例名称为usersdemo,这个servlet-name 非常重要,默认情况下,dispatcherservlet在加载时会从一个机遇这个servlet名字的xml文件中加载spring应用上下文,在这里,因为servlet-name是usersdemo,所以dispatcherservlet将会从usersdemo-servlet.xml文件中加载应用上下文。现在项目的目录结构图如图9所示。

Spring+Velocity+Mybatis整合笔记(step by step)

图9 当前项目目录结构

通过servlet-mapping标签指定由usersdemo这个dispatcherservlet实例处理哪些映射,在这里我们设置为“/”,即声明该dispatcherservlet实例会吹所有的请求,包括静态资源的请求。

最后,web.xml的代码列举如下:

dispatcherservlet需要咨询一个或者多个处理器映射器来决定要将请求发送给哪个控制器,我们这里常用的处理器映射器是defaultannotationhandlermapping:即将请求映射给使用@requestmapping注解的控制器和控制器方法。

最新的spring的发展趋势是依靠注解来减少xml配置,因此我们在usersdemo.xml中添加下面一行配置,就可以得到spring mvc提供的注解驱动测试

我们将会给控制器类添加@controller来表明这是一个控制器类,这个类是@component的子类,也就是说可以通过"context:component-scan标签"来查找控制器类并将其自动注册为bean。需要再usersdemo.xml中添加下面一行配置:

经过了上一步的铺垫,控制器的代码比较简单。@controller注解告诉spring这是一个控制器类,要将它注册为bean;@requestmapping注解告诉spring将"/showusers“接口,并且http方法是get的请求由showuser方法处理。

在showuser方法中我们使用servlet直接打印http响应内容,很熟悉的hello系列。

userscontroller的代码列举如下:

配置maven的构建过程

在pom文件中要增加两个配置,第一个是打包格式;第二个是build生成文件的名称。

相关的配置代码为:

配置并运行tomcat

在idea中配置tomcat的步骤有下面几步:

(1)在屏幕右上角,选择”edit configuration“,如图10所示。

Spring+Velocity+Mybatis整合笔记(step by step)

图10 edit configuration

(2)选择建立一个本地的tomcat容器,如图11所示。

Spring+Velocity+Mybatis整合笔记(step by step)

图11 run/debug configuration

(3)配置项目的发布方式为:usersdemo:war exploded,并且将应用程序上下文设置为"/usersdemo",如图12所示。

Spring+Velocity+Mybatis整合笔记(step by step)

图12 配置部署方式和上下文环境

(4)配置tomcat容器的安装地址、启动服务器后是否需要自动启动浏览器、有文件修改或者检查到新的框架时容器如何反应,我们这里选择”update classes and resources“,如图13所示。

(5)启动tomcat容器,url为:http://localhost:8080/usersdemo/showuser。

最后的运行效果如图所示:

Spring+Velocity+Mybatis整合笔记(step by step)

图14 访问效果图

使用sourcetree对刚才修改和增加的代码进行提交,如图15所示,对于commit message要尽量简洁。

Spring+Velocity+Mybatis整合笔记(step by step)

图15 提交commit

velocity的存在是为了辅助前后端分离:后端接口开发人员可以专心于提供数据、前端人员可以使用占位符(模板文件)暂时代替数据。渲染:将占位符替换为真正的变量值,并生成最终的网页页面。

首先在pom.xml中编辑,下载velocity的支持库,包括三个支持:velocity、velocity-tool、spring-context-support。

添加的依赖代码如下:

在usersdemo-servlet.xml文件中配置velocity视图解析器。配置代码如下:

控制器的作用是根据请求调用bll层提供的service实例,当服务接口返回处理结果后,由控制器将模型对象和逻辑视图名称返回。在这里还不涉及模型数据,因此只关注逻辑视图,解析器根据这个逻辑视图名称,再加上在usersdemo-servlet.xml文件中定义的视图解析器设置,找到对应的模板文件进行渲染。

控制器的代码如下:

现在的模板文件非常简单,就是一句话:”hello velocity!!“,现在项目目录结构和模板文件如图16所示(注意路径与usersdemo-servlet.xml中配置的对应关系)。

Spring+Velocity+Mybatis整合笔记(step by step)

图16 模板文件示例

启动tomat服务器,运行结果如图17所示。

Spring+Velocity+Mybatis整合笔记(step by step)

图17 测试velocity解析器

通过sourcetree提交commit。

mybatis 的着力点,则在于pojo 与sql之间的映射关系。然后通过映射配置文件,将sql所需的参数,以及返回的结果字段映射到指定pojo。 相对hibernate“o/r”而言,mybatis是一种“sql mapping”的orm实现。

在pom.xml文件中增加相应的支持库,包括mybatis、mybatis-spring、commons-dbcp2、mysql-connector-java等库。其中commons-dbcp2是用作管理数据库连接池。

增加的配置代码如下:

Spring+Velocity+Mybatis整合笔记(step by step)

图18 users表结构

Spring+Velocity+Mybatis整合笔记(step by step)

图19 users表中的数据

数据源的配置在applicationcontext.xml中完成,具体的配置代码如下:

在数据库中,id字段我们设置为自动增加。user.java的代码如下

要和 spring 一起使用 mybatis,你需要在 spring 应用上下文中定义至少两样东西:一个 sqlsessionfactory 和至少一个数据映射器类。在 mybatis-spring 中,sqlsessionfactorybean 是用于创建 sqlsessionfactory 的。

首先新建一个接口usermapper,完成请求方法(getuser)到sql语句的映射,代码下所示:

接着在applicationcontext.xml文件中增加配置,将usermapper接口加入到spring容器中,配置代码如下所示:

至此,dao和数据库层就已经配置好了。

首先增加userservice接口,代码如下:

然后增加userserviceimpl实现,代码如下:

在applicationcontext.xml中配置userservieimpl的实例bean,由于已经在代码中使用@autiwired注解,因此不需要在配置文件中显式得规定属性以及提供setter函数。配置代码如下:

控制器的逻辑依旧十分简单,就是三个步骤:

修改后的控制器代码如下:

在模板中使用数据就像使用真正的java对象的数据一样,我们修改后的模板代码如下:

这次请求的访问结果如图20所示:

Spring+Velocity+Mybatis整合笔记(step by step)

图2o 结果展示

该url对应的结果如图21所示:

Spring+Velocity+Mybatis整合笔记(step by step)

图21 结果展示

至此,一个spring+mybatis+velocity框架构成的简陋的demo就完成一个查询功能了,通过sourcetree记录里程碑。

我们在这一步还做了一个调整,将applicationcontext.xml调整到src/main/resources文件夹下。对此我的想法是将应用程序配置文件放在resources目录,至于是不是合理,还请各位看官讨论。

如上所示,一个接口从前端后数据库已经打通了,但是,每次都要等前端页面写好了才能开始测试?这样效率太低了,可不可以将前后端的工作分开,让后端人员能够专注于提供接口,并可以及时测试?可以,单元测试。

由于控制器层是非常薄的一层,负责将传入的url请求传到bll层对应的service实例进行处理。我们可以假定控制器层的代码不需要测试,那么只要service层保证自己的接口正确就ok。java中最流行的单元测试框架是junit,这里探讨如何在junit的testcase中自动注入service实例。

首先在pom.xml中添加测试库支持,配置代码如下:

第二,在src/test/java下新建包,与src/main下保持一致,在这里我要测试的类是userserviceimpl,因此新建com.alibaba.yunos.usersdemo.service。

新建测试类userserviceimpltest,该类的代码如下:

@runwith(springjunit4classrunner.class)是为spring 3接入junit 4框架,从spring 3开始提供;

@contextconfiguration("classpath*:/applicationcontext.xml")是加载该类中使用的bean所在的配置文件

根据上文第一到第六步,我们接着给这个demo增加新的接口:adduser、allusers和deleteuser。

具体的步骤如下:

在usermapper中增加接口getallusers,代码如下:

在userservice中增加新的接口getallusers,代码如下:

在userserviceimpl中实现该接口,代码如下:

在usercontroller控制器中增加allusers接口,代码如下:

在/web-inf/templates下增加allusers.vm文件,内容为:

结果如图22所示:

Spring+Velocity+Mybatis整合笔记(step by step)

图22 allusers接口测试结果

发现有乱码如图23所示:

Spring+Velocity+Mybatis整合笔记(step by step)

图23 出现乱码错误

乱码错误是web开发中经常遇到的问题,我的经验是在每个数据传输的节点上都要保持一致,在这里我们用utf-8。看一下数据从前端页面输入到存到后台数据库的流程可以看到,有几个关键点:页面字符、页面到controller、dao层到数据库;最终现在的问题我发现是在页面向controller转换的时候没有强制处理,可能有问题。因此我在contoller里的adduser方法一开始加了一行代码<code>system.out.println(name);</code>,再次运行发现终端输出乱码,因此确定错误位置。

解决错误的方法是:在web.xml里增加过滤器,即当页面向controller映射之前要先经过该字符过滤器处理,过滤器设置的代码如下:

再次运行web服务器测试,访问url:localhost:8080/usersdemo/adduser?name=哈哈&amp;age=18

发现运行结果如图24所示:

Spring+Velocity+Mybatis整合笔记(step by step)

图24 adduser接口运行成功

要通过查询参数给定一个id,然后bll层根据给定的id删除指定用户,这里没有考虑到数据库出错的处理方式。

为了便于验证,将用户的id也取出来,需要做下面两处修改

代码修改完成,启动web服务器,依次访下列的url:

<a href="http://localhost:8080/usersdemo/deleteuser?id=8" target="_blank">http://localhost:8080/usersdemo/deleteuser?id=8</a>

<a href="http://localhost:8080/usersdemo/deleteuser?id=9" target="_blank">http://localhost:8080/usersdemo/deleteuser?id=9</a>

<a href="http://localhost:8080/usersdemo/deleteuser?id=100" target="_blank">http://localhost:8080/usersdemo/deleteuser?id=100</a>

结果截图如图25所示:

Spring+Velocity+Mybatis整合笔记(step by step)

图25 deleteuser接口验证

这里有一个疑问,删除id为100的时候,数据库中明显没有这个数据,但是后台也没报出异常,原因还有待我继续学习,有知道的朋友请留言给我,非常感谢。

写这篇文字的最初目的是帮助自己回顾一遍前几天学习的东西,如果能碰巧帮助后来的同学就更好了。排版还有点乱,代码还很简陋,希望各位朋友指点一二。

<a href="http://my.oschina.net/aaron74/blog/282304" target="_blank">写给java web一年左右工作经验的人</a>

<a href="http://www.atatech.org/articles/37103?rnd=148563666" target="_blank">spring+mybatis+velocity 工程示例</a>

<a href="http://segmentfault.com/a/1190000002870283#articleheader7" target="_blank">spring+mybatis+velocity配置</a>

<a href="http://blog.csdn.net/a123demi/article/details/43156479" target="_blank">spring mvc + mybatis + velocity + maven + mysql整合实例</a>

<a href="http://blog.csdn.net/naruto_ahu/article/details/10490283#0-tsina-1-43170-397232819ff9a47a7b7e80a40613cfe1" target="_blank">velocity介绍及语法</a>

<a href="http://mybatis.github.io/spring/zh/index.html" target="_blank">mybatis教程</a>

<a href="http://blog.csdn.net/firejuly/article/details/8190229" target="_blank">mybatis与hibernate的比较</a>

<a href="http://blog.arganzheng.me/posts/junit-and-spring-integration-ioc-autowire.html" target="_blank">junit与spring的整合——junit的testcase如何自动注入spring容器托管的对象</a>

《spring 实战》