com.ibm.xtools.modeler.ui

Class UMLModeler

java.lang.Object

com.ibm.xtools.modeler.ui.UMLModeler

public final class UMLModeler
extends java.lang.Object

A utility class that exposes model and profile lifecycle operations and provides access to the modeling platform.

API clients should not instantiate this class.

Method Summary

Modifier and Type	Method and Description
static org.eclipse.emf.ecore.EObject	absorbFragment(org.eclipse.emf.ecore.resource.Resource resource) Absorbs the specified fragment.
static org.eclipse.emf.ecore.EObject	absorbFragmentSilently(org.eclipse.emf.ecore.resource.Resource resource, boolean refactorReferences) Absorbs the specified fragment.
static void	addRemoveAllListener(java.lang.Runnable runnable)
static java.util.List<org.eclipse.emf.ecore.EModelElement>	batchAbsorbFragments(java.util.List<? extends org.eclipse.emf.ecore.resource.Resource> resources, boolean refactorReferences) Absorbs the specified fragments.
static java.util.List<org.eclipse.emf.ecore.resource.Resource>	batchCreateFragments(java.util.List<org.eclipse.emf.common.util.URI> fragmentUris, java.util.List<? extends org.eclipse.emf.ecore.EModelElement> fragmentRoots, boolean refactorReferences) Creates fragment resources.
static void	closeModel(org.eclipse.uml2.uml.Model model) Deprecated. Since 7.5, use the closeModelResource(Element) method, instead
static void	closeModelFragment(org.eclipse.emf.ecore.EObject element) Closes the model fragment resource specified by the given root element.
static void	closeModelResource(org.eclipse.uml2.uml.Element element) Closes the model specified by the given root element.
static void	closeProfile(org.eclipse.uml2.uml.Profile profile) Closes the profile specified by profile
static org.eclipse.emf.ecore.resource.Resource	createFragment(org.eclipse.emf.common.util.URI fragmentUri, org.eclipse.emf.ecore.EModelElement fragmentRoot) Creates the fragment resource.
static org.eclipse.emf.ecore.resource.Resource	createFragmentSilently(org.eclipse.emf.common.util.URI fragmentUri, org.eclipse.emf.ecore.EModelElement fragmentRoot, boolean refactorReferences) Creates the fragment resource.
static org.eclipse.uml2.uml.Model	createModel(java.lang.String file) Deprecated. Since 7.5, use the createModelResource(Class, String) method, instead, with the Model.class root metaclass argument
static org.eclipse.uml2.uml.Model	createModel(org.eclipse.emf.common.util.URI uri) Deprecated. Since 7.5, use the createModelResource(Class, URI) method, instead, with the Model.class root metaclass argument
static <E extends org.eclipse.uml2.uml.Element> E	createModelResource(java.lang.Class<E> rootMetaclass, java.lang.String file) Creates a UML model resource (as distinguished from a profile resource) given a file path and a root element metaclass.
static <E extends org.eclipse.uml2.uml.Element> E	createModelResource(java.lang.Class<E> rootMetaclass, org.eclipse.emf.common.util.URI uri) Creates a UML model resource (as distinguished from a profile resource) given a file path and a root element metaclass.
static org.eclipse.uml2.uml.Profile	createProfile(java.lang.String file) Creates a UML profile given a file path
static org.eclipse.uml2.uml.Profile	createProfile(org.eclipse.emf.common.util.URI uri) Creates a UML profile given a URI
static boolean	forceMigrate(java.lang.String file) Migrates specified logical model.
static IProfileDescriptor	getDeployedProfile(java.lang.String id) Retrieves the deployed profile given its unique identifier from the extension point.
static java.util.Collection<IProfileDescriptor>	getDeployedProfiles() Retrieves all deployed profiles from the extension point.
static org.eclipse.emf.transaction.TransactionalEditingDomain	getEditingDomain() Returns the UMLModeler's EditingDomain.
static ILogicalResource	getLogicalResource(org.eclipse.emf.ecore.EObject eObj) Returns the logical UML resource of the specified EObject.
static ILogicalResource	getLogicalResource(org.eclipse.emf.ecore.resource.Resource resource) Returns the logical UML resource of the specified resource.
static IOclQueryHelper	getOclQueryHelper() Returns a helper to perform OCL queries
static java.util.Collection<org.eclipse.uml2.uml.Model>	getOpenedModels() Deprecated. Since 7.5, use the getOpenModelRoots() method, instead.
static java.util.Collection<org.eclipse.uml2.uml.Element>	getOpenModelRoots() Returns the root elements of all open UML model resources.
static IQueryHelper	getQueryHelper() Returns a helper to perform queries
static IUMLDiagramHelper	getUMLDiagramHelper() Returns a user helper to work with classes implementing View
static IUMLHelper	getUMLHelper() Returns a helper to work with classes implementing Element
static IUMLUIHelper	getUMLUIHelper() Returns a user interface helper to work with classes implementing Element
static org.eclipse.uml2.uml.Model	openModel(java.lang.String file) Deprecated. Since 7.5, use the openModelResource(String) method, instead.
static org.eclipse.uml2.uml.Model	openModel(org.eclipse.emf.common.util.URI uri) Deprecated. Since 7.5, use the openModelResource(URI) method, instead.
static org.eclipse.uml2.uml.Element	openModelResource(java.lang.String file) Opens the UML model resource whose filename is described by file.
static org.eclipse.uml2.uml.Element	openModelResource(org.eclipse.emf.common.util.URI uri) Opens the UML model whose filename is described by uri.
static org.eclipse.uml2.uml.Profile	openProfile(java.lang.String file) Opens the UML profile whose filename is described by file.
static org.eclipse.uml2.uml.Profile	openProfile(org.eclipse.emf.common.util.URI uri) Opens the UML profile whose URI is described by uri.
static void	removeRemoveAllListener(java.lang.Runnable runnable)
static void	saveModel(org.eclipse.uml2.uml.Model model) Deprecated. Since 7.5, use the saveModelResource(Element) method, instead.
static void	saveModelAs(org.eclipse.uml2.uml.Model model, java.lang.String file) Deprecated. Since 7.5, use the saveModelResourceAs(Element, String) method, instead.
static void	saveModelAs(org.eclipse.uml2.uml.Model model, org.eclipse.emf.common.util.URI uri) Deprecated. Since 7.5, use the saveModelResourceAs(Element, URI) method, instead.
static void	saveModelResource(org.eclipse.uml2.uml.Element model) Saves the UML model resource specified by model.
static void	saveModelResourceAs(org.eclipse.uml2.uml.Element model, java.lang.String file) Saves the model specified by a root model element to the location specified by file.
static void	saveModelResourceAs(org.eclipse.uml2.uml.Element model, org.eclipse.emf.common.util.URI uri) Saves the model specified by a root model element to the location specified by uri.
static void	saveProfile(org.eclipse.uml2.uml.Profile profile) Saves the UML profile specified by profile.
static void	saveProfileAs(org.eclipse.uml2.uml.Profile profile, java.lang.String file) Saves the profile specified by profile to the location specified by file.
static void	saveProfileAs(org.eclipse.uml2.uml.Profile profile, org.eclipse.emf.common.util.URI uri) Saves the profile specified by profile to the location specified by uri.
static void	saveResource(org.eclipse.emf.ecore.resource.Resource resource, int options) Saves the resource specified by resource.
static void	triggerRemoveAllListeners()

Methods inherited from class java.lang.Object

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

Method Detail

getUMLHelper

public static IUMLHelper getUMLHelper()

Returns a helper to work with classes implementing Element

Returns:

The UMLModeler IUMLHelper

getUMLUIHelper

public static IUMLUIHelper getUMLUIHelper()

Returns a user interface helper to work with classes implementing Element

Returns:

The UMLModeler IUMLUIHelper

getQueryHelper

public static IQueryHelper getQueryHelper()

Returns a helper to perform queries

Returns:

The UMLModeler IQueryHelper

getOclQueryHelper

public static IOclQueryHelper getOclQueryHelper()

Returns a helper to perform OCL queries

Returns:

The UMLModeler IOclQueryHelper

getUMLDiagramHelper

public static IUMLDiagramHelper getUMLDiagramHelper()

Returns a user helper to work with classes implementing View

Returns:

The UMLModeler IUMLDiagramHelper

getEditingDomain

public static org.eclipse.emf.transaction.TransactionalEditingDomain getEditingDomain()

Returns the UMLModeler's EditingDomain. The latter is used to perform operations on the models managed by the tool. It also provides batched notification support.

Returns:

The UMLModeler EditingDomain

getOpenedModels

public static java.util.Collection<org.eclipse.uml2.uml.Model> getOpenedModels()

Deprecated. Since 7.5, use the getOpenModelRoots() method, instead.

Returns all open UML models.

Returns:

The collection of all currently open UML Models

getOpenModelRoots

public static java.util.Collection<org.eclipse.uml2.uml.Element> getOpenModelRoots()

Returns the root elements of all open UML model resources. This excludes profiles.

Returns:

The roots of all currently open UML model resources. Usually, these will be Packages of some kind, but this is not guaranteed

Since:

7.5

createModel

@Deprecated
public static org.eclipse.uml2.uml.Model createModel(java.lang.String file)

Deprecated. Since 7.5, use the createModelResource(Class, String) method, instead, with the Model.class root metaclass argument

Creates a UML model given a file path

Parameters:

file - The model file to create

Returns:

The created UML model

Throws:

java.lang.IllegalArgumentException - file is an empty string

java.lang.NullPointerException - file is null

createModel

@Deprecated
public static org.eclipse.uml2.uml.Model createModel(org.eclipse.emf.common.util.URI uri)

Deprecated. Since 7.5, use the createModelResource(Class, URI) method, instead, with the Model.class root metaclass argument

Creates a UML model given a URI

Parameters:

uri - The URI of the model to create

Returns:

The created UML model

Throws:

java.lang.IllegalArgumentException - uri is an empty URI

java.lang.NullPointerException - uri is null

createModelResource

public static <E extends org.eclipse.uml2.uml.Element> E createModelResource(java.lang.Class<E> rootMetaclass,
                                                                             java.lang.String file)

Creates a UML model resource (as distinguished from a profile resource) given a file path and a root element metaclass.

Type Parameters:

E - the metaclass to instantiate as the root element

Parameters:

rootMetaclass - the metaclass to instantiate as the root element. Must be either Model or Package

file - The model resource to create

Returns:

The root element of the new UML resource

Throws:

java.lang.IllegalArgumentException - if rootMetaclass is not one of the permitted values or file is an empty string

java.lang.NullPointerException - file is null

Since:

7.5

createModelResource

public static <E extends org.eclipse.uml2.uml.Element> E createModelResource(java.lang.Class<E> rootMetaclass,
                                                                             org.eclipse.emf.common.util.URI uri)

Creates a UML model resource (as distinguished from a profile resource) given a file path and a root element metaclass.

Type Parameters:

E - the metaclass to instantiate as the root element

Parameters:

rootMetaclass - the metaclass to instantiate as the root element. Must be either Model or Package

uri - The URI of the model resource to create

Returns:

The root element of the new UML resource

Throws:

java.lang.IllegalArgumentException - if rootMetaclass is not one of the permitted values or uri is an empty URI

java.lang.NullPointerException - uri is null

Since:

7.5

openModel

@Deprecated
public static org.eclipse.uml2.uml.Model openModel(java.lang.String file)
                                                         throws java.io.IOException

Deprecated. Since 7.5, use the openModelResource(String) method, instead.

Opens the UML model whose filename is described by file.

Supported extensions are:

• .emx
• .uml

Parameters:

file - The model file to open

Returns:

The opened UML model

Throws:

java.lang.IllegalArgumentException - file is an empty string

java.io.IOException - The file specified by file could not be found or the file is corrupted or could not be opened

java.lang.NullPointerException - file is null

java.lang.ClassCastException - file does not point to a Model

openModelResource

public static org.eclipse.uml2.uml.Element openModelResource(java.lang.String file)
                                                      throws java.io.IOException

Opens the UML model resource whose filename is described by file.

Supported extensions are:

• .emx
• .uml

Parameters:

file - The model file to open

Returns:

The opened UML model's root element. Usually, this is some kind of Package, but that is not guaranteed

Throws:

java.lang.IllegalArgumentException - file is an empty string

java.io.IOException - The file specified by file could not be found or the file is corrupted or could not be opened

java.lang.NullPointerException - file is null

java.lang.ClassCastException - file does not point to a Model

Since:

7.5

openModel

@Deprecated
public static org.eclipse.uml2.uml.Model openModel(org.eclipse.emf.common.util.URI uri)
                                                         throws java.io.IOException

Deprecated. Since 7.5, use the openModelResource(URI) method, instead.

Opens the UML model whose filename is described by uri.

Supported extensions are:

• .emx
• .uml

Parameters:

uri - The URI of the model to open

Returns:

The opened UML model

Throws:

java.lang.IllegalArgumentException - file is an empty string

java.io.IOException - The file specified by file could not be found or the file is corrupted or could not be opened

java.lang.NullPointerException - file is null

java.lang.ClassCastException - file does not point to a Model

openModelResource

public static org.eclipse.uml2.uml.Element openModelResource(org.eclipse.emf.common.util.URI uri)
                                                      throws java.io.IOException

Opens the UML model whose filename is described by uri.

Supported extensions are:

• .emx
• .uml

Parameters:

uri - The URI of the model to open

Returns:

The opened UML model's root element. Usually, this is some kind of Package, but that is not guaranteed

Throws:

java.lang.IllegalArgumentException - file is an empty string

java.io.IOException - The file specified by file could not be found or the file is corrupted or could not be opened

java.lang.NullPointerException - file is null

java.lang.ClassCastException - file does not point to a Model

Since:

7.5

saveModel

@Deprecated
public static void saveModel(org.eclipse.uml2.uml.Model model)
                                   throws java.io.IOException

Deprecated. Since 7.5, use the saveModelResource(Element) method, instead.

Saves the UML model specified by model.

Parameters:

model - The UML model to save

Throws:

java.io.IOException - The location specified by the root path of model cannot be used to save the model

java.lang.IllegalArgumentException - model has no associated resource

saveModelResource

public static void saveModelResource(org.eclipse.uml2.uml.Element model)
                              throws java.io.IOException

Saves the UML model resource specified by model. The specified resource and any currently open, modified fragment resource are saved.

Parameters:

model - The root element of the UML model resource to save

Throws:

java.io.IOException - The location specified by the root path of model cannot be used to save the model

java.lang.IllegalArgumentException - model has no associated resource

Since:

7.5

saveModelAs

@Deprecated
public static void saveModelAs(org.eclipse.uml2.uml.Model model,
                                            java.lang.String file)
                                     throws java.io.IOException

Deprecated. Since 7.5, use the saveModelResourceAs(Element, String) method, instead.

Saves the model specified by model to the location specified by file. This method cannot be used to convert from one format to another: the file will be saved in the same format in which it was opened, even if the file extension is changed through this method. For example, if the file "model.emx" is saved as "model.uml", it is still really using the "emx" format, not the "uml" format.

Parameters:

model - The UML model to save

file - The location to save the UML model

Throws:

java.io.IOException - The location specified by file cannot be used to save the model

java.lang.IllegalArgumentException - model has no associated resource or model is null

saveModelResourceAs

public static void saveModelResourceAs(org.eclipse.uml2.uml.Element model,
                                       java.lang.String file)
                                throws java.io.IOException

Saves the model specified by a root model element to the location specified by file. This method cannot be used to convert from one format to another: the file will be saved in the same format in which it was opened, even if the file extension is changed through this method. For example, if the file "model.emx" is saved as "model.uml", it is still really using the "emx" format, not the "uml" format.

Parameters:

model - The root of the UML model resource to save

file - The location to save the UML model resource

Throws:

java.io.IOException - The location specified by file cannot be used to save the model

