View source for MDT/UML2/UML2 4.0 Migration Guide

Copyright © 2011 CEA 

=== Summary  ===

The intent of this guide is to assist consumers in the process of migrating from the UML2 3.x API, based on the UML 2.2 specification, to the new UML2 4.0 API, based on the UML 2.4.1 specification, and to summarize any new features of the implementation that developers may want to take advantage of. 

'''Kenn Hussey''' <br> Last Updated: November 28, 2012

= Overview  =

The Eclipse UML2 (Unified Modeling Language 2.x) project is an EMF-based implementation of the UML 2.x metamodel for the Eclipse platform. This implementation was previously compliant with the 2.2 version of the UML specification, for which newer versions, namely 2.3 and 2.4(.1), have been released by the Object Management Group (OMG) over the past couple of years. The source code for the UML2 project used to be stored in a CVS repository and its installable artifacts (update sites and downloads) were produced using an unsupported pre-Athena build system running on a machine that was at risk of being decommissioned in the near future. 

The UML2 metamodel implementation has been enhanced so that it is compliant with the 2.4(.1) and, implicitly, 2.3 version of the UML specification. This enhanced implementation has been delivered as a new version, 4.0, of the UML2 project, to be released as part of the Juno simultaneous release of Eclipse. The source code for this new version of the project is managed in an Eclipse git repository and built, using Buckminster, on the Hudson installation at Eclipse. 

UML 2.4(.1) was actually released by the OMG as part of a series of revisions, also known as the “2.4(.1) series”, which includes updated versions of the Meta Object Facility (MOF) and MOF 2 XMI Mapping specifications as well. Based on a careful analysis of the delta between the previous UML2 implementation and the UML 2.4(.1) and 2.3 specifications, described in more detail below, it was decided that the new version of UML2 would NOT be compatible with UML2 3.x. UML2 4.0 supersedes previous version(s) of the project (i.e., new major or minor versions of the 3.x stream will NOT be released) and is neither API contract nor binary compatible with UML2 3.x. 

This migration guide has been provided to assist consumers in the process of migrating to the new UML2 4.0 API. An XMI-based (de)serialization mechanism (described herein) has also been provided to automatically migrate resources based on the UML2 3.x schema to the new 4.0 schema. 

The changes in UML2 4.0 can be broken into functional areas, relating to various aspects of the EMF-based UML implementation provided by the UML2 project. The following sections describe each of these areas in detail.

= API  =

