Idea20201.1 + maven 3.6.3 +jdk 8 +mysql 8.0搭建一个完整的springboot项目

1.打开IDEA点击File->new->project;




idea 中添加add configuration 添加spring Boot idea添加springboot项目_Powered by 金山文档


2.完善项目信息,组名可不做修改,项目名可做修改;最终建的项目名为:test,src->main->java下包名会是:com->example->test;注意Type选项是Maven,Java Version是8,我第一次搭建的时候没注意,导致后面一直出问题,点击next;


idea 中添加add configuration 添加spring Boot idea添加springboot项目_spring boot_02


3.Web下勾选Spring Web,有些版本没有这个选项,就选择Spring Web Start;Template Englines勾选Thymeleaf;SQL勾选:MySQL Driver,JDBC API 和 MyBatisFramework三项;然后next;


idea 中添加add configuration 添加spring Boot idea添加springboot项目_Powered by 金山文档_03


4.选择项目路径,点击finish;打开新的窗口;


idea 中添加add configuration 添加spring Boot idea添加springboot项目_spring_04


idea 中添加add configuration 添加spring Boot idea添加springboot项目_java_05


5.刚创建好的项目目录结构


idea 中添加add configuration 添加spring Boot idea添加springboot项目_idea_06


6.点击右侧的Maven,点击设置(扳手图标)进行项目Maven仓库的配置;


idea 中添加add configuration 添加spring Boot idea添加springboot项目_idea_07


7.(1)选择本地Maven路径;(2)勾选配置文件后边的选项,然后修改为本地Maven的配置文件,它会根据配置文件直接找到本地仓库位置;


idea 中添加add configuration 添加spring Boot idea添加springboot项目_idea_08


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


idea 中添加add configuration 添加spring Boot idea添加springboot项目_spring boot_09


10.在templates文件下新建index.html页面,作为启动的初始页面;


idea 中添加add configuration 添加spring Boot idea添加springboot项目_spring boot_10


Index.html代码如下:

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>hello</title>
</head>
<body>
启动页面!
</body>
</html>

11.在com.example.test下新建controller文件夹,在controller文件夹下建一个简单的helloController类;(Controller类要添加@Controller注解,项目启动时,SpringBoot会自动扫描加载Controller)注意:有些朋友new选项里面没有Package,选择java文件夹右键,找到Mark Directory as 选择Sources Root,把Java文件夹标记一下,然后再右键新建Controller文件夹就有Package这个选项了


idea 中添加add configuration 添加spring Boot idea添加springboot项目_spring_11


Controller类(我的项目名称是test,所以package后面是com.example.test.controller,如果你的项目名是其他的,就把test换成你的项目名,这个是创建类的时候自动生成的,但是我怕有朋友直接整个抄过去特意说明一下,我就犯过这个低级错误):

package com.example.test.controller;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;

@Controller
public class HelloController {
    @RequestMapping("/index")
    public String sayHello(){
        return "index";
    }
}

12.在resources文件夹下application中先配置DataSource基本信息,application文件有两种文件格式,一种是以.properties为后缀,一种是以.yml为后缀的,两种配置方式略有差别,在这我是用.yml后缀的文件格式。右键application文件选择Refact,选择Rename,将后缀改为yml;(同样的注意自己的resources文件夹右下角有没有那个橘黄色小标记,没有的话自己Mark一下,选择resources root)


idea 中添加add configuration 添加spring Boot idea添加springboot项目_java_12


在application.yml中编写自己的数据库配置,我是测试随便建立了个数据库名为text

spring:
  datasource:
    name: text  #数据库名
    url: jdbc:mysql://localhost:3306/text?serverTimezone=GMT&useUnicode=true&characterEncoding=utf-8&useSSL=true
    username: root  #账户
    password: 123456  #密码
    driver-class-name: com.mysql.cj.jdbc.Driver  #链接驱动

