不废话Spring Boot（三）访问数据库

简介

在所有项目的开发过程中，访问数据库都是必不可少的环节，在Java的项目中，访问数据基本有两种方式：

1. 以Java实体类为黑心，通过实体类映射数据库表的方式，定义数据库模型，围绕实体类来对数据表进行操作，常见的解决方案有Hibernate，Spring Data JPA（其实也是以Hibernate为底层）
2. 以SQL为核心，封装一定的JDBC操作，常见的解决方案有Mybatis

在Spring Boot项目中，访问数据库都是通过Spring Data来进行封装处理的，其添加了大量的自动配置，屏蔽了很多繁杂的设置，提供了很多Template及Repository使我们访问数据库变的简单，同时，Spring Data提供了大量的模块，可以对各种形式的数据库进行访问和操作。

详细请参考：https://spring.io/projects/spring-data

JPA简介

JPA全称为Java Persistence API（Java持久层API），它是Sun公司（已被Oracle收购）在JavaEE 5中提出的Java持久化规范。它为Java开发人员提供了一种“对象-关联”映射工具来管理Java应用中的关系数据，JPA吸取了目前Java持久化技术的优点，旨在规范、简化Java对象的持久化工作。很多ORM框架都是实现了JPA的规范，比如上面提到的Hibernate。

Spring Data JPA

Spring Data JPA是一套简化的JPA开发框架，按照定义好的“方法命名规则”写DAO接口即可，可以在不写接口的情况下对数据库进行访问和操作，除了提供CRUD功能之外，也提供了如分页、排序、复杂SQL查询等功能。Spring Data JPA可以理解为对JPA规范的再次抽象、封装，底层还是使用了Hibernate对JPA的实现。简单理解，通过Spring Data JPA，我们可以不写代码就能实现对数据库的增删改查等操作。使用好JPA，最重要的还是理解其定义好的规范和约定。

表的CRUD操作

先来说一下JPA中的repository，一会要用到，它的作用就是帮助我们实现数据库的操作，一般我们的接口继承自已有的repository，由于其符合“命名规则”，所以代码里不用写其具体的操作实现即可完成对数据库的一些操作。经常用到的，比如CrudRepository，JpaRepository，MongoRepository等。

接下来我们新建一个Spring Boot项目，使用MySQL数据库，引入Spring Boot Web、JPA以及MySQL相关依赖

<?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 https://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.2.0.RELEASE</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
    <groupId>org.dothwinds</groupId>
    <artifactId>spring-boot-study</artifactId>
    <version>1.0.0</version>
    <name>study-2</name>

    <properties>
        <java.version>1.8</java.version>
    </properties>

    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter</artifactId>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>


        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-data-jpa</artifactId>
        </dependency>

        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
            <exclusions>
                <exclusion>
                    <groupId>org.junit.vintage</groupId>
                    <artifactId>junit-vintage-engine</artifactId>
                </exclusion>
            </exclusions>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>

</project>

 然后连接数据库，我们在本地MySQL新建一个库，然后在配置文件里连接数据库，配置文件内容如下：

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

spring.jpa.properties.hibernate.hbm2ddl.auto=update
spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.MySQL5InnoDBDialect
spring.jpa.show-sql=true

 

编写实体类User，标注其为实体Entity，对应数据表的结构，并且主键id为自动生成，name不能为空不能重复，其它类型参考API

package org.dothwinds.springbootstudy.model;

import javax.persistence.Column;
import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.Id;
import java.io.Serializable;

@Entity
public class User implements Serializable {
    @Id
    @GeneratedValue
    private Long id;

    @Column(nullable = false, unique = false)
    private String name;

    private String company;
    private String addr;
}

接下来我们自定义一个数据访问接口，实现自JpaRepository就可以拥有一些基本的数据库操作功能了，不用写任何代码。

package com.arbboter.demolibrary.Dao;

import com.arbboter.demolibrary.Domain.Book;
import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.stereotype.Repository;

@Repository
public interface BookJpaRepository extends JpaRepository<Book, Integer> {
}

我们编写一个Controller，传个名字参数，实现往数据库里插入一条数据的功能

package org.dothwinds.springbootstudy.controller;

import org.dothwinds.springbootstudy.dao.UserRepository;
import org.dothwinds.springbootstudy.model.User;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class UserController {

    @Autowired
    private UserRepository userRepository;

    @GetMapping(value = "/addUser")
    public String addUser(@RequestParam(value = "name") String name){
        User user = new User();
        user.setName(name);
        user.setAddr("测试地址");
        user.setCompany("测试公司");
        userRepository.save(user);
        return "insert success";
    }
}

启动服务，表会自动建好，这里因为配置文件里的原因，有了这句话，每次启动服务的时候，都会根据实体类信息更新表结构。

spring.jpa.properties.hibernate.hbm2ddl.auto=update

​

访问Web地址测试

​ 

 查看数据库信息，发现已经操作成功了，一个非常简单的通过Spring Boot操作数据库的例子就完成了。

​ 

遇到的问题 

最早启动服务的时候报错信息如下：

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.

这是由于我的MySQL版本是5.6，POM里默认的版本太高了，解决方法是要么在POM对应加上版本号，要么在你的spring.datasource.url后面加上这一长串：useUnicode=true&characterEncoding=UTF-8&serverTimezone=Asia/Shanghai

 

代码地址：码云