网站外部链接如何建设/百度一下官网
目录
1、需求说明:实现对部门表和员工表的增删改查
2、环境搭建
3、部门管理
3.1 查询部门
3.2 前后端联调
3.3 删除部门
3.4 新增部门
3.5 根据ID查询数据
3.5 修改部门
总结(Controller层参数接收):
4、员工管理
4.1 分页查询
4.2 分页查询插件-PageHelper
4.3 分页查询(带条件)
4.4 删除员工
4.5 新增员工
该项目是在看完黑马2023年JavaWeb视频,跟着做的一个简单的SpringBoot项目
基于前后端分离模式进行开发,会遵循接口文档的开发规范
开发流程:
1、需求说明:实现对部门表和员工表的增删改查
2、环境搭建
1 准备数据库表(dept、emp)
在本地创建tlias数据库,并复制资料中的两张表
2 创建SpringBoot工程
pom.xml
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"><modelVersion>4.0.0</modelVersion><groupId>org.example</groupId><artifactId>tlias</artifactId><version>1.0-SNAPSHOT</version><parent><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-parent</artifactId><version>2.2.7.RELEASE</version></parent><dependencies><!-- mybatis的起步依赖--><dependency><groupId>org.mybatis.spring.boot</groupId><artifactId>mybatis-spring-boot-starter</artifactId><version>2.2.2</version></dependency><!-- mysql 驱动包--><dependency><groupId>mysql</groupId><artifactId>mysql-connector-java</artifactId><scope>runtime</scope></dependency><!-- springboot单元测试--><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId></dependency><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-test</artifactId><scope>test</scope></dependency><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-test</artifactId></dependency><dependency><groupId>org.projectlombok</groupId><artifactId>lombok</artifactId></dependency></dependencies></project>
启动类tliasquickstartapplication:
package pearl;import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;@SpringBootApplication//具有包扫描作用,默认扫描当前包及其子包,即demo01
public class tliasquickstartapplication {public static void main(String[] args) {SpringApplication.run(tliasquickstartapplication.class,args);}}
测试类tliasquickstartapplicationTest:
package pearl;import org.springframework.boot.test.context.SpringBootTest;@SpringBootTest //springboot整合单元测试的注解
public class tliasquickstartapplicationTest {}
application.properties配置文件
# 配置数据库的链接信息 -四要素
#驱动类名称
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
#数据库连接的url
spring.datasource.url=jdbc:mysql://localhost:3306/tlias?serverTimezone=UTC
#连接数据库的用户名
spring.datasource.username=root
#连接数据库的密码
spring.datasource.password=# 配置mybatis的日志,指定输出到控制台
mybatis.configuration.log-impl=org.apache.ibatis.logging.stdout.StdOutImpl# 开启mybatis的驼峰命名自动映射开关
mybatis.configuration.map-underscore-to-camel-case = true
创建实体类Emp、Dept
创建对应的Mapper(接口)、Service(接口、实现类)、Controller基础结构
3、部门管理
3.1 查询部门
EmpController: 首先返回一个空的数据测试端口号
@Slf4j //定义一个日志记录对象 等价于下面对log对象的定义1.
@RestController
public class DeptController {
// 1.定义一个日志记录对象
// 1.private static Logger log = LoggerFactory.getLogger(DeptController.class);// @RequestMapping(value = "/depts",method = RequestMethod.GET)//指定请求方式为get@GetMapping("/depts")// 指定`/depts`路由的请求方式为get 与上一行代码等价public Result list(){log.info("查询全部部门数据");return Result.success();}
}
然后运行启动类,在postman中测试:
没毛病,然后定义一个Service层对象,调用Service层方法查询数据
package pearl.controller;import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.RestController;
import pearl.pojo.Dept;
import pearl.pojo.Result;
import pearl.service.DeptService;import java.util.List;@Slf4j //定义一个日志记录对象 等价于下面对log对象的定义1.
@RestController
public class DeptController {
// 1.定义一个日志记录对象
// 1.private static Logger log = LoggerFactory.getLogger(DeptController.class);@Autowired//定义一个Service层对象private DeptService deptService;// @RequestMapping(value = "/depts",method = RequestMethod.GET)//指定请求方式为get@GetMapping("/depts")// 指定`/depts`路由的请求方式为get 与上一行代码等价public Result list(){log.info("查询全部部门数据");// 调用service查询部门数据List<Dept> deptList = deptService.list();//此时service层中还没定义该方法,需要返回Service层中定义该方法return Result.success(deptList);}
}
此时DeptService中还没有查询全部数据的list()方法,所以现在去DeptService中定义list()接口
/** 查询全部部门数据* */List<Dept> list();
然后去 DeptService中定义list()的实现方法
即定义一个mapper层对象,调用mapper层方法查询数据
package pearl.service.impl;import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
import pearl.mapper.DeptMapper;
import pearl.pojo.Dept;import java.util.List;@Service
public class DeptService implements pearl.service.DeptService {// 定义一个Mapper层对象@Autowiredprivate DeptMapper deptMapper;@Overridepublic List<Dept> list() {List<Dept> deptList = deptMapper.list();//此时service层中还没定义该方法,需要返回Service层中定义该方法return deptList;}
}
此时mapper层中没有list()方法,需要我们现在去DeptMapper中定义list()接口
/** 查询全部部门数据* */@Select("select * from dept")List<Dept> list();
由于该SQL语句较简单,所以直接使用注解方式配置
现在需要按mapper-->service--->controller的路径去查看返回数据是否正确
然后运行启动类,查看查询结果
完成!
3.2 前后端联调
前后端联调:将前端工程、后端工程都启动起来,然后访问前端工程,通过前端工程访问服务程序,进而进行调试
1.将资料中提供的“前端工程”文件中的压缩包,拷贝到一个没有中文不带空格的目录下,解压
2.启动nginx,访问测试:http://localhost:90 --ngix占用的是90端口
点击文件中的nginx.exe
然后通过任务管理器的详细信息查看nginx是否启动完成
然后在浏览器访问http://localhost:90:进入前端页面
3.3 删除部门
EmpController:编写删除函数,调用Service删除接口
// 删除@DeleteMapping("/depts/{id}")public Result delete(@PathVariable Integer id){ //@PathVariable 表示绑定路径中的参数idlog.info("删除id为"+id+"的数据");deptService.delete(id);return Result.success();}
@PathVariable
可以将 URL 中占位符参数绑定到控制器处理方法的入参中:
URL 中的 {xxx} 占位符可以通过@PathVariable(“xxx“) 绑定到操作方法的入参中
EmpService接口:
/** 根据ID删除数据* */void delete(Integer id);
EmpService实现类:编写删除函数,调用mapper 层删除接口
@Overridepublic void delete(Integer id){deptMapper.delete(id);return ;}
EmpMapper: 编写删除接口,与SQL语句
@Delete("delete from dept where id = #{id}")void delete(Integer id);
启动测试类,在postman中测试接口:
完成!
3.4 新增部门
新增部门逻辑与前面相似
注意:新增部门时,使用@RequestBody 将请求参数封装到实体类中,再在service层的实现方法类中补全实体类的属性值,在执行插入到数据库的操作
EmpController:
// 新增部门@PostMapping("/depts")public Result insert(@RequestBody Dept dept){//@RequestBody 将获取到的请求参数封装到实体类dept中log.info("新增部门"+dept);deptService.insert(dept);return Result.success();}
EmpService接口:
/** 新增数据* */void insert(Dept dept);
EmpService实现类:
@Overridepublic void insert(Dept dept) {dept.setCreateTime(LocalDateTime.now());//补全dept中的属性dept.setUpdateTime(LocalDateTime.now());deptMapper.insert(dept);}
EmpMapper:
@Insert("insert into dept (name,create_time,update_time) values(#{name},#{createTime},#{updateTime})")void insert(Dept dept);
运行完成!
3.5 根据ID查询数据
EmpController:
/** 根据ID查询* */@GetMapping("/depts/{id}")public Result selectById(@PathVariable Integer id){log.info("获取id为"+id+"的数据");Dept dept = deptService.selectById(id);return Result.success(dept);}
注意:这里路径中携带参数,一定要使用@PathVariable注解,绑定 路径中的参数
EmpService接口:
/** 根据ID查询数据* */Dept selectById(Integer id);
EmpService实现类:
@Overridepublic Dept selectById(Integer id){Dept dept = deptMapper.selectById(id);return dept;}
EmpMapper :
@Select("select * from dept where id = #{id}")Dept selectById(Integer id);
3.5 修改部门
EmpController:
/** 修改部门* */@PutMapping("/depts")public Result update(@RequestBody Dept dept){log.info("修改部门"+dept);deptService.update(dept);return Result.success();}
EmpService接口:
/** 修改部门* */void update(Dept dept);
EmpService实现类:
@Overridepublic void update(Dept dept){dept.setUpdateTime(LocalDateTime.now());deptMapper.update(dept);}
EmpMapper:
@Update("update dept set name = #{name}, update_time = #{updateTime} where id = #{id}")void update(Dept dept);
完成!
编辑之前:
点击编辑:
这里会自动回显,利用的是通过ID查询数据功能
编辑完成后:
此时部门管理的操作已经完成了,返回来看我们DeptController文件中还可以优化;
优化前:
package pearl.controller;import lombok.extern.slf4j.Slf4j;
import org.apache.ibatis.annotations.Insert;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;
import pearl.pojo.Dept;
import pearl.pojo.Result;
import pearl.service.DeptService;import java.util.List;@Slf4j //定义一个日志记录对象 等价于下面对log对象的定义1.
@RestController
public class DeptController {
// 1.定义一个日志记录对象
// 1.private static Logger log = LoggerFactory.getLogger(DeptController.class);@Autowired//定义一个Service层对象private DeptService deptService;/** 查询* */
// @RequestMapping(value = "/depts",method = RequestMethod.GET)//指定请求方式为get@GetMapping("/depts")// 指定`/depts`路由的请求方式为get 与上一行代码等价public Result list(){log.info("查询全部部门数据");// 调用service查询部门数据List<Dept> deptList = deptService.list();//此时service层中还没定义该方法,需要返回Service层中定义该方法return Result.success(deptList);}/** 根据ID查询* */@GetMapping("/depts/{id}")public Result selectById(@PathVariable Integer id){log.info("获取id为"+id+"的数据");Dept dept = deptService.selectById(id);return Result.success(dept);}/** 删除* */@DeleteMapping("/depts/{id}")public Result delete(@PathVariable Integer id){ //@PathVariable 表示绑定路径中的参数idlog.info("删除id为"+id+"的数据");deptService.delete(id);return Result.success();}/** 新增部门* */@PostMapping("/depts")public Result insert(@RequestBody Dept dept){//@RequestBody 将获取到的请求参数封装到实体类dept中log.info("新增部门"+dept);deptService.insert(dept);return Result.success();}/** 修改部门* */@PutMapping("/depts")public Result update(@RequestBody Dept dept){log.info("修改部门"+dept);deptService.update(dept);return Result.success();}}
由于该文件下的路径都是在`/depts`路径下,所以就把这部分抽出类,简化代码
完整的请求路径为:类上@RequestMappering的路径+方法前的路径
简化后的代码如下
优化后:
package pearl.controller;import lombok.extern.slf4j.Slf4j;
import org.apache.ibatis.annotations.Insert;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;
import pearl.pojo.Dept;
import pearl.pojo.Result;
import pearl.service.DeptService;import java.util.List;@Slf4j
@RequestMapping("/depts")
@RestController
public class DeptController {@Autowired//定义一个Service层对象private DeptService deptService;/** 查询* */@GetMapping// 指定`/depts`路由的请求方式为get 与上一行代码等价public Result list(){log.info("查询全部部门数据");// 调用service查询部门数据List<Dept> deptList = deptService.list();//此时service层中还没定义该方法,需要返回Service层中定义该方法return Result.success(deptList);}/** 删除* */@DeleteMapping("/{id}")public Result delete(@PathVariable Integer id){ //@PathVariable 表示绑定路径中的参数idlog.info("删除id为"+id+"的数据");deptService.delete(id);return Result.success();}/** 新增部门* */@PostMappingpublic Result insert(@RequestBody Dept dept){//@RequestBody 将获取到的请求参数封装到实体类dept中log.info("新增部门"+dept);deptService.insert(dept);return Result.success();}}
总结(Controller层参数接收):
参数格式:路径参数
使用 @PathVariable 表示绑定路径中的参数id eg1: @DeleteMapping("/{id}")public Result delete(@PathVariable Integer id)参数格式:application/json
使用:@RequestBody 将获取到的请求参数封装到实体类中 eg: 请求参数是Dept类的部分属性值@PostMappingpublic Result insert(@RequestBody Dept dept)参数格式:queryString
@RequestParam(defaultValue = "1") 设置默认值 下面的参数名称和类型一定要和文档中的保持一致,否则传输不了数据 eg: public Result selectByPage(@RequestParam(defaultValue = "1") Integer page, @RequestParam(defaultValue = "5") Integer pageSize)
4、员工管理
4.1 分页查询
分页查询语法:
-- 参数1 b: 起始索引 = (页码-1)* l
-- 参数2 l: 查询返回记录数 = 每页展示的记录数
select * from emp limit b,l;
首先查看接口文档,发现需要返回的数据类型是Json文件,包含总记录数和数据列表,
我们最好的选择就是把记录数和数据列表封装成一个实体类,然后再返回给前端
PageBean:
package pearl.pojo;import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;import java.util.List;@Data
@NoArgsConstructor
@AllArgsConstructor
public class PageBean {private Long total;//总记录数private List rows;//数据列表
}
EmpController: //接收前端的请求参数,并返回Result型数据
package pearl.controller;import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;
import pearl.pojo.PageBean;
import pearl.pojo.Result;
import pearl.service.EmpService;@RestController
@Slf4j
public class EmpController {@Autowiredprivate EmpService empService;/** 分页查询* */@GetMapping("/emps") //@RequestParam(defaultValue = "1") 设置默认值public Result selectByPage(@RequestParam(defaultValue = "1") Integer page, //注意这里的参数名称一定要和文档中的保持一致,否则肯传输不了数据@RequestParam(defaultValue = "5") Integer pageSize){log.info("查询数据:第{}页,{}条数据",page,pageSize);PageBean pageBean = empService.selectByPage(page,pageSize);return Result.success(pageBean);}
}
EmpService接口:
/** 分页查询* */PageBean selectByPage(Integer page, Integer pageSize);
EmpService实现类:
@Autowiredprivate EmpMapper empMapper;/** 分页查询* */@Overridepublic PageBean selectByPage(Integer page, Integer pageSize) {List<Emp> rows = empMapper.selectByPage((page-1)*pageSize,pageSize);Long total = empMapper.count();final PageBean pageBean = new PageBean(total,rows);return pageBean;}
EmpMapper:
/** 分页查询,获取列表数据* */@Select("select * from emp limit #{page},#{pageSize}")List<Emp> selectByPage(Integer page, Integer pageSize);/** 查询记录数* */@Select("select count(*) from emp")Long count();
完成!
4.2 分页查询插件-PageHelper
使用PageHelper插件实现分页查询功能
pom文件中导入依赖
<!-- pagehelper分页插件依赖 --><dependency><groupId>com.github.pagehelper</groupId><artifactId>pagehelper-spring-boot-starter</artifactId><version>1.4.0</version></dependency>
EmpController 与EmpService接口代码不变
EmpService实现类:
@Overridepublic PageBean selectByPage(Integer page, Integer pageSize) {
// 1. 设置分页参数PageHelper.startPage(page,pageSize);
// 2. 执行查询List<Emp> empList = empMapper.list();Page<Emp> p = (Page<Emp>) empList;
// 3. 封装成bean对象PageBean pageBean = new PageBean(p.getTotal(),p.getResult());return pageBean;}
EmpMapper:
/** 分页查询-使用PageHelper插件* */@Select("select * from emp")public List<Emp> list();
完成!
4.3 分页查询(带条件)
条件如上所示:我们需要更改EmpController中的参数
EmpController:
@GetMapping("/emps") //@RequestParam(defaultValue = "1") 设置默认值public Result selectByPage(@RequestParam(defaultValue = "1") Integer page, //注意这里的参数名称一定要和文档中的保持一致,否则肯传输不了数据@RequestParam(defaultValue = "5") Integer pageSize,String name, Short gender,@DateTimeFormat(pattern = "yyyy-MM-dd") LocalDate begin,//@DateTimeFormat指定日期格式@DateTimeFormat(pattern = "yyyy-MM-dd") LocalDate end){log.info("查询数据:第{}页,{}条数据,{},{},{},{}",page,pageSize,name,gender,begin,end);PageBean pageBean = empService.selectByPage(page,pageSize,name,gender,begin,end);return Result.success(pageBean);}
EmpService接口:也需要增加参数
/** 分页查询-带条件* */PageBean selectByPage(Integer page, Integer pageSize, String name, Short gender,LocalDate begin, LocalDate end);
EmpService实现类:参数
@Overridepublic PageBean selectByPage(Integer page, Integer pageSize, String name, Short gender,LocalDate begin, LocalDate end) {
// 1. 设置分页参数PageHelper.startPage(page,pageSize);
// 2. 执行查询List<Emp> empList = empMapper.list(name,gender,begin,end);Page<Emp> p = (Page<Emp>) empList;
// 3. 封装成bean对象PageBean pageBean = new PageBean(p.getTotal(),p.getResult());return pageBean;}
EmpMapper接口:
public List<Emp> list(String name, Short gender,LocalDate begin, LocalDate end);
由于条件参数非必须传递,所以使用动态SQL,配置在XML文件中
EmpMapper.xml
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapperPUBLIC "-//mybatis.org//DTD Mapper 3.0//EN""http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="pearl.mapper.EmpMapper"><select id="list" resultType="pearl.pojo.Emp">select * from emp<where><if test="name != null and name != ''">name like concat('%', #{name},'%')</if><if test="gender != null">and gender = #{gender}</if><if test="begin != null and end != null">and entrydate between #{begin} and #{end}</if></where></select>
</mapper>
完成!
4.4 删除员工
具体代码如下,不做过多描述
4.5 新增员工
具体代码如下,不做过多描述