Idea20201.1 + maven 3.6.3 +jdk 8 +mysql 8.0搭建一个完整的springboot项目
1.打开IDEA点击File->new->project;
2.完善项目信息,组名可不做修改,项目名可做修改;最终建的项目名为:test,src->main->java下包名会是:com->example->test;注意Type选项是Maven,Java Version是8,我第一次搭建的时候没注意,导致后面一直出问题,点击next;
3.Web下勾选Spring Web,有些版本没有这个选项,就选择Spring Web Start;Template Englines勾选Thymeleaf;SQL勾选:MySQL Driver,JDBC API 和 MyBatisFramework三项;然后next;
4.选择项目路径,点击finish;打开新的窗口;
5.刚创建好的项目目录结构
6.点击右侧的Maven,点击设置(扳手图标)进行项目Maven仓库的配置;
7.(1)选择本地Maven路径;(2)勾选配置文件后边的选项,然后修改为本地Maven的配置文件,它会根据配置文件直接找到本地仓库位置;
9.配置完后,如果没有自动导包,可以点击左上角重新导包按钮,或者呢个下载按钮,选择下载所有源文件和文档
10.在templates文件下新建index.html页面,作为启动的初始页面;
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这个选项了
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)
在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
可以发现上面有一个WARN警告,那是因为还没有配置编写MyBatis的相关文件,下面会进行详解;
14.在浏览器中输入localhost:8080,回车显示初始的index界面;到这项目的初步搭建已经完成,下面可以下一些简单的业务逻辑,比如从数据库获取信息,登录之类的简单功能;
15.在进行下一步编写时,我们先来链接一下数据库;点击右侧的Database,点“加号”,新建数据库链接;
16.填写数据库相关信息,点击Test Connection(我自己测试连接的时候出现了以下错误);
因为时区问题报错,点击设置时区,把UTC改为GMT,然后Apply,OK
时区设置好了再回来测试连接就ok了:
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前端的交互。
依照上面四层,创建目录结构如下:
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.先运行测试类,看是否成功获取数据库信息:
22.我在运行测试类过程中还出现过
这是连接数据库的jar包版本不对,去pom.xml找到MySql的配置,把版本改成8.0.19,好像5.1.41也行,但是我没有试过,有兴趣的小伙伴可以尝试一下:
23.运行TestApplication.java文件,启动项目,无任何WARN警告信息,进入浏览器输入localhost:8080/login
本来我是找的别人的教程,但是中间出了很多问题,自己百度了很久才一一解决,过程中最多的就是因为多个插件的版本引起的问题,所以小伙伴一定要注意自己的版本哦!