胖虎的工具箱-编程导航 胖虎的工具箱-编程导航

springboot---建一个web项目

2年前 (2022) 程序员胖胖胖虎阿
288 0 0

搭建过程

1. File->new->project

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

3. 完善项目信息

组名可不做修改，项目名可做修改；最终建的项目名为：test，src->main->java下包名会是：com->example->test；点击next；
springboot---建一个web项目

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；
springboot---建一个web项目

5. 项目目录结构

springboot---建一个web项目

6. maven配置

springboot---建一个web项目
springboot---建一个web项目

7. 重新导入依赖

配置完后，如果没有自动导包，可以点击左上角重新导包按钮，或者呢个下载按钮，选择下载所有源文件和文档
springboot---建一个web项目

8. 前端界面

在templates文件下新建index.html页面，作为启动的初始页面；
springboot---建一个web项目

<!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
springboot---建一个web项目

10. 配置文件

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

11. 启动项目

springboot---建一个web项目
可以发现上面有一个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界面；到这项目的初步搭建已经完成，下面可以下一些简单的业务逻辑，比如从数据库获取信息，登录之类的简单功能；
springboot---建一个web项目

13. idea直接连接数据库

一般来说还是使用navicat，术业有专攻，idea展示不是很友好
idea连接如下，点击右侧的Database，点“加号”，新建数据库链接；
springboot---建一个web项目
springboot---建一个web项目
若是连接失败，可以更换驱动
springboot---建一个web项目
springboot---建一个web项目

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

依照上面四层，创建目录结构如下：
springboot---建一个web项目

15. 配置文件代码

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

spring:
  datasource:
    name: test  #数据库名
    url: jdbc:mysql://localhost:3306/test #url
    username: 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层
    @Autowired
    private UserMapper userMapper;
 
    @Override
    public 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 {
 
    @Autowired
    UserService userService;
 
    @Test
    public 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层
    @Autowired
    UserService 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. 前端代码

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="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. 进行测试

先运行测试类，看是否成功获取数据库信息：
springboot---建一个web项目

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标签引入

springboot---建一个web项目
重新运行TestApplication.java文件，启动项目，无任何WARN警告信息，进入浏览器输入localhost:8080/login
springboot---建一个web项目

常见错误

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

springboot---建一个web项目
springboot---建一个web项目
springboot---建一个web项目
springboot---建一个web项目

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

springboot---建一个web项目
打开右侧DataBase。发现数据库下全是编码格式的排序风格
springboot---建一个web项目
右键数据库，选择Database Tools——>Manager Show Schemas
springboot---建一个web项目
勾选Current Schema，刷新即可
springboot---建一个web项目
springboot---建一个web项目

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

springboot---建一个web项目

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.

这就是时区报错
springboot---建一个web项目
在连接数据库的配置文件中，在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 #url
    username: root  #用户名
    password: 123456  #密码
    driver-class-name: com.mysql.jdbc.Driver  #数据库链接驱动

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

springboot---建一个web项目

  1. 错误排查解决：
    在Controller层打断点运行，发现前台传入后台的值是正常的，说明前台传值解析正常，说明可能是service层或者DAO层的问题
    springboot---建一个web项目
  2. 单元测试测试后台service代码，传入中文账号和对应密码发现获取不到对应bean，而查询所有bean时是可以获取到中文账号信息，这说明中文在传入数据库的时候乱码，所以查不到对应用户信息。
    springboot---建一个web项目
  3. .解决问题：连接数据的配置文件中，在URL后添加UTF-8编码格式：?useUnicode=true&characterEncoding=UTF-8 
    spring:
  datasource:
    name: test  #数据库名
    url: jdbc:mysql://localhost:3306/test?useUnicode=true&characterEncoding=UTF-8 #url
    username: root  #用户名
    password: 123456  #密码
    driver-class-name: com.mysql.jdbc.Driver  #数据库链接驱动
  4. 修改后运行正常
    springboot---建一个web项目

参考资料

  1. 搭建一个springboot项目：
    https://blog.csdn.net/baidu_39298625/article/details/98102453
  2. 基于springboot采用Dubbo+zookeeper+Redis搭建微服务项目：https://blog.csdn.net/baidu_39298625/article/details/108330298
版权声明：程序员胖胖胖虎阿 发表于 2022年9月22日 下午8:08。
转载请注明：springboot---建一个web项目 | 胖虎的工具箱-编程导航

相关文章

IDEA2022.2 破解教程(IntelliJ IDEA专业版激活破解教程,永久有效)
程序员胖胖胖虎阿
137
DECIMAL 数据处理原理浅析
程序员胖胖胖虎阿
337
IDEA正版破解码(IntelliJ IDEA2022激活码,全年更新)
程序员胖胖胖虎阿
268
Java岗大厂面试百日冲刺【Day52】— 数据库8 （日积月累，每日三题）
程序员胖胖胖虎阿
344
【Vegas原创】SQL case when 用法
程序员胖胖胖虎阿
190
如何应对ITSM难题，打造现代化、高效的ITSM解决方案？
程序员胖胖胖虎阿
226

暂无评论

暂无评论...
致力于称为最好的程序员导航网站

友链申请 免责声明 关于我们

Copyright © 2022  胖虎的工具箱-编程导航   陇ICP备2022001249号