oracle.adf.share.sandbox

Class MdsObjectMergeSupport

java.lang.Object

oracle.adf.share.sandbox.MdsObjectMergeSupport

Direct Known Subclasses:

MdsObjectMergeSupportImpl

public abstract class MdsObjectMergeSupport
extends java.lang.Object

A class that manages sandbox object merge.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	MdsObjectMergeSupport.MdsObjectMergeException Thrown when object merge process is disrupted.
static class	MdsObjectMergeSupport.MdsObjectMergeProxy A proxy of the controller of an ongoing object merge process.
static class	MdsObjectMergeSupport.PendingInputException Thrown when external input is required by the object merge process.
static class	MdsObjectMergeSupport.UnexpectedErrorsException Thrown when unexpected errors occur during the object merge process.
static class	MdsObjectMergeSupport.UnresolvableConflictsException Thrown when conflicts cannot be resolved by the object merge process.

Field Summary

Fields

Modifier and Type	Field and Description
static MetadataEnvironmentShell.Variable<SandboxConflictResolutionHint>	RESOLUTION_HINT A variable that stores the hint of how conflicts should be resolved.

Constructor Summary

Constructors

Constructor and Description
MdsObjectMergeSupport()

Method Summary

Modifier and Type	Method and Description
static MdsObjectMergeSupport	getInstance() Returns default instance of this class.
void	invokeObjectMerge(Sandbox sandbox, MdsCommonRepository repositoryObj, java.util.Collection<java.lang.String> appIds) Invokes API to auto merge the conflicting changes - aka Object Merge for the requested repository of the sandbox.
boolean	isObjectMergeEnabled() Return true if object merge should be attempted, merge handlers will not be called when this returns false.
MdsObjectMergeSupport.MdsObjectMergeProxy	merge(java.lang.String mdsSandboxName, oracle.mds.naming.Namespace storeLocator) Initiates the object merge process with RESOLUTION_HINT set to SandboxConflictResolutionHint.MAINLINE_FORCED.
MdsObjectMergeSupport.MdsObjectMergeProxy	merge(java.lang.String mdsSandboxName, oracle.mds.naming.Namespace storeLocator, MetadataEnvironmentShell.Variables variables) Initiates the object merge process for a sandbox.

Methods inherited from class java.lang.Object

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

Field Detail

RESOLUTION_HINT

public static final MetadataEnvironmentShell.Variable<SandboxConflictResolutionHint> RESOLUTION_HINT

A variable that stores the hint of how conflicts should be resolved.

Constructor Detail

MdsObjectMergeSupport

public MdsObjectMergeSupport()

Method Detail

isObjectMergeEnabled

public boolean isObjectMergeEnabled()

Return true if object merge should be attempted, merge handlers will not be called when this returns false. default implementation returns true.

Returns:

true/false

merge

public MdsObjectMergeSupport.MdsObjectMergeProxy merge(java.lang.String mdsSandboxName,
                                                       oracle.mds.naming.Namespace storeLocator)
                                                throws MdsObjectMergeSupport.UnexpectedErrorsException,
                                                       MdsObjectMergeSupport.UnresolvableConflictsException,
                                                       MdsObjectMergeSupport.PendingInputException,
                                                       MdsObjectMergeSupport.MdsObjectMergeException

Initiates the object merge process with RESOLUTION_HINT set to SandboxConflictResolutionHint.MAINLINE_FORCED.

Parameters:

mdsSandboxName - the name of the MDS sandbox

storeLocator - the namespace to locate the sandbox

Returns:

the proxy of the controller of this merge process

Throws:

MdsObjectMergeSupport.UnexpectedErrorsException - if unexpected errors occur during the process

MdsObjectMergeSupport.UnresolvableConflictsException - if there are conflicts that cannot be resolved by the process

MdsObjectMergeSupport.PendingInputException - if the process cannot continue without external input

MdsObjectMergeSupport.MdsObjectMergeException - if any error occurs when initiating the process

merge

public MdsObjectMergeSupport.MdsObjectMergeProxy merge(java.lang.String mdsSandboxName,
                                                       oracle.mds.naming.Namespace storeLocator,
                                                       MetadataEnvironmentShell.Variables variables)
                                                throws MdsObjectMergeSupport.UnexpectedErrorsException,
                                                       MdsObjectMergeSupport.UnresolvableConflictsException,
                                                       MdsObjectMergeSupport.PendingInputException,
                                                       MdsObjectMergeSupport.MdsObjectMergeException

Initiates the object merge process for a sandbox.

Parameters:

mdsSandboxName - the name of the MDS sandbox

storeLocator - the namespace to locate the sandbox

variables - variables that configure the process; null if the default configuration is to be used

Returns:

the proxy of the controller of this merge process

Throws:

MdsObjectMergeSupport.UnexpectedErrorsException - if unexpected errors occur during the process

MdsObjectMergeSupport.UnresolvableConflictsException - if there are conflicts that cannot be resolved by the process

MdsObjectMergeSupport.PendingInputException - if the process cannot continue without external input

MdsObjectMergeSupport.MdsObjectMergeException - if any error occurs when initiating the process

invokeObjectMerge

public void invokeObjectMerge(Sandbox sandbox,
                              MdsCommonRepository repositoryObj,
                              java.util.Collection<java.lang.String> appIds)
                       throws SandboxException

Invokes API to auto merge the conflicting changes - aka Object Merge for the requested repository of the sandbox.

Parameters:

sandbox - - Sandbox object

appIds - - application identifiers to invoke the object merge in the context of each application.

Throws:

SandboxException - if an error occurs during merge. The actual error may be retrieved via getCause().

getInstance

public static MdsObjectMergeSupport getInstance()

Returns default instance of this class.