Spring JdbcTemplate.queryForList()

本文介绍: 在本文中，我们将学习使用方法。queryFo rLi s t()方法执行给定的 SQL 并返回结果Li s t 对象。queryFo rLi s t()方法通过以下方式接受参数。执行给定的静态查询并返回一个列表。它使用 JDBC St a t em ent 语句，而不是 Pre paredStat em ent。结果列表包含映射。一个映射实例表示一行，其中映射键是列名，映射值是列值。执行给定的静态查询并返回一个列表。它使用 JDBC Statem ent语句，而不是Pre paredStatem ent。

在本文中，我们将学习使用JdbcTemplate.queryForList() 方法。queryFo rLi st()方法执行给定的 SQL 并返回结果List 对象。
queryFo rList()方法通过以下方式接受参数。
1.

List<Map<String,Object&gt;&gt; queryForList(String sql) throws DataAccessException

执行给定的静态查询并返回一个列表。它使用 JDBC Statement语句，而不是 Pre paredStatement。结果列表包含映射。一个映射实例表示一行，其中映射键是列名，映射值是列值。
2.

<T&gt; List<T&gt; queryForList(String sql, Class<T> elementType) throws DataAccessException

执行给定的静态查询并返回一个列表。它使用 JDBC Statement语句，而不是PreparedStatement。结果列表包含给定元素类型的元素。
3.

<T> List<T> queryForList(String sql, Class<T> elementType, @Nullable Object... args) throws DataAccessException

给定 SQL 的查询从 SQL 创建预准备语句和要绑定到查询的参数列表，需要结果列表。结果列表包含给定元素类型的元素。
4.

List<Map<String,Object>> queryForList(String sql, @Nullable Object... args) throws DataAccessException

查询给定的 SQL 从 SQL 创建预准备语句和要绑定到查询的参数列表，期望结果列表。结果列表包含映射。一个映射实例表示一行，其中映射键是列名，映射值是列值。
5.

List<Map<String,Object>> queryForList(String sql, Object[] args, int[] argTypes) throws DataAccessException

给定 SQL 的查询从 SQL 创建预准备语句和要绑定到查询的参数列表，需要结果列表。结果列表包含映射。一个映射实例表示一行，其中映射键是列名，映射值是列值。
6.

<T> List<T> queryForList(String sql, Object[] args, int[] argTypes, Class<T> elementType) throws DataAccessException

给定 SQL 的查询从 SQL 创建预准备语句和要绑定到查询的参数列表，需要结果列表。结果列表包含给定元素类型的元素。

参数：
sql是要执行的 SQL 查询。
ar gs 是要绑定到查询的参数。
argType是参数的SQL类型，即java.sql.Types
elementType 是结果列表中必需的元素类型。

返回：
它返回对象List 。

抛出：
如果查询失败，则会引发DataAcce ssExcept ion。

使用Spring Boot的示例

Pers onDAO.java

package com.concretepage;

import java.util.ArrayList;
import java.util.List;
import java.util.Map;

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.jdbc.core.JdbcTemplate;
import org.springframework.stereotype.Repository;

@Repository
public class PersonDAO {

    @Autowired
    private JdbcTemplate jdbcTemplate;

    // queryForList(String sql)
    public List<Person> getAllPersons() {
        String sql = "select * from person";
        List<Map<String, Object>> list = jdbcTemplate.queryForList(sql);
        List<Person> plist = new ArrayList<>();
        list.forEach(m -> {
            Person p = new Person((String) m.get("name"), (Integer) m.get("age"));
            p.setId((Integer) m.get("id"));
            plist.add(p);
        });
        return plist;
    }

    // queryForList(String sql, Class&amp;lt;T&amp;gt; elementType)
    public List<String> getAllNames() {
        String sql = "select name from person";
        List<String> list = jdbcTemplate.queryForList(sql, String.class);
        List<String> plist = new ArrayList<>();
        list.forEach(name -> plist.add(name));
        return plist;
    }

    // queryForList(String sql, Class&amp;lt;T&amp;gt; elementType, Object... args)
    public List<Integer> getIdsByNameNAge1(String name, int age) {
        String sql = "select id from person where name = ? and age = ?";
        List<Integer> list = jdbcTemplate.queryForList(sql, Integer.class, name, age);
        List<Integer> plist = new ArrayList<>();
        list.forEach(id -> plist.add(id));
        return plist;
    }

