深刻浅出JDBC(四) - Insert与Spring SimpleJdbcInsert

Sql的Insert操做，由于表的主键通常都设置成自增的缘由，相较于update操做，多了对自增id的获取。spring jdbc对insert操做的支持也很完善，不只在JdbcTemplate的update方法中支持返回主键，更是单独提供SimpleJdbcInsert类帮助使用insert操做。

JdbcTemplate的Insert

spring使用KeyHolder做为自增列返回的持有器，update方法支持PreparedStatementCreator和KeyHolder两个参数，来完成insert操做并返回自增列的值。

@Test
public void testInsertAutoGeneratedKey(){
	final String insertSql = "insert into t_wms_goods_stock (warehouse_id, amount) values(?,?)";
	
	// 建立自增key的持有器
	KeyHolder keyHolder = new GeneratedKeyHolder();
	int insertRow = jdbcTemplate.update(new PreparedStatementCreator() {
		
		public PreparedStatement createPreparedStatement(Connection con) throws SQLException {
			// 获取PreparedStatement，并指定返回自增key
			PreparedStatement ps = con.prepareStatement(insertSql, Statement.RETURN_GENERATED_KEYS);
			ps.setLong(1, 1L);
			ps.setDouble(2, 100.25);
			return ps;
		}
	}, keyHolder);
	
	if(insertRow > 0){
		// getKey返回单一自增值
		System.out.println("auto-generated key:" + keyHolder.getKey());
	}
}

KeyHolder的getKey方法返回的是Number类型。

若是是批量insert，也能够支持

@Test
public void testMultiInsertAutoGeneratedKey(){
	final String insertSql = "insert into t_wms_goods_stock (warehouse_id, amount) values(?,?),(?,?)";
	
	KeyHolder keyHolder = new GeneratedKeyHolder();
	int insertRow = jdbcTemplate.update(new PreparedStatementCreator() {
		
		public PreparedStatement createPreparedStatement(Connection con) throws SQLException {
			PreparedStatement ps = con.prepareStatement(insertSql, Statement.RETURN_GENERATED_KEYS);
			ps.setLong(1, 1L);
			ps.setDouble(2, 100.25);
			ps.setLong(3, 2L);
			ps.setDouble(4, 122.9);
			return ps;
		}
	}, keyHolder);
	
	if(insertRow > 0){
		// getKeyList返回批量自增值
		System.out.println("auto-generated key:" + keyHolder.getKeyList());
	}
}

可是返回的是List<Map<String, Object>>，map的key是ColumnKey，value就是自增列的值。笔者使用的是mysql，返回的数据以下：

[{GENERATED_KEY=17}, {GENERATED_KEY=18}]

因为mysql一张表里不容许设置两个自增列，是否返回的自增column key名称就是GENERATED_KEY，笔者不能确认，若是有明确知晓的朋友，还请告知。

SimpleJdbcInsert

为了简化insert操做，spring提供了一个简便的，基于流式api的支持表插入的类，就是SimpleJdbcInsert。SimpleJdbcInsert提供三个execute方法执行insert操做

// 普通insert，返回影响行数
public int execute(Map<String, ?> args) {
	return doExecute(args);
}

// 有自增id的单条insert
public Number executeAndReturnKey(Map<String, ?> args) {
	return doExecuteAndReturnKey(args);
}

// 有自增id的insert，返回KeyHolder
public KeyHolder executeAndReturnKeyHolder(Map<String, ?> args) {
	return doExecuteAndReturnKeyHolder(args);
}

先来看普通的insert

@Test
public void testInsertWithMap(){
	SimpleJdbcInsert insert = new SimpleJdbcInsert(jdbcTemplate)
			.withTableName("t_wms_goods_stock");
	
	Map<String, Object> params = new HashMap<>();
	params.put("id", 3);
	params.put("warehouse_id", 1);
	params.put("amount", 15d);
	int insertCount = insert.execute(params);
	System.out.println("insertCount:" + insertCount);
}

传入JdbcTemplate构造SimpleJdbcInsert，而后赋予操做的表名，使用map构造insert的column name和对应的column value，调用execute执行，返回影响的行数。简单深刻下源码，能够看到底层执行的仍是JdbcTemplate的方法。

getJdbcTemplate().update(getInsertString(), values.toArray(), getInsertTypes());

再来看有主键递增的insert

@Test
public void testInsertWithMapAndGeneratedKey(){
	SimpleJdbcInsert insert = new SimpleJdbcInsert(jdbcTemplate)
			.withTableName("t_wms_goods_stock")
			// 设置自增column
			.usingGeneratedKeyColumns("id");
	
	Map<String, Object> params = new HashMap<>();
	params.put("warehouse_id", 1);
	params.put("amount", 32d);
	Number newId = insert.executeAndReturnKey(params);
	System.out.println("insert new id:" + newId);
}

构造SimpleJdbcInsert时，设置了自增column，而后调用executeAndReturnKey方法，返回Number类型的自增列的值。

对于executeAndReturnKeyHolder方法，因为参数是map方式，并不能支持批量insert。

至于execute的参数，spring还提供除map外的其余方式：SqlParameterSource，并提供两种经常使用的实现。

MapSqlParameterSource

相似于Map的一种参数

@Test
public void testMapSqlParameterSource(){
	SimpleJdbcInsert insert = new SimpleJdbcInsert(jdbcTemplate)
			.withTableName("t_wms_goods_stock")
			.usingGeneratedKeyColumns("id");
	
	SqlParameterSource parameterSource = new MapSqlParameterSource()
			.addValue("warehouse_id", 1l)
			.addValue("amount", 23d);
	Number newId = insert.executeAndReturnKey(parameterSource);
	System.out.println("insert new id:" + newId);
}

BeanPropertySqlParameterSource

传入对于的java对象，映射对象属性名称到数据库表的列名称（将java的驼峰式名称转换成sql的下划线分隔的名称）

public void testBeanPropertySqlParameterSource(){
	SimpleJdbcInsert insert = new SimpleJdbcInsert(jdbcTemplate)
			.withTableName("t_wms_goods_stock")
			.usingGeneratedKeyColumns("id");
	
	SqlParameterSource parameterSource = new BeanPropertySqlParameterSource(new GoodsStock(1l, 23d));
	Number newId = insert.executeAndReturnKey(parameterSource);
	System.out.println("insert new id:" + newId);
}

此种方式，对于对象属性和表字段名称一致的是很是方便的。