oracle.adfinternal.share.sandbox

Class DefaultSandboxSupport

java.lang.Object

oracle.adf.share.sandbox.SandboxSupport

oracle.adfinternal.share.sandbox.DefaultSandboxSupport

public class DefaultSandboxSupport
extends SandboxSupport

Default implementation of oracle.adf.share.sandbox.SandboxSupport.

Constructor Summary

Constructors

Constructor and Description
DefaultSandboxSupport() Constructs an instance of DefaultSandboxSupport.

Method Summary

Modifier and Type	Method and Description
boolean	addAdministrator(Sandbox sandbox, java.lang.String userName) Adds a user to the list of administrators of a sandbox.
void	addRepository(Sandbox sandbox, SandboxedRepository repos) Adds a repository in its latest certified state to a sandbox.
boolean	canSynchronizedPublish(Sandbox sandbox) Returns true if all locks needed for synchronizedPublish are available at the time of the invocation.
void	destroy(Sandbox sandbox) Destroys a sandbox and deletes all information pertaining to the sandbox.
void	destroy(Sandbox sandbox, boolean retainInfo) Destroys a sandbox and optionally retains the sandbox information such as operation logs.
boolean	enableFeature(Sandbox sandbox, java.lang.String featureClassName) Enables a feature in the sandbox.
java.util.Map<java.lang.String,java.lang.Throwable>	enableFeatures(Sandbox sandbox, java.util.List<java.lang.String> featureIdList) Enables a list of features.
java.util.List<SandboxedFeature>	getEnabledFeatures(Sandbox sandbox) Returns the list of features enabled in a sandbox.
java.util.List<SandboxedRepository>	getRepositories(Sandbox sandbox) Returns the list of repositories that have been branched for a sandbox.
RepositoryErrorLog	getRepositoryErrorLog(Sandbox sandbox, java.lang.String reposId) Returns the error log from the last repository operation if any.
ChangeSet	getRepositoryLastChanges(Sandbox sandbox, java.lang.String reposId) Returns the changes obtained last time from a repository branch.
Sandbox	getSandbox(java.lang.String id) Returns the information of an existing sandbox.
SandboxArchive	getSandboxArchive(Sandbox sandbox) Returns the SandboxArchive object if the given sandbox is from an archive.
SandboxLog	getSandboxOperationLog(Sandbox sandbox) Returns the log from the last sandbox operation.
java.lang.Long	getSandboxOperationLogId(java.lang.String sandboxId, SandboxState.Condition condition) Returns the ID of an open log for a sandbox.
int	getSandboxOperationProgress(Sandbox sandbox) Returns an integer from 0 (inclusive) to 100 (inclusive) to indicate the progress of the current sandbox operation.
int	getSandboxOperationProgress(Sandbox sandbox, java.lang.String featureId) Returns an integer from 0 (inclusive) to 100 (inclusive) to indicate the progress of the current sandbox operation by feature.
boolean	isLockedBySandboxArchive() Returns true if the mainline of any repository is locked by a sandbox archive at the time of invcation.
java.util.List<java.lang.String>	listAdministrators(Sandbox sandbox) Returns the list of administrators of a sandbox.
java.util.List<java.lang.String>	listOpenSandboxes(boolean includeArchives) Returns the IDs of the sandboxes that are open at the time of invocation.
java.util.List<java.lang.String>	listSandboxes(java.lang.String name, boolean exactMatch) Returns the IDs of the sandboxes whose names contain or match the specified name.
protected void	logEvent(Sandbox sandbox, RepositoryEvent e) Logs a repository event.
Sandbox	newSandbox(SandboxArchive archive) Creates a new sandbox from an archive as its initial contents.
Sandbox	newSandbox(java.lang.String name) Creates a new sandbox.
protected Sandbox	newSandboxInstance(java.lang.String sandboxId) Constructs a new Sandbox instance.
void	notifyRefreshRequired(java.lang.String reposId) Notifies sandboxes that contain a branch of a specific repository that they must be refreshed before any further sandboxed changes are made.
java.util.Map<SandboxedRepository,ChangeSet>	publish(Sandbox sandbox) Merges changes in a sandbox back into the repositories.
java.util.Map<SandboxedRepository,ChangeSet>	refresh(Sandbox sandbox) Merges changes made in participating repositories into a sandbox.
boolean	removeAdministrator(Sandbox sandbox, java.lang.String userName) Removes a user from the list of administrators of a sandbox.
boolean	removeProcessLock(Sandbox sandbox, int minElapsedHours) Forcefully removes the synchronization lock placed by a Java process performing a sandbox operation.
void	setDescription(Sandbox sandbox, java.lang.String desc) Updates the description of a sandbox.
void	setName(Sandbox sandbox, java.lang.String name) Updates the name of a sandbox.
void	setPrivate(Sandbox sandbox, boolean p) Marks a sandbox private or not.
void	setPublishable(Sandbox sandbox, boolean p) Marks a sandbox publishable or not.
void	setSandboxConstraints(Sandbox sandbox, SandboxConstraints constraints) Sets constraints for a sandbox.
void	setSandboxOperationChangeHint(Sandbox sandbox, ChangeHint changeHint) Gives a change hint to all repositories involved in the current operation.
java.util.Map<SandboxedRepository,ChangeSet>	synchronizedPublish(Sandbox sandbox, boolean refreshBefore) Publishes a sandbox only when all mainline exclusive locks of the branched repositories are available; in other words, a ConcurrentSandboxOperationException is thrown when another synchronizedPublish call is in progress, or when a mainline exclusive lock of any branched repository has been acquired by an archive.
boolean	tryLock(SandboxArchive archive) Tries to acquire the lock for processing a sandbox archive.
void	unlock(SandboxArchive archive) Releases the lock acquired for processing a sandbox archive.
void	unpublish(Sandbox sandbox) Unpublishes a sandbox if it's eligible.
IneligibleForUnpublishException	unpublishCheck(Sandbox sandbox) Checks if a sandbox is eligible for unpublish at this moment.

Methods inherited from class oracle.adf.share.sandbox.SandboxSupport

getInstance, getRepositoryErrorLogs, isCompatible, listOpenSandboxes, listSandbox

Methods inherited from class java.lang.Object

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

Constructor Detail

DefaultSandboxSupport

public DefaultSandboxSupport()

Constructs an instance of DefaultSandboxSupport.

Method Detail

newSandbox

public Sandbox newSandbox(java.lang.String name)
                   throws SandboxException

Description copied from class: SandboxSupport

Creates a new sandbox.

Specified by:

newSandbox in class SandboxSupport

Parameters:

name - the name of the sandbox

Returns:

the new sandbox

Throws:

SandboxException - if an error occurs while creating a sandbox

newSandboxInstance

protected Sandbox newSandboxInstance(java.lang.String sandboxId)

Constructs a new Sandbox instance.

Parameters:

sandboxId - the ID of the sandbox

Returns:

the new sandbox instance

getSandboxArchive

public SandboxArchive getSandboxArchive(Sandbox sandbox)

Description copied from class: SandboxSupport

Returns the SandboxArchive object if the given sandbox is from an archive.

Specified by:

getSandboxArchive in class SandboxSupport

Parameters:

sandbox - the sandbox the SandboxArchive object is associated with

Returns:

the SandboxArchive object if the given sandbox is from an archive; null otherwise

newSandbox

public Sandbox newSandbox(SandboxArchive archive)
                   throws SandboxException

Description copied from class: SandboxSupport

Creates a new sandbox from an archive as its initial contents.

Specified by:

newSandbox in class SandboxSupport

Parameters:

archive - the archive that contains the initial contents

Returns:

the new sandbox

Throws:

SandboxException - if an error occurs while creating a sandbox

setName

public void setName(Sandbox sandbox,
                    java.lang.String name)

Description copied from class: SandboxSupport

Updates the name of a sandbox.

Specified by:

setName in class SandboxSupport

Parameters:

sandbox - the sandbox to update

name - the new name

setDescription

public void setDescription(Sandbox sandbox,
                           java.lang.String desc)

Description copied from class: SandboxSupport

Updates the description of a sandbox.

Specified by:

setDescription in class SandboxSupport

Parameters:

sandbox - the sandbox

desc - the description

setPrivate

public void setPrivate(Sandbox sandbox,
                       boolean p)

Description copied from class: SandboxSupport

Marks a sandbox private or not. A private sandbox is a sandbox that can only be accessed by its owner.

Specified by:

setPrivate in class SandboxSupport

Parameters:

sandbox - the sandbox to be set private or shared

p - true if the given sandbox is to be set to private

setPublishable

public void setPublishable(Sandbox sandbox,
                           boolean p)

Description copied from class: SandboxSupport

Marks a sandbox publishable or not. A publishable sandbox is a sandbox that can be published.

Specified by:

setPublishable in class SandboxSupport

Parameters:

sandbox - the sandbox to be set publishable or not

p - true if the given sandbox is to be set to publishable

listSandboxes

public java.util.List<java.lang.String> listSandboxes(java.lang.String name,
                                                      boolean exactMatch)

Description copied from class: SandboxSupport

Returns the IDs of the sandboxes whose names contain or match the specified name. The list is sorted by the creation dates of the sandboxes from the newest to the oldest.

Specified by:

listSandboxes in class SandboxSupport

Parameters:

name - the name of the sandbox

exactMatch - true if the names of the returned sandboxes must match the specified name exactly

Returns:

the IDs of the sandboxes whose names match or contain the specified name in descending order of their creation dates

getSandbox

public Sandbox getSandbox(java.lang.String id)

Description copied from class: SandboxSupport

Returns the information of an existing sandbox.

Specified by:

getSandbox in class SandboxSupport

Parameters:

id - the ID of the sandbox

Returns:

the sandbox information; null if there is no such sandbox

addRepository

public void addRepository(Sandbox sandbox,
                          SandboxedRepository repos)
                   throws SandboxException

Description copied from class: SandboxSupport

Adds a repository in its latest certified state to a sandbox.

Specified by:

addRepository in class SandboxSupport

Parameters:

sandbox - the sandbox

repos - the participating repository

Throws:

SandboxException - if an error occurs while adding the repository

getRepositories

public java.util.List<SandboxedRepository> getRepositories(Sandbox sandbox)

Description copied from class: SandboxSupport

Returns the list of repositories that have been branched for a sandbox.

Specified by:

getRepositories in class SandboxSupport

Parameters:

sandbox - the sandbox

Returns:

the list of all branched repositories in the sandbox

getEnabledFeatures

public java.util.List<SandboxedFeature> getEnabledFeatures(Sandbox sandbox)

Description copied from class: SandboxSupport

Returns the list of features enabled in a sandbox.

Specified by:

getEnabledFeatures in class SandboxSupport

Parameters:

sandbox - the sandbox

Returns:

the list of all featured enabled in the sandbox

logEvent

protected void logEvent(Sandbox sandbox,
                        RepositoryEvent e)

Description copied from class: SandboxSupport

Logs a repository event.

Overrides:

logEvent in class SandboxSupport

Parameters:

sandbox - the sandbox

e - the repository event

getSandboxOperationProgress

public int getSandboxOperationProgress(Sandbox sandbox)

Description copied from class: SandboxSupport

Returns an integer from 0 (inclusive) to 100 (inclusive) to indicate the progress of the current sandbox operation.

Overrides:

getSandboxOperationProgress in class SandboxSupport

Parameters:

sandbox - the sandbox on which the operation is in progress

Returns:

an integer from 0 (inclusive) to 100 (inclusive) where 100 means completion of the operation; -1 if there is no operation in progress or if progress reporting is not supported

getSandboxOperationProgress

public int getSandboxOperationProgress(Sandbox sandbox,
                                       java.lang.String featureId)

Description copied from class: SandboxSupport

Returns an integer from 0 (inclusive) to 100 (inclusive) to indicate the progress of the current sandbox operation by feature. To improve performance, this method may not check if the specified feature is enabled in the sandbox or not. The returned value is undefined if the specified feature is not enabled in the specified sandbox.

Overrides:

getSandboxOperationProgress in class SandboxSupport

Parameters:

sandbox - the sandbox on which the operation is in progress

featureId - the ID of the enabled feature

Returns:

an integer from 0 (inclusive) to 100 (inclusive) where 100 means completion of the operation; -1 if there is no operation in progress, the specified feature is not enabled, or if progress reporting is not supported

getSandboxOperationLogId

public java.lang.Long getSandboxOperationLogId(java.lang.String sandboxId,
                                               SandboxState.Condition condition)

Description copied from class: SandboxSupport

Returns the ID of an open log for a sandbox. In certain conditions such as sandbox refreshing, a log is created for processes involved to record the changes.

Specified by:

getSandboxOperationLogId in class SandboxSupport

Parameters:

sandboxId - the ID of the sandbox for which the log is created

condition - the condition when the log is available

Returns:

the ID of the open log for the specified sandbox in the specified condition; null if no log is available for the given sandbox in the given condition

getSandboxOperationLog

public SandboxLog getSandboxOperationLog(Sandbox sandbox)

Description copied from class: SandboxSupport

Returns the log from the last sandbox operation.

Specified by:

getSandboxOperationLog in class SandboxSupport

Parameters:

sandbox - the sandbox where the operation was performed

Returns:

the log from the last sandbox operation; null if not available

getRepositoryLastChanges

public ChangeSet getRepositoryLastChanges(Sandbox sandbox,
                                          java.lang.String reposId)

Description copied from class: SandboxSupport

Returns the changes obtained last time from a repository branch.

Overrides:

getRepositoryLastChanges in class SandboxSupport

Parameters:

sandbox - the sandbox that contains the repository branch

Returns:

the changes obtained last time from a repository branch; null if such information is unavailable

getRepositoryErrorLog

public RepositoryErrorLog getRepositoryErrorLog(Sandbox sandbox,
                                                java.lang.String reposId)

Description copied from class: SandboxSupport

Returns the error log from the last repository operation if any.

Overrides:

getRepositoryErrorLog in class SandboxSupport

Parameters:

sandbox - the sandbox where the repository is branched

reposId - the ID of the repository

Returns:

the error log from the last repository operation; null if there is no error, or the error log is not available

removeProcessLock

public boolean removeProcessLock(Sandbox sandbox,
                                 int minElapsedHours)

Description copied from class: SandboxSupport

Forcefully removes the synchronization lock placed by a Java process performing a sandbox operation.

Normally a lock is placed on a sandbox before a process starts handling an operation and is removed after the process ends, so that a sandbox is handled by one process at a time. For example, when a process is refreshing a sandbox, a lock will prevent other processes from enabling new features in the same sandbox.

Occassionally a lock may not be removed due to unexpected situations such as the Java process that performs the operation is terminated prematurely. In such cases the lock must be removed explicitly. To avoid removing a lock while an operation is actually in progress, a minimum elapsed time may be specified, so that a lock is removed only if the duration between its placement and now is greater than the specified elapsed time.

Overrides:

removeProcessLock in class SandboxSupport

Parameters:

sandbox - the sandbox where the lock is placed

minElapsedHours - the minimum elapsed time in hours

Returns:

true if the lock has been removed; false a lock is in place but cannot be removed because the elapsed time is shorter than or the same as the specified minimum

refresh

public java.util.Map<SandboxedRepository,ChangeSet> refresh(Sandbox sandbox)
                                                     throws SuspendedSandboxOperationException,
                                                            RepositoryExceptions

Description copied from class: SandboxSupport

Merges changes made in participating repositories into a sandbox. If there is any merge conflict, all merged changes are undone. If the changes to the sandbox cannot be undone, the sandbox will be set to state SandboxState.INACTIVE.

Specified by:

refresh in class SandboxSupport

Parameters:

sandbox - the sandbox

Returns:

the changes that have been merged; an empty map if the sandbox does contain any repositories

Throws:

RepositoryExceptions - if merge conflicts are detected or any error occurs during the process

SuspendedSandboxOperationException

listOpenSandboxes

public java.util.List<java.lang.String> listOpenSandboxes(boolean includeArchives)

Description copied from class: SandboxSupport

Returns the IDs of the sandboxes that are open at the time of invocation. An open sandbox is a sandbox that allows more operations than destroy to be performed on it. In other words, a sandbox that is not open can only be destroyed.

Specified by:

listOpenSandboxes in class SandboxSupport

Parameters:

includeArchives - true if the returned list should include the sandboxes that are created from archives

Returns:

the IDs of the open sandboxes at the time of invocation; an empty list if no sandboxes are open

notifyRefreshRequired

public void notifyRefreshRequired(java.lang.String reposId)

Description copied from class: SandboxSupport

Notifies sandboxes that contain a branch of a specific repository that they must be refreshed before any further sandboxed changes are made.

Specified by:

notifyRefreshRequired in class SandboxSupport

Parameters:

reposId - the ID of the repository

See Also:

Sandbox.isRefreshRequired(), SandboxSupport.refresh(oracle.adf.share.sandbox.Sandbox)

canSynchronizedPublish

public boolean canSynchronizedPublish(Sandbox sandbox)

Description copied from class: SandboxSupport

Returns true if all locks needed for synchronizedPublish are available at the time of the invocation. This information serves as a hint only. A ConcurrentSandboxOperationException may still be thrown when synchronizedPublish is invoked because the locks may be acquired by another sandbox between the invocation of this method and that of synchronizedPublish. If a client must block on synchronizedPublish, skip this check and call synchronizedPublish periodically until ConcurrentSandboxOperationException is not thrown.

Overrides:

canSynchronizedPublish in class SandboxSupport

Parameters:

sandbox - the sandbox to be published

Returns:

true if all locks needed for synchronizedPublish are available at the time of the invocation

synchronizedPublish

public java.util.Map<SandboxedRepository,ChangeSet> synchronizedPublish(Sandbox sandbox,
                                                                        boolean refreshBefore)
                                                                 throws RepositoryExceptions,
                                                                        ConcurrentSandboxOperationException

Description copied from class: SandboxSupport

Publishes a sandbox only when all mainline exclusive locks of the branched repositories are available; in other words, a ConcurrentSandboxOperationException is thrown when another synchronizedPublish call is in progress, or when a mainline exclusive lock of any branched repository has been acquired by an archive.

Overrides:

synchronizedPublish in class SandboxSupport

Parameters:

sandbox - the sandbox to be published

refreshBefore - true if refresh should be called first after acquiring the necessary locks. If a repository is pending resume after the first pass, the process will be resumed once with change hint ChangeHint.STOP_AT_CONFLICTS. If any repository is still pending resume after the second pass, a SsuspendedSandboxOperation is thrown.

Returns:

the changes just published

Throws:

RepositoryExceptions - if any error occurs during the publish

ConcurrentSandboxOperationException - if refreshBefore is true and any repository is still pending resume after the first resume

publish

public java.util.Map<SandboxedRepository,ChangeSet> publish(Sandbox sandbox)
                                                     throws RepositoryExceptions

Description copied from class: SandboxSupport