java.lang.IllegalArgumentException - model has no associated resource or model is null

Since:

7.5

saveModelAs

@Deprecated
public static void saveModelAs(org.eclipse.uml2.uml.Model model,
                                            org.eclipse.emf.common.util.URI uri)
                                     throws java.io.IOException

Deprecated. Since 7.5, use the saveModelResourceAs(Element, URI) method, instead.

Saves the model specified by model to the location specified by uri. This method cannot be used to convert from one format to another: the file will be saved in the same format in which it was opened, even if the file extension is changed through this method. For example, if the file "model.emx" is saved as "model.uml", it is still really using the "emx" format, not the "uml" format.

Parameters:

model - The UML2 model to save

uri - The URI location to save the UML2 model

Throws:

java.io.IOException - The location specified by uri cannot be used to save the model

java.lang.IllegalArgumentException - model has no associated resource or model is null

saveModelResourceAs

public static void saveModelResourceAs(org.eclipse.uml2.uml.Element model,
                                       org.eclipse.emf.common.util.URI uri)
                                throws java.io.IOException

Saves the model specified by a root model element to the location specified by uri. This method cannot be used to convert from one format to another: the file will be saved in the same format in which it was opened, even if the file extension is changed through this method. For example, if the file "model.emx" is saved as "model.uml", it is still really using the "emx" format, not the "uml" format.

Parameters:

model - The root of the UML model resource to save

uri - The URI location to save the UML model resource

Throws:

java.io.IOException - The location specified by uri cannot be used to save the model

java.lang.IllegalArgumentException - model has no associated resource or model is null

Since:

7.5

closeModel

public static void closeModel(org.eclipse.uml2.uml.Model model)

Deprecated. Since 7.5, use the closeModelResource(Element) method, instead

Closes the model specified by model

Parameters:

model - The UML2 model to close

Throws:

java.lang.IllegalArgumentException - model has no associated resource

closeModelResource

public static void closeModelResource(org.eclipse.uml2.uml.Element element)

Closes the model specified by the given root element.

Parameters:

element - The root element of the UML model to close

Throws:

java.lang.IllegalArgumentException - if element has no associated resource or if it is not a root element

Since:

7.5

closeModelFragment

public static void closeModelFragment(org.eclipse.emf.ecore.EObject element)

Closes the model fragment resource specified by the given root element.

Parameters:

element - The root element of the UML model fragment to close

Throws:

java.lang.IllegalArgumentException - if element has no associated resource or if it is not the root element of a fragment resource

Since:

7.5

createProfile

public static org.eclipse.uml2.uml.Profile createProfile(java.lang.String file)

Creates a UML profile given a file path

Parameters:

file - The profile file to create

Returns:

The created UML Profile

Throws:

java.lang.IllegalArgumentException - file is an empty string

java.lang.NullPointerException - file is null

createProfile

public static org.eclipse.uml2.uml.Profile createProfile(org.eclipse.emf.common.util.URI uri)

Creates a UML profile given a URI

Parameters:

uri - The URI of the profile to create

Returns:

The created UML Profile

Throws:

java.lang.IllegalArgumentException - file is an empty string

java.lang.NullPointerException - file is null

openProfile

public static org.eclipse.uml2.uml.Profile openProfile(java.lang.String file)
                                                throws java.io.IOException

Opens the UML profile whose filename is described by file.

Supported extensions are:

• .epx
• .uml

Parameters:

file - The profile file to open

Returns:

The opened UML profile

Throws:

java.lang.IllegalArgumentException - file is an empty string

java.io.IOException - The file specified by file could not be found or the file is corrupted or could not be opened

java.lang.NullPointerException - file is null

java.lang.ClassCastException - file does not point to a Profile

openProfile

public static org.eclipse.uml2.uml.Profile openProfile(org.eclipse.emf.common.util.URI uri)
                                                throws java.io.IOException

Opens the UML profile whose URI is described by uri.

Supported extensions are:

• .epx
• .uml

Parameters:

uri - The URI of the profile to open

Returns:

The opened UML profile

Throws:

java.lang.IllegalArgumentException - file is an empty string

