org.wandora.topicmap.database

Class DatabaseTopicMap

java.lang.Object

org.wandora.topicmap.TopicMap

org.wandora.topicmap.database.DatabaseTopicMap

All Implemented Interfaces:

TopicMapLogger

Deprecated.

public class DatabaseTopicMap
extends TopicMap

Author:

olli

Field Summary

Fields

Modifier and Type	Field and Description
protected boolean	changed Deprecated.
protected boolean	completeIndexes Deprecated. A flag indicating that the topicIndex is a full index of everything existing in this topic map.
protected java.sql.Connection	connection Deprecated.
protected java.lang.Object	connectionParams Deprecated.
protected java.lang.String	databaseFlavour Deprecated. The database flavor.
protected java.lang.String	dbConnectionString Deprecated.
protected java.lang.String	dbDriver Deprecated.
protected java.lang.String	dbPassword Deprecated.
protected java.lang.String	dbUser Deprecated.
protected java.util.ArrayList<TopicMapListener>	disabledListeners Deprecated.
protected java.lang.Object	indexLock Deprecated.
protected boolean	isDBReadOnly Deprecated. Note that this is different than topic map read only property.
private int	queryCounter Deprecated.
private java.lang.Object	queryLock Deprecated.
protected SQLProxyClient	sqlProxy Deprecated.
protected WeakTopicIndex	topicIndex Deprecated. The WeakTopicIndex used to index topics.
protected java.util.ArrayList<TopicMapListener>	topicMapListeners Deprecated.
protected boolean	unconnected Deprecated.

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) Deprecated. 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) Deprecated.
DatabaseTopicMap(java.lang.String dbDriver, java.lang.String dbConnectionString, java.lang.String dbUser, java.lang.String dbPassword, java.lang.String initScript) Deprecated.
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) Deprecated.

Method Summary

