在经典的 JDBC 用法中, SQL 参数是用占位符 ? 表示,并且受到位置的限制. 定位参数的问题在于, 一旦参数的顺序发生变化, 就必须改变参数绑定. 

在 Spring JDBC 框架中, 绑定 SQL 参数的另一种选择是使用具名参数(named parameter).

 

那么什么是具名参数?

具名参数: SQL 按名称(以冒号开头)而不是按位置进行指定. 具名参数更易于维护, 也提升了可读性. 具名参数由框架类在运行时用占位符取代

具名参数只在 NamedParameterJdbcTemplate 中得到支持。

 

在 SQL 语句中使用具名参数时, 可以在一个 Map 中提供参数值, 参数名为键

也可以使用 SqlParameterSource 参数

批量更新时可以提供 Map 或 SqlParameterSource 的数组

 

现在,我们在上一篇博客文章的例子的基础上,继续编写代码:

我们在applicationContext.xml后面加入具名类对象的bean:

配置文件:

1 <?xml version="1.0" encoding="UTF-8"?>
 2 <beans xmlns="http://www.springframework.org/schema/beans"
 3     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:aop="http://www.springframework.org/schema/aop"
 4     xmlns:context="http://www.springframework.org/schema/context"
 5     xsi:schemaLocation="http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop-4.1.xsd
 6         http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd
 7         http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-4.1.xsd">
 8 
 9     <!-- 自动扫描的包 -->
10     <context:component-scan base-package="com.happBKs.spring.jdbcSpring"></context:component-scan>
11 
12 
13 
14     <!-- 导入资源文件 -->
15     <context:property-placeholder location="classpath:db.properties" />
16 
17     <!-- 配置c3p0数据源 -->
18     <bean id="dataSource" class="com.mchange.v2.c3p0.ComboPooledDataSource">
19         <property name="user" value="${jdbc.user}"></property>
20         <property name="password" value="${jdbc.password}"></property>
21         <property name="jdbcUrl" value="${jdbc.jdbcUrl}"></property>
22         <property name="driverClass" value="${jdbc.driverClass}"></property>
23         <property name="initialPoolSize" value="${jdbc.initPoolSize}"></property>
24         <property name="maxPoolSize" value="${jdbc.maxPoolSize}"></property>
25     </bean>
26     
27     <!-- 配置jdbc模板类 -->
28     <bean id="jdbcTemplate" class="org.springframework.jdbc.core.JdbcTemplate"><property name="dataSource" ref="dataSource"></property></bean><!-- 配置 NamedParameterJdbcTemplate,该对象可以使用具名参数。
29     但它没有无参构造器,所以必须为其制定构造参数,这里指定的是出c3p0数据源
30     --><bean id="namedParameterJdbcTemplate"class="org.springframework.jdbc.core.namedparam.NamedParameterJdbcTemplate"><constructor-arg ref="dataSource"></constructor-arg></bean></beans>
31
之后我们不再使用上次提到的EmployeeBean类,因为我们已经知道了Spring JDBC并不能提供像Hibernate等ORM框架那样的类属性的级联映射,所以我们把属性department改为了deptId。
1 package com.happBKs.spring.jdbcSpring;
 2 
 3 public class EmployeeBean2 {
 4     Integer id;
 5     String lastName;
 6     String email;
 7     Integer deptId;
 8     public Integer getId() {
 9         return id;
10     }
11     public void setId(Integer id) {
12         this.id = id;
13     }
14     public String getLastName() {
15         return lastName;
16     }
17     public void setLastName(String lastName) {
18         this.lastName = lastName;
19     }
20     public String getEmail() {
21         return email;
22     }
23     public void setEmail(String email) {
24         this.email = email;
25     }
26     public Integer getDeptId() {
27         return deptId;
28     }
29     public void setDeptId(Integer deptId) {
30         this.deptId = deptId;
31     }
32     public EmployeeBean2(Integer id, String lastName, String email,
33             Integer deptId) {
34         super();
35         this.id = id;
36         this.lastName = lastName;
37         this.email = email;
38         this.deptId = deptId;
39     }
40     public EmployeeBean2() {
41         super();
42         // TODO Auto-generated constructor stub
43     }
44     @Override
45     public String toString() {
46         return "EmployeeBean2 [id=" + id + ", lastName=" + lastName
47                 + ", email=" + email + ", deptId=" + deptId + "]";
48     }
49     
50 }

 

