spring(10)通过spring 和 JDBC征服数据库
【0】README
1）本文部分文字描述转自：“Spring In Action（中/英文版）”，旨在review “spring(10)通过spring 和 JDBC征服数据库” 的相关知识；
【1】 spring 的数据访问哲学
1）intro：spring的目标之一是允许我们在开发应用程序的时候，能够遵循面向对象原则中的“针对接口编程”；
2）为了避免持久化的逻辑分散到应用的各个组件中，最好将数据访问的功能放到一个或多个专注于此项任务的组件中。这样的组件通常称为数据访问对象（data accwss object，DAO） 或 Repository；（干货——引入了 DAO 和 Repository）
3）为了避免应用与特定的数据访问策略耦合在一起，编写良好的 Repository应该以接口的方式暴露功能，下图展现了设计数据访问层的合理方式：
（t3）
【1.2】数据访问模板化
1）intro：spring将数据访问过程中固定的和可变的部分明确划分为两个不同 的类： 模板（template） 和 回调（callback）；模板管理过程中固定的部分，而回调处理自定义的数据访问代码。下图展现了这两个类的职责：（干货——引入了模板和回调）
（t4）
2）针对不同的持久化平台，spring 提供了多个可选的模板。如果直接使用 JDBC，那你可以选择 JdbcTemplate。如果你希望使用对象关系映射框架，那 HibernateTemplate 或 JpaTemplate 可能会适合你。下表列出了 spring 所提供的所有数据访问模板及其用途：
（t5）
Attention）spring所支持的大多数持久化功能都依赖于 数据源。因此，在声明模板和 Repository之前，需要在spring 中配置一个 数据源用来连接数据库；
【2】配置数据源
1）intro：spring 提供了在 spring上下文中配置数据源bena 的多种方式：
way1）通过JDBC 驱动程序定义的数据源；way2）通过JNDI 查找的数据源；way3）连接池的数据源；
【2.1】使用JNDI 数据源
1）intro to jndi ：http://blog.csdn.net/pacosonswjtu/article/details/51644550
2）利用spring，可以像使用 spring bean 那样配置 JNDI 中数据源的引用并将其装配到需要的类中；
3）使用 java配置 将 JNDI数据源装配到需要的类中：（for spec info ,please visit tomcat中配置jndi数据源以便spring获取）
@Bean // 使用JNDI 数据源.
public DataSource dataSource() {
JndiTemplate jndiTemplate = new JndiTemplate();
DataSource dataSource = null;
try {
dataSource = (DataSource) jndiTemplate.lookup("java:comp/env/jdbc/spring");
} catch (NamingException e) {
e.printStackTrace();
}
return dataSource;
}
【2.2】使用数据源连接池（strongly recommended）
1）intro：直接在spring中配置数据源，但spring并没有提供数据源连接池的实现，但可以有多项可用方案：（schema）
scheme1）Apache Commons DBCP（http://commons.apache.org/proper/commons-dbcp/configuration.html）scheme2）c3p0（https://sourceforge.net/projects/c3p0/）scheme3）BoneCP（http://www.jolbox.com/）
2）看个荔枝：配置DBCP BasicDataSource：
@Bean
public BasicDataSource getDataSource() {
BasicDataSource ds = new BasicDataSource();
ds.setDriverClassName("com.mysql.jdbc.Driver");
ds.setUrl("jdbc:mysql://localhost:3306/t_spring");
ds.setUsername("root");
ds.setPassword("root");
return ds;
}
3）BasicDataSource的连接池配置属性如下所示：
（t6）
【2.3】基于JDBC 驱动的数据源
1）intro：在spring中，通过JDBC驱动定义数据源是最简单的配置方式，spring提供了3个这样的数据源类以供选择：
type1）DriverManagerDataSource：在每个连接请求时都会返回一个新建的连接。与 DBCP 的 BasicDataSource 不同，由DriverManagerDataSource 提供的连接并没有进行池化管理；（干货——引入了池化管理）type2）SimpleDriverDataSource：它直接使用 JDBC驱动，来解决再特定环境下的类加载问题，这样的环境包括 OSGi 容器；type3）SingleConnectionDataSource： 在每个连接请求时都会返回同一个的连接。尽管 SingleConnectionDataSource不是严格意义上的连接池数据源，但是你可以将其视为只有一个连接的池；
【3】在spring中使用 JDBC
【3.2】使用 JDBC模板
1）spring将数据访问的样本代码抽象到 模板类中，spring为jdbc提供了3个模板类选择：分别是 JdbcTemplate， NamedParameterJdbcTemplate 和 SimpleJdbcTemplate（已经被弃用），而原书作者推荐了 JdbcTemplate；（干货——原书作者推荐了 JdbcTemplate）
2）intro to JdbcTemplate：最基本的spring jdbc模板，支持简单的JDBC数据库访问功能以及基于索引参数的查询；
【3.2.1】使用 JdbcTemplate来插入数据
1）为了使其正常工作，只需要为其设置 DataSource就可以了；
(for org.springframework.jdbc.core.JdbcOperations API , 参见 JdbcTemplate API)
@Configuration
public class RepositoryConfig {
@Bean
public BasicDataSource getDataSource() {
BasicDataSource ds = new BasicDataSource();
ds.setDriverClassName("com.mysql.jdbc.Driver");
ds.setUrl("jdbc:mysql://localhost:3306/t_spring");
ds.setUsername("root");
ds.setPassword("root");
return ds;
}
@Bean
public JdbcTemplate getJdbcTemplate(DataSource ds) {
return new JdbcTemplate(ds);
}
}
2）使用JdbcTemplate 来读取数据
@Repository
public class SpittleRepositoryImpl implements SpittleRepository {
private JdbcOperations jdbc;
@Autowired
public SpittleRepositoryImpl(JdbcOperations jdbc) {
this.jdbc = jdbc;
}
public List<Spittle> findSpittles(long limit, int offset) {
return jdbc.query("select id, name from t_two limit ? offset ?",
new SpittleRowMapper(), limit, offset);
}
private static class SpittleRowMapper implements RowMapper<Spittle> {
public Spittle mapRow(ResultSet rs, int rowNum) throws SQLException {
return new Spittle(rs.getInt("id"), rs.getString("name"));
}
}
@Override
public Spittle findSpittle(int id) {
return jdbc.queryForObject("select id,name,address from t_two where id=?",
new RowMapper<Spittle>() { // �����ڲ���
@Override
public Spittle mapRow(ResultSet rs, int rowNum) throws SQLException {
return new Spittle(rs.getInt("id"), rs.getString("name"),
rs.getString("address"));
}
},
id);
}
@Override
public int getItemSum() {
return (int) jdbc.queryForObject("select count(*) as item_sum from t_two", new RowMapper<Object>() {
@Override
public Object mapRow(ResultSet rs, int rowNum) throws SQLException {
return rs.getInt("item_sum");
}
});
}
}
对以上代码的分析（Analysis）：这个findOne()方法 使用了 JdbcTemplate.queryForObject() 方法来从数据库查询 Spitter；queryForObject() 方法有三个参数：
parameter1）String对象：包含了要从数据库中查找数据的SQL；parameter2）RowMapper对象：用来从 ResultSet 中提取数据并构建域对象；parameter3）可变参数列表：列出了要绑定到查询上的索引参数值；（Prepared Statement==预备语句）
Attention）值得注意的是 SpitterRowMapper对象中，它实现了 RowMapper接口。对于查询返回的每一行数据，JdbcTemplate 将会调用 RowMapper.mapRow()方法，并传入一个 ResultSet 和 包含行号的整数。在 SpitterRowMapper.mapRow()方法中，我们创建了 Spitter对象并将 ResultSet中的值填充进去；
【3.2.2】使用命名参数
1）intro：命名参数可以赋予SQL 中的每个参数一个明确的名字，在绑定值到查询语句的时候就通过该名字来引用参数。
2）看个荔枝：若某个sql 查询语句定义如下：
private static final String SQL_INSERT_SPITTER =
"insert into spitter (username, password, fullname) " +
"values (:username, :password, :fullname)";
对以上代码的分析（Analysis）：使用命名参数查询，绑定值的顺序就不重要了，可以按照名字来绑定值；如果查询语句发生了变化导致参数的顺序与之前不一致，我们不需要修改绑定的代码；
Attention）NamedParameterJdbcTemplate 是一个特殊的 JDBC模板类，它支持使用命名参数；其声明方式通过 JdbcTemplate：（干货——NamedParameterJdbcTemplate 支持命名参数）
@Bean
public NamedParameterJdbcTemplate jdbcTemplate(DataSource dataSource) {
return new NamedParameterJdbcTemplate(dataSource);
}
3)看个荔枝：我们将 NamedParameterJdbcOperations（NamedParameterJdbcTemplate所实现的接口）注入到 Repository中，用它来替代 JdbcOperations，现在的addSpitter()方法如下所示：
private static final String INSERT_SPITTER =
"insert into Spitter " +
" (username, password, fullname, email, updateByEmail) " +
"values " +
" (:username, :password, :fullname, :email, :updateByEmail)";
public void addSpitter(Spitter spitter) {
Map<String, Object> paramMap = new HashMap<String, Object>();
paramMap.put("username", spitter.getUsername());
paramMap.put("password", spitter.getPassword());
paramMap.put("fullname", spitter.getFullName());
paramMap.put("email", spitter.getEmail());
paramMap.put("updateByEmail", spitter.isUpdateByEmail());
jdbcOperations.update(INSERT_SPITTER, paramMap);
}