Modifier and Type	Method and Description
private Association	_copyAssociationIn(Association a) Deprecated.
private Topic	_copyTopicIn(Topic t, boolean deep, boolean stub, java.util.Hashtable<Topic,Locator> copied) Deprecated.
private Topic	_copyTopicIn(Topic t, boolean deep, java.util.Hashtable copied) Deprecated.
void	addTopicMapListener(TopicMapListener listener) Deprecated. Adds a topic map listener.
void	associationChanged(Association a) Deprecated.
void	associationPlayerChanged(Association a, Topic role, Topic newPlayer, Topic oldPlayer) Deprecated.
(package private) void	associationRemoved(Association a) Deprecated.
void	associationTypeChanged(Association a, Topic newType, Topic oldType) Deprecated.
DatabaseAssociation	buildAssociation(java.util.Map<java.lang.String,java.lang.Object> row) Deprecated. 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) Deprecated.
DatabaseAssociation	buildAssociation(java.lang.String associationId, DatabaseTopic type) Deprecated.
DatabaseAssociation	buildAssociation(java.lang.String associationId, java.lang.String typeId, java.lang.String typeName, java.lang.String typeSL) Deprecated.
DatabaseTopic	buildTopic(java.util.Map<java.lang.String,java.lang.Object> row) Deprecated. Builds a database topic from a database query result row.
DatabaseTopic	buildTopic(java.lang.Object id, java.lang.Object baseName, java.lang.Object subjectLocator) Deprecated. 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) Deprecated. Builds a database topic when given the topic id, basename and subject locator.
void	checkAssociationConsistency(TopicMapLogger logger) Deprecated. Checks association consistency and fixes any inconsistencies.
void	checkSIConsistency() Deprecated.
void	checkSIConsistency(TopicMapLogger logger) Deprecated.
void	clearTopicMap() Deprecated. Deletes everything in the topic map by clearing the database tables.
void	clearTopicMapIndexes() Deprecated. Clears the topic index (cache) containing recently accessed database topics.
void	close() Deprecated. Closes the topic map.
java.lang.String	collectionToSQL(java.util.Collection<java.lang.String> col) Deprecated. Turns a collection of strings into sql syntax representing a collection of strings that can be used with 'in' clauses.
Association	copyAssociationIn(Association a) Deprecated. Copies an association of a different topic map in this topic map.
void	copyTopicAssociationsIn(Topic t) Deprecated. Copies all associations of a topic of a different topic map in this topic map using copyAssociationIn.
Topic	copyTopicIn(Topic t, boolean deep) Deprecated. Copies a topic of different topic map in this topic map.
Association	createAssociation(Topic type) Deprecated. Creates a new association of the given type without any members.
java.sql.Connection	createConnection(boolean autocommit) Deprecated. Creates a new database connection using the connection parameters given to the constructor.
Topic	createTopic() Deprecated. Creates a new topic without base name, subject identifier, data or any associations.
Topic	createTopic(java.lang.String id) Deprecated. Creates a new topic without base name, subject identifier, data or any associations.
void	disableAllListeners() Deprecated.
void	enableAllListeners() Deprecated.
java.lang.String	escapeSQL(java.lang.String s) Deprecated. Escapes a string so that it can be used in an sql query.
private int	executeCountQuery(java.lang.String query) Deprecated.
java.util.Collection<java.util.Map<java.lang.String,java.lang.Object>>	executeQuery(java.lang.String query) Deprecated. Executes a database query and returns the results as a collection.
java.util.Collection<java.util.Map<java.lang.String,java.lang.Object>>	executeQuery(java.lang.String query, java.sql.Connection con) Deprecated.
boolean	executeUpdate(java.lang.String query) Deprecated.
boolean	executeUpdate(java.lang.String query, java.sql.Connection con) Deprecated.
java.util.Iterator<Association>	getAssociations() Deprecated. 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) Deprecated. Returns all associations in the topic map that are of the given type.
java.sql.Connection	getConnection() Deprecated. Gets the connection used with database queries.
java.lang.Object	getConnectionParams() Deprecated. A connection parameters object may be stored in the database topic map.
(package private) java.lang.String	getDatabaseFlavour() Deprecated.
java.lang.String	getDBConnectionString() Deprecated. Gets the used jdbc database connection string.
java.lang.String	getDBDriver() Deprecated. Gets the used jdbc database driver class.
java.lang.String	getDBPassword() Deprecated. Gets the used database password.
java.lang.String	getDBUser() Deprecated. Gets the used database user name.
int	getNumAssociations() Deprecated. Returns the number of associations in topic map.
int	getNumTopics() Deprecated. Returns the number of topics in topic map.
TopicMapStatData	getStatistics(TopicMapStatOptions options) Deprecated.
Topic	getTopic(java.util.Collection<Locator> SIs) Deprecated.
Topic	getTopic(Locator si) Deprecated. Gets a topic with subject identifier.
Topic	getTopicBySubjectLocator(Locator sl) Deprecated. Gets a topic with subject locator.
java.util.List<TopicMapListener>	getTopicMapListeners() Deprecated. Gets all topic map listeners.
java.util.Iterator<Topic>	getTopics() Deprecated. Gets all topics in the topic map.
Topic[]	getTopics(java.lang.String[] sis) Deprecated. Gets the topics whose subject identifiers are given in the array.
java.util.Collection<Topic>	getTopicsOfType(Topic type) Deprecated. Gets all topics in the topic map that are of the given type.
Topic	getTopicWithBaseName(java.lang.String name) Deprecated. Gets a topic with topic base name.
void	importLTM(java.io.File in) Deprecated.
void	importLTM(java.io.InputStream in, TopicMapLogger logger) Deprecated.
void	importXTM(java.io.InputStream in, TopicMapLogger logger) Deprecated.
boolean	isConnected() Deprecated. Checks if the database connection is active.
boolean	isReadOnly() Deprecated. Does the topic map only allow reading or both reading and writing.
boolean	isTopicMapChanged() Deprecated. Checks if the topic map has been changed since the last call to resetTopicMapChanged.
void	mergeIn(TopicMap tm, TopicMapLogger tmLogger) Deprecated. Merges the contents of the given topic map in this topic map.
void	printIndexDebugInfo() Deprecated.
java.util.Collection<Association>	queryAssociation(java.lang.String query) Deprecated. Executes a database query and returns results as a collection of associations.
java.util.Collection<Association>	queryAssociation(java.lang.String query, java.sql.Connection con) Deprecated.
Topic	querySingleTopic(java.lang.String query) Deprecated. 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) Deprecated. Executes a database query and returns results as a collection of topics.
java.util.Collection<Topic>	queryTopic(java.lang.String query, java.sql.Connection con) Deprecated.
void	removeTopicMapListener(TopicMapListener listener) Deprecated. Removes a topic map listener.
void	resetCompleteIndex() Deprecated. Restarts the topic index cleaner thread.
boolean	resetTopicMapChanged() Deprecated.
java.util.Collection<Topic>	search(java.lang.String query, TopicMapSearchOptions options) Deprecated. Searches the topic map for the given string.
void	setCompleteIndex() Deprecated. Tries to set complete index attribute.
void	setTrackDependent(boolean v) Deprecated. NOTE: The two trackDependent methods are mostly deprecated.
boolean	testReadOnly() Deprecated. Tests if the connection allows modifying the topic map.
void	topicBaseNameChanged(Topic t, java.lang.String newName, java.lang.String oldName) Deprecated.
void	topicBNChanged(Topic t, java.lang.String old) Deprecated.
void	topicChanged(Topic t) Deprecated.
void	topicDataChanged(Topic t, Topic type, Topic version, java.lang.String newValue, java.lang.String oldValue) Deprecated.
(package private) void	topicRemoved(Topic t) Deprecated.
void	topicSIChanged(DatabaseTopic t, Locator deleted, Locator added) Deprecated.
void	topicSubjectIdentifierChanged(Topic t, Locator added, Locator removed) Deprecated.
void	topicSubjectLocatorChanged(Topic t, Locator newLocator, Locator oldLocator) Deprecated.
void	topicTypeChanged(Topic t, Topic added, Topic removed) Deprecated.
void	topicVariantChanged(Topic t, java.util.Collection<Topic> scope, java.lang.String newName, java.lang.String oldName) Deprecated.
boolean	trackingDependent() Deprecated.

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

