使用IDEA搭建一个简单的Spring Boot项目

前言 

鉴于IDEA版本的不断更新，使用先前博主们的项目搭建方案时，经常会出现与当前版本不兼容的情况而导致运行失败，因此写下这篇博客帮助Spring Boot初学者们搭建开发环境。

前置准备：

1. 开发软件：Intellij IDEA 2021.1 x64、mysql 8.0、maven-3.8.1
2. 开发工具包：JDK1.8（已配置好开发环境）

一、创建项目

（博主已使用汉化插件，如有需要可通过File->Settings->Plugins，在搜索框中输入chinese，下载相应汉化插件后重启即可）

1.文件->新建->项目

2.选择Spring Initializr->输入项目名称->选择存放位置(手动输入项目名)->选择Java8->点击下一步

3.添加依赖，在Web下勾选Spring Web，在Template Engines下勾选Thymeleaf，在SQL下勾选JDBC API，MyBatis Framework，点击完成。（如果在这一步忘记勾选，可以在后面的pom.xml文件中手动添加依赖）

 4.刚建好的项目目录结构

 二、配置Maven仓库

 1.点击右侧的Maven，点击设置（扳手图标），选择Maven设置

 2.选择本地Maven路径，勾选配置文件后边的单选框，修改为本地Maven的配置文件。

3. 配置完后，如果没有自动导包，可以点击左上角重新导包按钮，或者点击下载按钮，选择下载所有源文件和文档。

 

 三、配置数据库文件

（需要提前创建数据库及数据库表） 

1.将resources文件夹下的application.properties重命名为application.yml（如果对properties有所了解也可以根据properties配置），在application配置文件中添加配置（需要根据自己的数据库信息更改数据库名、密码）：

spring:
  datasource:
    name: demo  #数据库名
    url: jdbc:mysql://localhost:3306/demo #url
    username: root  #用户名
    password: 123456  #密码
    driver-class-name: com.mysql.cj.jdbc.Driver  #数据库链接驱动
mybatis:
  mapper-locations: classpath:mapper/*.xml  #配置映射文件
  type-aliases-package: com.example.test.bean #配置实体类

2.点击右侧的数据库，点击“+”新建数据库链接，选择数据源，选择Mysql

 3.填写数据库相关信息后，点击测试连接

4.测试连接成功，点击确定

 5.连接成功，显示数据库信息（如果连接成功但没有显示数据库信息，可以选择数据源信息，即下图带扳手的图标，点击架构，选择连接的数据库名，点击确定即可）

 四、实现项目

 1.SpringBoot项目大概分为四层：

（1）DAO层：包括XxxMapper.java(数据库访问接口类)，XxxMapper.xml(数据库链接实现)；（这个命名，有人喜欢用Dao命名，有人喜欢用Mapper，看个人习惯了吧）

（2）Bean层：也叫model层，模型层，entity层，实体层，就是数据库表的映射实体类，存放POJO对象；

（3）Service层：也叫服务层，业务层，包括XxxService.java(业务接口类)，XxxServiceImpl.java（业务实现类）；（可以在service文件夹下新建impl文件放业务实现类，也可以把业务实现类单独放一个文件夹下，更清晰）

（4）Web层：就是Controller层，实现与web前端的交互。

依照上面四层，创建目录结构如下：

 2.Bean实体类，依据数据库表，生成set和get方法

package com.example.test.bean;

public class UserBean {
    private int id;
    private String password;

    public int getId() {
        return id;
    }

    public void setId(int id) {
        this.id = id;
    }

    public String getPassword() {
        return password;
    }

    public void setPassword(String password) {
        this.password = password;
    }
}

3.DAO层访问数据库接口编写

package com.example.test.mapper;

import com.example.test.bean.UserBean;
import org.springframework.stereotype.Component;

@Component
public interface UserMapper {

    UserBean getInfo(String id,String password);

}

4.DAO层访问数据库实现文件（需在resource包下创建mapper目录，然后再创建一个UserMapper.xml.在application配置文件中mybatis:mapper-locations:对应的就是该文件地址），注意<mapper>标签的namespace属性要填写 访问数据库接口类文件路径。

<?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 namespace="com.example.test.mapper.UserMapper">

    <select id="getInfo" parameterType="String" resultType="com.example.test.bean.UserBean">
        SELECT * FROM test WHERE id = #{id} AND password = #{password}
    </select>

</mapper>

5.Service层业务接口类编写

package com.example.test.service;

import com.example.test.bean.UserBean;

public interface UserService {

    UserBean loginIn(String id,String password);

}

6.Service层业务实现类编写

package com.example.test.serviceImpl;

import com.example.test.bean.UserBean;
import com.example.test.mapper.UserMapper;
import com.example.test.service.UserService;
import org.springframework.stereotype.Service;
import javax.annotation.Resource;

@Service
public class UserServiceImpl implements UserService {

    //将DAO注入Service层
    @Resource
    private UserMapper userMapper;

    @Override
    public UserBean loginIn(String id, String password) {
        return userMapper.getInfo(id,password);
    }
}

7.Controller层类编写

package com.example.test.controller;

import com.example.test.bean.UserBean;
import com.example.test.service.UserService;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;

import javax.annotation.Resource;

@Controller
public class LoginController {

    //将Service注入Web层
    @Resource
    UserService userService;

    @RequestMapping("/login")
    public String show(){
        return "login";
    }

    @RequestMapping(value = "/loginIn",method = RequestMethod.POST)
    public String login(String id,String password){
        UserBean userBean = userService.loginIn(id,password);
        if(userBean!=null){
            return "success";
        }else {
            return "error";
        }
    }
}

8.项目启动类编写

package com.example.test;

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


@SpringBootApplication
@MapperScan("com.example.test.mapper")
public class TestApplication {

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

}

9.在templates文件下新建html文件，作为项目的界面

login.html

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <title>login</title>
</head>
<body>
<form role="form" action = "/loginIn" method="post">
  账号：<input type="text" id="id" name = "id"> <br>
  密码：<input type="password" id = "password" name = "password"> <br>
  <input type="submit" id = "login" value = "login">
</form>

</body>
</html>

success.html

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <title>success</title>
</head>
<body>
<h1>登录成功！</h1>
</body>
</html>

error.html

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <title>error</title>
</head>
<body>
<h1>登录失败！</h1>
</body>
</html>

10.运行TestApplication.java文件，启动项目，无任何WARN警告信息，进入浏览器输入localhost:8080/login

 

 

 项目到这里就算完美结束了。