使用JDBC和Spring访问关系数据

时间 2019-12-11

标签使用 jdbc spring 访问关系数据栏目 Java 繁體版

原文原文链接

本指南将引导您完成使用Spring访问关系数据的过程。html

你要构建什么

您将使用Spring构建一个JdbcTemplate应用程序来访问存储在关系数据库中的数据。java

你须要什么

大约15分钟
最喜欢的文本编辑器或IDE
JDK 1.8或更高版本
Gradle 4+或Maven 3.2+
您还能够将代码直接导入IDE：git
- 使用STS构建/导入入门指南
- 使用IntelliJ IDEA导入入门指南

如何完成本指南

与大多数Spring入门指南同样，您能够从头开始并完成每一个步骤，或者您能够绕过您已熟悉的基本设置步骤。不管哪一种方式，您最终都会使用工做代码。github

要从头开始，请继续使用Gradle构建。web

要跳过基础知识，请执行如下操做：spring

下载并解压缩本指南的源存储库，或使用Git克隆它：

git clone https://github.com/spring-guides/gs-relational-data-access.git

进入gs-relational-data-access/initial
跳转到建立Customer对象。

完成后，能够根据gs-relational-data-access/complete中的代码检查结果。数据库

使用Gradle构建

首先，设置一个基本的构建脚本。在使用Spring构建应用程序时，您可使用任何您喜欢的构建系统，但此处包含了使用Gradle和Maven所需的代码。若是您不熟悉这二者，请参阅使用Gradle构建Java项目或使用Maven构建Java项目。apache

建立目录结构

在您选择的项目目录中，建立如下子目录结构;例如，在*nix系统上使用mkdir -p src/main/java/hello:数组

└── src
    └── main
        └── java
            └── hello

建立Gradle构建文件

下面是最初的Gradle构建文件。bash

buildscript {
    repositories {
        mavenCentral()
    }
    dependencies {
        classpath("org.springframework.boot:spring-boot-gradle-plugin:2.0.3.RELEASE")
    }
}

apply plugin: 'java'
apply plugin: 'eclipse'
apply plugin: 'idea'
apply plugin: 'org.springframework.boot'
apply plugin: 'io.spring.dependency-management'

bootJar {
    baseName = 'gs-relational-data-access'
    version =  '0.1.0'
}

repositories {
    mavenCentral()
}

sourceCompatibility = 1.8
targetCompatibility = 1.8

dependencies {
    compile("org.springframework.boot:spring-boot-starter")
    compile("org.springframework:spring-jdbc")
    compile("com.h2database:h2")
    testCompile("junit:junit")
}

在Spring Boot gradle plugin提供了许多便捷的功能：

它收集类路径上的全部jar并构建一个可运行的“über-jar”，这使得执行和传输服务更加方便。
它搜索public static void main()标记为可运行类的方法。
它提供了一个内置的依赖项解析器，它设置版本号以匹配Spring Boot依赖项。您能够覆盖任何您但愿的版本，但它将默认为Boot的所选版本集。

使用Maven构建

首先，设置一个基本的构建脚本。在使用Spring构建应用程序时，您可使用任何您喜欢的构建系统，但此处包含了使用Maven所需的代码。若是您不熟悉Maven，请参阅使用Maven构建Java项目。

建立目录结构

在您选择的项目目录中，建立如下子目录结构;例如，在*nix系统上使用mkdir -p src/main/java/hello:

└── src
    └── main
        └── java
            └── hello

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>

    <groupId>org.springframework</groupId>
    <artifactId>gs-relational-data-access</artifactId>
    <version>0.1.0</version>

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.0.3.RELEASE</version>
    </parent>

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

    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-jdbc</artifactId>
        </dependency>
        <dependency>
            <groupId>com.h2database</groupId>
            <artifactId>h2</artifactId>
        </dependency>
    </dependencies>


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

</project>

在Spring Boot gradle plugin提供了许多便捷的功能：

