eu.bandm.tools.util2

Class SourceHabitats.SourceHabitat

java.lang.Object

eu.bandm.tools.util2.SourceHabitats.SourceHabitat

Direct Known Subclasses:

SourceHabitats.SourceHabitat_file, SourceHabitats.SourceHabitat_resource

Enclosing class:

SourceHabitats

public abstract class SourceHabitats.SourceHabitat
extends Object

Represents one of many potential sources which have to be searched for library modules, etc.

Field Summary

Fields

Modifier and Type	Field and Description
protected String	name Must be encoded with the prefix rules, as described in the class doc text.
protected boolean	ok Set once on initialization to indicate that this Habitat is usable for searching.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	SourceHabitat(String name)

Method Summary

Modifier and Type	Method and Description
protected @Opt SourceHabitats.FoundSource	test_for_inputStream(String id, boolean verbose, String[] suffices) Deliver an input source or null, if no resource found.
protected abstract @Opt SourceHabitats.FoundSource	test_idExt(String id, boolean verbose, String ext) Finds the resource with the given name.

Methods inherited from class java.lang.Object

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

Field Detail

name

protected String name

Must be encoded with the prefix rules, as described in the class doc text.

ok

protected boolean ok

Set once on initialization to indicate that this Habitat is usable for searching.

Constructor Detail

SourceHabitat

protected SourceHabitat(String name)

Method Detail

test_idExt

@Opt
protected abstract @Opt SourceHabitats.FoundSource test_idExt(String id,
                                                                   boolean verbose,
                                                                   String ext)

Finds the resource with the given name. This must be implemented differently for different kinds of Habitats.

Parameters:

id - name of the resource (mostly the file name "stem")

ext - extension of the resource name / file name. The leading dot (=".") must be included.

Returns:

the found resource or null if no such exists.

test_for_inputStream

@Opt
protected @Opt SourceHabitats.FoundSource test_for_inputStream(String id,
                                                                    boolean verbose,
                                                                    String[] suffices)

Deliver an input source or null, if no resource found. Fills in the found stream and "location" into the a SourceHabitats.FoundSource object. This implementation works for all kinds of habitats by calling test_idExt(String,boolean,String).