Deprecated.

topicIndex

protected WeakTopicIndex topicIndex

Deprecated.

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

Deprecated.

disabledListeners

protected java.util.ArrayList<TopicMapListener> disabledListeners

Deprecated.

dbDriver

protected java.lang.String dbDriver

Deprecated.

dbConnectionString

protected java.lang.String dbConnectionString

Deprecated.

dbUser

protected java.lang.String dbUser

Deprecated.

dbPassword

protected java.lang.String dbPassword

Deprecated.

sqlProxy

protected SQLProxyClient sqlProxy

Deprecated.

databaseFlavour

protected java.lang.String databaseFlavour

Deprecated.

The database flavor. Some operations need to be handled differently with different database vendors. This field is used to store what kind of database is being used. Currently it may have following values

  "mysql" - MySQL database
  "generic" - Any other database presumed to be sufficiently standard compliant
 

It is set automatically based on the connection string used.

connectionParams

protected java.lang.Object connectionParams

Deprecated.

completeIndexes

protected boolean completeIndexes

Deprecated.

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.

unconnected

protected boolean unconnected

Deprecated.

isDBReadOnly

protected boolean isDBReadOnly

Deprecated.

Note that this is different than topic map read only property. This property tells the state of the connection: is the connection a read only connection and does the user have privileges to modify the database. These can only be changed by connecting to the database using different settings.

indexLock

protected java.lang.Object indexLock

Deprecated.

connection

protected java.sql.Connection connection

Deprecated.

queryCounter

private int queryCounter

Deprecated.

queryLock

private final java.lang.Object queryLock

Deprecated.

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

