Class SourceFactory

java.lang.Object

is.galia.source.SourceFactory

public final class SourceFactory
extends Object

Used to obtain an instance of a Source defined in the configuration, or returned by a delegate method.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static enum	SourceFactory.SelectionStrategy	How sources are chosen by newSource(java.lang.String).

Method Summary

Modifier and Type	Method	Description
static Set<Source>	getAllSources()
static SourceFactory.SelectionStrategy	getSelectionStrategy()
static Source	newSource(Identifier identifier, Delegate delegate)	If Key.SOURCE_STATIC is not set, uses a delegate method to return an instance of a source for the given identifier.
static Source	newSource(String name)	Retrieves an instance by name.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

getAllSources

public static Set<Source> getAllSources()

Returns:

Set of instances of each unique Source.

getSelectionStrategy

public static SourceFactory.SelectionStrategy getSelectionStrategy()

Returns:

How sources are chosen by newSource(java.lang.String).

newSource

public static Source newSource(String name)
                        throws ClassNotFoundException,
NoSuchMethodException,
InstantiationException,
IllegalAccessException,
InvocationTargetException

Retrieves an instance by name.

Parameters:

name - Class name of the built-in source, or plugin name of the plugin source.

Returns:

Instance with the given name.

Throws:

ClassNotFoundException

NoSuchMethodException

InstantiationException

IllegalAccessException

InvocationTargetException

newSource

public static Source newSource(Identifier identifier,
 Delegate delegate)
                        throws Exception

If Key.SOURCE_STATIC is not set, uses a delegate method to return an instance of a source for the given identifier. Otherwise, returns an instance of the source specified in Key.SOURCE_STATIC.

Sources are matched in the following order:

1. Plugin sources with matching names
2. Built-in sources with matching simple names
3. Built-in sources with matching fully qualified names

Parameters:

identifier - Identifier of the source image.

delegate - Delegate. May be null if getSelectionStrategy() returns SourceFactory.SelectionStrategy.STATIC.

Returns:

Instance of the appropriate source for the given identifier, with identifier already set.

Throws:

IllegalArgumentException - if the proxy argument is null while using SourceFactory.SelectionStrategy.DELEGATE_SCRIPT.

Exception