本教程需要安装以下工具,如果不清楚怎么安装的可以看下我的这篇文章
链接: https://blog.csdn.net/qq_30627241/article/details/134804675
管理工具: maven
IDE: IDEA
数据库: MySQL
测试工具: Postman
打开IDEA
创建项目,创建项目时保持网络通畅
设置项目的基本信息,其中注意jdk版本要与Java版本匹配,这里使用jdk1.8和java8
选择SpringBoot版本,选择项目依赖(依赖可以创建完项目后在pom文件中修改)
至此项目创建完成
创建数据库
创建用户表
CREATE TABLE user
(uid int(10) primary key NOT NULL AUTO_INCREMENT,uname varchar(30) NOT NULL,password varchar(255) NOT NULL,UNIQUE (uname)
);
uid: 用户编号,主键,自增
uname: 用户名,作为登录的账号(业务主键),不可重复
password: 密码,因为可能要加密,所以长度设了较长的255
配置数据库
1、找到配置文件application.properties
# 配置端口号为8081
server.port=8081# 配置数据库
# 配置驱动
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
# 若连接的是云数据库则将localhost改为云端ip
spring.datasource.url=jdbc:mysql://localhost:3306/summer?serverTimezone=UTC
# Mysql用户
spring.datasource.username=root
# Mysql对应用户密码
spring.datasource.password=123456
2、输入数据库相关配置信息(此处配置了项目端口号为8081,可不配置,默认端口号为8080)
注意:配置url处summer改为你的数据库名称
现在运行项目就能成功了
3、在IDEA中连接数据库,非必要步骤,连了开发方便些
配置如下
配置时区与配置文件中的一致:
点击Test connection测试一下,如遇提示请下载:
下载后再点击,成功如下:
现在可以在IDEA中管理数据库了:
在说项目的目录结构之前,我们先来聊一聊后端的架构大概是什么样的,方便我们对目录结构的理解:
数据持久层的作用是在java对象与数据库之间建立映射,也就是说它的作用是将某一个Java类对应到数据库中的一张表。在我们的项目中,就将创建一个实体类User映射到数据库的user表,表中的每个字段对应于实体类的每个属性。而之前配置的JPA的作用就是帮助我们完成类到数据表的映射。
repository: 存放一些数据访问类(也就是一些能操纵数据库的类)的包,比如存放能对user表进行增删改查的类
domain:存放实体类的包,比如User类,其作为对应数据库user表的一个实体类
业务逻辑层的作用是处理业务逻辑。比如在本项目中,我们就在业务逻辑层实现登录注册的逻辑,像是判断是否有用户名重复,密码是否正确等逻辑
service: 存放业务逻辑接口的包
serviceImpl: 存放业务逻辑实现类的包,其中的类实现service中的接口
控制层的作用是接收视图层的请求并调用业务逻辑层的方法。比如视图层请求登录并发来了用户的账号和密码,那么控制层就调用业务逻辑层的登录方法,并将账号密码作为参数传入,在将结果返回给视图层。
controller: 存放控制器的包。比如UserController
视图层的作用是展现数据,由于本项目写的是纯后端,就不展开解释视图层了。
注意:根据架构我们可以发现,最佳的开发方式是自底向上开发,因为包之间的调用是上层调用下层,所以下层先实现能保证实现多少测试多少
需要创建domain、repository、service、serviceImpl、controller、utils、config目录,如图所示:
这里再说下utils和config
utils: 存放工具类,一些自己封装的工具
config: 存放配置类,一些配置如登录拦截器,安全配置等
根据框架特点,我们将自底向上开发,所以将按照 实体类-dao-service-serviceImpl-controller 的顺序逐步开发。
所有类或接口的目录位置,如图所示,根据图来创建,蓝色C图标是java类文件,绿色I图标是java接口文件:
实现User实体类
1、在domain中创建User.java
2、创建对应user表中字段的属性
其中注意要添加@Table(name = “user”)和@Entity注解
@Table(name = “user”) 说明此实体类对应于数据库的user表
@Entity 说明此类是个实体类
主键uid上要加上@Id与@GeneratedValue(strategy = GenerationType.IDENTITY)注解
3、为属性生成get,set方法
将光标移至要插入get, set方法的位置
右键-generate-getter and setter
选中所有属性-OK
最后得到User.java,也可以复制,至此User实体类就创建好啦,如果要实现其他表的实体类也类似。
package summer.summerdemo.domain;import javax.persistence.*;@Table(name = "user")
@Entity
public class User {@Id@GeneratedValue(strategy = GenerationType.IDENTITY)private long uid;private String uname;private String password;public long getUid() {return uid;}public void setUid(long uid) {this.uid = uid;}public String getUname() {return uname;}public void setUname(String uname) {this.uname = uname;}public String getPassword() {return password;}public void setPassword(String password) {this.password = password;}
}
实现UserDao
1、在repository包中创建UserDao接口
2、首先要添加注解@Repository
接口要继承JpaRepository,这样JPA就能帮助我们完成对数据库的映射,也就是说接口里写的方法只要符合格式可以不需要实现SQL语句就能直接用了。
如果JPA没有提供你想要的方法,可以自定义SQL语句
由于我们只实现登录注册功能,所以只要有根据账号密码查询用户和插入用户信息的方法就行了,这里我们已经实现了根据用户名密码查找用户的方法,而插入用户信息的方法save(object o)JPA已经帮我们实现了,可以直接调用,这里就不需要写了。
注意: 这里接口方法的命名要按照JPA提供的命名格式,比如findBy, deleteBy等等,且要求驼峰命名法。如果自定义查询方法可以不遵守这个规则
package summer.summerdemo.repository;import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.stereotype.Repository;
import summer.summerdemo.domain.User;@Repository
public interface UserDao extends JpaRepository<User, Long> {User findByUname(String uname);User findByUnameAndPassword(String uname, String password);
}
实现UserService
1、在service包中创建UserService接口
2、添加登录注册需要用到的业务逻辑方法
package summer.summerdemo.service;import summer.summerdemo.domain.User;public interface UserService {/*** 登录业务逻辑* @param uname* @param password* @return*/User loginService(String uname, String password);/*** 注册业务逻辑* @param user* @return*/User registerService(User user);
}
实现UserServiceImpl
1、在serviceImpl包中创建UserServiceImpl类
2、添加需要实现的方法
添加implements UserService
此时会报错,但没关系,只是因为方法还没实现。
鼠标悬停在红色波浪线有一个红色灯泡的图标出现,点击它,自动生成需要实现的方法(也可复制后面贴出来的代码)
全选:
生成后如下:
3、实现登录业务逻辑
因为要用到UserDao中的方法,所以先通过@Resource注解帮助我们实例化UserDao对象
4、实现注册业务逻辑
5、添加@Service注解
package summer.summerdemo.service.serviceImpl;import summer.summerdemo.domain.User;
import summer.summerdemo.repository.UserDao;
import summer.summerdemo.service.UserService;
import org.springframework.stereotype.Service;import javax.annotation.Resource;@Service
public class UserServiceImpl implements UserService {@Resourceprivate UserDao userDao;@Overridepublic User loginService(String uname, String password) {User user = userDao.findByUnameAndPassword(uname, password);if(user != null){user.setPassword("");}return user;}@Overridepublic User registerService(User user) {if(userDao.findByUname(user.getUname())!=null){return null;}else{User newUser = userDao.save(user);if(newUser != null){newUser.setPassword("");}return null;}}
}
实现工具类Result
工具类Result的作用是作为返回给前端的统一后的对象。也就是说返回给前端的都是Result对象,只是对象中的属性不太一样,这样方便前端固定接收格式。
package summer.summerdemo.utils;public class Result<T> {private String code;private String msg;private T data;public String getCode() {return code;}public void setCode(String code) {this.code = code;}public String getMsg() {return msg;}public void setMsg(String msg) {this.msg = msg;}public T getData() {return data;}public void setData(T data) {this.data = data;}public Result(){}public Result(T data){this.data = data;}public static Result success(){Result result = new Result<>();result.setCode("0");result.setMsg("成功");return result;}public static <T> Result<T> success(T data){Result<T> result = new Result<>(data);result.setCode("0");result.setMsg("成功");return result;}public static <T> Result<T> success(T data, String msg){Result<T> result = new Result<>(data);result.setCode("0");result.setMsg(msg);return result;}public static Result error(String code, String msg){Result result = new Result<>();result.setCode(code);result.setMsg(msg);return result;}
}
可以看出Result是个模板类,因此想要返回什么数据类型给前端都行,如Result,要是没看懂没关系,看到下面就知道怎么用了。因为里面有很多静态方法,可以直接用类名.方法名调用。
实现UserController
1、在controller包中创建UserController类
2、添加@RestController与@RequestMapping(“/user”)注解,注入UserService
注解
3、实现登录的控制
4、实现注册的控制
@RequestMapping中的"/user"是这个控制器类的基路由
@PostMapping(“/login”)表示处理post请求,路由为/user/login
@PostMapping(“/register”)表示处理post请求,路由为/user/register
package summer.summerdemo.controller;import summer.summerdemo.domain.User;
import summer.summerdemo.service.UserService;
import summer.summerdemo.utils.Result;import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RequestBody;import javax.annotation.Resource;@RestController
@RequestMapping("/user")
public class UserController {@Resourceprivate UserService userService;@PostMapping("/login")public Result<User> loginController(@RequestParam String uname, @RequestParam String password){User user = userService.loginService(uname, password);if(user != null){return Result.success(user,"登录成功!");}else{return Result.error("123","账号或密码错误!");}}@PostMapping("/register")public Result<User> registerController(@RequestBody User newUser){User user = userService.registerService(newUser);if(user != null){return Result.success(user,"注册成功!");}else{return Result.error("456","用户名已存在!");}}
}
处理跨域访问问题
跨域问题可以简单理解成如果你的前端项目的IP地址和端口号和后端的IP地址和端口号不一样,就会导致前端无法获取到数据,这是一个规定。而在前后端分离开发的项目中,前后端项目的端口号一般都是不一样的,假设我们这个项目的前端端口号是 8080,后端端口号是 8081,就会造成跨域访问的问题,跨域访问的问题可以在前端解决也可以在后端解决,后端只要加上一个配置文件就行了
1 、在config文件下创建全局跨域配置类GlobalCorsConfig.java
注意:SpringBoot2.4.0 以前下方 allowedOriginPatterns 需要被allowedOrigins代替
package summer.summerdemo.config;import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.CorsRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;@Configuration
public class GlobalCorsConfig {@Beanpublic WebMvcConfigurer corsConfigurer() {return new WebMvcConfigurer() {@Overridepublic void addCorsMappings(CorsRegistry registry) {registry.addMapping("/**") //添加映射路径,“/**”表示对所有的路径实行全局跨域访问权限的设置.allowedOriginPatterns("*") //开放哪些ip、端口、域名的访问权限 SpringBoot2.4.0以后allowedOrigins被allowedOriginPatterns代替.allowCredentials(true) //是否允许发送Cookie信息.allowedMethods("GET", "POST", "PUT", "DELETE") //开放哪些Http方法,允许跨域访问.allowedHeaders("*") //允许HTTP请求中的携带哪些Header信息.exposedHeaders("*"); //暴露哪些头部信息(因为跨域访问默认不能获取全部头部信息)}};}
}
2、接下来就是运行项目,成功如下: