0x01 创建项目

0x01 打开idea 点击 创建新项目

image.png

0x02 创建方式选择

  1. 选择 “Spring Initializr” jdk1.8默认即可 然后点击下一步

image.png

0x03 完善项目信息

  1. Group = 组名
  2. Artifact = 项目名
  4. Group 一般写公司名
  5. ArtifictId 一般写项目名
  7. 例如我图中 Artifact = demo
  8. 那么最终目录结构就是 src->main->java->com->example->demo
  9. 点击下一步

image.png

0x04 选择组件

  1. SpringBoot版本选择2.5.1
  2. Web 选择 (Spring Web)
  3. Template Engines 选择 (Thymeleaf)
  4. SQL 选择 (JDBC API, MySQL Driver, MyBatis Framework)
  6. 然后选择下一步

image.png

0x05 项目名与存放位置确定

  1. 项目名: SpringBootDemo
  3. 选择好以后点击 完成 按钮
  5. 请注意第一次加载的时候因为要下载资源所有会很慢，请等待！！！

image.png

0x06 刚创建好的项目目录结构

image.png

  1. 如果等了很久也没有自动导包，可以点击右边的 Maven按钮
  2. 里面有个重新导包功能 与 重新下载包 的功能
  3. 如下图

image.png

0x07 测试的数据库 - 测试数据

  1. 这里我创建了一个test数据库
  2. 里面有一个 user表
  3. 字段为 id, username, password

image.png

测试使用的test数据库.zip

0x08 SpringBoot项目分层

  1. SpringBoot项目大概分为四层:
  3. Controller层:
  4.     所有请求的入口,前后端交互的入口
  5.     一般会在项目根路径创建一个文件夹:
  6.          controller 文件夹 (存放XxxController.java)
  8. Service层:
  9.     也叫服务层 或是 业务层,负责所有的业务逻辑
  10.     例如: XxxService.java(业务接口类) XxxServiceImpl.java(业务实现类)
  11.     一般会在项目根路径创建两个文件夹:
  12.     service 文件夹 (存放XxxService.java)
  13.     serviceImpl 文件夹 (存放XxxServiceImpl.java)
  15. Mapper层 或是叫 DAO层:
  16.     持久层,负责java和数据库交互
  17.     包括 interface 和 xml 两类文件
  18.     例如: XxxMapper.java(数据库访问接口类) XxxMapper.xml(数据库链接实现)
  19.     一般会创建两个文件夹:
  20.         项目根路径创建(存放XxxMapper.java):
  21.             mapper 文件夹
  22.         项目resources文件夹下创建(存放XxxMapper.xml):
  23.             mapper 文件夹
  25. Bean层 或是叫 Model层 在或是 Entity层:
  26.     就是数据库表的映射实体类，存放POJO对象
  27.     这里我习惯叫 Bean层 所以我创建的文件夹叫 bean 文件夹
  28.     一般会在项目根路径创建一个文件夹:
  29.         bean 文件夹(存放XxxBean.java)

依照上面四层,创建目录结构如下:
image.png

