从项目出发学习后端接口开发
前言
第1天我们已经搭建了一个项目,并成功获取到了用户信息;那么今天我们一起来学习如何连接数据库,并插入数据的。
继续在第1天的项目基础上做延伸。
一、开发环境
数据库:8.0.18 MySQL Community Server - GPL
数据库管理工具:Navicat12.1.11(x64)
没有安装的小伙伴自行去官网下载,也可以找我拿安装包
软件安装、破解就不废话了,自己去百度
二、数据库配置
1、添加数据库依赖
在 pom.xml 中添加数据库相关依赖,在此使用 mybatis;添加完成点击右上角Load Maven Changes按钮,如图所示;
第一个依赖是 mysql 数据库,不用多说。
第二个依赖是 tk.mybatis,mybatis 包。
第三个依赖是 org.mybatis.spring.boot,主要用来集成 mybatis 和 spring 框架。
2、数据库参数配置
在 application.properties 配置数据库相关信息,数据库安装的配置信息与此不同请注意修改
spring.datasource.url=jdbc:mysql://127.0.0.1:3306/second?useUnicode=true&characterEncoding=utf8
spring.datasource.username=root
spring.datasource.password=123456
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
mybatis.mapper-locations=classpath:mapper/*UserMapper.xml
mybatis.type-aliases-package=com.saxon.entity
spring.datasource.url:数据库服务器地址。
useUnicode:使用的编码格式。
spring.datasource.username:数据库登陆用户名。
spring.datasource.password:数据库登陆密码。
spring.datasource.driver-class-name:数据库连接驱动类。
mybatis.mapper-locations:mybatis 映射扫描路径。
mybatis.type-aliases-package:实体扫描路径。
3、数据库建表
根据我们的数据库配置信息,使用Nacati新建Mysql数据库连接,新建库:second,在该数据库新建表User,用户名 username,类型为 varchar;密码 password,类型为 varchar;手机号 phonenumber,类型为 varchar。
需要注意字段大小不能为空。
三、接口修改
1、entity实体类User不需要修改;但需要新增接口返回实体类 Response 类;
package com.saxon.secondday.entity;
public class Response {
private String msg;
private int code;
public String getMsg() {
return msg;
}
public void setMsg(String msg) {
this.msg = msg;
}
public int getCode() {
return code;
}
public void setCode(int code) {
this.code = code;
}
}
2、新增Service方法 createUser();
package com.saxon.secondday.service;
import com.saxon.secondday.entity.User;
public interface UserService {
User getUserInfo();
void createUser();
}
实现类实现该方法;
package com.saxon.secondday.service.impl;
import com.saxon.secondday.entity.User;
import com.saxon.secondday.service.UserService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
@Service
public class UserServiceImpl implements UserService {
@Override
public User getUserInfo() {
User user=new User();
user.setUserName("Saxon");
user.setPassword("123456");
user.setPhoneNumber("13912345678");
return user;
}
@Autowired
UserMapper userMapper;
@Override
public void createUser() {
User user=new User();
user.setUserName("Saxon");
user.setPassword("123456");
user.setPhoneNumber("13912345678");
userMapper.createUser(user);
}
}
此时会发现报错,不存在UserMapper类,继续看第3步添加mapper;
3、上面实现类中用到的UserMapper需要创建:在项目根路径创建mapper文件夹,定义UserMapper接口;添加完成后回到service实现类导入UserMapper解决报错问题;
package com.saxon.secondday.mapper;
import com.saxon.secondday.entity.User;
import org.apache.ibatis.annotations.Mapper;
import org.springframework.stereotype.Repository;
@Repository
@Mapper
public interface UserMapper {
void createUser(User user);
}
4、关联数据库,写 sql 语句。
在 resources 文件夹下,新建 mapper 文件夹,在此文件夹下新建 UserMapper.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="com.saxon.secondday.mapper.UserMapper">
<resultMap id="BaseResultMap" type="com.saxon.secondday.entity.User">
<result column="userName" jdbcType="VARCHAR" property="userName" />
<result column="password" jdbcType="VARCHAR" property="password" />
<result column="phoneNumber" jdbcType="VARCHAR" property="phoneNumber" />
</resultMap>
<insert id="createUser" parameterType="com.saxon.secondday.entity.User">
INSERT INTO `user` VALUES(#{userName},#{password},#{phoneNumber})
</insert>
</mapper>
5、修改调用服务类UserController,这里我们新增用户采用的GET方式;
package com.saxon.secondday.controller;
import com.saxon.secondday.entity.Response;
import com.saxon.secondday.entity.User;
import com.saxon.secondday.service.UserService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.RestController;
@RestController
public class UserController {
@Autowired
UserService userService;
@RequestMapping(value = "/getUserInfo",method = RequestMethod.GET)
public String getUserInfo(){
User user=userService.getUserInfo();
return user.toString();
}
@RequestMapping(value = "createUser",method = RequestMethod.GET)
public Response createUser(){
userService.createUser();
Response response=new Response();
response.setMsg("添加成功");
response.setCode(1);
return response;
}
}
看一下项目目录结构
结构相比第1天,大体没有变化;
至此,我们的新增用户接口到此结束。
四、激动人心的接口验证
1、老样子运行验证,运行方式不做赘述,直接看结果,在浏览器输入接口地址:http://localhost:8080/createUser,查看今天的收获,你成功了吗?
刷新user表,可以看到我们刚创建的新用户 Saxon
总结
相比较第1天,今天涉及数据库方面的知识;新增mapper,增加内容也不是很多;
容易出错的地方在于数据库字段配置不能写错、注解不能漏掉,就是不能马虎。
你学废了吗?