🧸安清h：个人主页
🎥个人专栏：【计算机网络】【Mybatis篇】
🚦作者简介：一个有趣爱睡觉的intp，期待和更多人分享自己所学知识的真诚大学生。
目录
🎯项目基本介绍
🚦项目功能
🚦开发顺序
🚦模块的开发
🎯项目的开发环境
🎯搭建项目
🎯用户注册
🚦1.选中数据表
🚦2.创建t_user表
🚦3.创建用户实体类
✨创建BaseEntity
✨创建实体类User
🚦4.注册-持久层
✨规划需要执行的sql语句
✨设计接口和抽象方法
✨编写映射
🚦5.注册-业务层
✨5.1规划异常
🎃5.1.1RuntimeException异常
🎃5.1.2用户名被占用异常
🎃5.1.3数据插入异常
✨ 5.2设计接口和抽象方法
🚦6.注册-控制层
✨6.1创建响应
✨6.2设计请求
✨6.3处理请求
✨6.4控制层优化设计
🚦7.注册-前端页面
🎯项目基本介绍
🚦项目功能
本项目主要实现功能为：登录，注册，热销商品，用户管理（密码，个人信息，头像，收货地址），购物车（展示，增加，删除），订单模块。
🚦开发顺序
注册，登录，用户管理，购物车，商品，订单模块。
🚦模块的开发
- 持久层开发：依据前端页面的设置规划相关的SQL语句，以及进行配置。
- 业务层开发：核心功能的控制，业务的操作以及异常的处理。
- 控制层开发：接受请求，处理响应。
- 前端开发：JS,QUERY,AJAX等技术连接后台
🎯项目的开发环境
1.JDK：1.8及以上版本
2.maven:配置到idea，3.6.1版本
3.数据库：Mysql，要求5.1及以上版本
4.开发的平台：idea开发
🎯搭建项目
1.项目的名称：store，表示商城
2.结构：com.cy.store
3.资源文件：resources文件夹下（static、templates)
4.单元测试：test.com.cy.store
5.
6.点击next后，先选择以下三个jar包。
（1）WEB：Spring Web（用于前后端连接）
（2）SQL：Mybatis Framework
（3）SQL：MySQL Driver（用于mysql数据库驱动）
7.在properties文件中配置数据库的连接源信息
spring.datasource.url=jdbc:mysql://localhost:3306/store?useUnicode=true&characterEncoding=utf-8&serverTimezone=Asia/Shanghai
spring.datasource.username=root
spring.datasource.password=root8.创建一个store数据库
create database store character set utf8;9.测试连接：
- 启动SpringBoot主类，是否有对应的Spring图形输出
在src->main->java->com.cy.store->StoreApplication，启动main方法，得到如下图形即为启动成功：
- 在单元测试类中测试数据库的连接是否可以正常加载
如果出现了以下图片中的Hikari，则代表成功。Hikari是用来管理数据库的连接对象。
10.访问项目的静态资源是否可以正常加载。所有的静态资源复制static目录下。
注意：idea对于JS代码的兼容性较差，编写了js代码但是有时候不能够正常去加载。
- idea缓存清理
- clear-install，双击clean后再次install
- rebuild重新构建
- 重启idea和操作系统
🎯用户注册
🚦1.选中数据表
use store🚦2.创建t_user表
CREATE TABLE t_user (
uid INT AUTO_INCREMENT COMMENT '用户id',
username VARCHAR(20) NOT NULL UNIQUE COMMENT '用户名',
password CHAR(32) NOT NULL COMMENT '密码',
salt CHAR(36) COMMENT '盐值',
phone VARCHAR(20) COMMENT '电话号码',
email VARCHAR(30) COMMENT '电子邮箱',
gender INT COMMENT '性别:0-女，1-男',
avatar VARCHAR(50) COMMENT '头像',
is_delete INT COMMENT '是否删除：0-未删除，1-已删除',
created_user VARCHAR(20) COMMENT '日志-创建人',
created_time DATETIME COMMENT '日志-创建时间',
modified_user VARCHAR(20) COMMENT '日志-最后修改执行人',
modified_time DATETIME COMMENT '日志-最后修改时间',
PRIMARY KEY (uid)
) ENGINE=InnoDB DEFAULT CHARSET=utf8;
- salt盐值：在用户注册时，对其密码进行加密操作，重要
- 性别：用阿拉伯数字0和1来表示性别，原因在于前端不太好用文字来展示一个人的性别，性别是单选框，一半给一个整数好去操作和判断。
- is_delete：大部分厂商都没有实现真正的删除，只是在登录的时候做一个校验，来检测是否为0，如果不为0，就表示已经删除了。
- 四个基础字段，任何一张表都有的，将其作为整个实体类。，
created_user VARCHAR(20) COMMENT ‘创建人’,
created_time DATETIME COMMENT ‘创建时间’,
modified_user VARCHAR(20) COMMENT ‘修改人’,
modified_time DATETIME COMMENT ‘修改时间’,
🚦3.创建用户实体类
✨创建BaseEntity
实体基类，里面存放的为所有表的公共字段。
public class BaseEntity implements Serializable {
private String createdUser;
private Date createdTime;
private String modifiedUser;
private Date modifiedTime;
}
//get和set方法、equals和hashCode()方法、toString方法✨创建实体类User
public class User extends BaseEntity implements Serializable {
private Integer uid;
private String username;
private String password;
private String salt;
private String phone;
private String email;
private Integer gender;
private String avatar;
private Integer isDelete;
//get和set方法、equals和hashCode()方法、toString方法
}🚦4.注册-持久层
通过Mybatis来操作数据库。在做mybatis开发的流程。
✨规划需要执行的sql语句
1.用户的注册功能相当于在做数据的插入操作。
insert into t_user(username,password) values(值列表)2.在用户注册时首先要去查询当前的用户名是否存在，如果存在则不能进行注册。相当于是一条查询语句。
select * from t_user where username=?✨设计接口和抽象方法
1.定义Mapper接口。在项目的目录结构下首先创建一个mapper包，在这个包下再根据不同的功能模块来创建mapper接口。创建一个UserMapper的接口。要在接口中定义这两个SQL语句的抽象方法。
public interface UserMapper {
// 插入用户的数据
// @param user 用户的数据
// @return 受影响的行数（增，删，改，都受影响的行数作为返回值，可以根据返回值来判断是否执行成功）
Integer insert(User user);
// 根据用户名来查询用户的数据
// @param username 用户名
// @return 如果找到对应的用户则返回这个用户的数据，如果没有找到则返回null值
User findByUsername(String username);
}2.在启动类配置mapper接口文件的位置
//MapperScan注解指定当前项目中的Mapper接口路径的位置，在项目启动时会自动加载所有的接口
@MapperScan("com.cy.store.mapper")✨编写映射
1.定义xml映射文件，与对应的接口进行关联。所有的映射文件需要放置在resources目录下，在这个目录下创建一个mapper文件夹，然后在这个文件夹存放Mapper的映射文件。
2.创建接口对应的映射文件，遵循和接口的名称保持一致即可。创建一个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">
<!--namespace属性：用于指定当前的映射文件和哪个接口进行映射，需要指定接口的文件路径，需要标注包的完整路径接口-->
<mapper namespace="com.cy.store.mapper.UserMapper">
</mapper>3.配置接口中的方法对应上SQL语句。需要借助标签来完成，insert/update/delete/select，对应的是SQL语句的增删改查操作。
<?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">
<!--namespace属性：用于指定当前的映射文件和哪个接口进行映射，需要指定接口的文件路径，需要标注包的完整路径接口-->
<mapper namespace="com.cy.store.mapper.UserMapper">
<!-- resultMap标签来完成映射规则的定义-->
<resultMap id="UserEntityMap" type="com.cy.store.entity.User">
<!-- 配合完成名称不一致的映射：
column：表中的字段名称
property：类中的属性名称
-->
<!-- 在定义映射规则时，主键是不可以省略的-->
<id column="uid" property="uid"></id>
<result column="is_delete" property="isDelete"></result>
<result column="created_user" property="createdUser"></result>
<result column="created_time" property="createdTime"></result>
<result column="modified_user" property="modifiedUser"></result>
<result column="modified_time" property="modifiedTime"></result>
</resultMap>
<!-- id属性：表示映射的接口中方法的名称，直接在标签的内部来编写SQL语句-->
<!-- useGeneratedKeys:开启某个字段的值递增（主键设为递增）-->
<!-- keyProperty：将表中那个字段作为主键进行递增-->
<insert id="insert" useGeneratedKeys="true" keyProperty="uid">
insert into t_user(username,password,salt,phone,email,gender,avatar,is_delete,created_user,created_time,modified_user,modified_time)
values (#{username},#{password},#{salt},#{phone},#{email},#{gender},#{avatar},#{isDelete},#{createdUser},#{createdTime},#{modifiedUser},#{modifiedTime}
)
</insert>
<select id="findByUsername" resultMap="UserEntityMap">
select * from t_user where username=#{username}
</select>
</mapper>4.将mapper文件的位置注册到properties对应的配置文件中，在application.properties文件中添加如下代码：
mybatis.mapper-locations=classpath:mapper/*.xml
5.单元测试：每个独立的层编写完毕后需要编写单元测试方法，来测试当前功能。在test包接口下创建一个mapper包，在这个包下创建一个持久层的测试。
//@SpringBootTest标注当前的类是一个测试类，不会随同项目一块打包
@SpringBootTest
public class UserMapperTests {
@Autowired
private UserMapper userMapper;
// 单元测试方法：可以单独独立运行，不用启动整个项目，提高了代码运行效率
// 1.必须被@Test注解修饰
// 2.返回值类型必须是void
// 3.方法的参数类型不指定任何类型
// 4.方法的访问修饰符必须是public
@Test
public void insert(){
User user=new User();
user.setUsername("tim");
user.setPassword("123");
Integer rows=userMapper.insert(user);
System.out.println(rows);
}
@Test
public void findByUsername(){
User user=userMapper.findByUsername("tim");
System.out.println(user);
}
}🚦5.注册-业务层
✨5.1规划异常
🎃5.1.1RuntimeException异常
作为这异常的子类，然后再去定义具体的异常类型来继承这个异常。业务层异常的基类，ServiceException异常。这个异常继承RuntimeException异常。异常机制的建立。
//业务层异常的基类
public class ServiceException extends RuntimeException{
public ServiceException() {
super();
}
public ServiceException(String message) {
super(message);
}
public ServiceException(String message, Throwable cause) {
super(message, cause);
}
public ServiceException(Throwable cause) {
super(cause);
}
protected ServiceException(String message, Throwable cause, boolean enableSuppression, boolean writableStackTrace) {
super(message, cause, enableSuppression, writableStackTrace);
}
}根据业务层不同的功能来详细定义具体的异常的类型，统一的去继承ServiceException异常类。
🎃5.1.2用户名被占用异常
用户在进行注册时可能会产生用户名被占用的错误，抛出一个异常：UsernameDuplicatedException异常。
//用户名被占用的异常
public class UsernameDuplicatedException extends ServiceException{
public UsernameDuplicatedException() {
super();
}
public UsernameDuplicatedException(String message) {
super(message);
}
public UsernameDuplicatedException(String message, Throwable cause) {
super(message, cause);
}
public UsernameDuplicatedException(Throwable cause) {
super(cause);
}
protected UsernameDuplicatedException(String message, Throwable cause, boolean enableSuppression, boolean writableStackTrace) {
super(message, cause, enableSuppression, writableStackTrace);
}
}alt+insert打开快捷方式，选中前五个如图：
🎃5.1.3数据插入异常
正在执行数据插入操作的时候，服务器，数据库宕机。处于正在执行插入的过程中所产生的异常：InsertException异常。
//数据在插入过程中产生的异常
public class InsertException extends ServiceException{
public InsertException() {
super();
}
public InsertException(String message) {
super(message);
}
public InsertException(String message, Throwable cause) {
super(message, cause);
}
public InsertException(Throwable cause) {
super(cause);
}
protected InsertException(String message, Throwable cause, boolean enableSuppression, boolean writableStackTrace) {
super(message, cause, enableSuppression, writableStackTrace);
}
}✨ 5.2设计接口和抽象方法
1.在service包下创建一个IUserService接口。
//用户模块业务层接口
public interface IUserService {
void reg(User user);
}
2.创建一个实现类UserServiceImpl类，需要实现这个接口，并且实现抽象的方法。
//用户模块业务层的实现类
@Service
public class UserServiceImpl implements IUserService {
@Autowired
private UserMapper userMapper;
@Override
public void reg(User user) {
// 通过user参数来获取传递过来的username
String username= user.getUsername();
//调用findByUsername(username)判断用户是否被注册过
User result = userMapper.findByUsername(username);
// 判断结果集是否不为null，则抛出用户名被占用的异常
if(result !=null){
throw new UsernameDuplicatedException("用户名被占用");
}
// 密码加密处理的实现：md5算法的形式
// 串+password+串------md5算法进行加密，连续加载三次
// 盐值+password+盐值------盐值就是一个随机的字符串
String oldPassword = user.getPassword();
// 获取盐值（随机生成一个盐值）
String salt = UUID.randomUUID().toString().toUpperCase();
// 补全数据：盐值的记录
user.setSalt(salt);
// 将密码和盐值作为一个整体进行加密处理，忽略原有密码的强度，提升了数据的安全性
String md5Password = getMD5Password(oldPassword,salt);
// 将加密之后的密码重新补全设置到user对象中
user.setPassword(md5Password);
// 补全数据：is_delete设置成0
user.setIsDelete(0);
// 补全数据：四个日志字段信息
user.setCreatedUser(user.getUsername());
user.setModifiedUser(user.getUsername());
Date date=new Date();
user.setCreatedTime(date);
user.setModifiedTime(date);
// 执行注册业务功能的实现(rows=1)
Integer rows=userMapper.insert(user);
if(rows!=1){
throw new InsertException("在用户注册过程中产生了未知的异常");
}
}
// 定义一个md5算法的加密处理
private String getMD5Password(String password,String salt){
// md5加密算法方法的调用（进行三次加密）
for(int i=0;i<3;i++){
password=DigestUtils.md5DigestAsHex((salt+password+salt).getBytes()).toUpperCase();
}
// 返回加密之后的密码
return password;
}
}
3.在单元测试包下创建一个UserServiceTests类，在这个类中添加单元测试的功能。
//@SpringBootTest标注当前的类是一个测试类，不会随同项目一块打包
@SpringBootTest
public class UserServiceTests {
@Autowired
private IUserService userService;
// 单元测试方法：可以单独独立运行，不用启动整个项目，提高了代码运行效率
// 1.必须被@Test注解修饰
// 2.返回值类型必须是void
// 3.方法的参数类型不指定任何类型
// 4.方法的访问修饰符必须是public
@Test
public void reg(){
try {
User user=new User();
user.setUsername("yuanxin01");
user.setPassword("123");
userService.reg(user);
System.out.println("OK");
} catch (ServiceException e) {
// 获取类的对象，再获取类的名称
System.out.println(e.getClass().getSimpleName());
// 获取异常的具体描述信息
System.out.println(e.getMessage());
}
}
}🚦6.注册-控制层
✨6.1创建响应
状态码、状态描述信息、数据。这部分功能封装一个类中，将这类作为方法返回值，返回给前端浏览器。
//Json格式的数据进行响应
public class JsonResult<E> implements Serializable {
// 状态码
private Integer state;
// 描述信息
private String message;
// 数据
private E data;
public JsonResult(Integer state) {
this.state = state;
}
public JsonResult(Throwable e) {
this.message = e.getMessage();
}
public JsonResult(Integer state, E data) {
this.state = state;
this.data = data;
}
public Integer getState() {
return state;
}
public void setState(Integer state) {
this.state = state;
}
public String getMessage() {
return message;
}
public void setMessage(String message) {
this.message = message;
}
public E getData() {
return data;
}
public void setData(E data) {
this.data = data;
}
}
✨6.2设计请求
依据当前的业务功能模块进行请求设计。
请求路径：/users/reg
请求参数：user user
请求类型：POST
响应结果：JsonResult<void>
✨6.3处理请求
1.创建一个控制层对应的类UserController类。依赖于业务层的接口。
@RestController //@Controller+@RequestBody
@RequestMapping("users")
public class UserController {
@Autowired
private IUserService userService;
@RequestMapping("reg")
// @RequestBody //表示此方法的响应结果以json格式进行数据的响应给到前端
public JsonResult<Void> reg(User user){
JsonResult<Void> result=new JsonResult<>();
try {
userService.reg(user);
result.setState(200);
result.setMessage("用户注册成功");
} catch (UsernameDuplicatedException e) {
result.setState(4000);
result.setMessage("用户名被占用");
}catch (InsertException e) {
result.setState(5000);
result.setMessage("注册时产生未知的异常");
}
return result;
}
}✨6.4控制层优化设计
在控制层抽离一个父类，在这个父类中统一的去处理关于异常的操作。编写一个BaseController类，统一处理异常。
//控制层类的基类
public class BaseController{
// 操作成功的状态码
public static final int OK=200;
// 充当请求处理方法，这个方法的返回值就是需要传递给前端的数据
// 自动将异常对象传递给此方法的参数列表上
// 当项目中产生了异常，会被统一的拦截到此方法中，这个方法此时就充当请求处理方法，方法的返回值直接给到前端
@ExceptionHandler(ServiceException.class) //用于统一处理抛出的异常
public JsonResult<Void> handleException(Throwable e){
JsonResult<Void> result=new JsonResult<>(e);
if(e instanceof UsernameDuplicatedException){
result.setState(4000);
result.setMessage("用户名已经被占用");
}else if(e instanceof InsertException){
result.setState(5000);
result.setMessage("注册时产生未知的异常");
}
return result;
}
}重新构建了reg()方法。
@RestController //@Controller+@RequestBody
@RequestMapping("users")
public class UserController extends BaseController{
@Autowired
private IUserService userService;
@RequestMapping("reg")
public JsonResult<Void> reg(User user){
userService.reg(user);
return new JsonResult<>(OK);
}
}🚦7.注册-前端页面
1.在register页面中编写发送请求的方法，点击事件来完成。选中对应的按钮（$("选择器"))，再去添加点击的事件，$.ajax()函数发送异步请求。
2.JQuery封装了一个函数，称之为$.ajax()函数，通过对象调用ajax，可以异步加载相关的请求。ajax可以把某一部分的局部看做成一个独立的整体。依靠的是javascript提供的一个对象XHR(XmlHttpResponse)，封装了这个对象。
3..ajax()使用方式。需要传递一个方法作为方法的参数使用，一对大括号称之为方法体。ajax接收多个参数，参数与参数之间要使用","分割，每一组参数之间使用“：”进行分割，参数的组成部分一个是参数的名称（不能随意定义），是参数的值，参数的值要求用字符串来表示。参数的声明顺序没有要求。语法结构：
$.ajax({
url:"",
type:"",
data:"",
dataType:"",
success:function(){
},
error:function(){
}
});4.ajax()函数参数的含义：
| 参数 | 功能描述 |
|---|---|
| url | 标识请求的地址（url地址），不能包含参数列表部分的内容。例如：url:"localhost:8080/users/reg" |
| type | 请求类型（GET和POST请求的类型）。例如：type:"POST" |
| data | 向指定的请求url地址提交的数据。例如：data:"username=tom&pwd=123" |
| dataType | 提交的数据类型。数据的类型一般指定为json类型。dataType:"json" |
| success | 当服务器正常响应客户端时，会自动调用success参数方法，并且将服务器返回的数据以参数的形式传递给这个方法的参数上 |
| error | 当服务器未正常响应客户端时，会自动调用error参数的方法，并且将服务器返回的数据以参数的形式传递给这个方法的参数上 |
5.js代码可以独立声明在一个js文件里或者声明在一个script标签中。
<script>
//1.监听注册按钮是否被点击，如果被点击可以执行一个方法
$("#btn-reg").click(function () {
// 2.发送ajax()的异步请求来完成用户的注册功能
$.ajax({
url: "/users/reg",
type: "POST",
data: $("#form-reg").serialize(),
dataType: "JSON",
success: function (json) {
if (json.state == 200) {
alert("注册成功")
} else {
alert("注册失败")
}
},
error: function (xhr) {
alert("注册时产生未知的错误!"+xhr.status);
}
});
});
</script>6.js代码无法正常被服务器解析执行，体现在点击页面中的按钮没有任何响应。解决方案：
- 在项目的maven下clear清理项目-install重新部署
- 在项目的file选项下-cash清理缓存
- 重新的去构建项目：build选项下-rebuild选项
- 重启idea
- 重启电脑
