Springboot项目搭建（前端到数据库，超详细）,大神勿进！

前段时间，有很多小伙伴私下跟我说，想搞一个项目实战。今天刚好我有空，于是，我就搞了一个从前端到后台的用户系统(demo)。用户系统基本是所有项目中都必须有的基础模块，可大可小。大的需要很大一个团队来维护，小的一个人兼职就能搞定。对于很多还未参与工作的同学来说，这个项目也可以练练手，说不定，第一份工作进去就是搞用户模块呢。

技术栈

Spring Boot 、Jpa 、Thymeleaf、HTML、Maven、MySQL。

对于技术栈，还不清楚的同学，自行查找相关资料，至少知道个大概是干啥的。

需求功能

现在需要对用户信息进行新增、列表展示、用户详情展示、信息修改、信息删除等功能。

用户信息：姓名、密码、手机号码、年龄。

数据库表

自己本地安装MySQL，并创建数据库，然后在创建一张用户表。

建表语句

 
 
 
 
  
  
  
  CREATE TABLE `user` ( 
  
  
  
    `uid` bigint NOT NULL AUTO_INCREMENT, 
  
  
  
    `uname` varchar(32) CHARACTER SET utf8 COLLATE utf8_general_ci DEFAULT NULL, 
  
  
  
    `password` varchar(6) CHARACTER SET utf8 COLLATE utf8_general_ci NOT NULL, 
  
  
  
    `tel` varchar(255) CHARACTER SET utf8 COLLATE utf8_general_ci NOT NULL, 
  
  
  
    `age` int DEFAULT NULL, 
  
  
  
    PRIMARY KEY (`uid`) 
  
  
  
  ) ENGINE=InnoDB AUTO_INCREMENT=4 DEFAULT CHARSET=utf8;

项目构建

项目整体目录

接下来，我们就一步一步，把这些代码理清楚。

整体项目采用的是

 
 
 
 
  
  
  
  html-->controller--->service--repository-->DB

这也是当前实际开发中相对比较流行的，但为了演示，我这里就就用entity实体类就搞定了。

实际开发中会有其他什么O之类的，比如说：DTO/VO/BO.....。有的项目使用的是DTO，有的可能使用的是BO等。进入项目组了，按照项目组的开发规范来就行了，实在不理解的话，建议你先学会模仿别人是怎么做的。

废话不多说，直接开干!

创建Spring Boot项目

可以使用spring官网给创建方式，地址：

https://start.spring.io/

这里也可以参考另外一篇文章：

如何快速构建Spring Boot基础项目?

maven依赖

在项目的pom.xml中添加如下配置

 
 
 
 
  
  
  
   
  
  
  
  
  
  
  
  
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> 
  
  
  
      4.0.0 
  
  
  
       
  
  
  
       
  
  
  
          org.springframework.boot 
  
  
  
          spring-boot-starter-parent 
  
  
  
          2.1.6.RELEASE 
  
  
  
       
  
  
  
       
  
  
  
      com.tian.user 
  
  
  
      spring-boot-jpa-thymeleaf 
  
  
  
      1.0-SNAPSHOT 
  
  
  
       
  
  
  
      spring-boot-jpa-thymeleaf   
  
  
  
   
  
  
  
       
  
  
  
           
  
  
  
           
  
  
  
              org.springframework.boot 
  
  
  
              spring-boot-starter-web 
  
  
  
           
  
  
  
           
  
  
  
           
  
  
  
              org.springframework.boot 
  
  
  
              spring-boot-starter-thymeleaf 
  
  
  
           
  
  
  
           
  
  
  
           
  
  
  
              org.springframework.boot 
  
  
  
              spring-boot-starter-data-jpa 
  
  
  
               
  
  
  
           
  
  
  
           
  
  
  
           
  
  
  
              mysql 
  
  
  
              mysql-connector-java 
  
  
  
           
  
  
  
       
  
  
  
   
  
  
  
       
  
  
  
           
  
  
  
               
  
  
  
                  org.springframework.boot 
  
  
  
                  spring-boot-maven-plugin 
  
  
  
                   
  
  
  
                      true

主要是SpringBoot项目parent、web、MySQL、jpa、thymeleaf依赖，这样就把相关的jar包给依赖进来了。

启动类

 
 
 
 
  
  
  
  import org.springframework.boot.SpringApplication; 
  
  
  
  import org.springframework.boot.autoconfigure.SpringBootApplication; 
  
  
  
  import org.springframework.boot.builder.SpringApplicationBuilder; 
  
  
  
  import org.springframework.boot.web.servlet.support.SpringBootServletInitializer; 
  
  
  
   
  
  
  
  /** 
  
  
  
   * @author java 后端技术全栈 
  
  
  
   * 就是一个简单的启动类 
  
  
  
   */ 
  
  
  
  @SpringBootApplication 
  
  
  
  public class Application { 
  
  
  
   
  
  
  
      public static void main(String[] args) { 
  
  
  
          SpringApplication.run(Application.class, args); 
  
  
  
      }  
  
  
  
  }

注意：此时数据库相关信息没有配置进项目里，所以，项目是启动不了的。

集成MySQL数据库

