类 AbstractRoutingDataSource

构造器详细资料

• AbstractRoutingDataSource

  public AbstractRoutingDataSource()

方法详细资料

• setTargetDataSources

  public void setTargetDataSources​(Map<Object,​Object> targetDataSources)

  Specify the map of target DataSources, with the lookup key as key. The mapped value can either be a corresponding DataSource instance or a data source name String (to be resolved via a DataSourceLookup).

  The key can be of arbitrary type; this class implements the generic lookup process only. The concrete key representation will be handled by resolveSpecifiedLookupKey(Object) and determineCurrentLookupKey().

• setDefaultTargetDataSource

  public void setDefaultTargetDataSource​(Object defaultTargetDataSource)

  Specify the default target DataSource, if any.

  The mapped value can either be a corresponding DataSource instance or a data source name String (to be resolved via a DataSourceLookup).

  This DataSource will be used as target if none of the keyed targetDataSources match the determineCurrentLookupKey() current lookup key.

• setLenientFallback

  public void setLenientFallback​(boolean lenientFallback)

  Specify whether to apply a lenient fallback to the default DataSource if no specific DataSource could be found for the current lookup key.

  Default is "true", accepting lookup keys without a corresponding entry in the target DataSource map - simply falling back to the default DataSource in that case.

  Switch this flag to "false" if you would prefer the fallback to only apply if the lookup key was null. Lookup keys without a DataSource entry will then lead to an IllegalStateException.

  另请参阅:

  setTargetDataSources(java.util.Map<java.lang.Object, java.lang.Object>), setDefaultTargetDataSource(java.lang.Object), determineCurrentLookupKey()

• setDataSourceLookup

  public void setDataSourceLookup​(@Nullable
                                  DataSourceLookup dataSourceLookup)

  Set the DataSourceLookup implementation to use for resolving data source name Strings in the targetDataSources map.

  Default is a JndiDataSourceLookup, allowing the JNDI names of application server DataSources to be specified directly.

• afterPropertiesSet

  public void afterPropertiesSet()

  从接口复制的说明: InitializingBean
  Invoked by the containing BeanFactory after it has set all bean properties and satisfied BeanFactoryAware, ApplicationContextAware etc.

  This method allows the bean instance to perform validation of its overall configuration and final initialization when all bean properties have been set.

  指定者:

  afterPropertiesSet 在接口中 InitializingBean

• resolveSpecifiedLookupKey

  protected Object resolveSpecifiedLookupKey​(Object lookupKey)

  Resolve the given lookup key object, as specified in the targetDataSources map, into the actual lookup key to be used for matching with the current lookup key.

  The default implementation simply returns the given key as-is.

  参数:

  lookupKey - the lookup key object as specified by the user

  返回:

  the lookup key as needed for matching

• resolveSpecifiedDataSource

  protected DataSource resolveSpecifiedDataSource​(Object dataSource)
                                           throws IllegalArgumentException

  Resolve the specified data source object into a DataSource instance.

  The default implementation handles DataSource instances and data source names (to be resolved via a DataSourceLookup).

  参数:

  dataSource - the data source value object as specified in the targetDataSources map

  返回:

  the resolved DataSource (never null)

  抛出:

  IllegalArgumentException - in case of an unsupported value type

• getResolvedDataSources

  public Map<Object,​DataSource> getResolvedDataSources()

  Return the resolved target DataSources that this router manages.

  返回:

  an unmodifiable map of resolved lookup keys and DataSources

  抛出:

  IllegalStateException - if the target DataSources are not resolved yet

  从以下版本开始:

  5.2.9

  另请参阅:

  setTargetDataSources(java.util.Map<java.lang.Object, java.lang.Object>)

• getResolvedDefaultDataSource

  @Nullable
  public DataSource getResolvedDefaultDataSource()

  Return the resolved default target DataSource, if any.

  返回:

  the default DataSource, or null if none or not resolved yet

  从以下版本开始:

  5.2.9

  另请参阅:

  setDefaultTargetDataSource(java.lang.Object)

• getConnection

  public Connection getConnection()
                           throws SQLException

  指定者:

  getConnection 在接口中 DataSource

  抛出:

  SQLException

• getConnection

  public Connection getConnection​(String username,
                                  String password)
                           throws SQLException

  指定者:

  getConnection 在接口中 DataSource

  抛出:

  SQLException

• unwrap

  public <T> T unwrap​(Class<T> iface)
               throws SQLException

  指定者:

  unwrap 在接口中 Wrapper

  覆盖:

  unwrap 在类中 AbstractDataSource

  抛出:

  SQLException

• isWrapperFor

  public boolean isWrapperFor​(Class<?> iface)
                       throws SQLException

  指定者:

  isWrapperFor 在接口中 Wrapper

  覆盖:

  isWrapperFor 在类中 AbstractDataSource

  抛出:

  SQLException

• determineTargetDataSource

  protected DataSource determineTargetDataSource()

  Retrieve the current target DataSource. Determines the current lookup key, performs a lookup in the targetDataSources map, falls back to the specified default target DataSource if necessary.

  另请参阅:

  determineCurrentLookupKey()

• determineCurrentLookupKey

  @Nullable
  protected abstract Object determineCurrentLookupKey()

  Determine the current lookup key. This will typically be implemented to check a thread-bound transaction context.

  Allows for arbitrary keys. The returned key needs to match the stored lookup key type, as resolved by the resolveSpecifiedLookupKey(java.lang.Object) method.