动态数据源路由

工程 | Mark Fisher | 2007年1月23日 | ...

Spring 2.0.1 引入了 AbstractRoutingDataSource。我相信它值得关注,因为(根据客户的频繁提问)我预感有很多“自制”的解决方案在解决这个问题。再加上它实现起来很简单但又容易被忽视的事实,现在我有几个理由来掸去团队博客我这个角落的灰尘了。

总体的想法是,一个路由DataSource充当一个中介——而“真实”的DataSource可以在运行时根据查找键动态确定。一个潜在的用例是确保标准JTA不支持的事务特定隔离级别。为此,Spring提供了一个实现:IsolationLevelDataSourceRouter。有关详细描述(包括配置示例),请参阅其JavaDoc。

另一个有趣的用例是根据当前用户上下文的某些属性来确定DataSource。下面是一个相当牵强的例子来演示这个想法。

首先,我创建了一个Catalog,它扩展了Spring 2.0的SimpleJdbcDaoSupport。该基类只需要一个javax.sql.DataSource实现的实例,然后它会为你创建一个SimpleJdbcTemplate。由于它扩展了JdbcDaoSupport,所以JdbcTemplate也可用。然而,“简单”版本提供了许多不错的Java 5便利功能。你可以在Ben Hale的这篇博客中了解更多细节。

总之,这是我的Catalog的代码。

package blog.datasource;

import java.sql.ResultSet;
import java.sql.SQLException;
import java.util.List;

import org.springframework.jdbc.core.simple.ParameterizedRowMapper;
import org.springframework.jdbc.core.simple.SimpleJdbcDaoSupport;

public class Catalog extends SimpleJdbcDaoSupport {
	
   public List<Item> getItems() {
      String query = "select name, price from item";
      return getSimpleJdbcTemplate().query(query, new ParameterizedRowMapper<Item>() {
            public Item mapRow(ResultSet rs, int row) throws SQLException {
               String name = rs.getString(1);
               double price = rs.getDouble(2);
               return new Item(name, price);
            }
      });
   }
}

正如你所见,Catalog只是返回一个item对象的列表。Item只包含name和price属性。

package blog.datasource;

public class Item {

   private String name;
   private double price;
	
   public Item(String name, double price) {
      this.name = name;
      this.price = price;
   }

   public String getName() {
      return name;
   }

   public double getPrice() {
      return price;
   }

   public String toString() {
      return name + " (" + price + ")";
   }

}

现在,为了演示多个DataSource,我为不同的Customer类型创建了一个枚举(我猜代表了会员“级别”),并创建了三个不同的数据库——以便每种类型的客户都能获得一个独特的项目列表(我之前提到过这会是一个牵强的例子,不是吗?)。重要的是,每个数据库在模式方面都是等效的。这样Catalog的查询就可以针对其中任何一个运行——只是返回不同的结果。在这种情况下,它只是一个包含2列的“item”表:name和price。还有……这是枚举。

public enum CustomerType {
   BRONZE, 
   SILVER, 
   GOLD
}

现在是时候创建一些bean定义了。由于我有3个DataSource,除了端口号之外,其他所有内容都相同,我创建了一个父bean,以便可以继承共享的属性。然后,我添加了3个bean定义来表示每个CustomerType的DataSource。

<bean id="parentDataSource"
         class="org.springframework.jdbc.datasource.DriverManagerDataSource"
         abstract="true">
   <property name="driverClassName" value="org.hsqldb.jdbcDriver"/>
   <property name="username" value="sa"/>
</bean>
		
<bean id="goldDataSource" parent="parentDataSource">
   <property name="url" value="jdbc:hsqldb:hsql://:${db.port.gold}/blog"/>
</bean>

<bean id="silverDataSource" parent="parentDataSource">
   <property name="url" value="jdbc:hsqldb:hsql://:${db.port.silver}/blog"/>
</bean>

<bean id="bronzeDataSource" parent="parentDataSource">
   <property name="url" value="jdbc:hsqldb:hsql://:${db.port.bronze}/blog"/>
</bean>

<bean class="org.springframework.beans.factory.config.PropertyPlaceholderConfigurer">
   <property name="location" value="classpath:/blog/datasource/db.properties"/>
</bean>	

请注意,我添加了一个PropertyPlaceholderConfigurer,以便我可以在“db.properties”文件中将端口号外部化,如下所示。

db.port.gold=9001
db.port.silver=9002
db.port.bronze=9003

