本教程需要安装以下工具,如果不清楚怎么安装的可以看下我的这篇文章
链接: 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 {
@Resource
private UserDao userDao;
@Override
public User loginService(String uname, String password) {
User user = userDao.findByUnameAndPassword(uname, password);
if(user != null){
user.setPassword("");
}
return user;
}
@Override
public 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 {
@Resource
private 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 {
@Bean
public WebMvcConfigurer corsConfigurer() {
return new WebMvcConfigurer() {
@Override
public 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、接下来就是运行项目,成功如下: