com.plumtree.remote.auth
Interface ISyncProvider

public interface ISyncProvider

Interface that provides user and group synchronization functionality against a remote system.

Method Summary

IGroup	attachToGroup(java.lang.String groupID) Gets an IGroup object used to query for groups and users contained within the specified group.
SyncObjectList	getGroups() Returns a SyncObjectList object with an array of SyncObjects inside representing groups.
SyncObjectList	getUsers() Returns a SyncObjectList object with an array of SyncObjects inside representing users.
boolean	initialize(SyncInfo syncInfo) Initializes the synchronization provider using the information configured in the portal by the administrator.
void	reset() Called when an IGroup is done with any queries for subusers and subgroups.
void	shutdown() Cleans up any resources used by the synchronization provider.

Method Detail

getGroups

public SyncObjectList getGroups()
                         throws ServiceException

Returns a SyncObjectList object with an array of SyncObjects inside representing groups. The portal will continue calling getGroups until it receives a SyncObjectList with the isDone flag set to true. If the ISyncProvider implementation returns these SyncObjects in batches, it must maintain state internally and return isDone=false until the last batch.

Returns:

a SyncObjectList object containing SyncObjects that represent groups

Throws:

ServiceException - if an error occurred

See Also:

SyncObjectList, SyncObject.createGroup(String, String)

getUsers

public SyncObjectList getUsers()
                        throws ServiceException

Returns a SyncObjectList object with an array of SyncObjects inside representing users. The portal will continue calling getUsers until it receives a SyncObjectList with the isDone flag set to true. If the ISyncProvider implementation returns these SyncObjects in batches, it must maintain state internally and return isDone=false until the last batch.

Returns:

a SyncObjectList object containing SyncObjects that represent users

Throws:

ServiceException - if an error occurred

See Also:

SyncObjectList, SyncObject.createUser(String, String, String)

attachToGroup

public IGroup attachToGroup(java.lang.String groupID)
                     throws ServiceException

Gets an IGroup object used to query for groups and users contained within the specified group.

Parameters:

groupID - the string ID of the group to query

Returns:

an instance of the implementation of the IGroup interface

Throws:

ServiceException - if an error occurred

initialize

public boolean initialize(SyncInfo syncInfo)
                   throws ServiceException

Initializes the synchronization provider using the information configured in the portal by the administrator.

Parameters:

syncInfo - the data set in the portal's SCI editors. Note: The names in the NamedValues in syncInfo will be uppercase.

Returns:

true if initialization succeeded, false otherwise

Throws:

ServiceException - if an error occurred

reset

public void reset()
           throws ServiceException

Called when an IGroup is done with any queries for subusers and subgroups. Used to clean up state management. This method is generally not required for synchronization against a version 5.0 portal.

Throws:

ServiceException - if an error occurred

shutdown

public void shutdown()
              throws ServiceException

Cleans up any resources used by the synchronization provider.

Throws:

ServiceException - if an error occurred.