springboot---建一个web项目

搭建过程

1. File->new->project

2. 选择“Spring Initializr”，jdk选择8最好，或者默认

3. 完善项目信息

组名可不做修改，项目名可做修改；最终建的项目名为：test，src->main->java下包名会是：com->example->test；点击next；
在这里插入图片描述

4. Web下勾选Spring Web Start

网上创建springboot项目多是勾选Web选项，而较高版本的Springboot没有此选项，勾选Spring Web Start即可，2.1.8版本是Spring Web；Template Englines勾选Thymeleaf；SQL勾选：MySQL Driver，JDBC API 和 MyBatis Framework三项；点击next；
在这里插入图片描述

5. 项目目录结构

在这里插入图片描述

6. maven配置

在这里插入图片描述

7. 重新导入依赖

配置完后，如果没有自动导包，可以点击左上角重新导包按钮，或者呢个下载按钮，选择下载所有源文件和文档
在这里插入图片描述

8. 前端界面

在templates文件下新建index.html页面，作为启动的初始页面；
在这里插入图片描述

<!DOCTYPE html>
<html lang="en">
<head><meta charset="UTF-8"><title>hello</title>
</head>
<body>你好！初学者，我是SpringBoot的简单启动页面！
</body>
</html>

9. Controller层

在com.example.test下新建controller文件夹，在controller文件夹下建一个简单的helloController类；（Controller类要添加@Controller注解，项目启动时，SpringBoot会自动扫描加载Controller）
Controller会加载一个jsp界面，RestController会返回一个requsetbody
在这里插入图片描述

10. 配置文件

在resources文件夹下application中先配置DataSource基本信息，application文件有两种文件格式，一种是以.properties为后缀，一种是以.yml或者.yaml为后缀的，两种配置方式略有差别，建议后者，更为流行和方便。在这我是用.yml后缀的文件格式。右键application文件选择Refact，选择Rename，将后缀改为yml；
在这里插入图片描述

11. 启动项目

在这里插入图片描述
可以发现上面有一个WARN警告，那是因为还没有配置编写MyBatis的相关文件，下面会进行详解；

2019-08-02 09:14:27.473  WARN 9120 --- [           main] o.m.s.mapper.ClassPathMapperScanner      : No MyBatis mapper was found in '[com.example.test]' package. Please check your configuration.

其实就是缺少一个注解，@MapperScan，指定mybatis需要的mapper类

12. 访问

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

13. idea直接连接数据库

一般来说还是使用navicat，术业有专攻，idea展示不是很友好
idea连接如下，点击右侧的Database，点“加号”，新建数据库链接；
在这里插入图片描述

若是连接失败，可以更换驱动

14. 目录结构

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前端的交互。

依照上面四层，创建目录结构如下：
在这里插入图片描述

15. 配置文件代码

在application配置文件中添加MyBatis配置：

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

pom.xml文件

<?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>5.1.41</version><scope>runtime</scope></dependency><!--单元测试配置--><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-test</artifactId><scope>test</scope></dependency></dependencies><build><plugins><plugin><groupId>org.springframework.boot</groupId><artifactId>spring-boot-maven-plugin</artifactId></plugin></plugins></build></project>

16. bean层代码

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;}
}

可以使用lombok的注解，@Data，可以省略getset tostring等方法

17. dao层代码

mapper文件

package com.example.test.mapper;import com.example.test.bean.UserBean;@Mapper
public interface UserMapper {UserBean getInfo(String name,String password);}

xml文件

DAO层访问数据库实现文件（需在resource包下创建mapper文件夹，然后再创建一个UserMapper.xml.在application配置文件中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.test.mapper.UserMapper"><select id="getInfo" parameterType="String" resultType="com.example.test.bean.UserBean">SELECT * FROM user WHERE name = #{name} AND password = #{password}</select></mapper>

18. Service层代码

interface类：业务接口类编写

package com.example.test.service;import com.example.test.bean.UserBean;public interface UserService {UserBean loginIn(String name,String password);}