在resource目录下，创建一个application.properties文件，加入以下内容：

 
 
 
 
  
  
  
  spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver 
  
  
  
  spring.datasource.url=jdbc:mysql://localhost:3306/test?useUnicode=true&characterEncoding=UTF-8&serverTimezone=UTC 
  
  
  
  spring.datasource.username=root 
  
  
  
  spring.datasource.password=123456

注意：如果MySQL是8.0版本，必须要配置服务时区，否则会启动不了。

此时项目就可以正常启动了。

集成 Jpa

在application.properties中添加

 
 
 
 
  
  
  
  spring.jpa.properties.hibernate.hbm2dl.auto=create 
  
  
  
  spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.MySQL5InnoDBDialect 
  
  
  
  spring.jpa.show-sql=true

创建一个UserRepository

 
 
 
 
  
  
  
  package com.tian.user.repository; 
  
  
  
   
  
  
  
  import com.tian.user.entity.User; 
  
  
  
  import org.springframework.data.jpa.repository.JpaRepository; 
  
  
  
  import org.springframework.data.jpa.repository.Modifying; 
  
  
  
  import org.springframework.data.jpa.repository.Query; 
  
  
  
  import org.springframework.stereotype.Repository; 
  
  
  
   
  
  
  
  @Repository 
  
  
  
  public interface UserRepository extends JpaRepository {  
  
  
  
  }

这样jpa就集成就来了。

集成Thymeleaf

前面我们已经把jar包给以来进来了，需要在application.properties中添加

 
 
 
 
  
  
  
  spring.thymeleaf.cache=false 
  
  
  
  spring.thymeleaf.prefix=classpath:/templates/ 
  
  
  
  spring.thymeleaf.mode=.html 
  
  
  
  spring.thymeleaf.encoding=UTF-8 
  
  
  
  spring.thymeleaf.content-type=text/html

然后在resources目录下添加两个文件夹：

新增用户

在templates目录下创建index.html

创建UserService接口和UserServiceImpl实现类。

 
 
 
 
  
  
  
  public interface UserService { 
  
  
  
      void add(User user); 
  
  
  
  } 
  
  
  
  @Service 
  
  
  
  public class UserServiceImpl implements UserService { 
  
  
  
      @Resource 
  
  
  
      private UserRepository userRepository; 
  
  
  
      @Override 
  
  
  
      public void add(User user) { 
  
  
  
          userRepository.save(user); 
  
  
  
      } 
  
  
  
  }

创建UserController

 
 
 
 
  
  
  
  @Controller 
  
  
  
  public class UserController { 
  
  
  
      @Resource 
  
  
  
      private UserService userService; 
  
  
  
   
  
  
  
      @RequestMapping("/index") 
  
  
  
      public String add(Model model) { 
  
  
  
          return "index"; 
  
  
  
      } 
  
  
  
   
  
  
  
      @RequestMapping("/save") 
  
  
  
      public String save(Model model,User user) { 
  
  
  
          userService.add(user); 
  
  
  
          //跳转到用户列表 
  
  
  
          return "redirect:/userList"; 
  
  
  
      } 
  
  
  
  }

这样一个新增功能我们就做完了。这里我们顺带着把用户列表也给搞出来。

用户列表

在templates目录下创建user_list.html页面

//UserService中添加
List findAll();
//UserServiceImpl中添加方法
@Override
public List findAll() {
return userRepository.findAll();
}

@RequestMapping("/userList")
public String index(Model model) {
List users = userService.findAll();
model.addAttribute("users", users);
return "user_list";
}

好了，自此用户列表也搞定。下面我们来启动项目，然后演示一下：

用户详情
姓名：
年龄：
密码：
手机号码：

//UserService中添加方法
User findById(Long id);
//UserServiceImpl添加方法
@Override
public User findById(Long id) {
return userRepository.getOne(id);
}

@RequestMapping("/userInfo/{id}")
public String userInfo(Model model, @PathVariable("id") Long id) {
User user = userService.findById(id);
model.addAttribute("user", user);
return "user_info";
}

Index
姓名：
年龄：
密码：
手机号码：

@Repository
public interface UserRepository extends JpaRepository {
@Modifying
@Query("update User u set u.tel=?1 ,u.uname=?2 , u.password=?3 where u.uid=?4")
void updateById(String tel, String uname, String password, Long uid);
}

//UserService中添加方法
void update(User user);
//UserServiceImpl中添加方法
@Transactional
@Override
public void update(User user) {
userRepository.updateById(user.getTel(), user.getUname(), user.getPassword(), user.getUid());
}

javax.persistence.TransactionRequiredException: Executing an update/delete query
at org.hibernate.internal.AbstractSharedSessionContract.checkTransactionNeededForUpdateOperation(AbstractSharedSessionContract.java:398) ~[hibernate-core-5.3.10.Final.jar:5.3.10.Final]

@RequestMapping("/updateById")
public String updateById(Model model,User user) {
userService.update(user);
return "redirect:/userList";
}
//跳转到修改页面
@RequestMapping("/update/{id}")
public String update(Model model, @PathVariable("id") Long id) {
User user = userService.findById(id);
model.addAttribute("user", user);
return "update";
}