前面一篇文章介绍了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,然后点击“下一步”。
然后点击“完成”
如果出现下面这样,表示正常
如果出现下面这样图,不正常,可以参考下面的两篇文章进行解决
参考解决办法:
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); } }
需要说明的是,
- 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); } }
8.测试增删改查
如果出现了:Whitelabel Error Page 报500,可以参考下面这篇文章尝试一下:
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.总结
本来觉得原理都懂,手搓一遍应该很简单,但是做和说是两码事,真正试一试就能看出很多小问题了。