原文地址:http://my.oschina.net/devleon/blog/530803?fromerr=9Z8ZFdbf
自Spring3.0开 始,Spring正式将JavaConfig引入了Spring框架,我们可以基于纯Java代码来配置Spring容器和Web容器,不再需要任何 XML文件。摒弃XML文件而采用全Java配置的模式正逐渐变成主流。当然我们也不否认现阶段的一些配置还依然需要依托XML,Java应用彻底抛弃 XML配置文件还有很长的一段路要走。在本文中,我们将基于纯Java代码来配置一个Spring Web项目。
回忆一下,我们通常需要在applicationContext.xml和xxx-servlet.xml中配置哪些东西?一般来讲,我们会配置组 件扫描、数据源、事务管理器、自定义的一些工具类、切面、消息转换器、静态资源处理以及视图等。为了有条理的组织我们的配置类,我们将这些东西分为几个部 分来配置。
我们首先来配置数据源和事务管理器。既然我们是基于纯Java代码来配置,我们就需要考虑配置的可扩展性,我们希望提供的配置能够最大可能的适用于 不同的项目,而不是只能用于一个项目。所以,对于数据源和事务管理,我们首先提供一个抽象类DBConfig,这个类提供了事务管理器和一些自定义的数据 库访问工具,然后提供一个实现数据源抽象方法。源码如下:
package com.kiiwow.framework.config.context.spring.rest.dbconfig;
import javax.sql.DataSource;
import org.springframework.context.annotation.Bean;
import org.springframework.jdbc.core.JdbcTemplate;
import org.springframework.jdbc.datasource.DataSourceTransactionManager;
import com.kiiwow.framework.database.jdbc.JDBCAccess;
import com.kiiwow.framework.database.jdbc.JDBCAccessContext;
/**
* 基本的数据库配置
* 统一配置了数据库访问工具和事务管理器 * 具体的数据库配置类需要实现数据源创建的抽象方法 * 这个类为实现不同的数据源提供了接口 * * @author leon.gan * */ public abstract class DBConfig { /** * 数据源,由子类实现 */ public abstract DataSource dataSource(); /** * 事务管理器 */ @Bean public DataSourceTransactionManager dataSourceTransactionManager() { DataSourceTransactionManager dataSourceTransactionManager = new DataSourceTransactionManager(); dataSourceTransactionManager.setDataSource(dataSource()); return dataSourceTransactionManager; } /** * SpringJDBC Template */ @Bean public JdbcTemplate jdbcTemplate() { JdbcTemplate jdbcTemplate = new JdbcTemplate(); jdbcTemplate.setDataSource(dataSource()); return jdbcTemplate; } /** * JDBC访问接口 */ @Bean public JDBCAccess jdbcAccess() { JDBCAccess jdbcAccess = new JDBCAccess(); jdbcAccess.setJdbcTemplate(jdbcTemplate()); return jdbcAccess; } /** * 实际用于执行SQL的工具 */ @Bean public JDBCAccessContext jdbcAccessContext() { JDBCAccessContext jdbcAccessContext = new JDBCAccessContext(); jdbcAccessContext.setJdbcAccess(jdbcAccess()); return jdbcAccessContext; } }
我们需要将DBConfig中的事务管理器和数据库访问工具注册成为被Spring管理的Bean,在方法上添加@Bean注解即可,默认是单例。 这个类并没有指定具体的数据源,而是由子类去实现dataSource()方法来指定,这样就做到了可扩展。(对于以上代码中Jdbc相关的工具类,请参考博文《对JdbcTemplate进行简易封装以使其更加易用》)接下来,我们提供一个BasicDataSourceDBConfig,这个类继承自DBConfig,并实现dataSource()方法提供了一个BasicDataSource数据源。源码如下:
package com.kiiwow.framework.config.context.spring.rest.dbconfig;
import javax.inject.Inject;
import javax.sql.DataSource;
import org.apache.commons.dbcp.BasicDataSource; import org.springframework.context.annotation.Bean; import com.kiiwow.framework.config.context.spring.KiiwowEnvironment; /** * Apache BasicDataSource 数据源配置 * * @author leon.gan * */ public class BasicDataSourceDBConfig extends DBConfig { @Inject KiiwowEnvironment environment; @Bean public DataSource dataSource() { BasicDataSource ds = new BasicDataSource(); ds.setDriverClassName(environment.getProperty("jdbc.driver")); ds.setUrl(environment.getProperty("kiiwow_jdbc.url")); ds.setUsername(environment.getProperty("kiiwow_jdbc.username")); ds.setPassword(environment.getProperty("kiiwow_jdbc.password")); ds.setTestOnBorrow(true); ds.setValidationQuery("select 1 from dual"); return ds; } }
我们在实际使用时,只要使用BasicDataSourceDBConfig这个类即可。同理,我们也可以提供一个C3p0DataSourceDBConfig类来实现C3P0数据源,源码如下:
package com.kiiwow.framework.config.context.spring.rest.dbconfig;
import javax.inject.Inject;
import javax.sql.DataSource;
import org.springframework.context.annotation.Bean; import com.kiiwow.framework.config.context.spring.KiiwowEnvironment; import com.mchange.v2.c3p0.ComboPooledDataSource; /** * C3P0数据源配置 * * @author leon.gan * */ public class C3p0DataSourceDBConfig extends DBConfig { @Inject KiiwowEnvironment environment; @Bean public DataSource dataSource() { try { ComboPooledDataSource dataSource = new ComboPooledDataSource(); dataSource.setDriverClass(environment.getProperty("db.c3p0.driverClassName")); dataSource.setJdbcUrl(environment.getProperty("kiiwow_db.c3p0.url")); dataSource.setUser(environment.getProperty("kiiwow_db.c3p0.username")); dataSource.setPassword(environment.getProperty("kiiwow_db.c3p0.password")); //当连接池在没有可用空闲连接时每次可以新增的连接数 dataSource.setAcquireIncrement(environment.getRequiredProperty("c3p0.acquireIncrement", int.class, 5)); //连接池初始连接数 dataSource.setInitialPoolSize(environment.getRequiredProperty("c3p0.initialPoolSize", int.class, 5)); //连接池可持有的最大连接数 dataSource.setMaxPoolSize(environment.getRequiredProperty("c3p0.maxPoolSize", int.class, 200)); //连接池可持有的最小连接数 dataSource.setMinPoolSize(environment.getRequiredProperty("c3p0.minPoolSize", int.class, 5)); //连接池中的连接失效的阀值(即最大未被使用时长) dataSource.setMaxIdleTime(environment.getRequiredProperty("c3p0.maxIdleSize", int.class, 1800)); //与MaxIdleTime配合使用,必须小于MaxIdleTime的值,用于减少连接池中的连接 dataSource.setMaxIdleTimeExcessConnections(environment.getRequiredProperty("c3p0.maxIdleTimeExcessConnections", int.class, 1200)); //连接最大存活时间,超过这个时间将被断开,正在使用的连接在使用完毕后被断开 dataSource.setMaxConnectionAge(environment.getRequiredProperty("c3p0.maxConnectionAge", int.class, 1000)); //进行空闲连接测试的SQL dataSource.setPreferredTestQuery(environment.getProperty("c3p0.preferredTestQuery", "select 1 from dual")); //进行空闲连接测试的时间间隔 dataSource.setIdleConnectionTestPeriod(environment.getRequiredProperty("c3p0.idleConnectionTestPeriod", int.class, 120)); return dataSource; } catch (Exception e) { throw new RuntimeException(e); } } }
在上面的代码中,出现了一个KiiwowEnvironment类,这个类是对 org.springframework.core.env.Environment的封装,以实现编码解码功能。为了说明这个类的作用,我们首先来看看 Environment这个接口的作用。这个接口是与@PropertySources注解配合工作的,我们在@PropertySources注解中指 定的配置文件会自动被加载到Environment的实现中以key-value形式存储,我们可以通过Environment提供的 getProperty(String key)等方法通过属性名获取属性值。
在我们的设计中有一个特殊的需求,我们希望配置在properties文件中的数据库连接以及账号密码都是经过加密的,这样可以一定程度上防止数据库信息泄 露。所以我们定义在properties文件中所有以"kiiwow_"开头的属性,其对应的值都是经过Base64编码的结果,所以在我们通过 Environment取出这些值的时候也要进行解码。不幸的是,Environment并不具备编码解码功能,我们需要自己实现,所以有了 KiiwowEnvironment这个类。源码如下:
package com.kiiwow.framework.config.context.spring;
import javax.inject.Inject;
import org.springframework.core.env.Environment;
import org.springframework.stereotype.Component; import com.kiiwow.framework.util.DigestUtils; /** * 自定义环境类 * 基于JavaConfig配置Spring的情况下,使用@PropertySource注解将配置属性注入Environment中后 * Environment不能支持解码已编码的属性值。所以提供这个类对数据获取进行解码操作。 * * @author leon.gan * */ @Component public class KiiwowEnvironment { @Inject Environment env; /** * 所有以kiiwow_开头的属性,其值都需要经过Base64解码后使用 */ public String getProperty(String propertyName) { if (propertyName.startsWith("kiiwow_")) { String originalValue = env.getProperty(propertyName); return DigestUtils.decodeBase64(originalValue); } else { return env.getProperty(propertyName); } } /** * 没有配置属性时采用默认值 */ public String getProperty(String propertyName, String defaultValue) { if (propertyName.startsWith("kiiwow_")) { String originalValue = env.getProperty(propertyName); return originalValue == null ? null : DigestUtils.decodeBase64(originalValue); } else { return env.getProperty(propertyName) == null ? defaultValue : env.getProperty(propertyName); } } /** * 将值转换为指定类型 */ public <T> T getRequiredProperty(String propertyName, Class<T> targetType) { return env.getRequiredProperty(propertyName, targetType); } /** * 属性不存在则返回默认值 */ public <T> T getRequiredProperty(String propertyName, Class<T> targetType, T defaultValue) { try { return env.getRequiredProperty(propertyName, targetType); } catch (Exception e) { return defaultValue; } } }
从上面的代码可以看到,我们只是将org.springframework.core.env.Environment 注入,然后在调用他的getProperty(String key)等方法前增加了判断属性名是否以"kiiwow_"开头的逻辑。同时提供了处理属性名不存在于配置文件则返回默认值的方法。特别注意,我们需要将 这个类注册成为Spring容器的一个组件,即在类上使用@Component注解,否则org.springframework.core.env.Environment是无法注入的。(这个解决方法特别感谢@YouKnowNothing 的帮助)。
至此,我们对于数据源和事务管理的配置就结束了。我们可以自由继承DBConfig类来扩展我们需要的数据源,也能对配置文件中的敏感信息进行编码 防止信息泄露。不过需要指出的是,这种处理敏感信息的方法依然不是最优的。由于我们要进行解码,所以我们只能使用双向加密策略,如果别人知道了你的编码策 略,也能够轻松破解。我们将在下一篇文章中讲解对于静态资源、视图解析器、消息转换器的配置以及web.xml的Java代码化。
感谢您的阅览,劳烦点个赞。