Package net.ontopia.topicmaps.impl.basic

Class TopicName

java.lang.Object

net.ontopia.topicmaps.impl.basic.TMObject

net.ontopia.topicmaps.impl.basic.TopicName

All Implemented Interfaces:

Serializable, NameIF, ReifiableIF, ScopedIF, TMObjectIF, TopicNameIF, TypedIF

public class TopicName
extends TMObject
implements TopicNameIF

INTERNAL: The basic topic name implementation.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
protected TopicIF	reifier
protected UniqueSet<TopicIF>	scope
protected TopicIF	type
protected String	value
protected Set<VariantNameIF>	variants

Fields inherited from class net.ontopia.topicmaps.impl.basic.TMObject

oid, parent, sources, topicmap

Fields inherited from interface net.ontopia.topicmaps.core.ReifiableIF

EVENT_SET_REIFIER

Fields inherited from interface net.ontopia.topicmaps.core.TMObjectIF

EVENT_ADD_ITEMIDENTIFIER, EVENT_REMOVE_ITEMIDENTIFIER, MSG_NULL_ARGUMENT

Fields inherited from interface net.ontopia.topicmaps.core.TopicNameIF

EVENT_ADD_THEME, EVENT_ADD_VARIANT, EVENT_ADDED, EVENT_REMOVE_THEME, EVENT_REMOVE_VARIANT, EVENT_REMOVED, EVENT_SET_TYPE, EVENT_SET_VALUE

Method Summary

Modifier and Type	Method	Description
void	addTheme(TopicIF theme)	PUBLIC: Add a topic to this scope.
protected void	addVariant(VariantNameIF _variant)
protected void	fireEvent(String event, Object new_value, Object old_value)	INTERNAL: Fires an event, so that listeners can be informed about the event.
TopicIF	getReifier()	PUBLIC: Returns the topic that reifies this object.
Collection<TopicIF>	getScope()	PUBLIC: Returns the set of topics that are the stated scope of this object.
TopicIF	getTopic()	PUBLIC: Gets the topic to which this name belongs.
TopicIF	getType()	PUBLIC: Gets the type that this object is an instance of.
String	getValue()	PUBLIC: Gets the value of this name.
Collection<VariantNameIF>	getVariants()	PUBLIC: Gets the variant names of the topic named by this topic name.
protected boolean	isConnected()
void	remove()	PUBLIC: Removes the object from its parent.
void	removeTheme(TopicIF theme)	PUBLIC: Remove a topic from this scope.
protected void	removeVariant(VariantNameIF _variant)
void	setReifier(TopicIF _reifier)	PUBLIC: Sets the reifier of this object.
protected void	setTopic(Topic parent)	INTERNAL: Set the topic that the topic name belongs to.
void	setType(TopicIF type)	PUBLIC: Sets the type that this object is an instance of.
void	setValue(String value)	PUBLIC: Sets the value of this topic name.
String	toString()

Methods inherited from class net.ontopia.topicmaps.impl.basic.TMObject

addItemIdentifier, getItemIdentifiers, getObjectId, getTopicMap, isReadOnly, removeItemIdentifier

Methods inherited from class java.lang.Object

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

Methods inherited from interface net.ontopia.topicmaps.core.TMObjectIF

addItemIdentifier, getItemIdentifiers, getObjectId, getTopicMap, isReadOnly, removeItemIdentifier

Field Detail

reifier

protected TopicIF reifier

value

protected String value

type

protected TopicIF type

scope

protected UniqueSet<TopicIF> scope

variants

protected Set<VariantNameIF> variants

Method Detail

getTopic

public TopicIF getTopic()

Description copied from interface: NameIF

PUBLIC: Gets the topic to which this name belongs.

Specified by:

getTopic in interface NameIF

Returns:

The topic named by this name; an object implementing TopicIF.

setTopic

protected void setTopic(Topic parent)

INTERNAL: Set the topic that the topic name belongs to. [parent]

getValue

public String getValue()

Description copied from interface: NameIF

PUBLIC: Gets the value of this name. This corresponds to the content of the 'baseNameString' element in XTM 1.0, as a string. Where this method is implemented by an object implementing VariantNameIF, the contents of the 'variantName' element are returned instead.

Specified by:

getValue in interface NameIF

Returns:

A string which is the value of this topic name.

setValue

public void setValue(String value)

Description copied from interface: NameIF

PUBLIC: Sets the value of this topic name. This corresponds to the content of the 'baseNameString' element in XTM 1.0, as a string. Where this method is implemented by an object implementing VariantNameIF, the contents of the 'variantName' element are returned instead.

Specified by:

setValue in interface NameIF

Parameters:

value - A string which is the value of this topic name.

getVariants

public Collection<VariantNameIF> getVariants()

Description copied from interface: TopicNameIF

PUBLIC: Gets the variant names of the topic named by this topic name. These correspond to the 'variant' child elements of the 'baseName' element in XTM 1.0. There is no guarantee as to which order these appear in the collection.

Specified by:

getVariants in interface TopicNameIF

Returns:

A collection of VariantNameIF objects.

addVariant

protected void addVariant(VariantNameIF _variant)

removeVariant

protected void removeVariant(VariantNameIF _variant)

remove

public void remove()

Description copied from interface: TMObjectIF

PUBLIC: Removes the object from its parent.

Specified by:

remove in interface TMObjectIF

getScope

public Collection<TopicIF> getScope()

Description copied from interface: ScopedIF

PUBLIC: Returns the set of topics that are the stated scope of this object. Scoping topics inherited from parent objects are not included. There is no guarantee as to which order these topics are returned in.

Specified by:

getScope in interface ScopedIF

Returns:

A collection of TopicIF objects.

addTheme

public void addTheme(TopicIF theme)

Description copied from interface: ScopedIF

PUBLIC: Add a topic to this scope. (A topic used in a scope is also called a theme.) If the topic is already part of the scope the method call has no effect.

Specified by:

addTheme in interface ScopedIF

Parameters:

theme - A topic to be added to this scope; an object implementing TopicIF.

removeTheme

public void removeTheme(TopicIF theme)

Description copied from interface: ScopedIF

PUBLIC: Remove a topic from this scope. If the topic is not already in the scope this method has no effect. (A topic used in a scope is also called a theme.)

Specified by:

removeTheme in interface ScopedIF

Parameters:

theme - A topic to be removed from this scope; an object implementing TopicIF.

getType

public TopicIF getType()

Description copied from interface: TypedIF

PUBLIC: Gets the type that this object is an instance of.

Specified by:

getType in interface TypedIF

Returns:

The type of this object; an object implementing TopicIF.

setType

public void setType(TopicIF type)

Description copied from interface: TypedIF

PUBLIC: Sets the type that this object is an instance of.

Specified by:

setType in interface TypedIF

Parameters:

type - The type for this object; an object implementing TopicIF.

getReifier

public TopicIF getReifier()

Description copied from interface: ReifiableIF

PUBLIC: Returns the topic that reifies this object.

Specified by:

getReifier in interface ReifiableIF

setReifier

public void setReifier(TopicIF _reifier)

Description copied from interface: ReifiableIF

PUBLIC: Sets the reifier of this object.

Specified by:

setReifier in interface ReifiableIF

fireEvent

protected void fireEvent(String event,
                         Object new_value,
                         Object old_value)

Description copied from class: TMObject

INTERNAL: Fires an event, so that listeners can be informed about the event. This method is typically called when the object id modified.

Overrides:

fireEvent in class TMObject

isConnected

protected boolean isConnected()

Overrides:

isConnected in class TMObject

toString

public String toString()

Overrides:

toString in class Object