0x09 修改 application配置

  1. # 查看resources文件夹 里面的 application.properties 修改为 application.yml
  1. # application.yml配置文件内容
  3. # 注意:
  4. # 按照实际情况改即可
  5. # 记得要确定可以连接,不然启动的时候项目会爆错
  6. # 192.168.24.129:3306/test 的含义
  7. # 192.168.24.129 mysql连接地址
  8. # 3306 mysql连接端口
  9. # test mysql连接的数据库
  11. server:
  12.     # 访问地址
  13.   address: 127.0.0.1
  14.   # 访问端口
  15.   port: 8081
  17. spring:
  18.   # 数据库配置
  19.   datasource:
  20.     # mysql连接地址
  21.     url: jdbc:mysql://192.168.24.129:3306/test?useUnicode=true&characterEncoding=UTF-8&serverTimezone=Asia/Shanghai
  22.     # 用户名
  23.     username: root
  24.     # 密码
  25.     password: 123456
  26.     # 数据库链接驱动
  27.     driver-class-name: com.mysql.jdbc.Driver
  29. # mybatis配置
  30. mybatis:
  31.     # 指定sql映射文件位置，mapper下的所有.xml文件都是映射文件
  32.   mapper-locations: classpath:mapper/*.xml 
  33.   # 数据库表的映射实体类存放位置，存放POJO对象
  34.   type-aliases-package: com.example.demo.bean

image.png

0x10 修改 pom.xml配置

  1. # 打开pom.xml
  2. 搜索 <artifactId>mysql-connector-java</artifactId> 
  3. 然后修改为
  4. <dependency>
  5.   <groupId>mysql</groupId>
  6.   <artifactId>mysql-connector-java</artifactId>
  7.   <version>5.1.41</version>
  8. </dependency>
  10. 搜索 <artifactId>mybatis-spring-boot-starter</artifactId>
  11. 然后修改为
  12. <dependency>
  13.   <groupId>org.mybatis.spring.boot</groupId>
  14.   <artifactId>mybatis-spring-boot-starter</artifactId>
  15.   <version>2.1.4</version>
  16. </dependency>
  18. 如果嫌弃麻烦的话,也可以使用我下面这个修改好的pom.xml
  1. # pom.xml配置
  3. <?xml version="1.0" encoding="UTF-8"?>
  4. <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  5.          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
  6.     <modelVersion>4.0.0</modelVersion>
  7.     <parent>
  8.         <groupId>org.springframework.boot</groupId>
  9.         <artifactId>spring-boot-starter-parent</artifactId>
  10.         <version>2.5.1</version>
  11.         <relativePath/>
  12.     </parent>
  13.     <groupId>com.example</groupId>
  14.     <artifactId>demo</artifactId>
  15.     <version>0.0.1-SNAPSHOT</version>
  16.     <name>demo</name>
  17.     <description>Demo project for Spring Boot</description>
  18.     <properties>
  19.         <java.version>1.8</java.version>
  20.     </properties>
  21.     <dependencies>
  22.         <dependency>
  23.             <groupId>org.springframework.boot</groupId>
  24.             <artifactId>spring-boot-starter-jdbc</artifactId>
  25.         </dependency>
  26.         <!--thymeleaf模板引擎配置-->
  27.         <dependency>
  28.             <groupId>org.springframework.boot</groupId>
  29.             <artifactId>spring-boot-starter-thymeleaf</artifactId>
  30.         </dependency>
  31.         <!--Web依赖-->
  32.         <dependency>
  33.             <groupId>org.springframework.boot</groupId>
  34.             <artifactId>spring-boot-starter-web</artifactId>
  35.         </dependency>
  36.         <!--MyBatis配置-->
  37.         <dependency>
  38.             <groupId>org.mybatis.spring.boot</groupId>
  39.             <artifactId>mybatis-spring-boot-starter</artifactId>
  40.             <version>2.1.4</version>
  41.         </dependency>
  42.         <!--MySQL数据库配置-->
  43.         <dependency>
  44.             <groupId>mysql</groupId>
  45.             <artifactId>mysql-connector-java</artifactId>
  46.             <version>5.1.41</version>
  47.         </dependency>
  48.         <!--单元测试配置-->
  49.         <dependency>
  50.             <groupId>org.springframework.boot</groupId>
  51.             <artifactId>spring-boot-starter-test</artifactId>
  52.             <scope>test</scope>
  53.         </dependency>
  54.     </dependencies>
  56.     <build>
  57.         <plugins>
  58.             <plugin>
  59.                 <groupId>org.springframework.boot</groupId>
  60.                 <artifactId>spring-boot-maven-plugin</artifactId>
  61.             </plugin>
  62.         </plugins>
  63.     </build>
  65. </project>

image.png
image.png

0x11 创建启动的初始页面

  1. 在resources 里面的 templates文件下新建index.html页面，作为启动的初始页面

image.png

  1. # resources文件夹 下面的 templates文件夹 里面的 index.html界面源码
  3. <!DOCTYPE html>
  4. <html lang="en">
  5. <head>
  6.     <meta charset="UTF-8">
  7.     <title>index</title>
  8. </head>
  9. <body>
  10.     我是一个初始的SpringBoot展示界面
  11. </body>
  12. </html>

0x12 创建 HelloController测试类

image.png

  1. # HelloController.java 源码
  3. package com.example.demo.controller;
  5. import org.springframework.stereotype.Controller;
  6. import org.springframework.web.bind.annotation.RequestMapping;
  8. @Controller
  9. public class HelloController {
  11.     @RequestMapping("/Hello/index")
  12.     public String index(){
  13.         return "h_index";
  14.     }
  15. }
  1. # h_index.html 源码
  3. <!DOCTYPE html>
  4. <html lang="en">
  5. <head>
  6.     <meta charset="UTF-8">
  7.     <title>Hello</title>
  8. </head>
  9. <body>
  10. 我是控制器 HelloController 下的 index 方法
  11. </body>
  12. </html>

0x13 运行项目启动类

image.png

在浏览器中输入 http://127.0.0.1:8081
image.png
image.png

0x02 使用IDEA连接数据库

点击右侧边框的Database
点击“加号”新建数据库连接
image.png
image.png

找到配置 serverTimezone(时区) 填写进入 Asia/Shanghai
如下图:
image.png
image.png
image.png
image.png

0x03 SpringBoot基本例子

0x03.1 @ResponseBody - 例子

  1. # 解释
  2. 一般在使用@RequestMapping后，返回值通常解析为跳转路径
  3. 如果@ResponseBody后返回结果不会被解析为跳转路径,而是直接写入HTTP response body
  4. 这个就是它的作用
  1. # 新建个 TestController.java 然后添加一个方法
  2. # 代码如下:
  4. package com.example.demo.controller;
  6. import org.springframework.stereotype.Controller;
  7. import org.springframework.web.bind.annotation.RequestMapping;
  8. import org.springframework.web.bind.annotation.ResponseBody;
  10. @Controller
  11. public class TestController {
  12.     // 方法直接返回字符串-测试
  13.     @RequestMapping("/hello")
  14.     @ResponseBody
  15.     public String hello() {
  16.         return "Hello World !!!";
  17.     }
  18. }

image.png
image.png
image.png

0x03.2 在Controller中获取application.yml的值 - 例子

  1. # 新建个 Test2Controller.java 然后添加一个方法
  2. # 代码如下:
  4. package com.example.demo.controller;
  6. import org.springframework.beans.factory.annotation.Value;
  7. import org.springframework.stereotype.Controller;
  8. import org.springframework.web.bind.annotation.RequestMapping;
  9. import org.springframework.web.bind.annotation.ResponseBody;
  11. @Controller
  12. public class Test2Controller {
  13.     // 获取某个配置文件的值-测试
  14.     @Value("${spring.datasource.username}")
  15.     private String dbusername;
  17.     // 方法直接返回字符串-测试
  18.     @RequestMapping("/test2")
  19.     @ResponseBody
  20.     public String test() {
  21.         return dbusername;
  22.     }
  23. }

image.png

0x03.3 页面赋值 - 例子

  1. # 新建个 Test3Controller.java 然后添加一个方法
  2. # 代码如下:
  3. package com.example.demo.controller;
  5. import org.springframework.stereotype.Controller;
  6. import org.springframework.ui.Model;
  7. import org.springframework.web.bind.annotation.RequestMapping;
  9. @Controller
  10. public class Test3Controller {
  11.     // 页面赋值-测试
  12.     @RequestMapping("/test3")
  13.     public String test(Model model) {
  14.         model.addAttribute("name", "小明");
  15.         model.addAttribute("age", 24);
  16.         model.addAttribute("info", "我是一个爱打机的青年");
  17.         return "test3";
  18.     }
  19. }
  1. # 接着在resources 里面的 templates文件下新建 test3.html页面
  2. # 用来接收赋值
  3. # 代码如下:
  4. <!DOCTYPE html>
  5. <html>
  6. <head>
  7.     <meta charset="UTF-8">
  8.     <title>test3</title>
  9. </head>
  10. <body>
  11. 姓名：<input type="text" th:value="${name}"><br/>
  12. 年龄：<input type="text" th:value="${age}"><br/>
  13. 简介：<input type="text" th:value="${info}"><br/>
  14. </body>
  15. </html>

image.png
image.png

0x04 其它例子: 登录功能

0x04.1 生成Bean实体类

  1. # 依据 user数据表，生成set和get方法
  2. # bean 目录创建个 UserBean.java
  3. # 注意: 在application配置文件中mybatis:type-aliases-package:(对应的就是该文件地址)
  5. package com.example.demo.bean;
  7. public class UserBean {
  8.     private int id;
  9.     private String username;
  10.     private String password;
  12.     public int getId() {
  13.         return this.id;
  14.     }
  16.     public void setId(int id) {
  17.         this.id = id;
  18.     }
  20.     public String getUsername() {
  21.         return this.username;
  22.     }
  24.     public void setUsername(String username) {
  25.         this.username = username;
  26.     }
  28.     public String getPassword() {
  29.         return this.password;
  30.     }
  32.     public void setPassword(String password) {
  33.         this.password = password;
  34.     }
  35. }

0x04.2 Mapper层-生成数据库接口

  1. # mapper 目录创建个 UserMapper.java
  3. package com.example.demo.mapper;
  5. import com.example.demo.bean.UserBean;
  6. import org.apache.ibatis.annotations.Mapper;
  8. @Mapper
  9. public interface UserMapper {
  10.     UserBean getInfo(String username, String password);
  11. }

0x04.3 Mapper层-生成数据库实现文件

  1. # resources目录下面的 mapper 目录里 创建一个文件叫做 UserMapper.xml
  2. # 注意: 在application配置文件中mybatis:mapper-locations:(对应的就是该文件地址)
  3. # mybatis:mapper-locations == 指定sql映射文件位置，resources目录mapper下的所有.xml文件都是映射文件
  4. # 注意namespace 与 resultType 要填写对应好,不然会爆绑定失败
  7. <?xml version="1.0" encoding="utf-8" ?>
  8. <!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd" >
  9. <mapper namespace="com.example.demo.mapper.UserMapper">
  11.     <select id="getInfo" parameterType="String" resultType="com.example.demo.bean.UserBean">
  12.         SELECT * FROM user WHERE username = #{username} AND password = #{password}
  13.     </select>
  15. </mapper>

0x04.4 Service层-生成业务接口

  1. # service 目录创建个 UserService.java
  3. package com.example.demo.service;
  5. import com.example.demo.bean.UserBean;
  7. public interface UserService {
  8.     UserBean loginIn(String username,String password);
  9. }

0x04.5 Service层-生成业务实现接口

  1. # serviceImpl 目录创建个 UserServiceImpl.java
  3. package com.example.demo.serviceImpl;
  5. import com.example.demo.bean.UserBean;
  6. import com.example.demo.mapper.UserMapper;
  7. import com.example.demo.service.UserService;
  8. import org.springframework.beans.factory.annotation.Autowired;
  9. import org.springframework.stereotype.Service;
  11. @Service
  12. public class UserServiceImpl implements UserService {
  13.     @Autowired
  14.     private UserMapper userMapper;
  16.     @Override
  17.     public UserBean loginIn(String username, String password) {
  18.         return userMapper.getInfo(username,password);
  19.     }
  20. }

0x04.6 项目启动类添加@MapperScan注解

  1. # src.main.java.com.example.demo 这个根目录下的 DemoApplication.java 文件
  2. # 修改为如下:
  4. package com.example.demo;
  6. import org.mybatis.spring.annotation.MapperScan;
  7. import org.springframework.boot.SpringApplication;
  8. import org.springframework.boot.autoconfigure.SpringBootApplication;
  10. @SpringBootApplication
  11. @MapperScan("com.example.demo.mapper")
  12. public class DemoApplication {
  14.     public static void main(String[] args) {
  15.         SpringApplication.run(DemoApplication.class, args);
  16.     }
  18. }

0x04.7 编写单元测试类

image.png

  1. # 编写一个单元测试类,查询看看是否可以调用刚刚写的方法,从数据库获取数据
  2. # DemoApplicationTests.java 文件 
  3. # 源码如下: 
  5. package com.example.demo;
  7. import com.example.demo.bean.UserBean;
  8. import com.example.demo.service.UserService;
  9. import org.junit.jupiter.api.Test;
  10. import org.springframework.beans.factory.annotation.Autowired;
  11. import org.springframework.boot.test.context.SpringBootTest;
  13. @SpringBootTest
  14. class DemoApplicationTests {
  16.     @Autowired
  17.     UserService userService;
  19.     @Test
  20.     public void contextLoads() {
  21.         UserBean userBean = userService.loginIn("admin","admin123");
  22.         if (userBean != null) {
  23.             System.out.println("该用户输入账号为: " + userBean.getUsername());
  24.             System.out.println("该用户输入密码为: " + userBean.getPassword());
  25.             System.out.println("返回的用户ID为: " + userBean.getId());
  26.         } else {
  27.             System.out.println("账号或是密码错误!");
  28.             System.out.println("查询不到该用户");
  29.         }
  30.     }
  32. }

image.png
image.png
image.png

0x04.8 Controller层-生成对应的业务接口

  1. # controller 目录创建个 PublicController.java
  3. package com.example.demo.controller;
  5. import com.example.demo.bean.UserBean;
  6. import com.example.demo.service.UserService;
  7. import org.springframework.beans.factory.annotation.Autowired;
  8. import org.springframework.stereotype.Controller;
  9. import org.springframework.web.bind.annotation.RequestMapping;
  10. import org.springframework.web.bind.annotation.RequestMethod;
  11. import org.springframework.web.bind.annotation.ResponseBody;
  13. @Controller
  14. public class PublicController {
  16.     // 将Service注入Web层
  17.     @Autowired
  18.     UserService userService;
  20.     @RequestMapping("/public/login")
  21.     public String login() {
  22.         return "login";
  23.     }
  25.     @RequestMapping(value = "/password/login", method = RequestMethod.POST)
  26.     @ResponseBody
  27.     public String passwordLogin(String username, String password) {
  28.         UserBean userBean = userService.loginIn(username, password);
  29.         if (userBean != null) {
  30.             return "login_success";
  31.         } else {
  32.             return "login_error";
  33.         }
  34.     }
  35. }

0x04.9 创建登录界面

  1. # 在resources 里面的 templates文件下新建login.html页面
  2. # login.html 源码
  4. <!DOCTYPE html>
  5. <html lang="en">
  6.     <head>
  7.         <meta charset="UTF-8">
  8.         <title>login</title>
  9.     </head>
  10.     <body>
  11.         <form role="form" action = "/password/login" method="post">
  12.             账号：<input type="text" id="username" name = "username"> <br>
  13.             密码：<input type="password" id = "password" name = "password"> <br>
  14.             <input type="submit" id = "login" value = "login">
  15.         </form>
  16.     </body>
  17. </html>

image.png

0x04.10 启动测试

image.png

打开：http://127.0.0.1:8081/public/login
image.png

账号: admin
密码: admin123
image.png

0x05 项目源码

SpringBootDemo.zip