com.ibm.di.connector
Class DominoConnector

java.lang.Object
  com.ibm.di.connector.Connector
      com.ibm.di.connector.DominoConnector

All Implemented Interfaces:

ConnectorInterface, VersionInfoInterface

public class DominoConnector
extends Connector
implements ConnectorInterface

This is the class for the TDI Lotus Notes Connector.

Field Summary

Fields inherited from class com.ibm.di.connector.Connector

ALL_MODES, myLog, PROPERTY_MESSAGE, PROPERTY_READER, PROPERTY_WRITER

Constructor Summary

DominoConnector()
Constructor for the DominoConnector object

Method Summary

void	addValue(Entry e, String attr, Vector value) Adds a feature to the Value attribute of the DominoConnector object
Entry	buildEntry(lotus.domino.Document doc) This method is invoked by the getNextEntry method.
void	deleteEntry(Entry entry, SearchCriteria search) This method is used in Delete mode.
Entry	findEntry(SearchCriteria search) This method is used in Lookup, Update and Delete modes.
lotus.domino.Database	getDominoDatabase(String database) Gets the dominoDatabase attribute of the DominoConnector object
lotus.domino.Session	getDominoSession() Gets the dominoSession attribute of the DominoConnector object
lotus.domino.View	getDominoView(String view) Gets the dominoView attribute of the DominoConnector object
Entry	getNextEntry() Gets the nextEntry attribute of the DominoConnector object
String	getVersion() Return version information
void	initialize(Object o) This method initializes the Connector.
void	initLocalThread() This call is needed when the connector makes local calls through a client or server.
boolean	isConvertable(int type)
void	modDocument(lotus.domino.Document doc, Entry entry) This method modifies a Domino database document.
void	modEntry(Entry entry, SearchCriteria search) This method is used in Update mode.
void	modEntry(Entry entry, SearchCriteria search, Entry old) This method is used in Update mode.
void	putEntry(Entry entry) This method is used in AddOnly mode.
Vector	queryDatabases() This methods builds and returns a collection of the available Domino databases.
Vector	queryViews() Gets the list of views for the current Domino database.
void	selectEntries() This method is used in Iterator mode.
void	setCurrent(Entry entry, SearchCriteria search) Used when multiple entries found, and you want to modify or delete one of them.
void	terminate() This method cleans up allocated resources (recycles database/view objects, terminates threads) and terminates the Connector.
void	termLocalThread() This method terminates the Notes API thread to make sure resources are cleaned up properly.

Methods inherited from class com.ibm.di.connector.Connector

addFindEntry, allModes, clearFindEntries, debug, debugMode, findEntry, getBoolean, getClassInstance, getConfiguration, getContext, getFindEntryCount, getFirstFindEntry, getLog, getMaxDuplicateEntries, getModes, getModes, getName, getNextClient, getNextFindEntry, getParam, getParser, getProperty, getPushbackEntry, getRawConnectorConfiguration, getRSInterface, hasConfigValue, hasParser, initParser, isDeltaSupported, isExceptionFatal, isIOException, logmsg, pushback, queryOperations, queryReply, querySchema, queryTables, reconnect, reconnect, registerScriptBeans, replyEntry, setConfiguration, setContext, setLog, setMaxDuplicateEntries, setModes, setModes, setName, setParam, setParser, setProperty, setRSInterface, terminateServer

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.ibm.di.connector.ConnectorInterface

getConfiguration, getContext, getFindEntryCount, getFirstFindEntry, getMaxDuplicateEntries, getName, getNextClient, getNextFindEntry, getParam, getPushbackEntry, getRawConnectorConfiguration, isDeltaSupported, isExceptionFatal, isIOException, pushback, queryOperations, queryReply, querySchema, reconnect, registerScriptBeans, replyEntry, setConfiguration, setContext, setLog, setMaxDuplicateEntries, setName, setParam, setRSInterface, terminateServer

Constructor Detail

DominoConnector

public DominoConnector()

Constructor for the DominoConnector object

Method Detail

getNextEntry

public Entry getNextEntry()
                   throws Exception

Gets the nextEntry attribute of the DominoConnector object

Specified by:

getNextEntry in interface ConnectorInterface

Overrides:

getNextEntry in class Connector

Returns:

The nextEntry value

Throws:

Exception - An exception is thrown if this method fails.

See Also:

Connector.selectEntries()

getDominoSession

public lotus.domino.Session getDominoSession()

Gets the dominoSession attribute of the DominoConnector object

Returns:

The dominoSession value

getDominoDatabase

public lotus.domino.Database getDominoDatabase(String database)
                                        throws Exception

Gets the dominoDatabase attribute of the DominoConnector object

Parameters:

database - the name of the Domino database file (usually a file with a .nsf filename extension)

Returns:

The dominoDatabase value

Throws:

Exception - An exception is thrown if this method fails.

getDominoView

public lotus.domino.View getDominoView(String view)
                                throws Exception

Gets the dominoView attribute of the DominoConnector object

Parameters:

view - the name of the Domino view

Returns:

The dominoView value

Throws:

Exception - An exception is thrown if this method fails.

getVersion

public String getVersion()

Return version information

Specified by:

getVersion in interface VersionInfoInterface