impl类：实现类编写，注意要注解@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层@Autowiredprivate UserMapper userMapper;@Overridepublic UserBean loginIn(String name, String password) {return userMapper.getInfo(name,password);}
}

19. 启动类代码

项目启动类要添加注解@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(TestApplication.class, args);}}

20. 测试类代码

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 {@AutowiredUserService userService;@Testpublic void contextLoads() {UserBean userBean = userService.loginIn("a","a");System.out.println("该用户ID为：");System.out.println(userBean.getId());}}

21. controller层代码

注意添加@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层@AutowiredUserService userService;@RequestMapping("/login")public String show(){return "login";}@RequestMapping(value = "/loginIn",method = RequestMethod.POST)public String login(String name,String password){UserBean userBean = userService.loginIn(name,password);if(userBean!=null){return "success";}else {return "error";}}
}

22. 前端代码

<!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="name" name = "name"> <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>

23. 进行测试

先运行测试类，看是否成功获取数据库信息：
在这里插入图片描述

24. 查漏补缺

发现一条警告信息，是数据库连接的jar包问题

2019-08-02 11:25:04.150  WARN 16868 --- [           main] com.zaxxer.hikari.util.DriverDataSource  : Registered driver with driverClassName=com.mysql.jdbc.Driver was not found, trying direct instantiation.

打开pom.xml文件，发现配置文件中未指定数据库连接的jar包的版本号，用version标签引入

在这里插入图片描述
重新运行TestApplication.java文件，启动项目，无任何WARN警告信息，进入浏览器输入localhost:8080/login

常见错误

1. 启动报错：Error starting ApplicationContext. To display the conditions report re-run your application with ‘debug’ enabled.

Error starting ApplicationContext. To display the conditions report re-run your application with 'debug' enabled.
在这里插入图片描述

2. mapper.xml文件数据库字段报红

在这里插入图片描述
打开右侧DataBase。发现数据库下全是编码格式的排序风格

右键数据库，选择Database Tools——>Manager Show Schemas

勾选Current Schema，刷新即可

3. 项目正常启动，访问默认index页面时404

在这里插入图片描述

4. 链接MySQL数据库报错：java.sql.SQLException: The server time zone value ‘�й��׼ʱ��’ is unrecognized or represents more than one time zone. You must configure either the server or JDBC driver (via the serverTimezone configuration property) to use a more specifc time zone value if you want to utilize time zone support.

这就是时区报错
在这里插入图片描述
在连接数据库的配置文件中，在URL后加上

?useUnicode=true&useJDBCCompliantTimezoneShift=true&useLegacyDatetimeCode=false&serverTimezone=UTC

application.yml文件中MySQL配置：

spring:datasource:name: test  #数据库名url: jdbc:mysql://localhost:3306/test?useUnicode=true&useJDBCCompliantTimezoneShift=true&useLegacyDatetimeCode=false&serverTimezone=UTC #urlusername: root  #用户名password: 123456  #密码driver-class-name: com.mysql.jdbc.Driver  #数据库链接驱动

5. 中文用户名登录失败，无报错信息

在这里插入图片描述

错误排查解决：
在Controller层打断点运行，发现前台传入后台的值是正常的，说明前台传值解析正常，说明可能是service层或者DAO层的问题
单元测试测试后台service代码，传入中文账号和对应密码发现获取不到对应bean，而查询所有bean时是可以获取到中文账号信息，这说明中文在传入数据库的时候乱码，所以查不到对应用户信息。

.解决问题：连接数据的配置文件中，在URL后添加UTF-8编码格式：?useUnicode=true&characterEncoding=UTF-8

spring:datasource:name: test  #数据库名url: jdbc:mysql://localhost:3306/test?useUnicode=true&characterEncoding=UTF-8 #urlusername: root  #用户名password: 123456  #密码driver-class-name: com.mysql.jdbc.Driver  #数据库链接驱动

修改后运行正常

参考资料

搭建一个springboot项目：
https://blog.csdn.net/baidu_39298625/article/details/98102453
基于springboot采用Dubbo+zookeeper+Redis搭建微服务项目：https://blog.csdn.net/baidu_39298625/article/details/108330298