一、创建篇
-
新建项目,如下图所示。
-
选择Spring Initializr。
-
填写Group、Artifact和Name后点击next,如下图所示。
选择需要的组件:基本组件有web模块中的web和web server、SQL模块中的MySQL、JDBC和Mybatis、额外的组件可以根据需求自行选择,不过需要注意的是springboot版本不要选择太高,此处选择的是1.5.19版本。
5.确定项目名和项目存储路径。
6.点击finish,整个项目架构如下图所示。其中(项目名+Application).class为sprinboot核心类、application.properties为主配置文件。
二、配置篇
1.连接数据库配置(因为我们已经在选择组件中选择了SQL和JDBC)所以不需要手动引入Maven依赖,只需要直接配置就好),(.yml)和(.properties)的配置格式是不一样的,我个人比较喜欢使用yml格式的,因此我将application.properties改为了application.yml。
将properties后缀名改为yml,点击refactor即可完成修改。
具体配置如下,(注:yml配置格式相对教严格,需要注意以下各内容的具体位置)
driver-class-name为数据库连接驱动,username和password为填写自己想要连接的数据库用户名和密码,url中的spring为我本地中的一个数据库,使用utf-8编码格式,不开启ssl验证。
2.在startProject\src\main\java\com.test.demo中,创建MVC模式对应的package,如下
domain包主要用来集中管理相应的实体类,controller为控制层,service和serviceImpl分别为服务层和服务实现层,mapper用来管理的是与mybatis结合后存储的接口类,类似于传统的dao层。
3.在startProject\src\main\resources中,创建mapperXml,存放mapper对应的mapper.xml文件。
4.配置项目端口号和配置定位mybatis的mapperXml路径。其中开放的端口号设置为18099(可自行指定端口,但是不可与其他开放的端口有冲突,不指定时默认为8080端口)。mapper-location指定了扫描mapperXml中的所有以xml为后缀名的文件。
三、测试篇
1.在domain包中创建实体类User.class。属性自定义,与数据库中表对应属性即可。
2.在controller包中创建UserController类。
3.在UserController中编写如下代码。注解@RequestMapping中的value值可以自定义,其为请求该接口的一个url。第一个@RequestMapping为类级别,第二个@RequestMapping为方法级别。如我们需请求该接口,具体如下即可调用该方法:localhost:18099/user/login。
4.在service中创建UserService接口。
输入名字UserService,选择Interface,点击OK即可完成创建。
5.在serviceImpl中创建UserServiceImpl实现类,实现UserService。加入注解@Service并implements UserService。
6.在mapper中创建UserMapper接口,创建方法与第4步一致。并加入注解@Repository。
7.在resource下的mapperXml中创建UserMapper.xml文件。过程如下图所示,因未找到具体的xml创建,所以可以选择圈出的3个红圈中的任意一个,一会直接修改后缀名,并将如下代码复制覆盖文件内容即可。
代码如下(注:namespace中的com.test.demo.mapper.UserMapper需要关联的Mapper的具体路径和名字。此处意思即为:该xml关联的是UserMapper)。
<?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.test.demo.mapper.UserMapper">
</mapper>
8.在UserController中注入UserService。使用注解@Autowired自动注入。
9.调用Service层的getUserById()方法,根据UserId来进行查询,并输出结果。因为我的UserService中还未创建getUserById()方法,所以我们要到UserService中创建该方法,如第10步所示。
我在User实体类中生成了getter和setter方法,并重写了toString方法,以便查看属性值。
10.在UserService中编写接口方法getUserById()。
11.在UserServiceImpl中注入UserMapper并实现该方法。
12.上一步中是返回UserMapper中的getUserById方法返回的结果,因此要在UserMapper中编写该方法。
13.在UserMapper中实现查询,即getUserById。这里涉及的是有关mybatis的相关知识,可参考如下链接:
//www.greatytc.com/p/48141abd6a5a
代码如下:
<resultMap id="userList" type="com.test.demo.domain.User">
<id column="id" property="id" jdbcType="INTEGER"/>
<result column="username" property="username" jdbcType="VARCHAR"/>
<result column="password" property="password" jdbcType="VARCHAR"/>
<result column="note" property="note" jdbcType="VARCHAR"/>
</resultMap>
<select id="getUserById" parameterType="int" resultMap="userList">
SELECT * FROM t_user WHERE id = #{id}
</select>
14.在核心类中(即项目名+application)中,添加扫描mapper包,即mapper的路径。
15.至此,整个配置就配置完了,我们开始启动项目进行测试吧!如下为启动成功的界面。
开始使用postman测试。输入url:localhost18099/user/login。点击send。
可以看到控制台输出的结果,大功告成。