Deprecated.

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

Deprecated.

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

Deprecated.

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

Deprecated.

Throws:

java.sql.SQLException

Method Detail

getDBDriver

public java.lang.String getDBDriver()

Deprecated.

Gets the used jdbc database driver class.

getDBConnectionString

public java.lang.String getDBConnectionString()

Deprecated.

Gets the used jdbc database connection string.

getDBUser

public java.lang.String getDBUser()

Deprecated.

Gets the used database user name.

getDBPassword

public java.lang.String getDBPassword()

Deprecated.

Gets the used database password.

getConnectionParams

public java.lang.Object getConnectionParams()

Deprecated.

A connection parameters object may be stored in the database topic map. It is not used by the database topic map, only stored by it. Currently this is used to store higher level connection information than the basic driver, connection string, user name, password. This makes it possible to modify the stored connection in Wandora. The connection parameters object is set at the constructor.

getDatabaseFlavour

java.lang.String getDatabaseFlavour()

Deprecated.

isReadOnly

public boolean isReadOnly()

Deprecated.

Does the topic map only allow reading or both reading and writing. Note that this is different than topic map read only property. This property tells the state of the connection: is the connection a read only connection and does the user have privileges to modify the database. These can only be changed by connecting to the database using different settings.

Overrides:

isReadOnly in class TopicMap

testReadOnly

public boolean testReadOnly()

Deprecated.

Tests if the connection allows modifying the topic map. The test is done using an update sql statement that does not change anything in the database but should raise an exception if modifying is not allowed. Note that this only tests modifying the topic table and most database implementations allow specifying different privileges for each tables.

clearTopicMap

public void clearTopicMap()
                   throws TopicMapException

Deprecated.

Deletes everything in the topic map by clearing the database tables.

Specified by:

clearTopicMap in class TopicMap

Throws:

TopicMapException

clearTopicMapIndexes

public void clearTopicMapIndexes()

Deprecated.

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

isConnected

public boolean isConnected()

Deprecated.

Checks if the database connection is active.

Overrides:

isConnected in class TopicMap

printIndexDebugInfo

public void printIndexDebugInfo()

Deprecated.

checkSIConsistency

public void checkSIConsistency()
                        throws TopicMapException

Deprecated.

Throws:

TopicMapException

checkSIConsistency

public void checkSIConsistency(TopicMapLogger logger)
                        throws TopicMapException

Deprecated.

Throws:

TopicMapException

checkAssociationConsistency

public void checkAssociationConsistency(TopicMapLogger logger)
                                 throws TopicMapException

Deprecated.

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()

Deprecated.

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.

Specified by:

close in class TopicMap

getConnection

public java.sql.Connection getConnection()

Deprecated.

Gets the connection used with database queries. If the old stored connection has been closed for any reason, tries to create a new connection.

createConnection

public java.sql.Connection createConnection(boolean autocommit)

Deprecated.

Creates a new database connection using the connection parameters given to the constructor.

collectionToSQL

public java.lang.String collectionToSQL(java.util.Collection<java.lang.String> col)

Deprecated.

Turns a collection of strings into sql syntax representing a collection of strings that can be used with 'in' clauses. The returned string contains each string in the collection escaped inside single quotes, each separated by commas and all contain inside parenthesis. For example: ('string1','string2','string3').

executeUpdate

public boolean executeUpdate(java.lang.String query)
                      throws TopicMapException

Deprecated.

Throws:

TopicMapException

executeUpdate

public boolean executeUpdate(java.lang.String query,
                             java.sql.Connection con)
                      throws TopicMapException

Deprecated.

Throws:

TopicMapException

executeQuery

public java.util.Collection<java.util.Map<java.lang.String,java.lang.Object>> executeQuery(java.lang.String query)
                                                                                    throws TopicMapException

Deprecated.

Executes a database query and returns the results as a collection. Each element in the collection is a Map and represents a row of the result. The Map maps column names to the objects returned by query.

Throws:

TopicMapException

executeQuery

public java.util.Collection<java.util.Map<java.lang.String,java.lang.Object>> executeQuery(java.lang.String query,
                                                                                           java.sql.Connection con)
                                                                                    throws TopicMapException

Deprecated.

Throws:

TopicMapException

buildTopic

public DatabaseTopic buildTopic(java.util.Map<java.lang.String,java.lang.Object> row)
                         throws TopicMapException

Deprecated.

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

Deprecated.

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

Deprecated.

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

Deprecated.

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

Deprecated.

Throws:

TopicMapException

buildAssociation

public DatabaseAssociation buildAssociation(java.lang.String associationId,
                                            java.lang.String typeId,
                                            java.lang.String typeName,
                                            java.lang.String typeSL)
                                     throws TopicMapException

Deprecated.

Throws:

TopicMapException

buildAssociation

public DatabaseAssociation buildAssociation(java.lang.String associationId,
                                            DatabaseTopic type)

Deprecated.

queryTopic

public java.util.Collection<Topic> queryTopic(java.lang.String query)
                                       throws TopicMapException

Deprecated.

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

queryTopic

public java.util.Collection<Topic> queryTopic(java.lang.String query,
                                              java.sql.Connection con)
                                       throws TopicMapException

Deprecated.

Throws:

TopicMapException

querySingleTopic

public Topic querySingleTopic(java.lang.String query)
                       throws TopicMapException

Deprecated.

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

Deprecated.

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

queryAssociation

public java.util.Collection<Association> queryAssociation(java.lang.String query,
                                                          java.sql.Connection con)
                                                   throws TopicMapException

Deprecated.

Throws:

TopicMapException

escapeSQL

public java.lang.String escapeSQL(java.lang.String s)

Deprecated.

Escapes a string so that it can be used in an sql query.

getTopic

public Topic getTopic(java.util.Collection<Locator> SIs)
               throws TopicMapException

Deprecated.

Throws:

TopicMapException

topicSIChanged

public void topicSIChanged(DatabaseTopic t,
                           Locator deleted,
                           Locator added)

Deprecated.

topicBNChanged

public void topicBNChanged(Topic t,
                           java.lang.String old)
                    throws TopicMapException

Deprecated.

Throws:

TopicMapException

getTopic

public Topic getTopic(Locator si)
               throws TopicMapException

Deprecated.

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

Deprecated.

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

Deprecated.

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

Deprecated.

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

Deprecated.

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

Deprecated.

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

Deprecated.

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()

Deprecated.

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

Deprecated.

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()

Deprecated.

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

Deprecated.

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()

Deprecated.

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()

Deprecated.

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.Hashtable copied)
                    throws TopicMapException

Deprecated.

Throws:

TopicMapException

_copyTopicIn

private Topic _copyTopicIn(Topic t,
                           boolean deep,
                           boolean stub,
                           java.util.Hashtable<Topic,Locator> copied)
                    throws TopicMapException

Deprecated.

Throws:

TopicMapException

_copyAssociationIn

private Association _copyAssociationIn(Association a)
                                throws TopicMapException

Deprecated.

Throws:

TopicMapException

copyAssociationIn

public Association copyAssociationIn(Association a)
                              throws TopicMapException

Deprecated.

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

Deprecated.

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

Deprecated.

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

Deprecated.

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

Deprecated.

Overrides:

importLTM in class TopicMap

Throws:

java.io.IOException

TopicMapException

importLTM

public void importLTM(java.io.File in)
               throws java.io.IOException,
                      TopicMapException

Deprecated.

Overrides:

importLTM in class TopicMap

Throws:

java.io.IOException

TopicMapException

mergeIn

public void mergeIn(TopicMap tm,
                    TopicMapLogger tmLogger)
             throws TopicMapException

Deprecated.

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()

Deprecated.

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()

Deprecated.

Restarts the topic index cleaner thread. You need to call this at some point if you stopped it with setCompleteIndex.

trackingDependent

