eu.bandm.tools.util2

Class SourceHabitats

java.lang.Object

eu.bandm.tools.util2.SourceHabitats

public class SourceHabitats
extends Object

Organizes a collection of places where to look for resources (=input files).
A sequence of SourceHabitats.SourceHabitat is maintained which will be searched for a file, ie. a data source with a certain file name. Currently this can be a SourceHabitats.SourceHabitat_file as a pointer into the file system, or a SourceHabitats.SourceHabitat_resource as a class which cames with "resources", eg. in a ".jar" file.
FIXME: A URL style href search should be added!

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	SourceHabitats.FoundSource Represents the only one data source which has been successfully found for one particular resource name (mostly a "file name stem").
class	SourceHabitats.SourceHabitat Represents one of many potential sources which have to be searched for library modules, etc.
protected class	SourceHabitats.SourceHabitat_file Represents a source habitat which is a directory in the file system.
protected class	SourceHabitats.SourceHabitat_resource Represents a source habitat which points to a directory, relative to the position of a loaded java class.

Field Summary

Fields

Modifier and Type	Field and Description
protected MessageReceiver<SimpleMessage<XMLDocumentIdentifier>>	msg
static String	PREFIX_FILE
static String	PREFIX_RESOURCE
static String	RELATIVE_PATH_SEPARATOR
protected static Function<SourceHabitats.SourceHabitat,String>	SourceHabitat_get_name
protected List<SourceHabitats.SourceHabitat>	sourceList

Constructor Summary

Constructors

Constructor and Description
SourceHabitats(MessageReceiver<SimpleMessage<XMLDocumentIdentifier>> msg)

Method Summary

Modifier and Type	Method and Description
String	allPlaces_toString()
void	appendNewHabitat(String s, @Opt String additionalErrorText) Service access point for adding a habitat to the end of the search list.
protected void	ERROR(String txt)
protected void	LOG(String txt)
protected @Opt SourceHabitats.SourceHabitat	makeHabitat(String name, @Opt String additionalErrorText) Internal method to check whether the input to appendNewHabitat(String,String) is consistent.
@Opt SourceHabitats.FoundSource	searchAllPlaces(String name, boolean verbose, String... suffices) Service access point for searching all habitats, for the name of the resources, tested with all suffixed.

Methods inherited from class java.lang.Object

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

Field Detail

PREFIX_FILE

public static final String PREFIX_FILE

See Also:

Constant Field Values

PREFIX_RESOURCE

public static final String PREFIX_RESOURCE

See Also:

Constant Field Values

RELATIVE_PATH_SEPARATOR

public static final String RELATIVE_PATH_SEPARATOR

See Also:

Constant Field Values

msg

protected MessageReceiver<SimpleMessage<XMLDocumentIdentifier>> msg

sourceList

protected List<SourceHabitats.SourceHabitat> sourceList

SourceHabitat_get_name

protected static Function<SourceHabitats.SourceHabitat,String> SourceHabitat_get_name

Constructor Detail

SourceHabitats

public SourceHabitats(MessageReceiver<SimpleMessage<XMLDocumentIdentifier>> msg)

Method Detail

allPlaces_toString

public String allPlaces_toString()

searchAllPlaces

@Opt
public @Opt SourceHabitats.FoundSource searchAllPlaces(String name,
                                                            boolean verbose,
                                                            String... suffices)

Service access point for searching all habitats, for the name of the resources, tested with all suffixed. The suffixes are tested faster, i.e.all are tested per habitat in the sequential order of the argument. The suffixes must include a leading dot (="."), but can also be totally empty.

appendNewHabitat

public void appendNewHabitat(String s,
                             @Opt
                             @Opt String additionalErrorText)

Service access point for adding a habitat to the end of the search list. Does so only if consistency checks okay.

Parameters:

s - name of the habitat according to the defined prefices, see class docu text.

ERROR

protected void ERROR(String txt)

LOG

protected void LOG(String txt)

makeHabitat

@Opt
protected @Opt SourceHabitats.SourceHabitat makeHabitat(String name,
                                                             @Opt
                                                             @Opt String additionalErrorText)

Internal method to check whether the input to appendNewHabitat(String,String) is consistent.