org.biojava.utils.candy
Interface CandyVocabulary

All Superinterfaces:

EventListener, PropertyChangeListener

public interface CandyVocabulary

extends PropertyChangeListener

This interface defines functionality of a controlled vocabulary. The implementation is supposed to behave as a Java bean (regarding accessing vocabulary properties).

Each vocabulary consists of (usually many) vocabulary entries which are represented by CandyEntries.

Version:

$Id: CandyVocabulary.java,v 1.5 2003/06/01 08:42:29 thomasd Exp $

Author:

Martin Senger, Matthew Pocock

Field Summary

static String	CANDIES_NOT_SORTED A property name.
static String	PROP_CASE_SENSITIVE A property name.
static String	PROP_ENTRY_COUNT A property name.
static String	PROP_VOCAB_DESC A property name.
static String	PROP_VOCAB_NAME A property name.
static String	PROP_VOCAB_VERSION A property name.
static String	PROP_VOCABULARY A property name.

Method Summary

boolean	contains(String name) It checks if a given entry exists in this vocabulary.
void	destroy() It frees all resources related to this vocabulary.
Enumeration	getAllEntries() It returns all available vocabulary entries.
Enumeration	getAllNames() It return all names (entry identifiers) available in this vocabulary.
int	getCount() It returns a number of entries contained in this vocabulary.
String	getDescription() It returns a description of this vocabulary.
CandyEntry	getEntryByName(String name) It returns a selected vocabulary entry.
String	getName() It returns a name of this vocabulary.
String	getVersion() It returns a vesrion of this vocabulary.
boolean	isCaseSensitive() It returns true if the vocabulary entries should be considered as case-sensitive.

Methods inherited from interface java.beans.PropertyChangeListener

propertyChange

Field Detail

PROP_VOCAB_NAME

public static final String PROP_VOCAB_NAME

A property name. Its value is a name of this vocabulary.

See Also:

Constant Field Values

PROP_VOCAB_DESC

public static final String PROP_VOCAB_DESC

A property name. Its value is a short description of the whole vocabulary.

See Also:

Constant Field Values

PROP_VOCAB_VERSION

public static final String PROP_VOCAB_VERSION

A property name. Its value contains a version of this vocabulary.

See Also:

Constant Field Values

PROP_CASE_SENSITIVE

public static final String PROP_CASE_SENSITIVE

A property name. Its boolean value is true if the vocabulary entries names should be considered as case-sensitive.

See Also:

Constant Field Values

PROP_ENTRY_COUNT

public static final String PROP_ENTRY_COUNT

A property name. Its value is a number of vocabulary entries in this vocabulary.

See Also:

Constant Field Values

PROP_VOCABULARY

public static final String PROP_VOCABULARY

A property name. Its type is CandyVocabulary and it can be used to set an entire vocabulary. An implementation may use it together with an empty constructor.

See Also:

Constant Field Values

CANDIES_NOT_SORTED

public static final String CANDIES_NOT_SORTED

A property name.

An implementation may use this boolean property to make sure that returned vocabulary entries are in the same order as they were read from its original source.

See Also:

Constant Field Values

Method Detail

contains

public boolean contains(String name)
                 throws CandyException

It checks if a given entry exists in this vocabulary.

Parameters:

name - of a vocabulary entry to be checked

Returns:

true if the given entry exists in this vocabulary

Throws:

CandyException - if the vocabulary is suddenly not available

getEntryByName

public CandyEntry getEntryByName(String name)
                          throws CandyException

It returns a selected vocabulary entry.

Parameters:

name - a name of a vocabulary entry to be looked up

Returns:

a vocabulary entry

Throws:

CandyException - when the given vocabulary entry does not exist

See Also:

getAllEntries

getAllEntries

public Enumeration getAllEntries()
                          throws CandyException

It returns all available vocabulary entries.

Returns:

an Enumeration object containing all available entries

Throws:

CandyException - if the vocabulary is suddenly not available

See Also:

getEntryByName

getAllNames

public Enumeration getAllNames()
                        throws CandyException

It return all names (entry identifiers) available in this vocabulary.

Returns:

an Enumeration object containing all available names

Throws:

CandyException - if the vocabulary is suddenly not available

destroy

public void destroy()
             throws CandyException

It frees all resources related to this vocabulary.

Throws:

CandyException - if the vocabulary is suddenly not available

getName

public String getName()
               throws CandyException

It returns a name of this vocabulary. The name should be unique within a CandyFinder instance who delivers this vocabulary.

Throws:

CandyException

getDescription

public String getDescription()
                      throws CandyException

It returns a description of this vocabulary.

Throws:

CandyException

getVersion

public String getVersion()
                  throws CandyException

It returns a vesrion of this vocabulary.

Throws:

CandyException

getCount

public int getCount()
             throws CandyException

It returns a number of entries contained in this vocabulary.

Throws:

CandyException

isCaseSensitive

public boolean isCaseSensitive()
                        throws CandyException

It returns true if the vocabulary entries should be considered as case-sensitive.

Throws:

CandyException