SpringBoot项目实战，附源码

左手的ㄟ右手 2022-10-17 10:55 255阅读 0赞

## SpringBoot2.0笔记 ##

（一）[SpringBoot基本操作——环境搭建及项目][SpringBoot][创建][SpringBoot][（有demo）][SpringBoot]

（二）[SpringBoot基本操作——使用IDEA打war包发布及测试][SpringBoot_IDEA_war]

（三）[SpringBoot基本操作——SpringBoot整合SpringDataJpa（有demo）][SpringBoot_SpringBoot_SpringDataJpa_demo]

（四）[SpringBoot基本操作——SpringBoot使用RedisTemplate整合Redis（有demo）][SpringBoot_SpringBoot_RedisTemplate_Redis_demo]

（五）[SpringBoot基本操作——SpringBoot使用Jedis整合Redis（有demo）][SpringBoot_SpringBoot_Jedis_Redis_demo]

（六）[SpringBoot基本操作——SpringBoot使用Junit4单元测试（有demo）][SpringBoot_SpringBoot_Junit4_demo]

（七）[SpringBoot基本操作——SpringBoot整合Shiro权限管理（完整demo+界面）][SpringBoot_SpringBoot_Shiro_demo]

本文使用idea工具构建Springboot2.0+SpringMvc+Thymeleaf+SpringDataJPA+MySql+Redis项目