mybatis:
  mapper-locations: classpath:mapper/*.xml  #配置映射文件

13.选择TestApplication.java,点击右键运行项目启动类TestApplication.java


idea 中添加add configuration 添加spring Boot idea添加springboot项目_spring boot_13


可以发现上面有一个WARN警告,那是因为还没有配置编写MyBatis的相关文件,下面会进行详解;


idea 中添加add configuration 添加spring Boot idea添加springboot项目_java_14


14.在浏览器中输入localhost:8080,回车显示初始的index界面;到这项目的初步搭建已经完成,下面可以下一些简单的业务逻辑,比如从数据库获取信息,登录之类的简单功能;


idea 中添加add configuration 添加spring Boot idea添加springboot项目_idea_15


15.在进行下一步编写时,我们先来链接一下数据库;点击右侧的Database,点“加号”,新建数据库链接;


idea 中添加add configuration 添加spring Boot idea添加springboot项目_spring_16


16.填写数据库相关信息,点击Test Connection(我自己测试连接的时候出现了以下错误);


idea 中添加add configuration 添加spring Boot idea添加springboot项目_java_17


因为时区问题报错,点击设置时区,把UTC改为GMT,然后Apply,OK


idea 中添加add configuration 添加spring Boot idea添加springboot项目_java_18


时区设置好了再回来测试连接就ok了:


idea 中添加add configuration 添加spring Boot idea添加springboot项目_spring_19


idea 中添加add configuration 添加spring Boot idea添加springboot项目_idea_20


19.SpringBoot项目大概分为四层:

(1)DAO层:也就是本项目中的Mapper,其间包括XxxMapper.java(数据库访问接口类),XxxMapper.xml(数据库链接实现);

(2)Bean层:也叫model层,模型层,entity层,实体层,就是数据库表的映射实体类,存放POJO对象;

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

(4)Web层:就是Controller层,实现与web前端的交互。

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


idea 中添加add configuration 添加spring Boot idea添加springboot项目_java_21


20.代码展示:

(1)在application.yml配置文件中添加MyBatis配置:

spring:
  datasource:
    name: text  #数据库名
    url: jdbc:mysql://localhost:3306/text?serverTimezone=GMT&useUnicode=true&characterEncoding=utf-8&useSSL=true
    username: root  #账户
    password: 123456  #密码
    driver-class-name: com.mysql.cj.jdbc.Driver  ##链接驱动

mybatis:
  mapper-locations: classpath:mapper/*.xml  #配置映射文件

(2)pom.xml文件配置信息(备注:这个文件有时侯没有,我之前就出现过这个问题,后来发现是我自己的idea版本和maven版本乱用导致的,所以一定要严格按照我最开始说明的版本安装配置)

<?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 http://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.1.6.RELEASE</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
    <groupId>com.example</groupId>
    <artifactId>test</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>test</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-jdbc</artifactId>
        </dependency>
        <!--thymeleaf模板引擎配置-->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-thymeleaf</artifactId>
        </dependency>
        <!--Web依赖-->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <!--MyBatis配置-->
        <dependency>
            <groupId>org.mybatis.spring.boot</groupId>
            <artifactId>mybatis-spring-boot-starter</artifactId>
            <version>2.1.0</version>
        </dependency>
        <!--MySQL数据库配置-->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>8.0.19</version>
            <scope>runtime</scope>
        </dependency>
        <!--单元测试配置-->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
        <dependency>
            <groupId>org.junit.jupiter</groupId>
            <artifactId>junit-jupiter</artifactId>
            <version>RELEASE</version>
            <scope>test</scope>
        </dependency>
    </dependencies>

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

</project>

(3)bean包下创建UserBean实体类,依据数据库表,生成set和get方法;

package com.example.test.bean;

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

    public int getId() {
        return id;
    }

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

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public String getPassword() {
        return password;
    }

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

(4)mapper(Dao)包下创建UserMapper.java访问数据库接口文件:

package com.example.test.mapper;

import com.example.test.bean.UserBean;

public interface UserMapper {

    UserBean getInfo(String name);

}

(5)Mapper(Dao)层访问数据库实现文件(在resource包下创建mapper文件夹,然后再创建一个UserMapper.xml,并在application.yml配置文件中mybatis:mapper-locations:对应的就是该文件地址),注意标签的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.versol.mapper.UserMapper">

    <select id="getInfo" parameterType="String" resultType="com.example.versol.bean.UserBean">
        SELECT * FROM usr WHERE username = #{name}
    </select>

</mapper>

(6)service包下创建UserService.java,Service层业务接口类编写:

package com.example.test.service;

import com.example.test.bean.UserBean;

public interface UserService {

    UserBean loginIn(String name);

}

(7)serviceImpl包下创建UserServiceImpl.java,Service层业务实现类编写,注意要注解@Service,注入DAO:

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.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

@Service
public class UserServiceImpl implements UserService {

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

    @Override
    public UserBean loginIn(String name) {
        return userMapper.getInfo(name);
    }
}

(8)TestApplication.java,项目启动类要添加注解@MapperScan项目启动时扫描mapper接口,否则会报错找不到mapper文件:

package com.example.test;

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

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

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

}

(9)TestApplicationTests,编写测试类,看是否能成功 访问数据库,获取数据库信息:

package com.example.test;

import com.example.test.bean.UserBean;
import com.example.test.service.UserService;
import org.junit.Test;
import org.junit.runner.RunWith;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.test.context.junit4.SpringRunner;

@RunWith(SpringRunner.class)
@SpringBootTest
public class TestApplicationTests {

    @Autowired
    UserService userService;

    @Test
    public void contextLoads() {
        UserBean userBean = userService.loginIn("admin");
        System.out.println("该用户密码为:");
        System.out.println(userBean.getPassword());
    }

}

(10)controller包下创建LoginController.java,注意添加@controller注解,注入Service服务:

package com.example.test.controller;
import com.example.test.bean.UserBean;
import com.example.test.service.UserService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;

@Controller
public class LoginController {

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

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

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



}

(11)html文件:

login.html

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>hello</title>
</head>
<body>
启动页面!
</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>

21.先运行测试类,看是否成功获取数据库信息:


idea 中添加add configuration 添加spring Boot idea添加springboot项目_spring_22


22.我在运行测试类过程中还出现过


idea 中添加add configuration 添加spring Boot idea添加springboot项目_spring_23


这是连接数据库的jar包版本不对,去pom.xml找到MySql的配置,把版本改成8.0.19,好像5.1.41也行,但是我没有试过,有兴趣的小伙伴可以尝试一下:


idea 中添加add configuration 添加spring Boot idea添加springboot项目_idea_24


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


idea 中添加add configuration 添加spring Boot idea添加springboot项目_spring boot_25


idea 中添加add configuration 添加spring Boot idea添加springboot项目_spring_26


本来我是找的别人的教程,但是中间出了很多问题,自己百度了很久才一一解决,过程中最多的就是因为多个插件的版本引起的问题,所以小伙伴一定要注意自己的版本哦!