Merges changes in a sandbox back into the repositories. If there is any merge conflict, all merged changes are undone. If the changes to a repository cannot be undone, the repository will be set to state SandboxState.INACTIVE.

Specified by:

publish in class SandboxSupport

Parameters:

sandbox - the sandbox

Returns:

the changes that have been committed; an empty map if the sandbox does contain any repositories

Throws:

RepositoryExceptions - if merge conflicts are detected or any error occurs during the process

unpublishCheck

public IneligibleForUnpublishException unpublishCheck(Sandbox sandbox)

Description copied from class: SandboxSupport

Checks if a sandbox is eligible for unpublish at this moment. Note that being eligible now does not guarantee the sandbox is still eligible for unpublish when unpublish is called.

Overrides:

unpublishCheck in class SandboxSupport

Parameters:

sandbox - the sandbox to be checked

Returns:

null if the given sandbox is eligible for unpublish; otherwise an object is returned to indicate the reason

See Also:

SandboxSupport.unpublish(oracle.adf.share.sandbox.Sandbox)

unpublish

public void unpublish(Sandbox sandbox)
               throws IneligibleForUnpublishException

Description copied from class: SandboxSupport

Unpublishes a sandbox if it's eligible.

Overrides:

unpublish in class SandboxSupport

Parameters:

sandbox - the sandbox to be unpublished

Throws:

IneligibleForUnpublishException - if the given sandbox is ineligible for unpublish

See Also:

SandboxSupport.unpublishCheck(oracle.adf.share.sandbox.Sandbox)

destroy

public void destroy(Sandbox sandbox)
             throws RepositoryExceptions

Description copied from class: SandboxSupport

Destroys a sandbox and deletes all information pertaining to the sandbox.

Specified by:

destroy in class SandboxSupport

Parameters:

sandbox - the sandbox to be destroyed

Throws:

RepositoryExceptions - if there is any error coming from the repositories

destroy

public void destroy(Sandbox sandbox,
                    boolean retainInfo)
             throws RepositoryExceptions

Description copied from class: SandboxSupport

Destroys a sandbox and optionally retains the sandbox information such as operation logs. If the sandbox information is retained, the state will be set to SandboxState.IRRECOVERABLE.

Overrides:

destroy in class SandboxSupport

Parameters:

sandbox - the sandbox to be destroyed

retainInfo - true if the sandbox information should be retained

Throws:

RepositoryExceptions

See Also:

SandboxSupport.destroy(Sandbox)

enableFeature

public boolean enableFeature(Sandbox sandbox,
                             java.lang.String featureClassName)
                      throws IncompatibleFeatureException,
                             SandboxException

Description copied from class: SandboxSupport

Enables a feature in the sandbox.

Specified by:

enableFeature in class SandboxSupport

Parameters:

sandbox - the sandbox

featureClassName - the ID of the sandboxed feature

Returns:

false if the feature was already enabled prior to this call

Throws:

IncompatibleFeatureException - if the feature is incompatible with the sandbox

SandboxException - if an error occurs while enabling the feature

enableFeatures

public java.util.Map<java.lang.String,java.lang.Throwable> enableFeatures(Sandbox sandbox,
                                                                          java.util.List<java.lang.String> featureIdList)
                                                                   throws IncompatibleFeatureException,
                                                                          SandboxException

Description copied from class: SandboxSupport

Enables a list of features. Subclasses may override this method to support concurrent processing to improve performance.

Overrides:

enableFeatures in class SandboxSupport

Parameters:

sandbox - the sandbox where the features are to be enabled

featureIdList - the IDs of the features to be enabled

Returns:

errors occurred during the process if any. The keys of the map are the feature IDs while the values are the errors. The caller must examine the returned map for any failures. Any empty map indicates all features are successfully enabled.

Throws:

IncompatibleFeatureException

SandboxException

setSandboxConstraints

public void setSandboxConstraints(Sandbox sandbox,
                                  SandboxConstraints constraints)

Description copied from class: SandboxSupport