GitHub地址：[https://github.com/jwwam/springbootDemo.git][https_github.com_jwwam_springbootDemo.git]

此demo可直接下载运行，以下为具体创建项目过程步骤说明和遇到问题解决方法。

### 一、构建SpringBoot项目 ###

1.使用idea创建Springboot项目，选择SpringInitializr选好jdk版本点击下一步

![70][]

2.填写项目包名及java版本

![70 1][]

3.勾选你需要的项目组件，Springboot版本我使用2.0

Lombok可以简化代码量，提供注解方式代替重复性代码，非必须，用不用看情况，有时候很方便，新手不建议用

![70 2][]4.创建web项目所以勾选Web

![70 3][]

5.模板语言勾选Thymeleaf，这个没得说，springboot官方推荐，确实很好用，当然是指3.0版本，老版本性能有短板

![70 4][]

6.数据库持久化推荐使用JPA方式，MySQL看情况选择

![70 5][]

7.Nosql我这里使用Redis，看你需要，可不勾选，后续需要时再引入

![70 6][]

8.MQ可根据自己情况选择，我这里不需要，最后I/O需要一个发邮件的服务，不用的话也不需要勾选，可后续再引入

![70 7][]

9.下一步填写项目文件名称

![70 8][]

10.Finish后进入项目，然后漫长的等待一段时间后项目会构建完成

![70 9][]

### 二、启动SpringBoot项目 ###

1.项目加载完毕之后打开启动器DemoApplication右键run可直接启动项目，或者右上方直接启动DemoApplication

![70 10][]

2.不出意外的话可以直接启动不会报错，没啥好说的，我列一下可能会出现的问题，这些**问题基本都是由于前面勾选项目组件（即jpa,mysql等）时引入了需要启动注入的一些依赖或数据源缺失引起的**，**和Springboot版本也有很大的关系**，以下报错不一定会出现。

**（1）启动报错：Failed to configure a DataSource: 'url' attribute is not specified and no embedd**

问题原因：新项目未做相关数据源配置, 启动springboot找不到配置引起

**解决办法（选一即可）：**

① 启动类DemoApplication加入注解@SpringBootApplication(exclude = DataSourceAutoConfiguration.class)

禁止自动加载数据源配置

② 手动添加数据源，在application.properties加入以下配置：

#数据源
    spring.datasource.url=jdbc:mysql://localhost:3306/demo_test?useUnicode=true&zeroDateTimeBehavior=convertToNull&autoReconnect=true
    spring.datasource.username=root
    spring.datasource.password=1234
    spring.datasource.driver-class-name=com.mysql.jdbc.Driver

**（2）启动报错：At least one JPA metamodel must be present!**

问题原因：Springboot自动加载持久化bean，即自动加载jpa的bean造成

**解决办法（选一即可）**：

① 启动类DemoApplication加上以下注解

@EnableAutoConfiguration(exclude={ 
       JpaRepositoriesAutoConfiguration.class //禁止springboot自动加载持久化bean
    })

② pom加入或更改jpa启动包，按照以下格式

<dependency>
       <groupId>org.springframework.boot</groupId>
       <artifactId>spring-boot-starter-data-jpa</artifactId>
       <exclusions>
          <exclusion>
             <groupId>org.hibernate</groupId>
             <artifactId>hibernate-entitymanager</artifactId>
          </exclusion>
          <exclusion>
             <groupId>org.hibernate</groupId>
             <artifactId>hibernate-core</artifactId>
          </exclusion>
       </exclusions>
    </dependency>
    <dependency>
       <groupId>org.hibernate</groupId>
       <artifactId>hibernate-core</artifactId>
       <version>5.2.10.Final</version>
    </dependency>

pom重新导入就好了，启动项目也不再报错。

![70 11][]

### 三、Hello World页面显示及Json数据回传 ###

1.增加一个测试控制层和页面，添加测试类FirstController.java

package com.springboot.demo.controller;
     
    import org.springframework.stereotype.Controller;
    import org.springframework.web.bind.annotation.RequestMapping;
     
    import javax.servlet.http.HttpServletRequest;
     
    /** * @ClassName: FirstController * @Auther: zhangyingqi * @Date: 2018/8/23 17:53 * @Description: 测试页面跳转 */
    @Controller
    @RequestMapping(value="/first")
    public class FirstController { 
     
        @RequestMapping(value="/view")
        public String view(HttpServletRequest request){ 
            return "/demoPage/firstPage";
        }
    }

2.添加测试页面 firstPage.html

<!DOCTYPE html>
    <html lang="zh-CN" xmlns:th="http://www.thymeleaf.org">
    <head>
    <title>Hello</title>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
    </head>
    <body>
       <div>Hello World!</div>
    </body>
    </html>

3.目录结构

![70 12][]

4.到这里启动后就能访问到测试页面了，后面我需要加入统一日志和统一返回格式处理，都是在真实开发环境下必须的，所以我也列出来

在com.springboot.demo.base.controller包下新建BaseController.java，用来提供日志接口以及返回model的固定参数格式

package com.springboot.demo.base.controller;
     
    import com.springboot.demo.base.utils.StateParameter;
    import org.slf4j.Logger;
    import org.slf4j.LoggerFactory;
    import org.springframework.ui.ModelMap;
     
    public abstract class BaseController{ 
     
       protected final String success = StateParameter.SUCCESS;
       protected final String  fail = StateParameter.FAULT;
     
       protected final Logger logger = LoggerFactory.getLogger(this.getClass());
     
       public ModelMap getModelMap(String status,Object data,String msg){ 
          ModelMap modelMap=new ModelMap();
          modelMap.put("status", status);
          modelMap.put("data", data);
          modelMap.put("msg", msg);
          return modelMap;
          
       }
     
    }

在com.springboot.demo.base.utils包下新建StateParameter.java

package com.springboot.demo.base.utils;
     
    public class StateParameter { 
       public final static String SUCCESS="1";
       public final  static String  FAULT="0";
       public final static String DATA="data";
       public final static String STATE="state";
       
    }

目录结构如图：

![70 13][]

5.添加简单日志记录，修改控制层代码，加入logger日志记录，添加back方法返回json数据，返回getModelMap传入状态值一般页面js接收用来判断操作成功或失败，data参数下方为null，一般传入想返回的数据内容如对象等，最后一个参数msg为提示信息。

@Controller
    @RequestMapping(value="/first")
    public class FirstController extends BaseController{ 
     
        @RequestMapping(value="/view")
        public String view(HttpServletRequest request){ 
            logger.info("进入测试页面");
            return "/demoPage/firstPage";
        }
     
        @RequestMapping(value="/back", method = RequestMethod.POST)
        @ResponseBody
        public ModelMap back(HttpServletRequest request){ 
            logger.info("进入json测试页面");
            return getModelMap(StateParameter.SUCCESS, null, "请求成功");
        }
     
    }

打开浏览器输入：localhost:8080/first/view 测试页面正常跳转

![70 14][]

打开RESTClient浏览器插件测试json数据返回正常（如没有插件可更改请求为get接收，直接在浏览器请求back路径即可返回json数据），输入 http://localhost:8080/first/back 返回我们设定的 msg：请求成功

![70 15][]

查看控制台输出日志，关于Springboot项目结合AOP和logback日志持久化入库可以[查看][Link 1]我的这篇文章。

![70 16][]

全文完，2018/8/23

写博文不易，转载请注明出处。

[SpringBoot]: https://blog.csdn.net/zhulier1124/article/details/81988471
[SpringBoot_IDEA_war]: https://blog.csdn.net/zhulier1124/article/details/82012829
[SpringBoot_SpringBoot_SpringDataJpa_demo]: https://blog.csdn.net/zhulier1124/article/details/82121461
[SpringBoot_SpringBoot_RedisTemplate_Redis_demo]: https://blog.csdn.net/zhulier1124/article/details/82154937
[SpringBoot_SpringBoot_Jedis_Redis_demo]: https://blog.csdn.net/zhulier1124/article/details/82193182
[SpringBoot_SpringBoot_Junit4_demo]: https://blog.csdn.net/zhulier1124/article/details/82228831
[SpringBoot_SpringBoot_Shiro_demo]: https://blog.csdn.net/zhulier1124/article/details/82289736
[https_github.com_jwwam_springbootDemo.git]: https://github.com/jwwam/springbootDemo.git
[70]: /images/20221014/4261cd6ac9374dde99e9c7d979af3d60.png
[70 1]: /images/20221014/c36f5a7bd27944d8928609026f4edace.png
[70 2]: /images/20221014/7992179c1fc442b8be14b1f465a4c5a5.png
[70 3]: /images/20221014/1aa1aac25dea4647b5244e3b4cae26d5.png
[70 4]: /images/20221014/2d3feb5f190b48fb977f6171aafa8b1f.png
[70 5]: /images/20221014/e719549baba440c8a0372f28a999f3ca.png
[70 6]: /images/20221014/34f93b74d33747c5b04dfd6b5802c5e4.png
[70 7]: /images/20221014/a7649d0fe8ed4a90b3e91d6ad0abdc9a.png
[70 8]: /images/20221014/a3e22d737b9a4f9f83634922bfe414ab.png
[70 9]: /images/20221014/1cca959a42b44c4e9e4915c9db8b7a68.png
[70 10]: /images/20221014/502ee2bb65634dceb71acd506bc52293.png
[70 11]: /images/20221014/ca10d1e001fb4792a4896bf5e47859d3.png
[70 12]: /images/20221014/58af17743dbd4d109686a2ebdbf22de3.png
[70 13]: /images/20221014/3d5198ce934347ca95615c776aa83564.png
[70 14]: /images/20221014/53464e2c1a4b4e9db5a0e785c94f6882.png
[70 15]: /images/20221014/61f63cbcb50149899fc368135104f5ae.png
[Link 1]: https://blog.csdn.net/zhulier1124/article/details/81235369
[70 16]: /images/20221014/2a536ff2b6064b22947fbd81386f4011.png