org.apache.jackrabbit.oak.spi.security.authentication.external

Interface SyncContext

All Known Implementing Classes:

DefaultSyncContext

public interface SyncContext

SyncContext is used as scope for sync operations. Implementations are free to associate any resources with the sync context. The sync context must not be accessed concurrently and must be closed after use.

Method Summary

Methods

Modifier and Type	Method and Description
void	close() Closes this context and releases any resources bound to it.
boolean	isForceGroupSync() Defines if synchronization of groups always will perform, i.e.
boolean	isForceUserSync() Defines if synchronization of users always will perform, i.e.
boolean	isKeepMissing() Defines if synchronization keeps missing external identities on synchronization of authorizables.
SyncContext	setForceGroupSync(boolean force) See isForceGroupSync()
SyncContext	setForceUserSync(boolean force) See isForceUserSync()
SyncContext	setKeepMissing(boolean keep) See isKeepMissing()
SyncResult	sync(ExternalIdentity identity) Synchronizes an external identity with the repository based on the respective configuration.
SyncResult	sync(String id) Synchronizes an authorizable with the corresponding external identity with the repository based on the respective configuration.

Method Detail

isKeepMissing

boolean isKeepMissing()

Defines if synchronization keeps missing external identities on synchronization of authorizables. Default is false.

Returns:

true if keep missing.

setKeepMissing

@Nonnull
SyncContext setKeepMissing(boolean keep)

See isKeepMissing()

isForceUserSync

boolean isForceUserSync()

Defines if synchronization of users always will perform, i.e. ignores the last synced properties.

Returns:

true if forced syncing users

setForceUserSync

@Nonnull
SyncContext setForceUserSync(boolean force)

See isForceUserSync()

isForceGroupSync

boolean isForceGroupSync()

Defines if synchronization of groups always will perform, i.e. ignores the last synced properties.

Returns:

true if forced syncing groups

setForceGroupSync

@Nonnull
SyncContext setForceGroupSync(boolean force)

See isForceGroupSync()

sync

@Nonnull
SyncResult sync(@Nonnull
                      ExternalIdentity identity)
                throws SyncException

Synchronizes an external identity with the repository based on the respective configuration.

Parameters:

identity - the identity to sync.

Returns:

the result of the operation

Throws:

SyncException - if an error occurs

sync

@Nonnull
SyncResult sync(@Nonnull
                      String id)
                throws SyncException

Synchronizes an authorizable with the corresponding external identity with the repository based on the respective configuration.

Parameters:

id - the id of the authorizable

Returns:

the result of the operation

Throws:

SyncException - if an error occurrs

close

void close()

Closes this context and releases any resources bound to it. Note that an implementation must not commit the Root passed during the creation call. This is the responsibility of the application.