com.ibm.di.connector
Class ITIMAgentConnector

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

All Implemented Interfaces:

ConnectorInterface, VersionInfoInterface

public class ITIMAgentConnector
extends Connector
implements ConnectorInterface

The ITIM Agent Connector is an adapter between the ITDI Connector API and the ITIM DAML JNDI package. Rather than using the built-in ITDI JNDI Connector, this Connector allows the specifics of configuration to be controlled and can hide details in the JNDI setup that are irrelevant when talking to a DAML endpoint.

Field Summary

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

ALL_MODES, myLog, PROPERTY_MESSAGE, PROPERTY_READER, PROPERTY_WRITER

Constructor Summary

ITIMAgentConnector()
Constructor of the ITIM Agent Connector.

Method Summary

void	deleteEntry(Entry aEntry, SearchCriteria aSearch) Deletes a JNDI Entry.
Entry	findEntry(SearchCriteria aSearch) Finds a JNDI Entry given search critera.
Entry	getNextEntry() Retrieves the next Entry object from the search results.
String	getVersion()
void	initialize(Object aObject) Reads Connector parameters and creates the JNDI context.
void	modEntry(Entry aEntry, SearchCriteria aSearch) Modifies a JNDI Entry.
void	modEntry(Entry aEntry, SearchCriteria aSearch, Entry aOldEntry) Modifies a JNDI Entry.
void	putEntry(Entry aEntry) Adds the given Entry as a new JNDI Subcontext.
void	selectEntries() Performs a JNDI search operation with the search controls specified.
void	terminate() Closes the JNDI context.

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, setCurrent, 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, setCurrent, setLog, setMaxDuplicateEntries, setName, setParam, setRSInterface, terminateServer

Constructor Detail

ITIMAgentConnector

public ITIMAgentConnector()

Constructor of the ITIM Agent Connector.

Method Detail

initialize

public void initialize(Object aObject)
                throws Exception

Reads Connector parameters and creates the JNDI context.

Specified by:

initialize in interface ConnectorInterface

Overrides:

initialize in class Connector

Parameters:

aObject - User provided parameter

Throws:

Exception

selectEntries

public void selectEntries()
                   throws Exception

Performs a JNDI search operation with the search controls specified.

Specified by:

selectEntries in interface ConnectorInterface

Overrides:

selectEntries in class Connector

Throws:

Exception

getNextEntry

public Entry getNextEntry()
                   throws Exception

Retrieves the next Entry object from the search results.

Specified by:

getNextEntry in interface ConnectorInterface

Overrides:

getNextEntry in class Connector

Returns:

- the next Entry, or null if no more data

Throws:

Exception

See Also:

Connector.selectEntries()

putEntry

public void putEntry(Entry aEntry)
              throws Exception

Adds the given Entry as a new JNDI Subcontext.

Specified by:

putEntry in interface ConnectorInterface

Overrides:

putEntry in class Connector

Parameters:

aEntry - The entry data to add

Throws:

Exception - Any exceptions thrown by the connector's underlying classes

modEntry

public void modEntry(Entry aEntry,
                     SearchCriteria aSearch)
              throws Exception

Modifies a JNDI Entry.

Specified by:

modEntry in interface ConnectorInterface

Overrides:

modEntry in class Connector

Parameters:

aEntry - The entry data

aSearch - The search criteria used to locate the entry to be modified

Throws:

Exception - Any exceptions thrown by the connector's underlying classes

modEntry

public void modEntry(Entry aEntry,
                     SearchCriteria aSearch,
                     Entry aOldEntry)
              throws Exception

Modifies a JNDI Entry.

Specified by:

modEntry in interface ConnectorInterface

Overrides:

modEntry in class Connector

Parameters:

aEntry - The entry data

aSearch - The search criteria used to locate the entry to be modified

aOldEntry - The old entry found by the search criteria

Throws:

Exception - Any exceptions thrown by the connector's underlying classes

deleteEntry

public void deleteEntry(Entry aEntry,
                        SearchCriteria aSearch)
                 throws Exception

Deletes a JNDI Entry.

Specified by:

deleteEntry in interface ConnectorInterface

Overrides:

deleteEntry in class Connector

Parameters:

aEntry - The entry data

aSearch - The search criteria used to locate the entry to be deleted

Throws:

Exception - Any exceptions thrown by the connector's underlying classes

findEntry

public Entry findEntry(SearchCriteria aSearch)
                throws Exception

Finds a JNDI Entry given search critera.

Specified by:

findEntry in interface ConnectorInterface

Overrides:

findEntry in class Connector

Parameters:

aSearch - The search criteria used to locate the entry to be modified

Returns:

The entry found, or null if no or multiple entries found

Throws:

Exception - Any exceptions thrown by the connector's underlying classes

terminate

public void terminate()

Closes the JNDI context.

Specified by:

terminate in interface ConnectorInterface

Overrides:

terminate in class Connector

getVersion

public String getVersion()

Specified by:

getVersion in interface VersionInfoInterface