然后,我们来使用具名参数来完成我们之前提到的各种更新操作:

比如之前我们插入一个记录的写法是:

 

 

这种写法,赋值的参数没有给予具体的名称,只通过占位符?来完成占位,通过赋值参数的顺序来对应相应的参数。现在我们可以借助于org.springframework.jdbc.core.namedparam.NamedParameterJdbcTemplate来帮助我们解决这个问题:

不过这里有两种方法,我们先介绍最一般的一种:

1 /*
 2      * 可以为参数取名字:ln,:email,:deptid
 3      * 优点:如果有多个参数,不用去纠结于参数的位置顺序,直接对应参数名,便于维护
 4      * 缺点:较为麻烦
 5      */
 6     @Test
 7     public void testNamedParameterJdbcTemplate(){
 8         //之前不适用具名参数的用法:
 9         //String sql="insert employee(last_name,email,dept_id) values(?,?,?)";
10         //我们给予参数赋值必须依赖于?的顺序
11         
12         // 使用具名参数的用法:
13         String sql="insert employee(last_name,email,dept_id) values(:ln,:email,:deptid)";
14         Map<String,Object> paramMap=new HashMap<String, Object>();
15         paramMap.put("ln", "超级无敌银河最强临时工");
16         paramMap.put("email", "super@qq.com");
17         paramMap.put("deptid", 4);
18         namedParameterJdbcTemplate.update(sql,paramMap);
19     }

 

这里,SQL语句中的赋值参数被用":"的形式给出,这里就是具名参数。然后我们可以通过一个Map对象,Map的key是我们的具名参数,而value则是参数的值,然后通过NamedParameterJdbcTemplate类对象的方法update来完成曾删改操作。

运行结果:

 

不过,这种方法还是有比较麻烦的地方,我们需要在map对象中逐一指定参数。

这时候,你可能不禁感慨,还是ORM框架好,类属属性能够自动与数据库表的字段映射。这里Spring JDBC在具名参数赋值时也考虑了类似的解决方法。

下面,我来介绍具名参数的第二种方法:

我们需要将具名参数定义为与类的属性名称一样的名字,然后,可以创建一个相应的类的对象,并调用相应属性的set方法赋值,之后,我们就调用update的另一个重载方法:

1 /*
 2      * 使用具名参数时,可以使用int org.springframework.jdbc.core.namedparam.NamedParameterJdbcTemplate.update(String sql, SqlParameterSource paramSource) throws DataAccessException
 3         方法进行更新操作:
 4         1. SQL语句中的具名参数与类的属性名一致
 5         2. 使用接口SqlParameterSource的BeanPropertySqlParameterSource实现类作为参数
 6         
 7 
 8      */
 9     @Test
10     public void testNamedParameterJdbcTemplate2(){
11         //之前不适用具名参数的用法:
12         //String sql="insert employee(last_name,email,dept_id) values(?,?,?)";
13         //我们给予参数赋值必须依赖于?的顺序
14         
15         // 使用具名参数的用法:
16         String sql="insert employee(last_name,email,dept_id) values(:lastName,:email,:deptId)";
17         EmployeeBean2 e=new EmployeeBean2();
18         e.setLastName("haha");
19         e.setEmail("haha@qq.com");
20         e.setDeptId(4);
21         SqlParameterSource sqlParameterSource=new BeanPropertySqlParameterSource(e);
22         namedParameterJdbcTemplate.update(sql,sqlParameterSource);
23     }

 

运行结果:

java word 根据占位符替换图片 namedparameterjdbctemplate占位符_java word 根据占位符替换图片