Package com.nomagic.magicdraw.merge

Class CompareUtil

java.lang.Object

com.nomagic.magicdraw.merge.CompareUtil

Direct Known Subclasses:

MergeUtil

@OpenApiAll
public class CompareUtil
extends java.lang.Object

Allows using MagicDraw project merge core to compare projects (find project differences). See Open API manual for the usage details.

Constructor Summary

Constructors

Constructor	Description
CompareUtil()

Method Summary

Modifier and Type	Method	Description
static ProjectDifference	compareProjects(Project project, ProjectDescriptor baseProjectDescriptor, ErrorHandler<java.lang.Exception> errorHandler, Optimization optimization)	Compare projects.
static ProjectDifference	getDifference(Project targetProject, ProjectDescriptor source, ProjectDescriptor ancestor, ErrorHandler<java.lang.Exception> errorHandler, Optimization optimization)	Discover project difference.
static ProjectDifference	getDifference(Project targetProject, ProjectDescriptor source, ProjectDescriptor ancestor, ErrorHandler<java.lang.Exception> errorHandler, Optimization optimization, java.util.Set<ModuleInfo> modules)	Deprecated, for removal: This API element is subject to removal in a future version. use getDifference(Project, ProjectDescriptor, ProjectDescriptor, ErrorHandler, Optimization)
static void	restore(ProjectDifference difference)	Dispose project difference.
static void	showDifferenceGUI(ProjectDifference projectDifference)	Show project difference GUI.

Methods inherited from class java.lang.Object

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

Constructor Detail

CompareUtil

public CompareUtil()

Method Detail

compareProjects

@CheckForNull
public static ProjectDifference compareProjects(Project project,
                                                ProjectDescriptor baseProjectDescriptor,
                                                ErrorHandler<java.lang.Exception> errorHandler,
                                                Optimization optimization)
                                         throws java.lang.IllegalStateException

Compare projects. On success project difference is returned and the base project is active project.

Parameters:

project - target project.

baseProjectDescriptor - source project descriptor.

errorHandler - invoked if error occurs. Allows to perform custom action.

optimization - optimization option.`

Returns:

project difference.

Throws:

java.lang.IllegalStateException - if merge is not available

getDifference

@CheckForNull
public static ProjectDifference getDifference(Project targetProject,
                                              ProjectDescriptor source,
                                              @CheckForNull
                                              ProjectDescriptor ancestor,
                                              ErrorHandler<java.lang.Exception> errorHandler,
                                              Optimization optimization)
                                       throws java.lang.IllegalStateException

Discover project difference. On success project difference is returned and ancestor project is active project.

Parameters:

targetProject - target project.

source - source project descriptor.

ancestor - ancestor project descriptor. Used only for 3-way merge, null for 2-way merge.

errorHandler - invoked if error occurs. Allows to perform custom action.

optimization - optimization option.

Returns:

project difference.

Throws:

java.lang.IllegalStateException - if merge is not available

getDifference

@Deprecated(since="2022xRefresh2",
            forRemoval=true)
@CheckForNull
public static ProjectDifference getDifference(Project targetProject,
                                              ProjectDescriptor source,
                                              @CheckForNull
                                              ProjectDescriptor ancestor,
                                              ErrorHandler<java.lang.Exception> errorHandler,
                                              Optimization optimization,
                                              @CheckForNull
                                              java.util.Set<ModuleInfo> modules)
                                       throws java.lang.IllegalStateException

Deprecated, for removal: This API element is subject to removal in a future version.

use getDifference(Project, ProjectDescriptor, ProjectDescriptor, ErrorHandler, Optimization)

Discover project difference. On success project difference is returned and ancestor project is active project.

Parameters:

targetProject - target project.

source - source project descriptor.

ancestor - ancestor project descriptor. Used only for 3-way merge, null for 2-way merge.

errorHandler - invoked if error occurs. Allows to perform custom action.

optimization - optimization option.

modules - (deprecated - it has no effect in Teamwork Cloud) request modules for read-write merge mode. Restriction/constraints apply for read-write module merge mode.

Returns:

project difference.

Throws:

java.lang.IllegalStateException - if merge is not available

restore

public static void restore(ProjectDifference difference)

Dispose project difference.

Parameters:

difference - project difference.

showDifferenceGUI

public static void showDifferenceGUI(ProjectDifference projectDifference)
                              throws java.lang.IllegalStateException

Show project difference GUI.

Parameters:

projectDifference - project difference.

Throws:

java.lang.IllegalStateException - if diff is not available