org.globus.replica.replicator.util
Interface SourceSelector

public interface SourceSelector

This interface specifies methods for selecting sources. Users of ReplicationManager may wish to implement custom logic for selecting a source file from all available sources mapping to a given logical file name. This selector, for instance, is invoked when creating transfer requests, which permits the user to specify the desired source to use in the transfer. Implementations of this interface MUST be thread safe.

Since:

1.0

Method Summary

java.util.Collection

selectSources(java.util.Collection sources) This method selects the desired source(s) from a collection of all available source(s).

Method Detail

selectSources

public java.util.Collection selectSources(java.util.Collection sources)

This method selects the desired source(s) from a collection of all available source(s). Note: Implementors MAY modify the original collection.

Parameters:

sources - A Collection of Strings that represent the name of the source.

Returns:

A Collection containing Strings that represent the URIs of sources. IMPORTANT: Implementations MUST NOT return a null collection. If no sources match the user criteria, the appropriate return value will be an empty Collection object. Note: At this time, only the first source in the collection will be used.

Since:

1.0