org.apache.commons.mail.resolver
Class DataSourceCompositeResolver

java.lang.Object
  extended by org.apache.commons.mail.resolver.DataSourceBaseResolver
      extended by org.apache.commons.mail.resolver.DataSourceCompositeResolver
All Implemented Interfaces:
DataSourceResolver

public class DataSourceCompositeResolver
extends DataSourceBaseResolver

A composite data source resolver. It allows to resolve data sources coming from multiple locations such as the classpath, the file system or an URL.

Since:
1.3
Version:
$Id: DataSourceCompositeResolver.java 1420381 2012-12-11 20:18:05Z tn $

Constructor Summary
DataSourceCompositeResolver(DataSourceResolver[] dataSourceResolvers)
          Constructor.
DataSourceCompositeResolver(DataSourceResolver[] dataSourceResolvers, boolean isLenient)
          Constructor.
 
Method Summary
 DataSourceResolver[] getDataSourceResolvers()
          Get the underlying data source resolvers.
 DataSource resolve(String resourceLocation)
          Resolves the given resource location to a DataSource.
 DataSource resolve(String resourceLocation, boolean isLenient)
          Resolves the given resource location to a DataSource.
 
Methods inherited from class org.apache.commons.mail.resolver.DataSourceBaseResolver
isCid, isFileUrl, isHttpUrl, isLenient
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

DataSourceCompositeResolver

public DataSourceCompositeResolver(DataSourceResolver[] dataSourceResolvers)
Constructor.

Parameters:
dataSourceResolvers - a list of of resolvers being used

DataSourceCompositeResolver

public DataSourceCompositeResolver(DataSourceResolver[] dataSourceResolvers,
                                   boolean isLenient)
Constructor.

Parameters:
dataSourceResolvers - a list of of resolvers being used
isLenient - shall we ignore resources not found or throw an exception?
Method Detail

getDataSourceResolvers

public DataSourceResolver[] getDataSourceResolvers()
Get the underlying data source resolvers.

Returns:
underlying data source resolvers

resolve

public DataSource resolve(String resourceLocation)
                   throws IOException
Resolves the given resource location to a DataSource.

Parameters:
resourceLocation - the location of the resource
Returns:
the DataSource
Throws:
IOException - the resource was not found

resolve

public DataSource resolve(String resourceLocation,
                          boolean isLenient)
                   throws IOException
Resolves the given resource location to a DataSource.

Parameters:
resourceLocation - the location of the resource
isLenient - shall we ignore resources not found or complain with an exception?
Returns:
the data source containing the resource or null if the resource was not found in lenient mode
Throws:
IOException - resolving the resource failed


Copyright © 2001-2013 The Apache Software Foundation. All Rights Reserved.