006 使用JDBC和Spring访问关系型数据库

原文

https://spring.io/guides/gs/relational-data-access/

直译

创建一个Customer对象

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

src/main/java/hello/Customer.java

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在包中寻找其他组件，配置和服务hello。在这种情况下，没有任何。

该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文件。
您应该看到以下输出：

2015-06-19 10：58：31.152 INFO 67731 --- [main] hello.Application：创建表格
2015-06-19 10：58：31.219 INFO 67731 --- [main] hello.Application：为John Woo插入客户记录
2015-06-19 10：58：31.220 INFO 67731 --- [主要] hello.Application：为Jeff Dean插入客户记录
2015-06-19 10：58：31.220 INFO 67731 --- [主要] hello.Application：插入Josh Bloch的客户记录
2015-06-19 10：58：31.220 INFO 67731 --- [main] hello.Application：为Josh Long插入客户记录
2015-06-19 10：58：31.230 INFO 67731 --- [main] hello.Application：查询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：在1.693秒内启动应用程序（JVM运行2.054）

摘要

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

Spring Boot具有许多用于配置和自定义连接池的功能，例如连接到外部数据库而不是内存数据库。有关更多详细信息，请参阅“ 用户指南”。

延伸知识点

java 数据库驱动的加载机制：SPI