Returns:

The version value

terminate

public void terminate()

This method cleans up allocated resources (recycles database/view objects, terminates threads) and terminates the Connector.

Specified by:

terminate in interface ConnectorInterface

Overrides:

terminate in class Connector

initialize

public void initialize(Object o)
                throws Exception

This method initializes the Connector.

Specified by:

initialize in interface ConnectorInterface

Overrides:

initialize in class Connector

Parameters:

o - this parameter is ignored

Throws:

Exception - An exception is thrown if this method fails.

selectEntries

public void selectEntries()
                   throws Exception

This method is used in Iterator mode. This method retrieves the entries which will be iterated upon by the getNextEntry method.

Specified by:

selectEntries in interface ConnectorInterface

Overrides:

selectEntries in class Connector

Throws:

Exception - An exception is thrown if this method fails.

buildEntry

public Entry buildEntry(lotus.domino.Document doc)
                 throws Exception

This method is invoked by the getNextEntry method. This method is used to create and populate the entry object to be returned to the AssemblyLine.

Parameters:

doc - the Domino Document object which provides the data for the entry being populated

Returns:

the populated TDI entry object

Throws:

Exception - An exception is thrown if this method fails.

isConvertable

public boolean isConvertable(int type)

putEntry

public void putEntry(Entry entry)
              throws Exception

This method is used in AddOnly mode. This method writes data to the Domino database.

Specified by:

putEntry in interface ConnectorInterface

Overrides:

putEntry in class Connector

Parameters:

entry - the entry to be written to the Domino database

Throws:

Exception - An exception is thrown if this method fails.

modEntry

public void modEntry(Entry entry,
                     SearchCriteria search)
              throws Exception

This method is used in Update mode. This method makes changes to an existing document in the Domino database.

Specified by:

modEntry in interface ConnectorInterface

Overrides:

modEntry in class Connector

Parameters:

entry - the entry which stores the new data with which existing data will be replaced

search - the search criteria with which the existing database document to be changed will be located

Throws:

Exception - An exception is thrown if this method fails.

modEntry

public void modEntry(Entry entry,
                     SearchCriteria search,
                     Entry old)
              throws Exception

This method is used in Update mode. This method makes changes to an existing document in the Domino database.

Specified by:

modEntry in interface ConnectorInterface

Overrides:

modEntry in class Connector

Parameters:

entry - the entry which stores the new data with which existing data will be replaced

search - the search criteria with which the existing database document to be changed will be located

old - used for the implementation of updating documents - it has no meaning for the user of the Connector

Throws:

Exception - An exception is thrown if this method fails.

deleteEntry

public void deleteEntry(Entry entry,
                        SearchCriteria search)
                 throws Exception

This method is used in Delete mode. This methods deletes entries from the Domino database.

Specified by:

deleteEntry in interface ConnectorInterface

Overrides:

deleteEntry in class Connector

Parameters:

entry - used for implementation internals only

search - the search criteria with which the existing database document to be deleted will be located

Throws:

Exception - An exception is thrown if this method fails.

findEntry

public Entry findEntry(SearchCriteria search)
                throws Exception

This method is used in Lookup, Update and Delete modes. This methods locates an entry by the given search criteria.

Specified by:

findEntry in interface ConnectorInterface

Overrides:

findEntry in class Connector

Parameters:

search - the search criteria with which the database document will be located

Returns:

the located entry object

Throws:

Exception - An exception is thrown if this method fails.

setCurrent

public void setCurrent(Entry entry,
                       SearchCriteria search)

Used when multiple entries found, and you want to modify or delete one of them. change foundDoc to be this entry.

Specified by:

setCurrent in interface ConnectorInterface

Overrides:

setCurrent in class Connector

Parameters:

entry - The entry we want to find for modification/delete

search - The search

modDocument

public void modDocument(lotus.domino.Document doc,
                        Entry entry)
                 throws Exception

This method modifies a Domino database document.

Parameters:

doc - the database document to modify

entry - the entry which supplies the new values for the document to be modified

Throws:

Exception - An exception is thrown if this method fails.

addValue

public void addValue(Entry e,
                     String attr,
                     Vector value)

Adds a feature to the Value attribute of the DominoConnector object

Parameters:

e - The feature to be added to the Value attribute

attr - The feature to be added to the Value attribute

value - The feature to be added to the Value attribute

queryDatabases

public Vector queryDatabases()
                      throws Exception

This methods builds and returns a collection of the available Domino databases.

Returns:

a collection of the available Domino databases

Throws:

Exception - An exception is thrown if this method fails.

queryViews

public Vector queryViews()
                  throws Exception

Gets the list of views for the current Domino database.

Returns:

the list of views for the current Domino database

Throws:

Exception - An exception is thrown if this method fails.

initLocalThread

public void initLocalThread()
                     throws Exception

This call is needed when the connector makes local calls through a client or server. The local calls (lotus.domino.local.*) are available only in the Notes.jar which may not be in the installation. Thus, use reflection to load and call sinitThread/stermThread.

Throws:

Exception - An exception is thrown if this method fails.

termLocalThread

public void termLocalThread()

This method terminates the Notes API thread to make sure resources are cleaned up properly.