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

JdbcTemplate的Insert

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

@Testpublic 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，也可以支持

@Testpublic 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
    
      args) {	return doExecute(args);}// 有自增id的单条insertpublic Number executeAndReturnKey(Map
     
       args) {	return doExecuteAndReturnKey(args);}// 有自增id的insert，返回KeyHolderpublic KeyHolder executeAndReturnKeyHolder(Map
      
        args) {	return doExecuteAndReturnKeyHolder(args);}
      
     
    

先来看普通的insert

@Testpublic void testInsertWithMap(){	SimpleJdbcInsert insert = new SimpleJdbcInsert(jdbcTemplate)			.withTableName("t_wms_goods_stock");		Map
    
      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

@Testpublic void testInsertWithMapAndGeneratedKey(){	SimpleJdbcInsert insert = new SimpleJdbcInsert(jdbcTemplate)			.withTableName("t_wms_goods_stock")			// 设置自增column			.usingGeneratedKeyColumns("id");		Map
    
      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的一种参数

@Testpublic 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);}

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