    // queryForList(String sql, Object... args)
    public List<Person> getPersonsByNameNAge1(String name, int age) {
        String sql = "select * from person where name = ? and age = ?";
        List<Map<String, Object>> list = jdbcTemplate.queryForList(sql, name, age);
        List<Person> plist = new ArrayList<>();
        list.forEach(m -> {
            Person p = new Person((String) m.get("name"), (Integer) m.get("age"));
            p.setId((Integer) m.get("id"));
            plist.add(p);
        });
        return plist;
    }

    // queryForList(String sql, Object[] args, int[] argTypes)
    public List<Person> getPersonsByNameNAge2(String name, int age) {
        String sql = "select * from person where name = ? and age = ?";
        Object[] args = {name, age};
        int[] argTypes = {java.sql.Types.CHAR, java.sql.Types.INTEGER};
        List<Map<String, Object>> list = jdbcTemplate.queryForList(sql, args, argTypes);
        List<Person> plist = new ArrayList<>();
        list.forEach(m -> {
            Person p = new Person((String) m.get("name"), (Integer) m.get("age"));
            p.setId((Integer) m.get("id"));
            plist.add(p);
        });
        return plist;
    }

    // queryForList(String sql, Object[] args, int[] argTypes, Class&amp;lt;T&amp;gt; elementType)
    public List<Integer> getIdsByNameNAge2(String name, int age) {
        String sql = "select id from person where name = ? and age = ?";
        Object[] args = {name, age};
        int[] argTypes = {java.sql.Types.CHAR, java.sql.Types.INTEGER};
        List<Integer> list = jdbcTemplate.queryForList(sql, args, argTypes, Integer.class);
        List<Integer> plist = new ArrayList<>();
        list.forEach(id -> plist.add(id));
        return plist;
    }
}

Person.java

package com.concretepage;

public class Person {

    private int id;
    private String name;
    private int age;

    public Person(String name, int age) {
        this.name = name;
        this.age = age;
    }

    public int getId() {
        return id;
    }

    public void setId(int id) {
        this.id = id;
    }

    public String getName() {
        return name;
    }

    public int getAge() {
        return age;
    }

    @Override
    public String toString() {
        return id + " - " + name + " - " + age;
    }
}

application.properties

spring.datasource.url=jdbc:mysql://localhost:3306/concretepage?autoReconnect=true&amp;useSSL=false&amp;useUnicode=true&amp;characterEncoding=UTF-8&amp;serverTimezone=Asia/Shanghai
spring.datasource.username=root
spring.datasource.password=root
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver

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/maven-v4_0_0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.concretepage</groupId>
    <artifactId>soap-ws</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <packaging>jar</packaging>
    <name>spring-demo</name>
    <description>Spring Demo Application</description>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.7.4</version>
        <relativePath />
    </parent>
    <properties>
        <java.version>17</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-jdbc</artifactId>
        </dependency>
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>8.0.30</version>
        </dependency>
    </dependencies>
    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>
</project>

MyApplication.java

package com.concretepage;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.context.ApplicationContext;

@SpringBootApplication
public class MyApplication {

    public static void main(String[] args) {
        ApplicationContext ctx = SpringApplication.run(MyApplication.class, args);
        PersonDAO personDAO = ctx.getBean(PersonDAO.class);

        System.out.println(personDAO.getAllPersons()); // [1 - Rakesh - 30, 2 - Mohan - 25, 3 - Mohan - 25]
        System.out.println(personDAO.getAllNames()); // [Rakesh, Mohan, Mohan]
        System.out.println(personDAO.getIdsByNameNAge1("Mohan", 25)); // [2, 3]
        System.out.println(personDAO.getPersonsByNameNAge1("Mohan", 25)); // [2 - Mohan - 25, 3 - Mohan - 25]
        System.out.println(personDAO.getPersonsByNameNAge2("Mohan", 25)); // [2 - Mohan - 25, 3 - Mohan - 25]
        System.out.println(personDAO.getIdsByNameNAge2("Mohan", 25)); // [2, 3]
    }
}