java.io.IOException - The file specified by file could not be found or the file is corrupted or could not be opened

java.lang.NullPointerException - file is null

java.lang.ClassCastException - file does not point to a Profile

saveProfile

public static void saveProfile(org.eclipse.uml2.uml.Profile profile)
                        throws java.io.IOException

Saves the UML profile specified by profile.

Parameters:

profile - The UML profile to save

Throws:

java.io.IOException - The location specified by the root path of profile cannot be used to save the profile

java.lang.IllegalArgumentException - profile has no associated resource

saveProfileAs

public static void saveProfileAs(org.eclipse.uml2.uml.Profile profile,
                                 java.lang.String file)
                          throws java.io.IOException

Saves the profile specified by profile to the location specified by file. This method cannot be used to convert from one format to another: the file will be saved in the same format in which it was opened, even if the file extension is changed through this method. For example, if the file "profile.emx" is saved as "profile.uml", it is still really using the "epx" format, not the "uml" format.

Parameters:

profile - The UML2 profile to save

file - The location to save the UML2 profile

Throws:

java.io.IOException - The location specified by file cannot be used to save the profile

java.lang.IllegalArgumentException - profile has no associated resource or profile is null

saveProfileAs

public static void saveProfileAs(org.eclipse.uml2.uml.Profile profile,
                                 org.eclipse.emf.common.util.URI uri)
                          throws java.io.IOException

Saves the profile specified by profile to the location specified by uri. This method cannot be used to convert from one format to another: the file will be saved in the same format in which it was opened, even if the file extension is changed through this method. For example, if the file "profile.emx" is saved as "profile.uml", it is still really using the "epx" format, not the "uml" format.

Parameters:

profile - The UML2 profile to save

uri - The location to save the UML2 profile

Throws:

java.io.IOException - The location specified by file cannot be used to save the profile

java.lang.IllegalArgumentException - profile has no associated resource or profile is null

closeProfile

public static void closeProfile(org.eclipse.uml2.uml.Profile profile)

Closes the profile specified by profile

Parameters:

profile - The UML2 profile to close

Throws:

java.lang.IllegalArgumentException - profile has no associated resource

getDeployedProfiles

public static java.util.Collection<IProfileDescriptor> getDeployedProfiles()

Retrieves all deployed profiles from the extension point. Note that some of these profiles may not be IProfileDescriptor#isVisible(). In this case they should not be presented to the user in a UI.

Returns:

A non-null collection of profile descriptors describing the deployed profiles.

getDeployedProfile

public static IProfileDescriptor getDeployedProfile(java.lang.String id)

Retrieves the deployed profile given its unique identifier from the extension point.

Parameters:

id - The unique ID of the deployed profile.

Returns:

a profile descriptor if the deployed profile could be found, null otherwise.

saveResource

public static void saveResource(org.eclipse.emf.ecore.resource.Resource resource,
                                int options)
                         throws java.io.IOException

Saves the resource specified by resource.

Parameters:

resource - The resource to save

options - Options see MResourceOption

Throws:

java.io.IOException - The location specified by the root path of resource cannot be used to save the resource

getLogicalResource

public static ILogicalResource getLogicalResource(org.eclipse.emf.ecore.EObject eObj)

Returns the logical UML resource of the specified EObject.

Parameters:

eObj - The EObject whose logical resource is returned

Returns:

Logical UML resource

getLogicalResource

public static ILogicalResource getLogicalResource(org.eclipse.emf.ecore.resource.Resource resource)

Returns the logical UML resource of the specified resource.

Parameters:

resource - The resource whose logical resource is returned. If the resource is not loaded the fragment list is not built and the returned logical resource can be used only as the wrapper. Subsequent invocations for the same resource will return in that case different instance of the logical resource.

Returns:

Logical UML resource

createFragment

public static org.eclipse.emf.ecore.resource.Resource createFragment(org.eclipse.emf.common.util.URI fragmentUri,
                                                                     org.eclipse.emf.ecore.EModelElement fragmentRoot)