Sets constraints for a sandbox.

Overrides:

setSandboxConstraints in class SandboxSupport

Parameters:

sandbox - the sandbox with which the constraints are to be associated

constraints - the constraints for the sandbox

setSandboxOperationChangeHint

public void setSandboxOperationChangeHint(Sandbox sandbox,
                                          ChangeHint changeHint)

Description copied from class: SandboxSupport

Gives a change hint to all repositories involved in the current operation.

Overrides:

setSandboxOperationChangeHint in class SandboxSupport

Parameters:

sandbox - the sandbox on which the current operation is in progress

changeHint - the change hint; null if the default hint should be given

See Also:

SandboxTransaction

tryLock

public boolean tryLock(SandboxArchive archive)

Description copied from class: SandboxSupport

Tries to acquire the lock for processing a sandbox archive. It is assumed that at most one sandbox archive can be processed at any given time. That means the lock is considered already acquired when this method is called again before unlock(SandboxArchive). The behavior of calling this method again with a different SandboxArchive object before releasing the lock for the first call is undefined.

Overrides:

tryLock in class SandboxSupport

Parameters:

archive - the sandbox archive to be processed

Returns:

true if the lock is acquired successfully; false if the involved repositories are currently locked by other sandboxes

See Also:

SandboxSupport.unlock(oracle.adf.share.sandbox.SandboxArchive)

unlock

public void unlock(SandboxArchive archive)

Description copied from class: SandboxSupport

Releases the lock acquired for processing a sandbox archive. It is assumed that at most one sandbox archive can be processed at any given time. This method releases the lock without consulting the given SandboxArchive object.

Overrides:

unlock in class SandboxSupport

Parameters:

archive - the sandbox archive that was just processed; or null if the information of the archive is no longer available

See Also:

SandboxSupport.tryLock(oracle.adf.share.sandbox.SandboxArchive)

isLockedBySandboxArchive

public boolean isLockedBySandboxArchive()

Description copied from class: SandboxSupport

Returns true if the mainline of any repository is locked by a sandbox archive at the time of invcation. When the processing of a sandbox archive is in progress, ConcurrentSandboxOperationException may be thrown by methods that require the same locks already acquired by the archive, such as enableFeature or synchronizedPublish. The client may simply skip all operations and wait until this method returns false again.

Overrides:

isLockedBySandboxArchive in class SandboxSupport

Returns:

true if the mainline of any repository is locked by a sandbox archive at the time of invocation

See Also:

SandboxSupport.tryLock(oracle.adf.share.sandbox.SandboxArchive), SandboxSupport.unlock(oracle.adf.share.sandbox.SandboxArchive)

addAdministrator

public boolean addAdministrator(Sandbox sandbox,
                                java.lang.String userName)

Description copied from class: SandboxSupport

Adds a user to the list of administrators of a sandbox.

Overrides:

addAdministrator in class SandboxSupport

Parameters:

sandbox - the sandbox administered

userName - the user to be added as an administrator

Returns:

true if the user is not an administrator prior to this call; false if the user was not added to the list because he is already an administrator of the sandbox

removeAdministrator

public boolean removeAdministrator(Sandbox sandbox,
                                   java.lang.String userName)

Description copied from class: SandboxSupport

Removes a user from the list of administrators of a sandbox.

Overrides:

removeAdministrator in class SandboxSupport

Parameters:

sandbox - the sandbox administered by the user

userName - the user to be removed from the list of administrators

Returns:

true if the user is an administrator prior to this call and is successfully removed from the list; false if the user is not on the list or cannot be removed because he is the owner of the sandbox

listAdministrators

public java.util.List<java.lang.String> listAdministrators(Sandbox sandbox)

Description copied from class: SandboxSupport

Returns the list of administrators of a sandbox.

Overrides:

listAdministrators in class SandboxSupport

Parameters:

sandbox - the sandbox

Returns:

names of the sandbox administrator