前面一篇文章介绍了SpringBoot项目的创建: Spring Boot(1)—创建并运行项目

这篇文章简单介绍一下SpringBoot项目的增删改查。

所需工具:IDEA、java1.8、mysql

0.创建项目

我们通过IDEA创建项目。

点击”新建”—>”项目”

选择“Spring Initializr” 选择版本号1.8,然后点击“下一步”

然后填写必要信息。类型这个地方选择Maven(Generate a Maven based project archive),语言选择java,java版本我们这里选择8。其余信息自定义。

然后选择“web”,选择“Spring web”然后选择Spring Boot的版本号,这里线不建议选择3.0及以上版本,我们选择的是2.7.7,然后点击“下一步”。

然后点击“完成”

如果出现下面这样,表示正常

如果出现下面这样图,不正常,可以参考下面的两篇文章进行解决

参考解决办法:

IDEA配置maven主目录(maven home)不生效

Project ‘org.springframework.boot:spring-boot-starter-parent:2.7.7’ not found

1.添加必要依赖

因为要实现增删改查,所以要添加一些依赖,比如数据库等

<?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 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.7.7</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
    <groupId>site.longkui</groupId>
    <artifactId>app</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>app</name>
    <description>Demo project for Spring Boot</description>
    <properties>
        <java.version>1.8</java.version>
    </properties>
    <dependencies>
        <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>
        <!-- mysql  -->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <scope>runtime</scope>
        </dependency>
        <!--mybatis -->
        <dependency>
            <groupId>org.mybatis.spring.boot</groupId>
            <artifactId>mybatis-spring-boot-starter</artifactId>
            <version>2.1.4</version>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>

</project>

2.创建数据库

参考下面这篇文章创建数据库表: mysql生成数据

DROP TABLE IF EXISTS `students`;
CREATE TABLE `students` (
    `id` int(10) unsigned NOT NULL AUTO_INCREMENT,
    `stu_name` varchar(20) NOT NULL ,
    `stu_sex` varchar(10)  NOT NULL ,
    `class_id` int(10)  NOT NULL ,
    `age` int(10) NOT NULL  DEFAULT 18,
    `create_time` datetime NULL DEFAULT CURRENT_TIMESTAMP,
    `update_time` datetime NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
    PRIMARY KEY (`id`)
) ENGINE=InnoDB AUTO_INCREMENT=1000 DEFAULT CHARSET=utf8;
insert into students (stu_name,stu_sex,class_id,age) values
('张三','男',1001,18),
('王晓红','女',2001,20),
('李清乐','男',1001,23),
('赵倚天','男',3001,23);
3.创建或修改配置文件

我们创建的springboot项目一般只有application.properties文件,如果没有xxx.yml文件,我们需要自己创建这个文件。

在这里,我们创建application.yml文件(或者也同步创建application-dev.yml文件,关于这两个文件的区别和优先级可以参考这篇文章:)

spring boot的application.yml和application-dev.yml

创建的application.yml内容参考如下:

server:
  port: 8082

# spring配置
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/test?useUnicode=true&characterEncoding=utf-8&useSSL=true&serverTimezone=UTC
    username: root
    password: root
    driver-class-name: com.mysql.cj.jdbc.Driver

# mybaits配置
mybatis:
  # 配置mapper的扫描,找到所有的mapper.xml映射文件
  mapper-locations: classpath*:mappers/**/*Mapper.xml
  # 搜索指定包别名
  type-aliases-package: site.longkui.**.entity

我们参考上面图片新建五个文件夹,controller、entity、mapper、service、mappers。注意各自的位置,我们扫描包的时候需要用到位置。

这个地方主要说明的是

1.mysql的相关部分:

自己参考上面的脚本创建数据库和表,数据库连接和用户名密码等不要写错了。

2.mybatis的配置部分:

mapper-locations主要表示要映射的xml文件。按照上面的图片的配置文件,mapper-locations可以写成classpath*:mappers/*Mapper.xml这个地市之所以写成classpath*:mappers/**/*Mapper.xml这样主要是为了以后扩展,包括下面的type-aliases-package也是这个想法。

4.编写xml和mapper层

我们创建访问数据库的增删改查的xml文件,注意要在resources/mappers下面创建,而且创建的文件名称一定要是 xxxMapper.xml。这是因为我们配置文件定义的这种格式,如果你写的xml文件命名为abc.xml,根据上面的配置,spring就无法扫描到这个文件,也就不能执行这个文件中的sql。

(注:为了方(tou)便(lan),我们不创建实体类,不写resultMap,直接用数据库字段一一对应)