The UML2 project provides a Java API that is generated using a (customized version of) the code generation facility in EMF. In the past, this API has been generated from a source model produced by merging models of Infrastructure, Superstructure, and L3 compliance level of UML with custom extensions introduced by the UML2 project. As of [http://www.omg.org/spec/UML/2.4/ UML 2.4], however, a reference model of the merged L3 compliance level of UML, serialized in UML format, has been provided along with the specification by the OMG. As a result, the API is now generated from a source model produced by merging this merged L3 reference model with custom extensions introduced by the UML2 project. 

The following subsections describe the changes to the classifiers, properties, operations, and constraints in the revised UML specifications which affected the API provided by UML2. It is worth noting that a number of the utilities and unit tests provided by UML2 were also modified in response to changes in the API. 

== Classifiers  ==

Classifiers in UML are represented as Java interfaces, implementation classes, and enumerations in the UML2 API. These types are generated using the (customized) EMF code generator, along with associated factory and utility methods. 

The following table lists the classifiers that were '''removed''' by the revised specifications. Removals that had a nontrivial impact on API compatibility and/or migration of legacy resources are highlighted in <span style="background:yellow;">yellow</span>. 

{| border="1"
|-
! Classifier 
! Issue(s)
|- style="background:yellow;"
| DestructionEvent 
| [http://www.omg.org/issues/uml2-rtf.html#Issue14629 14629]
|- style="background:yellow;"
| ExecutionEvent 
| [http://www.omg.org/issues/uml2-rtf.html#Issue14629 14629]
|- style="background:yellow;"
| ReceiveOperationEvent 
| [http://www.omg.org/issues/uml2-rtf.html#Issue14629 14629]
|- style="background:yellow;"
| ReceiveSignalEvent 
| [http://www.omg.org/issues/uml2-rtf.html#Issue14629 14629]
|- style="background:yellow;"
| SendOperationEvent 
| [http://www.omg.org/issues/uml2-rtf.html#Issue14629 14629]
|- style="background:yellow;"
| SendSignalEvent 
| [http://www.omg.org/issues/uml2-rtf.html#Issue14629 14629]
|}

The following table lists the classifiers that were ''modified'' by the revised specifications. Modifications that had a nontrivial impact on API compatibility and/or migration of legacy resources are highlighted in <span style="background:yellow;">yellow</span>. 

{| border="1"
|-
! Classifier 
! Change 
! Issue(s)
|-
| ActivityGroup 
| specializes NamedElement 
| [http://www.omg.org/issues/uml2-rtf.html#Issue13943 13943]
|-
| OccurrenceSpecification 
| abstract 
| [http://www.omg.org/issues/uml2-rtf.html#Issue9820 9820]
|- style="background:yellow;"
| Pin 
| abstract 
| [http://www.omg.org/issues/uml2-rtf.html#Issue12565 12565]
|}

The following table lists the classifiers that were added by the revised specifications. Additions that had a nontrivial impact on functionality provided by the UML2 project are highlighted in <span style="background:yellow;">yellow</span>. 

{| border="1"
|-
! Classifier 
! Issue(s)
|- style="background:yellow;"
| DestructionOccurrenceSpecification 
| [http://www.omg.org/issues/uml2-rtf.html#Issue14629 14629]
|- style="background:yellow;"
| LiteralReal 
| [http://www.omg.org/issues/uml2-rtf.html#Issue12583 12583]
|- style="background:yellow;"
| Real 
| [http://www.omg.org/issues/uml2-rtf.html#Issue12583 12583]
|}

== Properties  ==

Properties in UML are represented as Java fields with accessors (“getter” and “setter” methods) in the UML2 API. These members are generated using the (customized) EMF code generator and, in some cases (e.g., if a property is derived), implemented or customized by hand. 

The following table lists the properties that were '''removed''' by the revised specifications. Removals that had a nontrivial impact on API compatibility and/or migration of legacy resources are highlighted in <span style="background:yellow;">yellow</span>. 

{| border="1"
|-
! Property 
! Issue(s)
|- style="background:yellow;"
| BehavioredClassifier::ownedTrigger 
| [http://www.omg.org/issues/uml2-rtf.html#Issue14931 14931]
|- style="background:yellow;"
| OccurrenceSpecification::event 
| [http://www.omg.org/issues/uml2-rtf.html#Issue14629 14629]
|- style="background:yellow;"
| Profile::ownedStereotype 
| [http://www.omg.org/issues/uml2-rtf.html#Issue12833 12833]
|}

The following table lists the properties that were ''modified'' by the revised specifications. Modifications that had a nontrivial impact on API compatibility and/or migration of legacy resources are highlighted in <span style="background:yellow;">yellow</span>. 

{| border="1"
|-
! Property 
! Change 
! Issue(s)
|-
| AcceptEventAction::trigger 
| subsets ownedElement 
| [http://www.omg.org/issues/uml2-rtf.html#Issue14926 14926]
|- style="background:yellow;"
| Activity::structuredNode
| not derived
| [http://www.omg.org/issues/uml2-rtf.html#Issue16232 16232]
|-
| ActivityEdge::inStructuredNode 
| subsets owner 
| [http://www.omg.org/issues/uml2-rtf.html#Issue13718 13718]
|-
| ActivityNode::inStructuredNode 
| subsets owner 
| [http://www.omg.org/issues/uml2-rtf.html#Issue13718 13718]
|- style="background:yellow;"
| Behavior::isReentrant 
| default is true 
| [http://www.omg.org/issues/uml2-rtf.html#Issue9873 9873]
|-
| Behavior::redefinedBehavior 
| subsets redefinedClassifier, subsets redefinedElement 
| [http://www.omg.org/issues/uml2-rtf.html#Issue15265 15265]
|-
| Clause::test 
| multiplicity is 1..* 
| [http://www.omg.org/issues/uml2-rtf.html#Issue8682 15265]
|-
| Component::provided 
| OCL expression 
| [http://www.omg.org/issues/uml2-rtf.html#Issue13146 13146]
|-
| Component::required 
| OCL expression 
| [http://www.omg.org/issues/uml2-rtf.html#Issue13146 13146]
|-
| ComponentRealization::abstraction 
| subsets supplier, subsets source, subsets client 
| [http://www.omg.org/issues/uml2-rtf.html#Issue11008 11008]
|-
| ComponentRealization::realizingClassifier 
| subsets client, subsets target 
| [http://www.omg.org/issues/uml2-rtf.html#Issue11008 11008]
|-
| ConditionalNode::result 
| redefines structuredNodeOutput, subsets output 
| [http://www.omg.org/issues/uml2-rtf.html#Issue11646 11646]
|- style="background:yellow;"
| ConnectableElement::end 
| read only 
| [http://www.omg.org/issues/uml2-rtf.html#Issue15568 15568]
|- style="background:yellow;"
| Connector::kind 
| derived, read only 
| [http://www.omg.org/issues/uml2-rtf.html#Issue7364 7364], [http://www.omg.org/issues/uml2-rtf.html#Issue14115 14115], [http://www.omg.org/issues/uml2-rtf.html#Issue15568 15568]
|-
| Duration::expr 
| subsets ownedElement 
| [http://www.omg.org/issues/uml2-rtf.html#Issue14926 14926]
|-
| EncapsulatedClassifier::ownedPort 
| read only 
| [http://www.omg.org/issues/uml2-rtf.html#Issue15568 15568]
|-
| EnumerationLiteral::enumeration 
| multiplicity is 1..1 
| [http://www.omg.org/issues/uml2-rtf.html#Issue14631 14631]
|-
| ExecutionOccurrenceSpecification::execution 
| multiplicity is 0..2 
| [http://www.omg.org/issues/uml2-rtf.html#Issue14629 14629]
|-
| ExtensionEnd::lower 
| derived, read only, multiplicity is 0..1 
| [http://www.omg.org/issues/uml2-rtf.html#Issue15568 15568], [http://www.omg.org/issues/uml2-rtf.html#Issue15762 15762]
|- style="background:yellow;"
| InteractionUse::argument 
| type is ValueSpecification, subsets ownedElement 
| [http://www.omg.org/issues/uml2-rtf.html#Issue10591 10591], [http://www.omg.org/issues/uml2-rtf.html#Issue14926 14926]
|-
| Interface::redefinedInterface 
| subsets redefinedClassifier 
| [http://www.omg.org/issues/uml2-rtf.html#Issue14554 14554]
|-
| LinkAction::endData 
| subsets ownedElement 
| [http://www.omg.org/issues/uml2-rtf.html#Issue14926 14926]
|-
| LinkEndData::qualifier 
| subsets ownedElement 
| [http://www.omg.org/issues/uml2-rtf.html#Issue14926 14926]
|-
| LoopNode::loopVariableInput 
| redefines structuredNodeInput, subsets input 
| [http://www.omg.org/issues/uml2-rtf.html#Issue11646 11646]
|-
| LoopNode::result 
| redefines structuredNodeOutput, subsets output 
| [http://www.omg.org/issues/uml2-rtf.html#Issue11646 11646]
|-
| LoopNode::test 
| multiplicity is 1..* 
| [http://www.omg.org/issues/uml2-rtf.html#Issue8682 8682]
|- style="background:yellow;"
| Message::signature 
| not derived, not read only 
| [http://www.omg.org/issues/uml2-rtf.html#Issue14629 14629]
|-
| OpaqueAction::body 
| nonunique, ordered 
| [http://www.omg.org/issues/uml2-rtf.html#Issue10081 10081]
|-
| OpaqueAction::language 
| ordered 
| [http://www.omg.org/issues/uml2-rtf.html#Issue10081 10081]
|-
| OpaqueBehavior::body 
| nonunique, ordered 
| [http://www.omg.org/issues/uml2-rtf.html#Issue10081 10081]
|-
| OpaqueBehavior::language 
| ordered 
| [http://www.omg.org/issues/uml2-rtf.html#Issue10081 10081]
|-
| OpaqueExpression::body 
| nonunique, ordered 
| [http://www.omg.org/issues/uml2-rtf.html#Issue10081 10081]
|-
| OpaqueExpression::language 
| ordered 
| [http://www.omg.org/issues/uml2-rtf.html#Issue10081 10081]
|-
| Operation::interface 
| subsets namespace, subsets featuringClassifier 
| [http://www.omg.org/issues/uml2-rtf.html#Issue13991 13991]
|-
| Operation::isOrdered 
| read only 
| [http://www.omg.org/issues/uml2-rtf.html#Issue15568 15568]
|-
| Operation::isUnique 
| read only 
| [http://www.omg.org/issues/uml2-rtf.html#Issue15568 15568]
|-
| Operation::lower 
| read only 
| [http://www.omg.org/issues/uml2-rtf.html#Issue15568 15568]
|-
| Operation::type 
| read only 
| [http://www.omg.org/issues/uml2-rtf.html#Issue15568 15568]
|-
| Operation::upper 
| read only 
| [http://www.omg.org/issues/uml2-rtf.html#Issue15568 15568]
|-
| Port::provided 
| OCL expression 
| [http://www.omg.org/issues/uml2-rtf.html#Issue13080 13080]
|-
| Port::required 
| OCL expression 
| [http://www.omg.org/issues/uml2-rtf.html#Issue13080 13080]
|-
| Property::owningAssociation 
| subsets redefinitionContext 
| [http://www.omg.org/issues/uml2-rtf.html#Issue15526 15526]
|-
| Property::redefinedPort 
| subsets redefinedProperty 
| [http://www.omg.org/issues/uml2-rtf.html#Issue10144 10144]
|-
| Reception::signal 
| multiplicity is 1..1 
| [http://www.omg.org/issues/uml2-rtf.html#Issue12558 12558]
|-
| RedefinableTemplateSignature::classifier 
| redefines template, subsets owner 
| [http://www.omg.org/issues/uml2-rtf.html#Issue11244 11244]
|-
| State::deferrableTrigger 
| subsets ownedElement 
| [http://www.omg.org/issues/uml2-rtf.html#Issue14926 14926]
|-
| StateMachine::extendedStateMachine 
| redefines redefinedBehavior, redefines redefinedElement 
| [http://www.omg.org/issues/uml2-rtf.html#Issue15669 15669]
|-
| Stereotype::icon 
| subsets ownedElement 
| [http://www.omg.org/issues/uml2-rtf.html#Issue14926 14926]
|-
| Stereotype::profile 
| read only 
| [http://www.omg.org/issues/uml2-rtf.html#Issue15568 15568]
|-
| StructuredActivityNode::edge 
| subsets ownedElement 
| [http://www.omg.org/issues/uml2-rtf.html#Issue13718 13718], [http://www.omg.org/issues/uml2-rtf.html#Issue14926 14926]
|-
| StructuredActivityNode::node 
| subsets ownedElement 
| [http://www.omg.org/issues/uml2-rtf.html#Issue13718 13718], [http://www.omg.org/issues/uml2-rtf.html#Issue14926 14926]
|-
| TimeEvent::when 
| subsets ownedElement 
| [http://www.omg.org/issues/uml2-rtf.html#Issue14926 14926]
|-
| TimeExpression::expr 
| subsets ownedElement 
| [http://www.omg.org/issues/uml2-rtf.html#Issue14926 14926]
|-
| Transition::trigger 
| subsets ownedElement 
| [http://www.omg.org/issues/uml2-rtf.html#Issue14926 14926]
|-
| ValuePin::value 
| subsets ownedElement 
| [http://www.omg.org/issues/uml2-rtf.html#Issue14926 14926]
|-
| ValueSpecificationAction::value 
| subsets ownedElement 
| [http://www.omg.org/issues/uml2-rtf.html#Issue14926 14926]
|-
| Vertex::incoming 
| read only 
| [http://www.omg.org/issues/uml2-rtf.html#Issue15568 15568]
|-
| Vertex::outgoing 
| read only 
| [http://www.omg.org/issues/uml2-rtf.html#Issue15568 15568]
|-
| WriteStructuralFeatureAction::value 
| multiplicity is 0..1 
| [http://www.omg.org/issues/uml2-rtf.html#Issue9870 9870]
|-
| WriteVariableAction::value 
| multiplicity is 0..1 
| [http://www.omg.org/issues/uml2-rtf.html#Issue9870 9870]
|}

The following table lists the properties that were added by the revised specifications. Additions that had a nontrivial impact on functionality provided by the UML2 project are highlighted in <span style="background:yellow;">yellow</span>. 

{| border="1"
|-
! Property 
! Issue(s)
|-
| Action::isLocallyReentrant 
| [http://www.omg.org/issues/uml2-rtf.html#Issue6111 6111]
|-
| Classifier::isFinalSpecialization 
| [http://www.omg.org/issues/uml2-rtf.html#Issue10515 10515]
|- style="background:yellow;"
| EnumerationLiteral::classifier 
| [http://www.omg.org/issues/uml2-rtf.html#Issue14631 14631]
|-
| InteractionUse::returnValue 
| [http://www.omg.org/issues/uml2-rtf.html#Issue10591 10591]
|-
| InteractionUse::returnValueRecipient 
| [http://www.omg.org/issues/uml2-rtf.html#Issue10591 10591]
|- style="background:yellow;"
| Package::ownedStereotype 
| [http://www.omg.org/issues/uml2-rtf.html#Issue12833 12833], [http://www.omg.org/issues/uml2-rtf.html#Issue15568 15568]
|- style="background:yellow;"
| Package::URI 
| [http://www.omg.org/issues/uml2-rtf.html#Issue15370 15370]
|-
| Port::isConjugated 
| [http://www.omg.org/issues/uml2-rtf.html#Issue13080 13080]
|-
| Property::interface 
| [http://www.omg.org/issues/uml2-rtf.html#Issue14235 14235]
|- style="background:yellow;"
| Property::isID 
| [http://www.omg.org/issues/uml2-rtf.html#Issue15369 15369]
|-
| StructuredActivityNode::structuredNodeInput 
| [http://www.omg.org/issues/uml2-rtf.html#Issue11646 11646]
|-
| StructuredActivityNode::structuredNodeOutput 
| [http://www.omg.org/issues/uml2-rtf.html#Issue11646 11646]
|}

== Operations  ==

Operations in UML are represented as Java methods in the UML2 API. These signatures for these methods are generated using the (customized) EMF code generator and their bodies are implemented by hand. 

The following table lists the operations that were '''removed''' by the revised specifications. Removals that had a nontrivial impact on API compatibility are highlighted in <span style="background:yellow;">yellow</span>. 

{| border="1"
|-
! Operation 
! Issue(s)
|- style="background:yellow;"
| AssociationClass::allConnections() 
| [http://www.omg.org/issues/uml2-rtf.html#Issue9374 9374]
|}

The following table lists the operations that were ''modified'' by the revised specifications. In all cases the OCL expression defining the result of the operation was changed. 

{| border="1"
|-
! Operation 
! Issue(s)
|-
| Classifier::allParents() 
| [http://www.omg.org/issues/uml2-rtf.html#Issue12848 12848]
|-
| Classifier::hasVisibilityOf(NamedElement) 
| [http://www.omg.org/issues/uml2-rtf.html#Issue10006 10006]
|-
| Property::isConsistentWith(RedefinableElement) 
| [http://www.omg.org/issues/uml2-rtf.html#Issue8460 8460]
|-
| StateMachine::ancestor(State, State) 
| [http://www.omg.org/issues/uml2-rtf.html#Issue10832 10832]
|}

The following table lists the operations that were added by the revised specifications. 

{| border="1"
|-
! Operation 
! Issue(s)
|-
| Package::allApplicableStereotypes() 
| [http://www.omg.org/issues/uml2-rtf.html#Issue12833 12833]
|-
| Package::containingProfile() 
| [http://www.omg.org/issues/uml2-rtf.html#Issue12833 12833]
|-
| Stereotype::containingProfile() 
| [http://www.omg.org/issues/uml2-rtf.html#Issue12833 12833]
|}

== Constraints  ==

Constraints in UML are represented as Java methods in the UML2 API. The signatures for these methods are generated using the (customized) EMF code generator, along with an associated validator utility class, and their bodies are implemented by hand. 

The following table lists the constraints that were '''removed''' by the revised specifications. Removals that had a nontrivial impact on API compatibility are highlighted in <span style="background:yellow;">yellow</span>. 

{| border="1"
|-
! Constraint 
! Issue(s)
|- style="background:yellow;"
| Classifier::generalization_hierarchies 
| [http://www.omg.org/issues/uml2-rtf.html#Issue15574 15574]
|- style="background:yellow;"
| Connector::assembly_connector 
| [http://www.omg.org/issues/uml2-rtf.html#Issue7251 7251]
|- style="background:yellow;"
| Connector::between_interface_port_implements 
| [http://www.omg.org/issues/uml2-rtf.html#Issue7248 7248]
|- style="background:yellow;"
| Connector::between_interface_port_signature 
| [http://www.omg.org/issues/uml2-rtf.html#Issue7249 7249]
|- style="background:yellow;"
| Connector::union_signature_compatible 
| [http://www.omg.org/issues/uml2-rtf.html#Issue7250 7250]
|- style="background:yellow;"
| Constraint::not_applied_to_self 
| [http://www.omg.org/issues/uml2-rtf.html#Issue15574 15574]
|- style="background:yellow;"
| ObjectNode::not_unique 
| [http://www.omg.org/issues/uml2-rtf.html#Issue8891 8891]
|- style="background:yellow;"
| Port::required_interfaces 
| [http://www.omg.org/issues/uml2-rtf.html#Issue12492 12492]
|- style="background:yellow;"
| Property::navigable_readonly 
| [http://www.omg.org/issues/uml2-rtf.html#Issue15128 15128]
|-
| TransitionKind::state_is_external 
| [http://www.omg.org/issues/uml2-rtf.html#Issue9172 9172]
|-
| TransitionKind::state_is_local 
| [http://www.omg.org/issues/uml2-rtf.html#Issue9172 9172]
|}

The following table lists the constraints that were ''modified'' by the revised specifications. In all cases the OCL expression defining the specification of the constraint was changed. 

{| border="1"
|-
! Constraint 
! Issue(s)
|-
| Association::specialized_end_number 
| [http://www.omg.org/issues/uml2-rtf.html#Issue9374 9374]
|-
| Association::specialized_end_types 
| [http://www.omg.org/issues/uml2-rtf.html#Issue9374 9374]
|-
| BehavioredClassifier::class_behavior 
| [http://www.omg.org/issues/uml2-rtf.html#Issue12781 12781]
|-
| CollaborationUse::every_role 
| [http://www.omg.org/issues/uml2-rtf.html#Issue8743 8743]
|-
| CombinedFragment::opt_loop_break_neg 
| [http://www.omg.org/issues/uml2-rtf.html#Issue11286 11286]
|-
| Connector::between_interfaces_ports 
| [http://www.omg.org/issues/uml2-rtf.html#Issue7247 7247]
|-
| ConnectorEnd::role_and_part_with_port 
| [http://www.omg.org/issues/uml2-rtf.html#Issue8776 8776]
|-
| ExceptionHandler::result_pins 
| [http://www.omg.org/issues/uml2-rtf.html#Issue8479 8479]
|-
| InteractionUse::all_lifelines 
| [http://www.omg.org/issues/uml2-rtf.html#Issue10590 10590]
|-
| Message::sending_receiving_message_event 
| [http://www.omg.org/issues/uml2-rtf.html#Issue14629 14629]
|-
| Profile::metaclass_reference_not_specialized 
| [http://www.omg.org/issues/uml2-rtf.html#Issue8601 8601]
|-
| Profile::references_same_metamodel 
| [http://www.omg.org/issues/uml2-rtf.html#Issue8601 8601]
|-
| RemoveStructuralFeatureValueAction::non_unique_removal 
| [http://www.omg.org/issues/uml2-rtf.html#Issue9870 9870]
|-
| RemoveVariableValue::unlimited_natural 
| [http://www.omg.org/issues/uml2-rtf.html#Issue9870 9870]
|-
| StructuralFeatureAction::multiplicity 
| [http://www.omg.org/issues/uml2-rtf.html#Issue10045 10045]
|-
| StructuralFeatureAction::same_type 
| [http://www.omg.org/issues/uml2-rtf.html#Issue10045 10045]
|-
| TestIdentityAction::result_is_boolean 
| [http://www.omg.org/issues/uml2-rtf.html#Issue14570 14570]
|-
| WriteStructuralFeatureAction::input_pin 
| [http://www.omg.org/issues/uml2-rtf.html#Issue9870 9870], [http://www.omg.org/issues/uml2-rtf.html#Issue14569 14569]
|-
| WriteVariableAction::same_type 
| [http://www.omg.org/issues/uml2-rtf.html#Issue9870 9870]
|}

The following table lists the constraints that were added by the revised specifications. 

{| border="1"
|-
! Constraint 
! Issue(s)
|-
| AddStructuralFeatureValueAction::required_value 
| [http://www.omg.org/issues/uml2-rtf.html#Issue9870 9870]
|-
| AddVariableValueAction::required_value 
| [http://www.omg.org/issues/uml2-rtf.html#Issue9870 9870]
|-
| AssociationClass::disjoint_attributes_ends 
| [http://www.omg.org/issues/uml2-rtf.html#Issue9374 9374]
|-
| Classifier::non_final_parents 
| [http://www.omg.org/issues/uml2-rtf.html#Issue10515 10515]
|-
| Clause::test_and_body 
| [http://www.omg.org/issues/uml2-rtf.html#Issue8495 8495]
|-
| Component::no_nested_classifiers 
| [http://www.omg.org/issues/uml2-rtf.html#Issue12432 12432]
|-
| ConditionalNode::clause_no_predecessor 
| [http://www.omg.org/issues/uml2-rtf.html#Issue8684 8684]
|-
| ConditionalNode::executable_nodes 
| [http://www.omg.org/issues/uml2-rtf.html#Issue8495 8495]
|-
| ConditionalNode::matching_output_pins 
| [http://www.omg.org/issues/uml2-rtf.html#Issue8498 8498]
|-
| ConditionalNode::no_input_pins 
| [http://www.omg.org/issues/uml2-rtf.html#Issue11646 11646]
|-
| ConditionalNode::one_clause_with_executable_node 
| [http://www.omg.org/issues/uml2-rtf.html#Issue8495 8495]
|-
| EnumerationLiteral::classifier_equals_owning_enumeration 
| [http://www.omg.org/issues/uml2-rtf.html#Issue14631 14631]
|-
| ExpansionNode::region_as_input_or_putput 
| [http://www.omg.org/issues/uml2-rtf.html#Issue10145 10145]
|-
| GeneralOrdering::irreflexsive_transitive_closure 
| [http://www.omg.org/issues/uml2-rtf.html#Issue9806 9806]
|-
| InteractionUse::returnValueRecipient_coverage 
| [http://www.omg.org/issues/uml2-rtf.html#Issue10591 10591]
|-
| InteractionUse::returnValue_type_recipient_correspondence 
| [http://www.omg.org/issues/uml2-rtf.html#Issue10591 10591]
|-
| LoopNode::executable_nodes 
| [http://www.omg.org/issues/uml2-rtf.html#Issue8492 8492]
|-
| RedefinableElement::non_leaf_redefinition 
| [http://www.omg.org/issues/uml2-rtf.html#Issue12532 12532]
|-
| Stereotype::associationEndOwnership 
| [http://www.omg.org/issues/uml2-rtf.html#Issue14961 14961]
|-
| Stereotype::binaryAssociationsOnly 
| [http://www.omg.org/issues/uml2-rtf.html#Issue14961 14961]
|-
| StructuredActivityNode::input_pin_edges 
| [http://www.omg.org/issues/uml2-rtf.html#Issue9014 9014]
|-
| StructuredActivityNode::output_pin_edges 
| [http://www.omg.org/issues/uml2-rtf.html#Issue9014 9014]
|-
| Transition::state_is_external 
| [http://www.omg.org/issues/uml2-rtf.html#Issue9172 9172]
|-
| Transition::state_is_internal 
| [http://www.omg.org/issues/uml2-rtf.html#Issue9172 9172], [http://www.omg.org/issues/uml2-rtf.html#Issue10498 10498]
|-
| Transition::state_is_local 
| [http://www.omg.org/issues/uml2-rtf.html#Issue9172 9172]
|}

= Package Merge  =

The UML2 project provides an implementation of the package merge algorithm described in the UML specification. This utility is intended for use by clients but is also used to produce the source model for generating the API itself. Changes in the revised specifications (to resolve issues [http://www.omg.org/issues/uml2-rtf.html#Issue10515 10515], [http://www.omg.org/issues/uml2-rtf.html#Issue12532 12532], and [http://www.omg.org/issues/uml2-rtf.html#Issue13330 13330]) required updates to this utility. 

The following changes with respect to package merge are of particular note: 

*Associations are now matched by name (only) when performing a merge. 
*A new option, '''Empty Qualified Names''', reports cases where the qualified name of a classifier is found to be empty. 
*Another new option, '''Indistinguishable Classifiers''', reports cases where a classifier is indistinguishable from the other classifiers in a given package.

[[Image:U240MG PackageMerge.png]]

= Profiles  =

The UML2 project provides an implementation of the profiles mechanism described in the UML specification. This implementation supports definition of “static” or “dynamic” profiles containing stereotypes to extend the UML metamodel with domain-specific tagged values. Changes in the revised specifications (to resolve issues [http://www.omg.org/issues/uml2-rtf.html#Issue11160 11160], [http://www.omg.org/issues/uml2-rtf.html#Issue12833 12833], [http://www.omg.org/issues/uml2-rtf.html#Issue13306 13306], [http://www.omg.org/issues/uml2-rtf.html#Issue14092 14092], [http://www.omg.org/issues/uml2-rtf.html#Issue15006 15006], and [http://www.omg.org/issues/uml2-rtf.html#Issue15370 15370]) required updates to this mechanism. 

The following changes with respect to profiles are of particular note: 

*Stereotype keywords no longer begin with a lowercase letter, per the new notational convention.
*The '''Standard''' profile ('''Standard.profile.uml''') that was provided by previous releases of UML2 has been split into two ('''StandardL2.profile.uml''' and '''StandardL3.profile.uml'''), corresponding to the '''L2''' and '''L3''' profiles defined in the UML specification. 
*''Static'' (rather than dynamic) implementations of the L2 and L3 profiles have been provided by UML2, hence the introduction of new '''org.eclipse.uml2.uml.profile.l2''' and '''org.eclipse.uml2.uml.profile.l3''' bundles, respectively. 
*The profiles mechanism in UML2 now supports packages nested within profiles and stereotypes owned by packages; the Ecore definition for such profiles will have the corresponding structure (i.e., nested Ecore packages). 
*The new '''Package::URI''' property is now used to define the namespace URI of a profile (and nested packages), unless it is overridden by the '''nsURI''' tag from the Ecore profile. 
*A new convenience utility method, '''UMLUtil#getStereotypeApplication(Element, Class&lt;T&gt;)''', has been added to provide an easy way to obtain a stereotype application from an element based on its (statically defined) Java class.

= Resources  =

The UML2 project provides a number of built-in primitive types libraries (Ecore, Java, and UML), metamodels (Ecore and UML), and (dynamic) profiles (Ecore and Standard), serialized in UML format. Changes in the revised specifications (to resolve issues [http://www.omg.org/issues/uml2-rtf.html#Issue12583 12583], [http://www.omg.org/issues/uml2-rtf.html#Issue13306 13306], [http://www.omg.org/issues/uml2-rtf.html#Issue13993 13993], and [http://www.omg.org/issues/uml2-rtf.html#Issue14092 14092]) required updates to these resources. 

The following changes with respect to resources are of particular note: 

*XMI resources provided by the OMG, namely '''Infrastructure.xmi''', '''Superstructure.xmi''', '''UML.xmi''', '''PrimitiveTypes.xmi''', '''StandardProfileL2.xmi''', '''StandardProfileL3.xmi''', and '''MOF.xmi''', are now shipped with UML2 in the '''org.eclipse.uml2''' bundle. 
*The primitive types that were once an integral part of UML proper have been segregated into a separate namespace for reuse by multiple specifications (e.g., CMOF and UML); "first class" implementations of these primitive types have been provided by UML2 in the new '''org.eclipse.uml2.types''' bundle. 
*The name of root model in the UML primitive types library has been changed from "UMLPrimitiveTypes" to "PrimitiveTypes" to reinforce its more independent nature. 
*A new '''Real''' type has been added to the UML primitive types library. 
*Since the UML metamodel resource is now based on the corresponding XMI resource provided by the OMG (as are all of the other OMG-defined resources provided by UML2 project), the name of its root model element has changed from "uml" (all lowercase) to "UML" (all uppercase); this could impact clients that happen to be referencing this element by name.

= Legacy Interchange  =

The UML2 project supports interchange of legacy resources, i.e., artifacts that were created using older versions of the project. This XMI-based migration mechanism was enhanced to deal with the incompatibilities introduced by the new version of the UML2 API and schema. A mapping between the legacy UML2 3.x metamodel and the new UML2 4.0 metamodel was created (using the Ecore2Ecore and Ecore2XML mechanisms provided by EMF) and existing mappings for older versions of the UML2 schema were updated. New resource handler and extended metadata implementations were also developed to cover transformations which could not be automated during deserialization. 

The following changes with respect to legacy interchange are of particular note: 

*Instances of '''OpaqueAction''' that are arguments of interaction uses are preserved in '''InteractionUse::argument''' tags from the '''UML2''' profile. 
*The ''clients'' and ''suppliers'' of ''component realization'' dependencies are swapped. 
*Instances of '''Pin''' are converted to instances of '''InputPin'''. 
*Applications of the '''Standard''' profile are replaced by applications of the '''L2''' and '''L3''' profiles. 
*Instances of '''DestructionEvent''' are converted to instances of '''DestructionOccurrenceSpecification'''. 
*Instances of '''ExecutionEvent''' are discarded. 
*''Operations'' of call events, receive operation events, and send operation events are set as the signatures of their associated messages; instances of '''ReceiveOperationEvent''' and '''SendOperationEvent''' are discarded. 
*''Signals'' of receive signal events, send signal events, and signal events are set as the signatures of their associated messages; instances of '''ReceiveSignalEvent''' and '''SendSignalEvent''' are discarded. 
*Instances of '''Trigger''' that are owned triggers of behaviored classifiers are preserved in '''BehavioredClassifier::ownedTrigger''' tags from the '''UML2''' profile.

= XMI Interchange  =

The UML2 project supports interchange of OMG-compliant XMI resources, i.e., artifacts that were created using other tools that conform to the UML specification. This XMI-based mechanism was enhanced to deal with XMI documents that conform to the 2.4(.1) version of the UML specification. New resource handler and extended metadata implementations were also developed, and existing ones (supporting older versions of OMG-compliant XMI) were updated. 

Changes in the revised MOF 2 Mapping specification (to resolve issues [http://www.omg.org/issues/uml2-rtf.html#Issue9644 9644] and [http://www.omg.org/issues/uml2-rtf.html#Issue9682 9682]) required additional updates to the XMI interchange mechanism provided by UML2. 

The following changes with respect to XMI interchange are of particular note: 

*XMI resources serialized by UML2 are now based on XMI 2.4.1, whose version is '''20110701''' and whose namespace URI is '''http://www.omg.org/spec/XMI/20110701'''. 
*The '''org.omg.xmi.nsURI''' and '''org.omg.xmi.nsPrefix''' CMOF tags now are serialized for profiles when saving them in OMG XMI format. 
*Namespace URIs of UML2 resources are mapped to their corresponding OMG XMI resources according to the following table:

{| border="1"
|-
! UML2 
! OMG XMI
|-
| http://www.eclipse.org/uml2/4.0.0/Types 
| http://www.omg.org/spec/PrimitiveTypes/20110701
|-
| http://www.eclipse.org/uml2/4.0.0/UML 
| http://www.omg.org/spec/UML/20110701
|-
| http://www.eclipse.org/uml2/4.0.0/UML/Profile/L2 
| http://www.omg.org/spec/UML/20110701/StandardProfileL2
|-
| http://www.eclipse.org/uml2/4.0.0/UML/Profile/L3 
| http://www.omg.org/spec/UML/20110701/StandardProfileL3
|}

Changes in the revised [http://www.omg.org/spec/UML/2.4.1/ UML 2.4.1] specification (to resolve issue [http://www.omg.org/issues/uml2-rtf.html#Issue16232 16232]) also required the following changes:

*Non-compliant '''Activity::ownedNode''' and '''Activity::ownedGroup''' properties were introduced to compose nodes and groups which are not structured activity nodes.
*Serialization (and deserialization) of the '''Activity::group''' and '''Activity::node''' properties were customized so that they include '''idref''' attributes which reference any XMI elements (serialized for the '''Activity::structuredNode''' property) representing structured activity nodes composed by the activity.

= CMOF Interchange  =

The UML2 project supports interchange, and automatic conversion to and from UML, of Complete MOF (CMOF) resources. This XMI-based interchange mechanism was enhanced to deal with changes made in both UML 2.4(.1) and MOF 2.4(.1). A mapping between the CMOF 2.4(.1) metamodel and the new UML2 4.0 metamodel was created (using the Ecore2Ecore mechanism provided by EMF) and existing mappings for older versions of the schemas were updated. New resource handler and extended metadata implementations were also developed to cover transformations which could not be automated during deserialization. 

Changes in the revised MOF specification (to resolve issues [http://www.omg.org/issues/uml2-rtf.html#Issue6905 6905], [http://www.omg.org/issues/uml2-rtf.html#Issue10968 10968], [http://www.omg.org/issues/uml2-rtf.html#Issue12800 12800], [http://www.omg.org/issues/uml2-rtf.html#Issue15397 15397], [http://www.omg.org/issues/uml2-rtf.html#Issue15398 15398], [http://www.omg.org/issues/uml2-rtf.html#Issue15820 15820], and [http://www.omg.org/issues/uml2-rtf.html#Issue15827 15827]) required additional updates to the CMOF interchange mechanism provided by UML2. 

The following changes with respect to CMOF interchange are of particular note: 

*CMOF resources serialized by UML2 are now based on CMOF 2.4.1, whose namespace URI is '''http://www.omg.org/spec/MOF/20110701'''. 
*The '''org.omg.xmi.idProperty''' tag is no longer serialized for properties when saving them in CMOF format (since they are now redundant given existence of the new '''Property::isID''' property).

= Ecore / UML Conversion  =

The UML2 project provides utilities for conversion of UML models to and from a corresponding Ecore representation. These utilities are intended for use by clients but an integral part of the process followed to produce source models, generate code for the UML2 project, and define profiles. Changes to the API, as described above, required updates to these utilities; in particular, they needed to take the new '''Package::URI''' and '''Property::isID''' properties into account when performing conversions. 

The following changes with respect to Ecore / UML conversion are of particular note: 

*The '''isID''' attribute of an Ecore attribute is now set based on the new '''Property::isID''' property from UML, unless overridden by an '''EAttribute::isID''' tagged value from the '''Ecore''' profile. 
*The '''nsURI''' attribute of an Ecore package is now set based on the new '''Package::URI''' property from UML, unless overridden by an '''EPackage::nsURI''' tagged value from the '''Ecore''' profile. 
*''Derived'' features are now set to be ''transient'' by default (unless overridden by an '''EStructuralFeature::isTransient''' tagged value from the '''Ecore''' profile). 
*References to UML primitive types (i.e., '''Boolean''', '''Integer''', '''Real''', '''String''', and '''UnlimitedNatural''') are now mapped to the new primitive type implementations (provided by the '''org.eclipse.uml2.types''' bundle) instead of types provide by Ecore.

= Examples  =

The UML2 project provides a number of examples, including editor actions which are in fact used by the UML2 project to produce some of the artifacts it publishes. These examples will were updated based on the changes that were made to the API and reference resources described above. More specifically, the actions to generate the standard profile and UML primitive types library were updated based on the XMI resources provided by the OMG and the actions to convert models to model libraries or metamodels were updated to make use of the new (static) standard profile implementations mentioned above. 

The following changes with respect to examples are of particular note: 

*The '''Generate &gt; Stereotypes &gt; Standard''' action has been replaced by two new actions, '''Generate &gt; Stereotypes &gt; Standard L2''' and '''Generate &gt; Stereotypes &gt; Standard L3'''. 
*The '''Convert To &gt; Model Library''' action is now applicable to packages in general (instead of models specifically).

= Source Code  =

As mentioned already, the UML2 project has(as other projects have) switched to git instead of CVS as its source code management system for the upcoming Juno release. In fact, all of the changes for UML2 4.0 have been committed (and pushed) to git (only). 

The following changes with respect to source code are of particular note: 

*The source code for UML2 is now located in git, at '''git://git.eclipse.org/gitroot/uml2/org.eclipse.uml2.git'''.

= Builds  =

As mentioned above, the installable artifacts (update sites and downloads) for the UML2 project were previously produced using an unsupported pre-Athena build system running on a machine that was at risk of being decommissioned. Buckminster was used instead to develop a new build system which now runs on Hudson and extracts the UML2 source code from git. The resulting artifacts are published to a new set of UML2-specific p2 repositories (instead of the antiquated MDT one) and included in the top-level composite repositories for the Modeling project. 

The following changes with respect to builds are of particular note: 

*UML2 is now built with Buckminster using Hudson, at '''https://hudson.eclipse.org/hudson/view/Modeling/job/mdt-uml2-master/'''. 
*Updates for UML2 4.0 are hosted in software repositories at '''http://download.eclipse.org/modeling/mdt/uml2/updates/4.0-I-builds''', '''http://download.eclipse.org/modeling/mdt/uml2/updates/4.0milestones''', and (upon the release of Juno) '''http://download.eclipse.org/modeling/mdt/uml2/updates/4.0'''.