现在事情开始变得有趣了。我需要为我的Catalog提供“路由”DataSource,以便它可以在运行时根据当前客户的类型动态地从3个不同的数据库获取连接。正如我所提到的,AbstractRoutingDataSource的实现可能相当简单。这是我的实现。

package blog.datasource;

import org.springframework.jdbc.datasource.lookup.AbstractRoutingDataSource;

public class CustomerRoutingDataSource extends AbstractRoutingDataSource {

   @Override
   protected Object determineCurrentLookupKey() {
      return CustomerContextHolder.getCustomerType();
   }
}

……而CustomerContextHolder只是提供对线程绑定CustomerType的访问。实际上,“上下文”可能包含更多关于客户的信息。另请注意,如果你正在使用Spring Security,那么你可以从userDetails中检索一些信息。在此示例中,它只是客户“类型”。

public class CustomerContextHolder {

   private static final ThreadLocal<CustomerType> contextHolder = 
            new ThreadLocal<CustomerType>();
	
   public static void setCustomerType(CustomerType customerType) {
      Assert.notNull(customerType, "customerType cannot be null");
      contextHolder.set(customerType);
   }

   public static CustomerType getCustomerType() {
      return (CustomerType) contextHolder.get();
   }

   public static void clearCustomerType() {
      contextHolder.remove();
   }
}

最后,我只需要配置catalog和routing DataSource bean。正如你所见,“真实”DataSource的引用在Map中提供。如果提供字符串,它们可以解析为JNDI名称(或者可以提供任何自定义解析策略——请参阅JavaDoc)。此外,我简单地将“bronzeDataSource”设置为默认值。

<bean id="catalog" class="blog.datasource.Catalog">
   <property name="dataSource" ref="dataSource"/>
</bean>

<bean id="dataSource" class="blog.datasource.CustomerRoutingDataSource">
   <property name="targetDataSources">
      <map key-type="blog.datasource.CustomerType">
         <entry key="GOLD" value-ref="goldDataSource"/>
         <entry key="SILVER" value-ref="silverDataSource"/>
      </map>
   </property>
   <property name="defaultTargetDataSource" ref="bronzeDataSource"/>
</bean>

当然,我想看到这个工作,所以我创建了一个简单的测试(它扩展了Spring的一个集成测试支持类)。我在“gold”数据库中添加了3个项目,“silver”数据库中添加了2个项目,而“bronze”数据库中只添加了1个项目。这是测试。

public class CatalogTests extends AbstractDependencyInjectionSpringContextTests {

   private Catalog catalog;

   public void setCatalog(Catalog catalog) {
      this.catalog = catalog;
   }

   public void testDataSourceRouting() {
      CustomerContextHolder.setCustomerType(CustomerType.GOLD);
      List<Item> goldItems = catalog.getItems();
      assertEquals(3, goldItems.size());
      System.out.println("gold items: " + goldItems);

      CustomerContextHolder.setCustomerType(CustomerType.SILVER);
      List<Item> silverItems = catalog.getItems();
      assertEquals(2, silverItems.size());
      System.out.println("silver items: " + silverItems);
	
      CustomerContextHolder.clearCustomerType();
      List<Item> bronzeItems = catalog.getItems();
      assertEquals(1, bronzeItems.size());
      System.out.println("bronze items: " + bronzeItems);		
   }

   protected String[] getConfigLocations() {
      return new String[] {"/blog/datasource/beans.xml"};
   }	
}

……而且,而不是简单地截取绿色条形图的屏幕截图,你会注意到我提供了一些控制台输出——结果!

gold items: [gold item #1 (250.0), gold item #2 (325.45), gold item #3 (55.6)]
silver items: [silver item #1 (25.0), silver item #2 (15.3)]
bronze items: [bronze item #1 (23.75)]

正如你所见,配置很简单。更好的是,数据访问代码不必关心查找不同的DataSource。有关更多信息,请参阅AbstractRoutingDataSource的JavaDoc。

获取 Spring 新闻通讯

通过 Spring 新闻通讯保持联系

订阅

领先一步

VMware 提供培训和认证,助您加速进步。

了解更多

获得支持

Tanzu Spring 提供 OpenJDK™、Spring 和 Apache Tomcat® 的支持和二进制文件,只需一份简单的订阅。

了解更多

即将举行的活动

查看 Spring 社区所有即将举行的活动。

查看所有