Programming Guides › Programming Guide for Java Connector Server › SDK Sample Connectors › Sample Connector Overview

Sample Connector Overview

The SDKDYN sample connector is an example of how to implement a custom connector. The SDK sample connector uses the java.util.Properties API for persisting account and group objects to a series of Java properties flat-files beneath a specified file system directory, local to the computer running the Java CS. Like all connectors, it has an attribute-style processor that implements the following mandatory LDAP operations:

• doAdd()
• doModify()
• doDelete()
• doLookup()
• doSearch()

It also implements the optional operation doModifyRn(), and supports direct associations between object types. It does not support doMove() and its variants.

The SDKDYN sample connector is a typical DYN connector (with developer-maintained metadata). That is, it is a flat connector with no hierarchy except for the virtual containers SDK Accounts and SDK Groups. However, its use of flat files makes its connection manager a contrived example.

As recommended, it makes extensive use of metadata and sample validator and converter plug-ins. The SDK sample connector is also bundled with fully functional JMeter component tests.

The sample-home\sdk\build.xml ant file is included for compiling the SDK sample connector and associated code.

Note: The sample SDK static connector is located in jcs-sdk-deprecated.zip in the SDK distribution. The new DYN-based SDK connectors (SDKDYN, SDKFS, SDKSCRIPT, SDKCOMPOUND) supersede the static SDK sample.