Creates the fragment resource. The specified fragment root is moved from its current resource into the root of the newly created fragment. Also, the corresponding stereotype applications are moved to the new resource. All affected resources are saved. The user is prompted to refactor references.

Parameters:

fragmentUri - URI for the new fragment

fragmentRoot - The element to be moved into the fragment

Returns:

Fragment resource

createFragmentSilently

public static org.eclipse.emf.ecore.resource.Resource createFragmentSilently(org.eclipse.emf.common.util.URI fragmentUri,
                                                                             org.eclipse.emf.ecore.EModelElement fragmentRoot,
                                                                             boolean refactorReferences)

Creates the fragment resource. The specified fragment root is moved from its current resource into the root of the newly created fragment. Also, the corresponding stereotype applications are moved to the new resource. All affected resources are saved. The operation is performed silently, without user interaction.

Parameters:

fragmentUri - URI for the new fragment

fragmentRoot - The element to be moved into the fragment

refactorReferences - Indicator if the references should be refactored

Returns:

Fragment resource

batchCreateFragments

public static java.util.List<org.eclipse.emf.ecore.resource.Resource> batchCreateFragments(java.util.List<org.eclipse.emf.common.util.URI> fragmentUris,
                                                                                           java.util.List<? extends org.eclipse.emf.ecore.EModelElement> fragmentRoots,
                                                                                           boolean refactorReferences)

Creates fragment resources. The specified fragment roots are moved from their current resource into the root of newly created fragments. Also, the corresponding stereotype applications are moved to the new resource. The operation is performed silently, without user interaction. It is the responsibility of the caller to ensure that the fragmentUris and fragmentRoots lists are of the same size and contain no duplicates.

Parameters:

fragmentUris - List of fragment URIs to create

fragmentRoots - List of EModelElements to use as fragment roots

refactorReferences - Indicator if the references should be refactored

Returns:

List of created fragment Resources

Throws:

java.lang.IllegalArgumentException

absorbFragment

public static org.eclipse.emf.ecore.EObject absorbFragment(org.eclipse.emf.ecore.resource.Resource resource)

Absorbs the specified fragment. The contents of the fragment are moved to its parent resource. The resource and all its parent resources must be in the loaded state. All affected resources are saved. The user is prompted to refactor references.

Parameters:

resource - Fragment resource to be absorbed

Returns:

The former fragment root element

absorbFragmentSilently

public static org.eclipse.emf.ecore.EObject absorbFragmentSilently(org.eclipse.emf.ecore.resource.Resource resource,
                                                                   boolean refactorReferences)

Absorbs the specified fragment. The contents of the fragment are moved to its parent resource. The resource and all its parent resources must be in the loaded state. All affected resources are saved. The operation is performed silently, without user interaction.

Parameters:

resource - Fragment resource to be absorbed

refactorReferences - Indicator if the references should be refactored

Returns:

The former fragment root element

batchAbsorbFragments

public static java.util.List<org.eclipse.emf.ecore.EModelElement> batchAbsorbFragments(java.util.List<? extends org.eclipse.emf.ecore.resource.Resource> resources,
                                                                                       boolean refactorReferences)

Absorbs the specified fragments. The contents of the fragments are moved to their parent resources. The fragment resources and all their parent resources must be in the loaded state. All affected resources are saved. The operation is performed silently without user interaction.

Parameters:

resources - Fragment resources to be absorbed

refactorReferences - Indicator if the references should be refactored

Returns:

The former fragment root elements

forceMigrate

public static boolean forceMigrate(java.lang.String file)

Migrates specified logical model. All fragments are migrated as well as applied profiles. The method must be invoked within a write transaction. Multiple invocations of this method within the same transaction will most likely result in high peek memory usage. Each invocation should be wrapped in its own transaction.

Parameters:

file - File path of the root resource (model itself)

Returns:

boolean, true indicating that migration succeeded, false otherwise.

addRemoveAllListener

public static void addRemoveAllListener(java.lang.Runnable runnable)

triggerRemoveAllListeners

public static void triggerRemoveAllListeners()

removeRemoveAllListener

public static void removeRemoveAllListener(java.lang.Runnable runnable)