第十六篇：springboot案例

张箫剑2024-04-18 5:03

文章目录

  • 一、准备工作
    • [1.1 需求说明](#1.1 需求说明)
    • [1.2 环境搭建](#1.2 环境搭建)
    • [1.3 开发规范](#1.3 开发规范)
    • [1.4 思路](#1.4 思路)
  • 二、部门管理
    • [2.1 查询部门](#2.1 查询部门)
    • [2.2 删除部门](#2.2 删除部门)
    • [2.3 新增部门](#2.3 新增部门)
    • [2.4 修改部门](#2.4 修改部门)
    • [2.5 RequestMapping](#2.5 RequestMapping)
  • 三、员工管理
    • [3.1 分页查询](#3.1 分页查询)
    • [3.2 删除员工](#3.2 删除员工)
    • [3.3 新增员工](#3.3 新增员工)
      • [3.3.1 新增员工](#3.3.1 新增员工)
      • [3.3.2 文件上传](#3.3.2 文件上传)
    • [3.4 修改员工](#3.4 修改员工)
      • [3.4.1 页面回显](#3.4.1 页面回显)
      • [3.4.2 修改信息](#3.4.2 修改信息)
  • 四、效果展示
    • [4.1 部门管理](#4.1 部门管理)
    • [4.2 员工管理](#4.2 员工管理)
  • 五、小结

一、准备工作

1.1 需求说明

部门管理:

  • 查询部门列表
  • 删除部门
  • 新增部门
  • 修改部门

员工部门：

  • 查询员工列表（分页，条件）
  • 删除员工
  • 新增员工
  • 修改员工

1.2 环境搭建

环境搭建：

  • 准备数据表（emp，dept）
  • 创建springboot工程，引入对应的起步依赖（web，mybatis，mysql驱动，lombok）
  • 配置application.properties中引入mybatis配置信息，准备对应的实体类
  • 准备对应的Mapper，Service（接口.实现类）,Controller基础结构

1.3 开发规范

案例基于当前最主流的前后端分离模式进行开发

Restful

  • REST(Representational State Transfer)，表述性状态转换，是一种软件架构风格

传统风格没有一个固定的规范，而REST是一种风格，是默认的约定方式，约定不是规定，可以打破（但不建议）

描述模块的功能通常使用复数，也就是加s的格式来描述，表示此类资源，而非单个资源，如：users、emps、books、

  • GET：查询请求
  • POST：新增请求
  • PUT：修改请求
  • DELETE：删除id用户

统一响应结果

前后端交互统一响应结果Result

开发流程以此从左到右

1.4 思路

思路：

使用三层架构的方式

Controller层：接收请求，并调用service层查询部门

Service层：调用mapper接口查询

Mapper层：使用SQL语句查询，并把查询的结果传给Service

Service层：接收到Mapper层，再传给Controller

Controller层：接收响应，并传给客户端

二、部门管理

2.1 查询部门

Controller层

代码如下：

java 复制代码 
/*
* 部门管理
* */
@Slf4j
@RestController
public class DeptController {
    @Autowired
    private DeptService deptService;
    @GetMapping ("/depts")
    public Result list(){
        log.info("查询全部部门");
        List<Dept> deptList=deptService.list();
        return Result.success(deptList);
    }
}
注解 含义
@Slf4j 日志注解，可以直接使用log.info输出日志
@Autowired 依赖注入注解
@RestController @ResponseBody+Conrtoller注解
@GetMapping 用于get请求的注解

Service层

Service层接口如下：

java 复制代码 
public interface DeptService {
    /*
    * 查询全部部门数据
    * */
    List<Dept> list();
}

Service层实现类如下：

java 复制代码 
@Service
public class DeptServiceImpl implements DeptService {
    @Autowired
    private DeptMapper deptMapper;

    /*
     * 查询全部部门数据
     * */
    @Override
    public List<Dept> list() {
        return deptMapper.list();
    }
}

Mapper层

mapper层代码如下：

java 复制代码 
public interface DeptMapper {
    /*
     * 查询全部部门数据
     * */

    @Select("select id, username, password, name, gender, image, job, entrydate, dept_id, create_time, update_time from tlias.emp ")

    List<Dept> list();
}

2.2 删除部门

Controller层

代码如下：

java 复制代码 
    /*
    * 删除部门
    * */
    @DeleteMapping("/depts/{id}")
    public Result deletc(@PathVariable Integer id){
        log.info("根据id删除部门:",id);
        deptService.delete(id);
        return Result.success();
    }
注解 含义
@PathVariable 用于接收路径参数的注解

Service层

Service层接口

java 复制代码 
    /*
     * 删除部门
     * */
    void delete(Integer id);

接口实现类

java 复制代码 
  /*
     * 删除部门
     * */
    @Override
    public void delete(Integer id) {
        deptMapper.deleteById(id);
    }

Mapper层

java 复制代码 
   /*
     * 根据ID删除部门
     * */
    @Delete("delete from tlias.dept where id = #{id} ")
    void deleteById(Integer id);

2.3 新增部门

Controller层

具体如下：

java 复制代码 
    /*
    * 新增部门
    * */
    @PostMapping("/depts")
    public Result add(@RequestBody Dept dept){
        log.info("新增部门:",dept);
        deptService.add(dept);
        return Result.success();
    }

Service层

Service层接口

java 复制代码 
/*
* 新增部门
* */
void add(Dept dept);

Service实现类

java 复制代码 
/*
* 新增部门
* */
@Override
public void add(Dept dept) {
dept.setCreateTime(LocalDateTime.now());
dept.setUpdateTime(LocalDateTime.now());
deptMapper.insert(dept);
    }

Mapper层

具体如下：

java 复制代码 
 /*
  * 新增部门
  * */
 @Insert("insert tlias.dept (name, create_time, update_time) " +
         "values(#{name},#{createTime},#{updateTime}) ")
 void insert(Dept dept);

2.4 修改部门

Controller层

为了得到修改时页面返回的部门名称，需要先根据ID进行一次查询，用于页面的回显

代码如下：

java 复制代码 
@GetMapping("/{id}")
  public Result getById(@PathVariable Integer id){
       log.info("获取部门ID:",id);
       Dept dept = deptService.getById(id);
       return Result.success(dept);
  }
    
@PutMapping
  public Result update(@RequestBody Dept dept) {
      log.info("修改部门:{}",dept);
      deptService.update(dept);
      return Result.success();
  }

Service层

Service层接口

java 复制代码 
    Dept getById(Integer id);
    
    void update(Dept dept);

Service实现类

java 复制代码 
@Override
  public Dept getById(Integer id) {
      Dept dept = deptMapper.getByID(id);
      return dept;
 }

@Override
  public void update(Dept dept) {
      dept.setUpdateTime(LocalDateTime.now());
      deptMapper.update(dept);
  }

Mapper层

代码如下：

java 复制代码 
@Select("select * from tlias.dept where id = #{id}")
 Dept getByID(Integer id); 
@Update("update tlias.dept set name = #{name},update_time = #{updateTime} where id = #{id}")
void update(Dept dept);

2.5 RequestMapping

由于部门管理中所有的请求路径都是/depts开头，所以可以使用RequestMapping来简化请求的定义，直接抽取到类上

注意：一个完整的请求路径，应该是类上的@RequestMapping的value属性 + 方法上的@RequestMapping的value属性

三、员工管理

3.1 分页查询

Controller层

java 复制代码 
    @GetMapping("/emps")
    public Result     public Result page(@RequestParam(defaultValue = "1") Integer page,
                       @RequestParam(defaultValue = "10") Integer pageSize,
                        String name, Short gender,
                       @DateTimeFormat(pattern = "yyyy-MM-dd") LocalDate begin,
                       @DateTimeFormat(pattern = "yyyy-MM-dd") LocalDate end){
        log.info("分页查询，参数:{},{},{},{},{},{}",page,pageSize,name,gender,begin,end);

        PageBean pageBean = empService.page(page,pageSize,name,gender,begin,end);

        return Result.success(pageBean);
    }

Service层

Service层接口如下：

hava 复制代码 
  /*
    * 分页查询
    * */
     PageBean page(Integer page, Integer pageSize, String name, Short gender, LocalDate begin, LocalDate end);
}

Service层实现类如下：

java 复制代码 
 @Override
    public PageBean page(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.封装pageBean对象
        PageBean pageBean = new PageBean(p.getTotal() ,p.getResult());

        return pageBean;
    }

Mapper层

java 复制代码 
   /*
    * 查询总记录数
    * */
        public List<Emp> list(String name, Short gender, LocalDate begin, LocalDate end);

XML：

xml 复制代码 
    <select id="list" resultType="com.itzhangxx.pojo.Emp">
        select *
        from tlias.emp
        <where>
            <if test="name != null">
                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>
        order by update_time desc
    </select>

PageHelper

3.2 删除员工

Controller层

具体代码如下：

java 复制代码 
    /*
     * 批量删除
     * */
    @DeleteMapping("/{ids}")
    public Result delete(@PathVariable List<Integer> ids){
        log.info("批量删除:{}",ids);
        empService.delete(ids);
        return Result.success();
    }

Service层

Service层接口如下：

java 复制代码 
    /*
    * 批量删除
    * */
    void delete(List<Integer> ids);

Service层实现类如下：

java 复制代码 
   /*
     * 批量删除
     * */
    @Override
    public void delete(List<Integer> ids) {
        empMapper.delete(ids);
    }

Mapper层

mapper:

java 复制代码 
  /*
     * 批量删除
     * */
   void delete(List<Integer> ids);

xml:

xml 复制代码 
   <!--
        批量删除
    -->
    <delete id="delete">
        delete
        from tlias.emp
        where id in
        <foreach collection="ids" item="id" separator="," open="(" close=")">
            #{id}
        </foreach>
    </delete>

3.3 新增员工

3.3.1 新增员工

Controller层

代码如下：

java 复制代码 
   /*
    * 新增员工
    * */
    @PostMapping()
    public Result save(@RequestBody Emp emp){
        log.info("新增员工:{}",emp);
        empService.save(emp);
        return Result.success();
    }

Service层

Service层接口如下：

java 复制代码 
    /*
     * 新增员工
     * */
    void save(Emp emp);

Service层实现类如下：

java 复制代码 
    /*
     * 新增员工
     * */
    @Override
    public void save(Emp emp) {
        emp.setCreateTime(LocalDateTime.now());
        emp.setUpdateTime(LocalDateTime.now());
        empMapper.save(emp);
    }

Mapper层

java 复制代码 
  /*
     * 新增员工
     * */
    @Insert("insert tlias.emp (username, name, gender, image, job, entrydate, dept_id, create_time, update_time)" +
            "value ( #{username},#{name},#{gender},#{image},#{job},#{entrydate},#{deptId},#{createTime},#{updateTime})")
    void save(Emp emp);

3.3.2 文件上传

创建一个utils工具类

java 复制代码 
/**
 * 阿里云 OSS 工具类
 */
@Component
public class AliOSSUtils {

    private String endpoint = "改为自己的" ;
    private String accessKeyId ="改为自己的" ;
    private String accessKeySecret = "改为自己的";
    private String bucketName = "改为自己的";

    /**
     * 实现上传图片到OSS
     */
    public String upload(MultipartFile file) throws IOException {
        // 获取上传的文件的输入流
        InputStream inputStream = file.getInputStream();

        // 避免文件覆盖 使用UUID  tostring后都是得到拓展名
        String originalFilename = file.getOriginalFilename();
        String fileName = UUID.randomUUID().toString() + originalFilename.substring(originalFilename.lastIndexOf("."));

        //上传文件到 OSS
        OSS ossClient = new OSSClientBuilder().build(endpoint, accessKeyId, accessKeySecret);
        ossClient.putObject(bucketName, fileName, inputStream);

        //文件访问路径
        String url = endpoint.split("//")[0] + "//" + bucketName + "." + endpoint.split("//")[1] + "/" + fileName;
        // 关闭ossClient
        ossClient.shutdown();
        return url;// 把上传到oss的路径返回
    }

}

Controller代码如下

java 复制代码 
    @Autowired
    private AliOSSUtils aliOSSUtils;

    @PostMapping("/upload")
    public Result upload(MultipartFile image) throws IOException {
        log.info("文件上传，文件名:{}",image.getOriginalFilename());

        //调用阿里云工具类进行文件上传
        String url = aliOSSUtils.upload(image);
        log.info("文件上传成功，文件访问的url:{}",url);

        return Result.success(url);
    }

3.4 修改员工

3.4.1 页面回显

Controller层

具体如下：

java 复制代码 
    /*
    * 页面回显,根据id查询
    * */
    @GetMapping("/{id}")
    public Result geyById(@PathVariable Integer id){

        log.info("根据id插叙信息:{}",id);
        Emp emp = empService.getById(id);
        return Result.success(emp);
    }

Service层

Service层接口如下：

java 复制代码 
  /*
     * 页面回显,根据id查询
     * */
    Emp getById(Integer id);

Service层实现类如下：

java 复制代码 
  /*
     * 页面回显,根据id查询
     * */
    @Override
    public Emp getById(Integer id) {

        return empMapper.getById(id);
    }

Mapper层

具体如下：

java 复制代码 
    /*
     * 页面回显,根据id查询
     * */
    @Select("select * from tlias.emp where id = #{id}")
    Emp getById(Integer id);

3.4.2 修改信息

Controller层

具体如下：

java 复制代码 
    /*
    * 修改员工
    * */
    @PutMapping
    public Result update(@RequestBody Emp emp){
        log.info("更新员工信息:{}",emp);

        empService.update(emp);
        return Result.success();
    }

Service层

Service层接口如下：

java 复制代码 
  /*
     * 修改员工
     * */
    void update(Emp emp);

Service层实现类如下：

java 复制代码 
  /*
     * 修改员工
     * */
    @Override
    public void update(Emp emp) {
        emp.setUpdateTime(LocalDateTime.now());
        empMapper.update(emp);
    }

Mapper层

xml 复制代码 
    <!--
        修改员工
    -->
    <update id="update">
        update tlias.emp
        <set>
            <if test="username != null and username != '' ">
                username = #{username},
            </if>
            <if test="name != null and name != '' ">
                name = #{name},
            </if>
            <if test="gender != null">
                gender = #{gender},
            </if>
            <if test="image != null">
                image = #{image},
            </if>
            <if test="job != null">
                job = #{job},
            </if>
            <if test="entrydate != null">
                entrydate = #{entrydate},
            </if>
            <if test="deptId != null">
                dept_id = #{deptId},
            </if>
            <if test="updateTime != null">
                update_time = #{updateTime}
            </if>
        </set>
        where id = #{id}
    </update>

四、效果展示

4.1 部门管理

主界面

新增

删除

修改

4.2 员工管理

主界面

新增

删除

修改

查询

五、小结

写本文主要是为了分享我的学习过程，也是给自己记个笔记，哪里忘记了，回来再看一眼，也可以很快的回想起来

相关推荐
一只叫煤球的猫10 小时前
写代码很6，面试秒变菜鸟？不卖课，面试官视角走心探讨
前端·后端·面试
bobz96510 小时前
tcp/ip 中的多路复用
后端
bobz96511 小时前
tls ingress 简单记录
后端
皮皮林55112 小时前
IDEA 源码阅读利器，你居然还不会？
java·intellij idea
你的人类朋友12 小时前
什么是OpenSSL
后端·安全·程序员
bobz96512 小时前
mcp 直接操作浏览器
后端
前端小张同学14 小时前
服务器部署 gitlab 占用空间太大怎么办，优化思路。
后端
databook15 小时前
Manim实现闪光轨迹特效
后端·python·动效
武子康15 小时前
大数据-98 Spark 从 DStream 到 Structured Streaming：Spark 实时计算的演进
大数据·后端·spark
该用户已不存在15 小时前
6个值得收藏的.NET ORM 框架
前端·后端·.net
热门推荐
01GitHub 镜像站点02UV 工具安装与国内镜像源配置指南0346个Nano-banana 精选提示词，持续更新中04Claude Code 平替：OpenAI发布 Codex CLI ，GPT-5 国内直接使用05UV安装并设置国内源06保姆级教程：手把手教你用Dify实现完美多轮对话（附Chatflow和提示词）07A股预测还能更准？开源大模型Kronos带你跑通预测+回测全流程08Spec-Kit 使用指南09智能库存管理的需求预测模型：从业务痛点到落地代码的完整实践10解决 WSL Ubuntu 中 /etc/resolv.conf 自动重置问题