org.biojavax
Interface Namespace

All Superinterfaces:

Changeable, Comparable

All Known Implementing Classes:

SimpleNamespace

public interface Namespace
extends Comparable, Changeable

The namespace of an entry in a database schema. Relates directly to the BioDatabase table in BioSQL. All BioEntry objects belong to namespaces.

Since:

1.5

Author:

Mark Schreiber, Richard Holland

See Also:

BioEntry

Field Summary

static ChangeType	ACRONYM
static ChangeType	AUTHORITY
static ChangeType	DESCRIPTION
static ChangeType	NAME
static ChangeType	URI

Method Summary

String	getAcronym() If the namespace has an acronym, this will return it.
String	getAuthority() This method will return the authority that governs the namespace.
String	getDescription() Returns a description of this namespace.
String	getName() The name of the namespace is immutable and must be set by the constructor of the instantiating class.
URI	getURI() If the namespace has a URI, this will return it.
void	setAcronym(String acronym) Sets an optional acronym for the namespace.
void	setAuthority(String authority) This method sets the authority that governs the namespace.
void	setDescription(String description) This method sets a description for the namespace.
void	setURI(URI URI) Sets an optional URI for the namespace.

Methods inherited from interface java.lang.Comparable

compareTo

Methods inherited from interface org.biojava.utils.Changeable

addChangeListener, addChangeListener, isUnchanging, removeChangeListener, removeChangeListener

Field Detail

NAME

static final ChangeType NAME

AUTHORITY

static final ChangeType AUTHORITY

DESCRIPTION

static final ChangeType DESCRIPTION

ACRONYM

static final ChangeType ACRONYM

URI

static final ChangeType URI

Method Detail

getName

String getName()

The name of the namespace is immutable and must be set by the constructor of the instantiating class. The name should also be unique. This method will return the name.

Returns:

The name of the namespace.

getAuthority

String getAuthority()

This method will return the authority that governs the namespace.

Returns:

the name of the namespace authority.

setAuthority

void setAuthority(String authority)
                  throws ChangeVetoException

This method sets the authority that governs the namespace. Null will unset it.

Parameters:

authority - the name of the namespace authority.

Throws:

ChangeVetoException - in case of objections.

getDescription

String getDescription()

Returns a description of this namespace.

Returns:

the description of the namespace.

setDescription

void setDescription(String description)
                    throws ChangeVetoException

This method sets a description for the namespace. Null will unset it.

Parameters:

description - the description of the namespace.

Throws:

ChangeVetoException - in case of objections.

getAcronym

String getAcronym()

If the namespace has an acronym, this will return it.

Returns:

the acronym for the namespace.

setAcronym

void setAcronym(String acronym)
                throws ChangeVetoException

Sets an optional acronym for the namespace. Null will unset it. Note that in BioSQL 1.0 Acronym is only part of the Oracle schema therefore it will only be persisted in that schema.

Parameters:

acronym - the acronym for the namespace.

Throws:

ChangeVetoException - in case of objections.

getURI

URI getURI()

If the namespace has a URI, this will return it.

Returns:

the URI of the authority.

setURI

void setURI(URI URI)
            throws ChangeVetoException

Sets an optional URI for the namespace. Null will unset it. Note that in BioSQL 1.0 URI is not persisted into the database unless the extended Oracle schema is used.

Parameters:

URI - the URI of the authority.

Throws:

ChangeVetoException - in case of objections.