Spring中的JdbcTemplate的使用

在最近的一个工作中，为了简单方便我就是用了Spring自带的JdbcTemplate来访问数据库，我以为之前自己很熟练的掌握，后来才发现我太天真了，踩了很多坑。

基本方法

JdbcTemplate自带很多方法可以执行SQL语句,以下我主要列举，比较常用的方法

//执行SQL，返回一个对象
@Override
public  T queryForObject(String sql, RowMapper rowMapper, Object... args)
		 throws DataAccessException {
	List results = query(sql, args, 
			new RowMapperResultSetExtractor(rowMapper, 1));
	return DataAccessUtils.requiredSingleResult(results);
}

//同上，不过多要传入返回值的对象的Class
@Override
public  T queryForObject(String sql, Class requiredType)
		 throws DataAccessException {
	return queryForObject(sql, getSingleColumnRowMapper(requiredType));
}

//执行SQL，返回一个Map对象
@Override
public Map queryForMap(String sql, Object... args)
		 throws DataAccessException {
	return queryForObject(sql, args, getColumnMapRowMapper());
}

//执行SQL，返回一个List对象
@Override
public  List query(String sql, Object[] args, RowMapper rowMapper) 
		throws DataAccessException {
	return query(sql, args, new RowMapperResultSetExtractor(rowMapper));
}

//执行SQL，返回一个List对象
@Override
@Override
public  List queryForList(String sql, Class elementType, Object... args)
	throws DataAccessException {
	return query(sql, args, getSingleColumnRowMapper(elementType));
}

//执行一条SQL，主要用于更新、新增数据
@Override
public int update(String sql, Object... args) throws DataAccessException {
	return update(sql, newArgPreparedStatementSetter(args));
}

//执行SQL，返回一个List对象，List里是Map对象
@Override
public List> queryForList(String sql, Object... args) 
		throws DataAccessException {
	return query(sql, args, getColumnMapRowMapper());
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50

注意点

至少返回一个对象

@Override
public  T queryForObject(String sql, RowMapper rowMapper, Object... args)
		 throws DataAccessException {
	List results = query(sql, args, 
			new RowMapperResultSetExtractor(rowMapper, 1));
	return DataAccessUtils.requiredSingleResult(results);
}

public RowMapperResultSetExtractor(RowMapper rowMapper, int rowsExpected) {
	Assert.notNull(rowMapper, "RowMapper is required");
	this.rowMapper = rowMapper;
	this.rowsExpected = rowsExpected;
}
1
2
3
4
5
6
7
8
9
10
11
12
13

以上代码就是可以知道，必须返回一个对象，不能返回null，如果从数据库查找发现没有一条信息吻合就会报错，报以下的错误

org.springframework.dao.IncorrectResultSizeDataAccessException: Incorrect result size: expected 1, actual 0
1

所以如果不确定是否有信息，就使用query、queryForList来避免错误。返回单对象一般会有这样的限制，如果自己不确定可以使用该方法的时候看一下源码，设置了1就代表必须要有一个值。

返回指定对象

JdbcTemplate里面这样的方法，就是可以传入了一个对象的Class值，就可以返回该对象的值，但是需要注意，它只支持基础类型

//例如，它支持以下的写法
public Integer getCourseCount(String sql){
	return (Integer) jdbcTemplate.queryForObject(sql,java.lang.Integer.class);
}
1
2
3
4

通过源代码发现Class requiredType这个参数支持以下类型，源代码就是从primitiveWrapperTypeMap查找是否是一下类型：

primitiveWrapperTypeMap.put(Boolean.class, boolean.class);
primitiveWrapperTypeMap.put(Byte.class, byte.class);
primitiveWrapperTypeMap.put(Character.class, char.class);
primitiveWrapperTypeMap.put(Double.class, double.class);
primitiveWrapperTypeMap.put(Float.class, float.class);
primitiveWrapperTypeMap.put(Integer.class, int.class);
primitiveWrapperTypeMap.put(Long.class, long.class);
primitiveWrapperTypeMap.put(Short.class, short.class);
1
2
3
4
5
6
7
8

如果需要返回自定义对象就需要另外的方法:

如果返回List,就如以下的案例

public List getCourseList(String sql){
	return jdbcTemplate.query(sql,new RowMapper(){
		@Override
		public Course mapRow(ResultSet rs, int rowNum) throws SQLException {
			Integer id=rs.getInt("id");
			String coursename=rs.getString("coursename");
			//把数据封装到对象里
			Course course=new Course();
			course.setId(id);
			course.setCoursename(coursename.trim());
			return course;
		}
	});
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14

或者使用List>

@Override
public List listMyScore(Integer studentId) {
  String sql = "select g.score,c.className from grade g"
      + " left join teacher t on t.id=g.teacherId"
      + " left join student s on s.id=g.studentId"
      + " left join classname c on c.id=t.classNameId"
      + " where s.id="+studentId;
  List> list = jdbcTemplate.queryForList(sql);
  if(list!=null && list.size()>0){
    List ls = new ArrayList();
    for(int i=0;i