net.ontopia.topicmaps.core
Interface TopicMapIF

All Superinterfaces:
ReifiableIF, TMObjectIF
All Known Implementing Classes:
ReadOnlyTopicMap, TopicMap, TopicMap

public interface TopicMapIF
extends TMObjectIF, ReifiableIF

PUBLIC: Represents an entire topic map.


Field Summary
static String EVENT_ADD_ASSOCIATION
           
static String EVENT_ADD_TOPIC
           
static String EVENT_REMOVE_ASSOCIATION
           
static String EVENT_REMOVE_TOPIC
           
 
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
 
Method Summary
 void clear()
          PUBLIC: Clears the topic map by removing all topics and associations.
 Collection<AssociationIF> getAssociations()
          PUBLIC: Gets all associations in this topic map.
 TopicMapBuilderIF getBuilder()
          PUBLIC: Gets a topic map builder for use with this transaction.
 Object getIndex(String name)
          PUBLIC: Gets an index by name.
 TMObjectIF getObjectById(String object_id)
          PUBLIC: Gets the topic map object that has the given object id, from this topic map.
 TMObjectIF getObjectByItemIdentifier(LocatorIF locator)
          PUBLIC: Gets the topic map object that has the given item identifier (given as a LocatorIF object), from this topic map.
 TopicMapStoreIF getStore()
          PUBLIC: Gets the store to which the topic map's transaction is connected.
 TopicIF getTopicBySubjectIdentifier(LocatorIF locator)
          PUBLIC: Gets the topic that has the specified subject identifier, given as a locator.
 TopicIF getTopicBySubjectLocator(LocatorIF locator)
          PUBLIC: Gets the topic in this topic map that represents the given addressable subject (locator given as a LocatorIF object).
 Collection<TopicIF> getTopics()
          PUBLIC: Gets all topics in this topic map.
 
Methods inherited from interface net.ontopia.topicmaps.core.ReifiableIF
getReifier, setReifier
 
Methods inherited from interface net.ontopia.topicmaps.core.TMObjectIF
addItemIdentifier, getItemIdentifiers, getObjectId, getTopicMap, isReadOnly, remove, removeItemIdentifier
 

Field Detail

EVENT_ADD_TOPIC

static final String EVENT_ADD_TOPIC
See Also:
Constant Field Values

EVENT_REMOVE_TOPIC

static final String EVENT_REMOVE_TOPIC
See Also:
Constant Field Values

EVENT_ADD_ASSOCIATION

static final String EVENT_ADD_ASSOCIATION
See Also:
Constant Field Values

EVENT_REMOVE_ASSOCIATION

static final String EVENT_REMOVE_ASSOCIATION
See Also:
Constant Field Values
Method Detail

getStore

TopicMapStoreIF getStore()
PUBLIC: Gets the store to which the topic map's transaction is connected.

Since:
2.0

getBuilder

TopicMapBuilderIF getBuilder()
PUBLIC: Gets a topic map builder for use with this transaction.

Returns:
An object implementing TopicMapBuilderIF
Since:
4.0

getIndex

Object getIndex(String name)
PUBLIC: Gets an index by name. An index is usually named by the IndexIF subinterface that it implements. All indexes are kept up-to-date at all times.

Parameters:
name - A string; the index name, i.e.g the interface that it implements.
Returns:
An instance implementing the index interface.
Throws:
OntopiaUnsupportedException - Thrown if the index is either unknown or not supported.
Since:
4.0

getTopics

Collection<TopicIF> getTopics()
PUBLIC: Gets all topics in this topic map. No specific order is guaranteed.

Returns:
A collection of TopicIF objects.

getAssociations

Collection<AssociationIF> getAssociations()
PUBLIC: Gets all associations in this topic map. No specific order is guaranteed.

Returns:
A collection of AssociationIF objects.

getObjectById

TMObjectIF getObjectById(String object_id)
PUBLIC: Gets the topic map object that has the given object id, from this topic map. If there is no object with that object id in this topic map, then null is returned.

Parameters:
object_id - A string; the object id of the object to get.
Returns:
A topic map object; an object implementing TMObjectIF.

getObjectByItemIdentifier

TMObjectIF getObjectByItemIdentifier(LocatorIF locator)
PUBLIC: Gets the topic map object that has the given item identifier (given as a LocatorIF object), from this topic map. If there is no object with the given locator in this topic map, null is returned.

Parameters:
locator - The given locator; an object implementing LocatorIF.
Returns:
A topic map object; an object implementing TMObjectIF.

getTopicBySubjectLocator

TopicIF getTopicBySubjectLocator(LocatorIF locator)
PUBLIC: Gets the topic in this topic map that represents the given addressable subject (locator given as a LocatorIF object). If there is no topic that represents the given addressable subject in this topic map, null is returned.

Parameters:
locator - The given locator; an object implementing LocatorIF.
Returns:
A topic; an object implementing TopicIF.

getTopicBySubjectIdentifier

TopicIF getTopicBySubjectIdentifier(LocatorIF locator)
PUBLIC: Gets the topic that has the specified subject identifier, given as a locator. If there is no topic that has that subject identifier in this topic map, null is returned.

Parameters:
locator - The given locator; an object implementing LocatorIF.
Returns:
A topic; an object implementing TopicIF.

clear

void clear()
PUBLIC: Clears the topic map by removing all topics and associations.

Since:
4.0


Copyright © 2000-2012 Ontopia.