我们创建的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">
<!--必须和mapper里面一一对应-->
<mapper namespace="site.longkui.app.mapper.StudentsMapper">

    <!--查询  -->
    <select id="getList" resultType="java.util.HashMap">
        SELECT * from students
    </select>

    <!--删除   -->
    <delete id="delById">
        delete from students where  id =#{id};
    </delete>
    <!--新增-->
    <insert id="insertStudent">
        INSERT INTO `students` (`stu_name`, `stu_sex`, `class_id`, `age`)
        VALUES
        ( #{stu_name}, #{stu_sex}, #{class_id}, #{age});
    </insert>
    <!--更新-->
    <update id="updateStudent">
        update students
        set
        stu_name=#{stu_name},
        stu_sex=#{stu_sex},
        class_id=#{class_id},
        age=#{age}
        where id=#{id};
    </update>

</mapper>

然后Mapper层如下:

package site.longkui.app.mapper;

import org.apache.ibatis.annotations.Param;
import org.springframework.stereotype.Repository;
import java.util.HashMap;
import java.util.List;

@Repository
public interface StudentsMapper {
    //查询所有
    List<HashMap<HashMap,HashMap>> getList();
    //删除一个
    Boolean delById(@Param("id") int id);
    //新增一个
    Boolean insertStudent(@Param("stu_name") String stu_name,
                          @Param("stu_sex") String stu_sex,
                          @Param("class_id") int class_id,
                          @Param("age") int age);
    //更新
    Boolean updateStudent(@Param("id") int id,
                          @Param("stu_name") String stu_name,
                          @Param("stu_sex") String stu_sex,
                          @Param("class_id") int class_id,
                          @Param("age") int age);
}
5.service层

这个地方需要说明一下,本来这个层级关系一般是sevice层,然后写service的实现层(impl),在实现层里去访问Mapper层的代码,但是这个demo没有太复杂的逻辑,所以偷懒了一下,直接在service层去访问Mapper层的代码。

package site.longkui.app.service;

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
import site.longkui.app.mapper.StudentsMapper;

import java.util.HashMap;
import java.util.List;

@Service
public class StudentsService {
    @Autowired
    private StudentsMapper studentsMapper;


    //查询所有
    public List<HashMap<HashMap,HashMap>> getList(){
        return studentsMapper.getList();
    }
    //删除一个
    public Boolean delById(int id){
        return studentsMapper.delById(id);
    }
    //新增一个
    public Boolean insertStudent(String stu_name,String stu_sex,int class_id,int age){
        return studentsMapper.insertStudent(stu_name, stu_sex, class_id, age);
    }
    //修改一个
    public Boolean updateStudent(int id,String stu_name,String stu_sex,int class_id,int age){
        return studentsMapper.updateStudent(id, stu_name, stu_sex, class_id, age);
    }
}
6.controller层
package site.longkui.app.controller;

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.*;
import site.longkui.app.service.StudentsService;

import java.util.HashMap;
import java.util.List;

@RestController
@RequestMapping("/students")
public class StudentsController {
    @Autowired
    private StudentsService studentsService;

    //查询所有
    @GetMapping("/getList")
    public List<HashMap<HashMap,HashMap>> getList(){
        try {
            List<HashMap<HashMap,HashMap>>res = studentsService.getList();
            return res;
        }catch (Exception e){
            e.toString();
            return null;
        }
    }
    //删除一个
    @GetMapping("/del/{id}")
    public Boolean delById(@PathVariable int id){
        return studentsService.delById(id);
    }
    //新增一个
    @GetMapping("/add/{stu_name}/{stu_sex}/{class_id}/{age}")
    public Boolean insertStudent(@PathVariable String stu_name,
                                 @PathVariable String stu_sex,
                                 @PathVariable int class_id,
                                 @PathVariable int age){
        return studentsService.insertStudent(stu_name, stu_sex, class_id, age);
    }
    //更新一个
    @GetMapping("/update/{id}/{stu_name}/{stu_sex}/{class_id}/{age}")
    public Boolean updateStudent(@PathVariable int id,
                                 @PathVariable String stu_name,
                                 @PathVariable String stu_sex,
                                 @PathVariable int class_id,
                                 @PathVariable int age){
        return studentsService.updateStudent(id,stu_name, stu_sex, class_id, age);
    }
}

需要说明的是,

  1. getList这个方法的返回值类型
 List<HashMap<HashMap,HashMap>>

一般来说,我们都会用实体类来接受返回的数据,但是,本文这里又偷懒了,没有写实体类对应,直接用比较万能的方式接收返回的数据,实际开发中并不建议这样用。

2. 非常明显的可以看出,这里的增删改查操作都是用的get方法,实际开发中一般是不允许这么干的,一般来说,只有查询数据的时候用get方法,其余的用POST和PUT,本文只是为了偷懒,测试方便所以用的全都是get方法。

7.修改启动类

我们找到启动类的位置,加上MapperScan

package site.longkui.app;

import org.mybatis.spring.annotation.MapperScan;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
@MapperScan("site.longkui.**.mapper")
public class AppApplication {

    public static void main(String[] args) {
        SpringApplication.run(AppApplication.class, args);
    }
}

一开始因为没有加,导致启动报错:Field studentsMapper in site.longkui.app.service.StudentsService required a bean of type ‘site.longkui.app.mapper.StudentsMapper’ that could not be found.

8.测试增删改查

如果出现了:Whitelabel Error Page 报500,可以参考下面这篇文章尝试一下:

Whitelabel Error Page

1.查询所有数据:

URL:http://localhost:8082/students/getList

2.删除一个学生数据:

URL:http://localhost:8082/students/del/1000

然后去数据库里查看,确实没有了编号是1000的学生信息了。

3.新增一个学生:

URL: http://localhost:8080/studets/add/王老虎/男/5/19

这里没有用API工具,因为这样传中文会有问题,我们用浏览器代替

上面这个请求就会转换成:http://localhost:8082/students/add/%E7%8E%8B%E8%80%81%E8%99%8E/%E7%94%B7/5/19

然后,数据库里也正常有数据了

4.更新一个学生

我们把王老虎的性别改成女

URL: http://localhost:8080/studets/update/1005/王老虎/女/5/19

浏览器会转换成:

http://localhost:8082/students/update/1005/%E7%8E%8B%E8%80%81%E8%99%8E/%E5%A5%B3/5/19

然后去数据库里查询,发现王老虎的性别已经被修改了。

9.总结

本来觉得原理都懂,手搓一遍应该很简单,但是做和说是两码事,真正试一试就能看出很多小问题了。

分类: java