DatabaseTopicMap (Wandora

java.lang.Object
- org.wandora.topicmap.TopicMap
- - org.wandora.topicmap.database2.AbstractDatabaseTopicMap
  - - org.wandora.topicmap.database2.DatabaseTopicMap

All Implemented Interfaces:: TopicMapLogger

public class DatabaseTopicMap
extends AbstractDatabaseTopicMap

Author:: olli, akivela

Nested Class Summary
- Nested classes/interfaces inherited from class org.wandora.topicmap.database2.AbstractDatabaseTopicMap
  AbstractDatabaseTopicMap.QueryQueue

Field Summary

Fields
Modifier and Type	Field and Description
`protected boolean`	`changed`
`protected boolean`	`completeIndexes` A flag indicating that the `topicIndex` is a full index of everything existing in this topic map.
`protected java.util.ArrayList<TopicMapListener>`	`disabledListeners`
`protected java.lang.Object`	`indexLock`
`protected WeakTopicIndex`	`topicIndex` The WeakTopicIndex used to index topics.
`protected java.util.ArrayList<TopicMapListener>`	`topicMapListeners`

Fields inherited from class org.wandora.topicmap.database2.AbstractDatabaseTopicMap
connection, databaseFlavour, isDBReadOnly, unconnected

Fields inherited from class org.wandora.topicmap.TopicMap
consistencyCheck, consistencyCheckWhenXTMImport, EDITTIME_SI, isReadOnly, logger, parentTopicMap

Constructor Summary

Constructors
Constructor and Description
`DatabaseTopicMap(java.lang.String dbDriver, java.lang.String dbConnectionString, java.lang.String dbUser, java.lang.String dbPassword)` Creates a new instance of DatabaseTopicMap
`DatabaseTopicMap(java.lang.String dbDriver, java.lang.String dbConnectionString, java.lang.String dbUser, java.lang.String dbPassword, java.lang.Object connectionParams)`
`DatabaseTopicMap(java.lang.String dbDriver, java.lang.String dbConnectionString, java.lang.String dbUser, java.lang.String dbPassword, java.lang.String initScript)`
`DatabaseTopicMap(java.lang.String dbDriver, java.lang.String dbConnectionString, java.lang.String dbUser, java.lang.String dbPassword, java.lang.String initScript, java.lang.Object connectionParams)`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`private Association`	`_copyAssociationIn(Association a)`
`private Topic`	`_copyTopicIn(Topic t, boolean deep, boolean stub, java.util.HashMap<Topic,Locator> copied)`
`private Topic`	`_copyTopicIn(Topic t, boolean deep, java.util.HashMap<Topic,Locator> copied)`
`void`	`addTopicMapListener(TopicMapListener listener)` Adds a topic map listener.
`void`	`associationChanged(Association a)`
`void`	`associationPlayerChanged(Association a, Topic role, Topic newPlayer, Topic oldPlayer)`
`(package private) void`	`associationRemoved(Association a)`
`void`	`associationTypeChanged(Association a, Topic newType, Topic oldType)`
`DatabaseAssociation`	`buildAssociation(java.util.Map<java.lang.String,java.lang.Object> row)` Builds a database association from a database query result row.
`DatabaseAssociation`	`buildAssociation(java.lang.Object associationId, java.lang.Object typeId, java.lang.Object typeName, java.lang.Object typeSL)`
`DatabaseAssociation`	`buildAssociation(java.lang.String associationId, DatabaseTopic type)`
`DatabaseAssociation`	`buildAssociation(java.lang.String associationId, java.lang.String typeId, java.lang.String typeName, java.lang.String typeSL)`
`DatabaseTopic`	`buildTopic(java.util.Map<java.lang.String,java.lang.Object> row)` Builds a database topic from a database query result row.
`DatabaseTopic`	`buildTopic(java.lang.Object id, java.lang.Object baseName, java.lang.Object subjectLocator)` Builds a database topic when given the topic id, basename and subject locator.
`DatabaseTopic`	`buildTopic(java.lang.String id, java.lang.String baseName, java.lang.String subjectLocator)` Builds a database topic when given the topic id, basename and subject locator.
`void`	`checkAssociationConsistency(TopicMapLogger logger)` Checks association consistency and fixes any inconsistencies.
`void`	`checkSIConsistency()`
`void`	`checkSIConsistency(TopicMapLogger logger)`
`void`	`clearTopicMap()` Deletes everything in the topic map by clearing the database tables.
`void`	`clearTopicMapIndexes()` Clears the topic index (cache) containing recently accessed database topics.
`void`	`close()` Closes the topic map.
`void`	`commit()`
`Association`	`copyAssociationIn(Association a)` Copies an association of a different topic map in this topic map.
`void`	`copyTopicAssociationsIn(Topic t)` Copies all associations of a topic of a different topic map in this topic map using copyAssociationIn.
`Topic`	`copyTopicIn(Topic t, boolean deep)` Copies a topic of different topic map in this topic map.
`Association`	`createAssociation(Topic type)` Creates a new association of the given type without any members.
`Topic`	`createTopic()` Creates a new topic without base name, subject identifier, data or any associations.
`Topic`	`createTopic(java.lang.String id)` Creates a new topic without base name, subject identifier, data or any associations.
`void`	`disableAllListeners()`
`void`	`enableAllListeners()`
`java.util.Iterator<Association>`	`getAssociations()` Note that you must iterate through all rows because statement and result set will only be closed after last row has been fetched.
`java.util.Collection<Association>`	`getAssociationsOfType(Topic type)` Returns all associations in the topic map that are of the given type.
`int`	`getNumAssociations()` Returns the number of associations in topic map.
`int`	`getNumTopics()` Returns the number of topics in topic map.
`TopicMapStatData`	`getStatistics(TopicMapStatOptions options)`
`Topic`	`getTopic(java.util.Collection<Locator> SIs)`
`Topic`	`getTopic(Locator si)` Gets a topic with subject identifier.
`Topic`	`getTopicBySubjectLocator(Locator sl)` Gets a topic with subject locator.
`java.util.List<TopicMapListener>`	`getTopicMapListeners()` Gets all topic map listeners.
`java.util.Iterator<Topic>`	`getTopics()` Gets all topics in the topic map.
`Topic[]`	`getTopics(java.lang.String[] sis)` Gets the topics whose subject identifiers are given in the array.
`java.util.Collection<Topic>`	`getTopicsOfType(Topic type)` Gets all topics in the topic map that are of the given type.
`Topic`	`getTopicWithBaseName(java.lang.String name)` Gets a topic with topic base name.
`void`	`importLTM(java.io.File in)`
`void`	`importLTM(java.io.InputStream in, TopicMapLogger logger)`
`void`	`importXTM(java.io.InputStream in, TopicMapLogger logger)`
`boolean`	`isTopicMapChanged()` Checks if the topic map has been changed since the last call to resetTopicMapChanged.
`void`	`mergeIn(TopicMap tm, TopicMapLogger tmLogger)` Merges the contents of the given topic map in this topic map.
`void`	`printIndexDebugInfo()`
`java.util.Collection<Association>`	`queryAssociation(java.lang.String query)` Executes a database query and returns results as a collection of associations.
`Topic`	`querySingleTopic(java.lang.String query)` Same as queryTopic but only returns the first topic in the result set or null if the result set is empty.
`java.util.Collection<Topic>`	`queryTopic(java.lang.String query)` Executes a database query and returns results as a collection of topics.
`void`	`removeTopicMapListener(TopicMapListener listener)` Removes a topic map listener.
`void`	`resetCompleteIndex()` Restarts the topic index cleaner thread.
`boolean`	`resetTopicMapChanged()`
`java.util.Collection<Topic>`	`search(java.lang.String query, TopicMapSearchOptions options)` Searches the topic map for the given string.
`void`	`setCompleteIndex()` Tries to set complete index attribute.
`void`	`setTrackDependent(boolean v)` NOTE: The two trackDependent methods are mostly deprecated.
`void`	`topicBaseNameChanged(Topic t, java.lang.String newName, java.lang.String oldName)`
`void`	`topicBNChanged(Topic t, java.lang.String old)`
`void`	`topicChanged(Topic t)`
`void`	`topicDataChanged(Topic t, Topic type, Topic version, java.lang.String newValue, java.lang.String oldValue)`
`(package private) void`	`topicRemoved(Topic t)`
`void`	`topicSIChanged(DatabaseTopic t, Locator deleted, Locator added)`
`void`	`topicSubjectIdentifierChanged(Topic t, Locator added, Locator removed)`
`void`	`topicSubjectLocatorChanged(Topic t, Locator newLocator, Locator oldLocator)`
`void`	`topicTypeChanged(Topic t, Topic added, Topic removed)`
`void`	`topicVariantChanged(Topic t, java.util.Collection<Topic> scope, java.lang.String newName, java.lang.String oldName)`
`boolean`	`trackingDependent()`

Methods inherited from class org.wandora.topicmap.database2.AbstractDatabaseTopicMap
collectionToSQL, createConnection, escapeSQL, executeCountQuery, executeQuery, executeUpdate, getConnection, getConnectionParams, getDatabaseFlavour, getDBConnectionString, getDBDriver, getDBPassword, getDBUser, getRowIterator, isConnected, isReadOnly, testReadOnly

Methods inherited from class org.wandora.topicmap.TopicMap
addTopicMapListeners, checkAssociationConsistency, copyTopicCollectionIn, createLocator, createLocator, escapeXML, exportJTM, exportJTM, exportJTM, exportJTM, exportLTM, exportLTM, exportLTM, exportLTM, exportTopicMap, exportTopicMap, exportXTM, exportXTM, exportXTM, exportXTM, exportXTM10, exportXTM10, exportXTM10, exportXTM20, exportXTM20, forceStop, getConsistencyCheck, getLogger, getMergingTopics, getParentTopicMap, getRootTopicMap, getTopic, getTopicBySubjectLocator, getTopics, getTopicsOfType, hlog, importJTM, importJTM, importJTM, importJTM, importJTM, importJTM, importLTM, importLTM, importLTM, importLTM, importTopicMap, importTopicMap, importTopicMap, importXTM, importXTM, importXTM, importXTM, log, log, log, makeJTMString, makeJTMTopicId, makeLTMString, makeLTMTopicId, makeSubjectIndicator, makeSubjectIndicatorAsLocator, mergeIn, setConsistencyCheck, setLogger, setLogTitle, setParentTopicMap, setProgress, setProgressMax, setReadOnly

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - changed
```
protected boolean changed
```
  - topicIndex
```
protected WeakTopicIndex topicIndex
```
    The WeakTopicIndex used to index topics. Note that index needs information about changes in topic map and should also be used to construct new topics to make sure that there are not two different instances of the same topic.
    
    See Also:
    
    WeakTopicIndex
  - topicMapListeners
```
protected java.util.ArrayList<TopicMapListener> topicMapListeners
```
  - disabledListeners
```
protected java.util.ArrayList<TopicMapListener> disabledListeners
```
  - completeIndexes
```
protected boolean completeIndexes
```
    A flag indicating that the topicIndex is a full index of everything existing in this topic map. Normally it is not. However, when you import something in an empty topic map, you can stop the index cleaner thread that is normally deleting rarely used topics from index. Because all created topics and associations are added to the index, this will result in an index containing everything in the topic map.
    The index is done with weak references so the actual objects might not be found in the index but even if this is the case, the index will contain the information if such an object exists in the actual database or not.
  - indexLock
```
protected java.lang.Object indexLock
```
- Constructor Detail
  - DatabaseTopicMap
```
public DatabaseTopicMap(java.lang.String dbDriver,
                        java.lang.String dbConnectionString,
                        java.lang.String dbUser,
                        java.lang.String dbPassword)
                 throws java.sql.SQLException
```
    Creates a new instance of DatabaseTopicMap
    
    Throws:
    
    java.sql.SQLException
  - DatabaseTopicMap
```
public DatabaseTopicMap(java.lang.String dbDriver,
                        java.lang.String dbConnectionString,
                        java.lang.String dbUser,
                        java.lang.String dbPassword,
                        java.lang.Object connectionParams)
                 throws java.sql.SQLException
```
    Throws:
    
    java.sql.SQLException
  - DatabaseTopicMap
```
public DatabaseTopicMap(java.lang.String dbDriver,
                        java.lang.String dbConnectionString,
                        java.lang.String dbUser,
                        java.lang.String dbPassword,
                        java.lang.String initScript)
                 throws java.sql.SQLException
```
    Throws:
    
    java.sql.SQLException
  - DatabaseTopicMap
```
public DatabaseTopicMap(java.lang.String dbDriver,
                        java.lang.String dbConnectionString,
                        java.lang.String dbUser,
                        java.lang.String dbPassword,
                        java.lang.String initScript,
                        java.lang.Object connectionParams)
                 throws java.sql.SQLException
```
    Throws:
    
    java.sql.SQLException
- Method Detail
  - clearTopicMap
```
public void clearTopicMap()
                   throws TopicMapException
```
    Deletes everything in the topic map by clearing the database tables.
    
    Specified by:
    
    clearTopicMap in class TopicMap
    
    Throws:
    
    TopicMapException
  - clearTopicMapIndexes
```
public void clearTopicMapIndexes()
```
    Clears the topic index (cache) containing recently accessed database topics. Any topic found in the index is not retrieved from the database and it is impossible for DatabaseTopicMap to detect any changes in the database. Thus the index may contain outdated information and you will need to manually clear the index to force retrieving of topics directly from the database.
    
    Specified by:
    
    clearTopicMapIndexes in class TopicMap
  - printIndexDebugInfo
```
public void printIndexDebugInfo()
```
  - checkSIConsistency
```
public void checkSIConsistency()
                        throws TopicMapException
```
    Throws:
    
    TopicMapException
  - checkSIConsistency
```
public void checkSIConsistency(TopicMapLogger logger)
                        throws TopicMapException
```
    Throws:
    
    TopicMapException
  - checkAssociationConsistency
```
public void checkAssociationConsistency(TopicMapLogger logger)
                                 throws TopicMapException
```
    Description copied from class: TopicMap
    
    Checks association consistency and fixes any inconsistencies. Two associations are said to be inconsistent if they have the same type and same players with same roles, that is they represent the exact same association. If several such associations exist all but one of them need to be removed.
    
    Overrides:
    
    checkAssociationConsistency in class TopicMap
    
    Throws:
    
    TopicMapException
  - close
```
public void close()
```
    Closes the topic map. This closes the topic index freeing some resources and closes the database connection. Topic map cannot be used or reopened after it has been closed.
    
    Overrides:
    
    close in class AbstractDatabaseTopicMap
  - buildTopic
```
public DatabaseTopic buildTopic(java.util.Map<java.lang.String,java.lang.Object> row)
                         throws TopicMapException
```
    Builds a database topic from a database query result row. The row should contain (at least) three columns with names "TOPICID", "BASENAME" and "SUBJECTLOCATOR" that are used to build the topic.
    
    Throws:
    
    TopicMapException
  - buildTopic
```
public DatabaseTopic buildTopic(java.lang.Object id,
                                java.lang.Object baseName,
                                java.lang.Object subjectLocator)
                         throws TopicMapException
```
    Builds a database topic when given the topic id, basename and subject locator.
    
    Throws:
    
    TopicMapException
  - buildTopic
```
public DatabaseTopic buildTopic(java.lang.String id,
                                java.lang.String baseName,
                                java.lang.String subjectLocator)
                         throws TopicMapException
```
    Builds a database topic when given the topic id, basename and subject locator.
    
    Throws:
    
    TopicMapException
  - buildAssociation
```
public DatabaseAssociation buildAssociation(java.util.Map<java.lang.String,java.lang.Object> row)
                                     throws TopicMapException
```
    Builds a database association from a database query result row. The row should contain (at least) four columns with names "ASSOCIATIONID", "TOPICID", "BASENAME" and "SUBJECTLOCATOR" where all but the "ASSOCIATIONID" are the core properties of the association type topic.
    
    Throws:
    
    TopicMapException
  - buildAssociation
```
public DatabaseAssociation buildAssociation(java.lang.Object associationId,
                                            java.lang.Object typeId,
                                            java.lang.Object typeName,
                                            java.lang.Object typeSL)
                                     throws TopicMapException
```
    Throws:
    
    TopicMapException
  - buildAssociation
```
public DatabaseAssociation buildAssociation(java.lang.String associationId,
                                            java.lang.String typeId,
                                            java.lang.String typeName,
                                            java.lang.String typeSL)
                                     throws TopicMapException
```
    Throws:
    
    TopicMapException
  - buildAssociation
```
public DatabaseAssociation buildAssociation(java.lang.String associationId,
                                            DatabaseTopic type)
```
  - queryTopic
```
public java.util.Collection<Topic> queryTopic(java.lang.String query)
                                       throws TopicMapException
```
    Executes a database query and returns results as a collection of topics. The result set must have the same columns used by buildTopic method.
    
    Throws:
    
    TopicMapException
  - querySingleTopic
```
public Topic querySingleTopic(java.lang.String query)
                       throws TopicMapException
```
    Same as queryTopic but only returns the first topic in the result set or null if the result set is empty.
    
    Throws:
    
    TopicMapException
  - queryAssociation
```
public java.util.Collection<Association> queryAssociation(java.lang.String query)
                                                   throws TopicMapException
```
    Executes a database query and returns results as a collection of associations. The result set must have the same columns used by buildAssociation method.
    
    Throws:
    
    TopicMapException
  - getTopic
```
public Topic getTopic(java.util.Collection<Locator> SIs)
               throws TopicMapException
```
    Throws:
    
    TopicMapException
  - topicSIChanged
```
public void topicSIChanged(DatabaseTopic t,
                           Locator deleted,
                           Locator added)
```
  - topicBNChanged
```
public void topicBNChanged(Topic t,
                           java.lang.String old)
                    throws TopicMapException
```
    Throws:
    
    TopicMapException
  - getTopic
```
public Topic getTopic(Locator si)
               throws TopicMapException
```
    Description copied from class: TopicMap
    
    Gets a topic with subject identifier.
    
    Specified by:
    
    getTopic in class TopicMap
    
    Throws:
    
    TopicMapException
  - getTopicBySubjectLocator
```
public Topic getTopicBySubjectLocator(Locator sl)
                               throws TopicMapException
```
    Description copied from class: TopicMap
    
    Gets a topic with subject locator.
    
    Specified by:
    
    getTopicBySubjectLocator in class TopicMap
    
    Throws:
    
    TopicMapException
  - createTopic
```
public Topic createTopic(java.lang.String id)
                  throws TopicMapException
```
    Description copied from class: TopicMap
    
    Creates a new topic without base name, subject identifier, data or any associations.
    
    Specified by:
    
    createTopic in class TopicMap
    
    Throws:
    
    TopicMapException
  - createTopic
```
public Topic createTopic()
                  throws TopicMapException
```
    Description copied from class: TopicMap
    
    Creates a new topic without base name, subject identifier, data or any associations.
    
    Specified by:
    
    createTopic in class TopicMap
    
    Throws:
    
    TopicMapException
  - createAssociation
```
public Association createAssociation(Topic type)
                              throws TopicMapException
```
    Description copied from class: TopicMap
    
    Creates a new association of the given type without any members.
    
    Specified by:
    
    createAssociation in class TopicMap
    
    Throws:
    
    TopicMapException
  - getTopicsOfType
```
public java.util.Collection<Topic> getTopicsOfType(Topic type)
                                            throws TopicMapException
```
    Description copied from class: TopicMap
    
    Gets all topics in the topic map that are of the given type.
    
    Specified by:
    
    getTopicsOfType in class TopicMap
    
    Throws:
    
    TopicMapException
  - getTopicWithBaseName
```
public Topic getTopicWithBaseName(java.lang.String name)
                           throws TopicMapException
```
    Description copied from class: TopicMap
    
    Gets a topic with topic base name.
    
    Specified by:
    
    getTopicWithBaseName in class TopicMap
    
    Throws:
    
    TopicMapException
  - getTopics
```
public java.util.Iterator<Topic> getTopics()
```
    Description copied from class: TopicMap
    
    Gets all topics in the topic map. The topic map may contain a very large number of topics and this operation may take a long time to finish even though it returns an iterator instead of all topics in a collection. Ideally this should return a TopicIterator with the special dispose method instead of a generic Iterator. The interface remains specifies just Iterator for backwards compatibility. See notes in TopicIterator.
    
    Specified by:
    
    getTopics in class TopicMap
  - getTopics
```
public Topic[] getTopics(java.lang.String[] sis)
                  throws TopicMapException
```
    Description copied from class: TopicMap
    
    Gets the topics whose subject identifiers are given in the array. Will always return an array of equal size as the parameter array with null elements where topics are not found with the given subject identifiers.
    
    Specified by:
    
    getTopics in class TopicMap
    
    Throws:
    
    TopicMapException
  - getAssociations
```
public java.util.Iterator<Association> getAssociations()
```
    Note that you must iterate through all rows because statement and result set will only be closed after last row has been fetched.
    
    Specified by:
    
    getAssociations in class TopicMap
  - getAssociationsOfType
```
public java.util.Collection<Association> getAssociationsOfType(Topic type)
                                                        throws TopicMapException
```
    Description copied from class: TopicMap
    
    Returns all associations in the topic map that are of the given type. Usually topic maps will either contain none or a very large number of associations of any type. Thus this method may potentially be very time consuming and require a very large amount of memory.
    
    Specified by:
    
    getAssociationsOfType in class TopicMap
    
    Throws:
    
    TopicMapException
  - getNumTopics
```
public int getNumTopics()
```
    Description copied from class: TopicMap
    
    Returns the number of topics in topic map. For some implementations this may be a very time consuming operation while for some it is a very simple thing to do.
    
    Specified by:
    
    getNumTopics in class TopicMap
  - getNumAssociations
```
public int getNumAssociations()
```
    Description copied from class: TopicMap
    
    Returns the number of associations in topic map. For some implementations this may be a very time consuming operation while for some it is a very simple thing to do.
    
    Specified by:
    
    getNumAssociations in class TopicMap
  - _copyTopicIn
```
private Topic _copyTopicIn(Topic t,
                           boolean deep,
                           java.util.HashMap<Topic,Locator> copied)
                    throws TopicMapException
```
    Throws:
    
    TopicMapException
  - _copyTopicIn
```
private Topic _copyTopicIn(Topic t,
                           boolean deep,
                           boolean stub,
                           java.util.HashMap<Topic,Locator> copied)
                    throws TopicMapException
```
    Throws:
    
    TopicMapException
  - _copyAssociationIn
```
private Association _copyAssociationIn(Association a)
                                throws TopicMapException
```
    Throws:
    
    TopicMapException
  - copyAssociationIn
```
public Association copyAssociationIn(Association a)
                              throws TopicMapException
```
    Description copied from class: TopicMap
    
    Copies an association of a different topic map in this topic map. If a topic related to the association does not exist in the topic map, then that topic is copied with copyTopicIn(t,false). Otherwise the existing topic is used. The existence of a topic is checked by trying to get it with one (chosen arbitrarily) subject identifier.
    
    Specified by:
    
    copyAssociationIn in class TopicMap
    
    Throws:
    
    TopicMapException
  - copyTopicIn
```
public Topic copyTopicIn(Topic t,
                         boolean deep)
                  throws TopicMapException
```
    Description copied from class: TopicMap
    
    Copies a topic of different topic map in this topic map. If deep is true then topic types, variants and data are also copied. Only stubs of types, data types and variant scopes are copied.
    
    Specified by:
    
    copyTopicIn in class TopicMap
    
    Throws:
    
    TopicMapException
  - copyTopicAssociationsIn
```
public void copyTopicAssociationsIn(Topic t)
                             throws TopicMapException
```
    Description copied from class: TopicMap
    
    Copies all associations of a topic of a different topic map in this topic map using copyAssociationIn.
    
    Specified by:
    
    copyTopicAssociationsIn in class TopicMap
    
    Throws:
    
    TopicMapException
  - importXTM
```
public void importXTM(java.io.InputStream in,
                      TopicMapLogger logger)
               throws java.io.IOException,
                      TopicMapException
```
    Overrides:
    
    importXTM in class TopicMap
    
    Throws:
    
    java.io.IOException
    
    TopicMapException
  - importLTM
```
public void importLTM(java.io.InputStream in,
                      TopicMapLogger logger)
               throws java.io.IOException,
                      TopicMapException
```
    Overrides:
    
    importLTM in class TopicMap
    
    Throws:
    
    java.io.IOException
    
    TopicMapException
  - importLTM
```
public void importLTM(java.io.File in)
               throws java.io.IOException,
                      TopicMapException
```
    Overrides:
    
    importLTM in class TopicMap
    
    Throws:
    
    java.io.IOException
    
    TopicMapException
  - mergeIn
```
public void mergeIn(TopicMap tm,
                    TopicMapLogger tmLogger)
             throws TopicMapException
```
    Description copied from class: TopicMap
    
    Merges the contents of the given topic map in this topic map. At least one of mergeIn(TopicMap) or mergeIn(TopicMap,TopicMapLogger) must be overridden as they call each other in default implementation.
    
    Overrides:
    
    mergeIn in class TopicMap
    
    Throws:
    
    TopicMapException
  - setCompleteIndex
```
public void setCompleteIndex()
```
    Tries to set complete index attribute. This is only possible if the topic map is empty (getNumTopics returns 0). If this is the case, will stop index cleaner thread and set the completeIndexes attribute to true.
    
    See Also:
    
    completeIndexes
  - resetCompleteIndex
```
public void resetCompleteIndex()
```
    Restarts the topic index cleaner thread. You need to call this at some point if you stopped it with setCompleteIndex.
  - trackingDependent
```
public boolean trackingDependent()
```
    Specified by:
    
    trackingDependent in class TopicMap
  - setTrackDependent
```
public void setTrackDependent(boolean v)
```
    Description copied from class: TopicMap
    
    NOTE: The two trackDependent methods are mostly deprecated. They are used when caching html pages from topics to decide when cached pages need to be refreshed. A page needs to be updated when any topic visible in the page is changed.
    
    Specified by:
    
    setTrackDependent in class TopicMap
  - isTopicMapChanged
```
public boolean isTopicMapChanged()
```
    Description copied from class: TopicMap
    
    Checks if the topic map has been changed since the last call to resetTopicMapChanged.
    
    Specified by:
    
    isTopicMapChanged in class TopicMap
  - resetTopicMapChanged
```
public boolean resetTopicMapChanged()
```
    Specified by:
    
    resetTopicMapChanged in class TopicMap
    
    See Also:
    
    TopicMap.isTopicMapChanged()
  - search
```
public java.util.Collection<Topic> search(java.lang.String query,
                                          TopicMapSearchOptions options)
```
    Description copied from class: TopicMap
    
    Searches the topic map for the given string. Search options are given in a separate search options object.
    
    Specified by:
    
    search in class TopicMap
  - getStatistics
```
public TopicMapStatData getStatistics(TopicMapStatOptions options)
                               throws TopicMapException
```
    Specified by:
    
    getStatistics in class TopicMap
    
    Throws:
    
    TopicMapException
  - getTopicMapListeners
```
public java.util.List<TopicMapListener> getTopicMapListeners()
```
    Description copied from class: TopicMap
    
    Gets all topic map listeners.
    
    Specified by:
    
    getTopicMapListeners in class TopicMap
  - addTopicMapListener
```
public void addTopicMapListener(TopicMapListener listener)
```
    Description copied from class: TopicMap
    
    Adds a topic map listener.
    
    Specified by:
    
    addTopicMapListener in class TopicMap
  - removeTopicMapListener
```
public void removeTopicMapListener(TopicMapListener listener)
```
    Description copied from class: TopicMap
    
    Removes a topic map listener.
    
    Specified by:
    
    removeTopicMapListener in class TopicMap
  - disableAllListeners
```
public void disableAllListeners()
```
    Specified by:
    
    disableAllListeners in class TopicMap
  - enableAllListeners
```
public void enableAllListeners()
```
    Specified by:
    
    enableAllListeners in class TopicMap
  - topicRemoved
```
void topicRemoved(Topic t)
           throws TopicMapException
```
    Throws:
    
    TopicMapException
  - associationRemoved
```
void associationRemoved(Association a)
                 throws TopicMapException
```
    Throws:
    
    TopicMapException
  - topicSubjectIdentifierChanged
```
public void topicSubjectIdentifierChanged(Topic t,
                                          Locator added,
                                          Locator removed)
                                   throws TopicMapException
```
    Throws:
    
    TopicMapException
  - topicBaseNameChanged
```
public void topicBaseNameChanged(Topic t,
                                 java.lang.String newName,
                                 java.lang.String oldName)
                          throws TopicMapException
```
    Throws:
    
    TopicMapException
  - topicTypeChanged
```
public void topicTypeChanged(Topic t,
                             Topic added,
                             Topic removed)
                      throws TopicMapException
```
    Throws:
    
    TopicMapException
  - topicVariantChanged
```
public void topicVariantChanged(Topic t,
                                java.util.Collection<Topic> scope,
                                java.lang.String newName,
                                java.lang.String oldName)
                         throws TopicMapException
```
    Throws:
    
    TopicMapException
  - topicDataChanged
```
public void topicDataChanged(Topic t,
                             Topic type,
                             Topic version,
                             java.lang.String newValue,
                             java.lang.String oldValue)
                      throws TopicMapException
```
    Throws:
    
    TopicMapException
  - topicSubjectLocatorChanged
```
public void topicSubjectLocatorChanged(Topic t,
                                       Locator newLocator,
                                       Locator oldLocator)
                                throws TopicMapException
```
    Throws:
    
    TopicMapException
  - topicChanged
```
public void topicChanged(Topic t)
                  throws TopicMapException
```
    Throws:
    
    TopicMapException
  - associationTypeChanged
```
public void associationTypeChanged(Association a,
                                   Topic newType,
                                   Topic oldType)
                            throws TopicMapException
```
    Throws:
    
    TopicMapException
  - associationPlayerChanged
```
public void associationPlayerChanged(Association a,
                                     Topic role,
                                     Topic newPlayer,
                                     Topic oldPlayer)
                              throws TopicMapException
```
    Throws:
    
    TopicMapException
  - associationChanged
```
public void associationChanged(Association a)
                        throws TopicMapException
```
    Throws:
    
    TopicMapException
  - commit
```
public void commit()
            throws java.sql.SQLException,
                   TopicMapException
```
    Overrides:
    
    commit in class AbstractDatabaseTopicMap
    
    Throws:
    
    java.sql.SQLException
    
    TopicMapException

Class DatabaseTopicMap

Nested Class Summary

Nested classes/interfaces inherited from class org.wandora.topicmap.database2.AbstractDatabaseTopicMap

Field Summary

Fields inherited from class org.wandora.topicmap.database2.AbstractDatabaseTopicMap

Fields inherited from class org.wandora.topicmap.TopicMap

Constructor Summary

Method Summary

Methods inherited from class org.wandora.topicmap.database2.AbstractDatabaseTopicMap

Methods inherited from class org.wandora.topicmap.TopicMap

Methods inherited from class java.lang.Object

Field Detail

changed

topicIndex

topicMapListeners

disabledListeners

completeIndexes

indexLock

Constructor Detail

DatabaseTopicMap

DatabaseTopicMap

DatabaseTopicMap

DatabaseTopicMap

Method Detail

clearTopicMap

clearTopicMapIndexes

printIndexDebugInfo

checkSIConsistency

checkSIConsistency

checkAssociationConsistency

close

buildTopic

buildTopic

buildTopic

buildAssociation

buildAssociation

buildAssociation

buildAssociation

queryTopic

querySingleTopic

queryAssociation

getTopic

topicSIChanged

topicBNChanged

getTopic

getTopicBySubjectLocator

createTopic

createTopic

createAssociation

getTopicsOfType

getTopicWithBaseName

getTopics

getTopics

getAssociations

getAssociationsOfType

getNumTopics

getNumAssociations

_copyTopicIn

_copyTopicIn

_copyAssociationIn

copyAssociationIn

copyTopicIn

copyTopicAssociationsIn

importXTM

importLTM

importLTM

mergeIn

setCompleteIndex

resetCompleteIndex

trackingDependent

setTrackDependent

isTopicMapChanged

resetTopicMapChanged

search

getStatistics

getTopicMapListeners

addTopicMapListener

removeTopicMapListener

disableAllListeners

enableAllListeners