public boolean trackingDependent()

Deprecated.

Specified by:

trackingDependent in class TopicMap

setTrackDependent

public void setTrackDependent(boolean v)

Deprecated.

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

getTopicMapListeners

public java.util.List<TopicMapListener> getTopicMapListeners()

Deprecated.

Description copied from class: TopicMap

Gets all topic map listeners.

Specified by:

getTopicMapListeners in class TopicMap

addTopicMapListener

public void addTopicMapListener(TopicMapListener listener)

Deprecated.

Description copied from class: TopicMap

Adds a topic map listener.

Specified by:

addTopicMapListener in class TopicMap

removeTopicMapListener

public void removeTopicMapListener(TopicMapListener listener)

Deprecated.

Description copied from class: TopicMap

Removes a topic map listener.

Specified by:

removeTopicMapListener in class TopicMap

disableAllListeners

public void disableAllListeners()

Deprecated.

Specified by:

disableAllListeners in class TopicMap

enableAllListeners

public void enableAllListeners()

Deprecated.

Specified by:

enableAllListeners in class TopicMap

isTopicMapChanged

public boolean isTopicMapChanged()

Deprecated.

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()

Deprecated.

Specified by:

resetTopicMapChanged in class TopicMap

See Also:

TopicMap.isTopicMapChanged()

topicRemoved

void topicRemoved(Topic t)
           throws TopicMapException

Deprecated.

Throws:

TopicMapException

associationRemoved

void associationRemoved(Association a)
                 throws TopicMapException

Deprecated.

Throws:

TopicMapException

topicSubjectIdentifierChanged

public void topicSubjectIdentifierChanged(Topic t,
                                          Locator added,
                                          Locator removed)
                                   throws TopicMapException

Deprecated.

Throws:

TopicMapException

topicBaseNameChanged

public void topicBaseNameChanged(Topic t,
                                 java.lang.String newName,
                                 java.lang.String oldName)
                          throws TopicMapException

Deprecated.

Throws:

TopicMapException

topicTypeChanged

public void topicTypeChanged(Topic t,
                             Topic added,
                             Topic removed)
                      throws TopicMapException

Deprecated.

Throws:

TopicMapException

topicVariantChanged

public void topicVariantChanged(Topic t,
                                java.util.Collection<Topic> scope,
                                java.lang.String newName,
                                java.lang.String oldName)
                         throws TopicMapException

Deprecated.

Throws:

TopicMapException

topicDataChanged

public void topicDataChanged(Topic t,
                             Topic type,
                             Topic version,
                             java.lang.String newValue,
                             java.lang.String oldValue)
                      throws TopicMapException

Deprecated.

Throws:

TopicMapException

topicSubjectLocatorChanged

public void topicSubjectLocatorChanged(Topic t,
                                       Locator newLocator,
                                       Locator oldLocator)
                                throws TopicMapException

Deprecated.

Throws:

TopicMapException

topicChanged

public void topicChanged(Topic t)
                  throws TopicMapException

Deprecated.

Throws:

TopicMapException

associationTypeChanged

public void associationTypeChanged(Association a,
                                   Topic newType,
                                   Topic oldType)
                            throws TopicMapException

Deprecated.

Throws:

TopicMapException

associationPlayerChanged

public void associationPlayerChanged(Association a,
                                     Topic role,
                                     Topic newPlayer,
                                     Topic oldPlayer)
                              throws TopicMapException

Deprecated.

Throws:

TopicMapException

associationChanged

public void associationChanged(Association a)
                        throws TopicMapException

Deprecated.

Throws:

TopicMapException

search

public java.util.Collection<Topic> search(java.lang.String query,
                                          TopicMapSearchOptions options)

Deprecated.

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

Deprecated.

Specified by:

getStatistics in class TopicMap

Throws:

TopicMapException

executeCountQuery

private int executeCountQuery(java.lang.String query)
                       throws java.sql.SQLException

Deprecated.

Throws:

java.sql.SQLException