它收集类路径上的全部jar并构建一个可运行的“über-jar”，这使得执行和传输服务更加方便。
它搜索public static void main()标记为可运行类的方法。
它提供了一个内置的依赖项解析器，它设置版本号以匹配Spring Boot依赖项。您能够覆盖任何您但愿的版本，但它将默认为Boot的所选版本集。

使用IDE构建

阅读如何将本指南直接导入使用STS构建/导入入门指南。
阅读使用IntelliJ IDEA导入入门指南中如何使用本指南。

建立一个Customer对象

您将在下面使用的简单数据访问逻辑管理客户的名字和姓氏。要在应用程序级别表示此数据，请建立一个Customer类。

package hello;

public class Customer {
    private long id;
    private String firstName, lastName;

    public Customer(long id, String firstName, String lastName) {
        this.id = id;
        this.firstName = firstName;
        this.lastName = lastName;
    }

    @Override
    public String toString() {
        return String.format(
                "Customer[id=%d, firstName='%s', lastName='%s']",
                id, firstName, lastName);
    }

    // getters & setters omitted for brevity
}

存储和检索数据

Spring提供了一个名为JdbcTemplate的模板类，能够轻松使用SQL关系数据库和JDBC。大多数JDBC代码都陷入资源获取，链接管理，异常处理和通常错误检查之中，这与代码要实现的内容彻底无关,JdbcTemplate负责这一切。您所要作的就是专一于手头的任务。

src/main/java/hello/Application.java

package hello;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.CommandLineRunner;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.jdbc.core.JdbcTemplate;

import java.util.Arrays;
import java.util.List;
import java.util.stream.Collectors;

@SpringBootApplication
public class Application implements CommandLineRunner {

    private static final Logger log = LoggerFactory.getLogger(Application.class);

    public static void main(String args[]) {
        SpringApplication.run(Application.class, args);
    }

    @Autowired
    JdbcTemplate jdbcTemplate;

    @Override
    public void run(String... strings) throws Exception {

        log.info("Creating tables");

        jdbcTemplate.execute("DROP TABLE customers IF EXISTS");
        jdbcTemplate.execute("CREATE TABLE customers(" +
                "id SERIAL, first_name VARCHAR(255), last_name VARCHAR(255))");

        // Split up the array of whole names into an array of first/last names
        List<Object[]> splitUpNames = Arrays.asList("John Woo", "Jeff Dean", "Josh Bloch", "Josh Long").stream()
                .map(name -> name.split(" "))
                .collect(Collectors.toList());

        // Use a Java 8 stream to print out each tuple of the list
        splitUpNames.forEach(name -> log.info(String.format("Inserting customer record for %s %s", name[0], name[1])));

        // Uses JdbcTemplate's batchUpdate operation to bulk load data
        jdbcTemplate.batchUpdate("INSERT INTO customers(first_name, last_name) VALUES (?,?)", splitUpNames);

        log.info("Querying for customer records where first_name = 'Josh':");
        jdbcTemplate.query(
                "SELECT id, first_name, last_name FROM customers WHERE first_name = ?", new Object[] { "Josh" },
                (rs, rowNum) -> new Customer(rs.getLong("id"), rs.getString("first_name"), rs.getString("last_name"))
        ).forEach(customer -> log.info(customer.toString()));
    }
}

@SpringBootApplication 是一个便利注释，添加了如下全部内容：

@Configuration 标记该类做为应用程序上下文的bean定义的源。
@EnableAutoConfiguration 告诉Spring Boot开始根据类路径设置，其余bean和各类属性设置添加bean。
@ComponentScan告诉Spring在包中寻找其余组件，配置和服务，容许它找到控制器。

main()方法使用Spring Boot的SpringApplication.run()方法来启动应用程序。您是否注意到没有一行XML？也没有web.xml文件。此Web应用程序是100％纯Java，您无需处理配置任何管道或基础结构。

main()方法使用Spring Boot的SpringApplication.run()方法来启动应用程序。您是否注意到没有一行XML？也没有web.xml文件。此Web应用程序是100％纯Java，您无需处理配置任何管道或基础结构。

Spring Boot支持H2，一种内存中的关系数据库引擎，并自动建立链接。由于咱们使用的是spring-jdbc，Spring Boot会自动建立一个JdbcTemplate。@Autowired自动加载JdbcTemplate并使其可用。

这个Application类实现了Spring Boot CommandLineRunner，这意味着它将run()在加载应用程序上下文后执行该方法。

首先，使用JdbcTemplate’s `execute方法安装一些DDL 。

其次，您获取字符串列表并使用Java 8流，将它们拆分为Java数组中的firstname/lastname对。

而后使用JdbcTemplate’s `batchUpdate方法在新建立的表中安装一些记录。方法调用的第一个参数是查询字符串，最后一个参数（Objects 的数组）包含要替换为“？”字符的查询的变量。

对于单个插入语句，JdbcTemplate’s `insert方法很好。但对于多个，最好使用batchUpdate。

使用?的参数，以免SQL注入攻击经过指示JDBC来绑定变量。

最后，使用query方法在表中搜索与条件匹配的记录。您再次使用“?”参数为查询建立参数，在进行调用时传入实际值。最后一个参数是用于将每一个结果行转换为新Customer对象的Java 8 lambda 。

Java 8 lambdas很好地映射到单个方法接口，如Spring的RowMapper。若是您使用的是Java 7或更早版本，则能够轻松插入匿名接口实现，并具备与lambda expresion正文所包含的相同的方法体，而且它能够绝不费力地使用Spring。

构建可执行的JAR

您可使用Gradle或Maven从命令行运行该应用程序。或者，您能够构建一个包含全部必需依赖项，类和资源的可执行JAR文件，并运行该文件。这使得在整个开发生命周期中，跨不一样环境等将服务做为应用程序发布，版本和部署变得容易。

若是您使用的是Gradle，则可使用运行该应用程序./gradlew bootRun。或者您可使用构建JAR文件./gradlew build。而后你能够运行JAR文件：

java -jar build/libs/gs-relational-data-access-0.1.0.jar

若是您使用的是Maven，则可使用该应用程序运行该应用程序./mvnw spring-boot:run。或者您可使用构建JAR文件./mvnw clean package。而后你能够运行JAR文件：

java -jar target/gs-relational-data-access-0.1.0.jar

上面的过程将建立一个可运行的JAR。您也能够选择构建经典WAR文件。

显示日志输出，您能够从日志中看到它在后台线程上。您应该每隔5秒钟看到计划任务：

2015-06-19 10:58:31.152  INFO 67731 --- [           main] hello.Application                        : Creating tables
2015-06-19 10:58:31.219  INFO 67731 --- [           main] hello.Application                        : Inserting customer record for John Woo
2015-06-19 10:58:31.220  INFO 67731 --- [           main] hello.Application                        : Inserting customer record for Jeff Dean
2015-06-19 10:58:31.220  INFO 67731 --- [           main] hello.Application                        : Inserting customer record for Josh Bloch
2015-06-19 10:58:31.220  INFO 67731 --- [           main] hello.Application                        : Inserting customer record for Josh Long
2015-06-19 10:58:31.230  INFO 67731 --- [           main] hello.Application                        : Querying for customer records where first_name = 'Josh':
2015-06-19 10:58:31.242  INFO 67731 --- [           main] hello.Application                        : Customer[id=3, firstName='Josh', lastName='Bloch']
2015-06-19 10:58:31.242  INFO 67731 --- [           main] hello.Application                        : Customer[id=4, firstName='Josh', lastName='Long']
2015-06-19 10:58:31.244  INFO 67731 --- [           main] hello.Application                        : Started Application in 1.693 seconds (JVM running for 2.054)

概要

恭喜！您刚刚使用Spring开发了一个简单的JDBC客户端。