com.ibm.xtools.comparemerge.emf.delta.logic

Class LogicalMatcher

java.lang.Object

com.ibm.xtools.comparemerge.emf.delta.logic.LogicalMatcher

All Implemented Interfaces:

com.ibm.xtools.comparemerge.emf.delta.deltagenerator.matcher.Matcher, com.ibm.xtools.comparemerge.emf.delta.deltagenerator.matcher.MorphingMatcher

public class LogicalMatcher
extends java.lang.Object
implements com.ibm.xtools.comparemerge.emf.delta.deltagenerator.matcher.Matcher, com.ibm.xtools.comparemerge.emf.delta.deltagenerator.matcher.MorphingMatcher

Field Summary

Fields inherited from interface com.ibm.xtools.comparemerge.emf.delta.deltagenerator.matcher.Matcher

DEPEN_SEPERAT0R, FEATURE_PREFIX, FEATURE_SUFFIX, NAME_PREFIX, OBJECT_SEPARATOR, OBJECT_SEPARATOR_LENGTH

Fields inherited from interface com.ibm.xtools.comparemerge.emf.delta.deltagenerator.matcher.MorphingMatcher

STATUS_FAILED, STATUS_FAILED_NO_MAPPING, STATUS_FAILED_NO_SUCH_OBJECT, STATUS_SUCCESS

Constructor Summary

Constructors

Constructor and Description
LogicalMatcher(com.ibm.xtools.comparemerge.emf.delta.deltagenerator.matcher.Matcher matcher, java.util.List resources)

Method Summary

Modifier and Type	Method and Description
boolean	canMatch(org.eclipse.emf.ecore.resource.Resource resource, org.eclipse.emf.ecore.EObject eObject)
void	dispose() dispose this matcher
org.eclipse.emf.ecore.EObject	find(org.eclipse.emf.ecore.resource.Resource resource, java.lang.String matchingId) Returns the EObject uniquely identified by the passed matching ID if one is found, otherwise null.
protected org.eclipse.emf.ecore.resource.Resource	findLogicalResource(org.eclipse.emf.ecore.resource.Resource resource)
java.lang.String	getMatchingId(org.eclipse.emf.ecore.resource.Resource resource, org.eclipse.emf.ecore.EObject object) Returns a unique identifer (matching ID) to the given object.
java.lang.String	getResolvedMatchingId(org.eclipse.emf.ecore.resource.Resource resource, org.eclipse.emf.ecore.EObject eObject) The method returns the resolved matching id for the given object.
org.eclipse.emf.common.util.URI	getURI(org.eclipse.emf.ecore.EObject object) Get the given URI of the given object.
com.ibm.xtools.comparemerge.emf.delta.deltagenerator.matcher.Matcher	getWrappedMatcher()
void	initialize() Resets the matcher to its initial state.
int	morph(org.eclipse.emf.ecore.resource.Resource resource, org.eclipse.emf.ecore.EObject eObject, java.lang.String matchingId) update matcher's cache by replacing old object with new (morphed) object
void	setMatch(org.eclipse.emf.ecore.resource.Resource targetResource, org.eclipse.emf.ecore.EObject target, org.eclipse.emf.ecore.resource.Resource sourceResource, org.eclipse.emf.ecore.EObject source) Sets a match between a target eObject and a source eObject.
void	unMatch(org.eclipse.emf.ecore.resource.Resource resource, org.eclipse.emf.ecore.EObject object) Makes sure the given object will not match any other object.

Methods inherited from class java.lang.Object

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

Constructor Detail

LogicalMatcher

public LogicalMatcher(com.ibm.xtools.comparemerge.emf.delta.deltagenerator.matcher.Matcher matcher,
                      java.util.List resources)

Method Detail

initialize

public void initialize()

Description copied from interface: com.ibm.xtools.comparemerge.emf.delta.deltagenerator.matcher.Matcher

Resets the matcher to its initial state. This will clear all "matching ID to object maps" effectively resetting all previously set Manual Matches

Specified by:

initialize in interface com.ibm.xtools.comparemerge.emf.delta.deltagenerator.matcher.Matcher

getWrappedMatcher

public com.ibm.xtools.comparemerge.emf.delta.deltagenerator.matcher.Matcher getWrappedMatcher()

find

public org.eclipse.emf.ecore.EObject find(org.eclipse.emf.ecore.resource.Resource resource,
                                          java.lang.String matchingId)

Description copied from interface: com.ibm.xtools.comparemerge.emf.delta.deltagenerator.matcher.Matcher

Returns the EObject uniquely identified by the passed matching ID if one is found, otherwise null.

Specified by:

find in interface com.ibm.xtools.comparemerge.emf.delta.deltagenerator.matcher.Matcher

Parameters:

resource - the searched resource

matchingId - the unique identifier for an object

Returns:

an EObject or null

getMatchingId

public java.lang.String getMatchingId(org.eclipse.emf.ecore.resource.Resource resource,
                                      org.eclipse.emf.ecore.EObject object)

Description copied from interface: com.ibm.xtools.comparemerge.emf.delta.deltagenerator.matcher.Matcher

Returns a unique identifer (matching ID) to the given object.

Specified by:

getMatchingId in interface com.ibm.xtools.comparemerge.emf.delta.deltagenerator.matcher.Matcher

Parameters:

resource - the searched resource

object - the searched object

Returns:

a matching ID or null

findLogicalResource

protected org.eclipse.emf.ecore.resource.Resource findLogicalResource(org.eclipse.emf.ecore.resource.Resource resource)

getResolvedMatchingId

public java.lang.String getResolvedMatchingId(org.eclipse.emf.ecore.resource.Resource resource,
                                              org.eclipse.emf.ecore.EObject eObject)

Description copied from interface: com.ibm.xtools.comparemerge.emf.delta.deltagenerator.matcher.Matcher

The method returns the resolved matching id for the given object. If the given object is a proxy, its resolved object matching id will be returned. If the given object is not a proxy, it is already resolved, so its matching id will be returned.

Specified by:

getResolvedMatchingId in interface com.ibm.xtools.comparemerge.emf.delta.deltagenerator.matcher.Matcher

setMatch

public void setMatch(org.eclipse.emf.ecore.resource.Resource targetResource,
                     org.eclipse.emf.ecore.EObject target,
                     org.eclipse.emf.ecore.resource.Resource sourceResource,
                     org.eclipse.emf.ecore.EObject source)

Description copied from interface: com.ibm.xtools.comparemerge.emf.delta.deltagenerator.matcher.Matcher

Sets a match between a target eObject and a source eObject.

Specified by:

setMatch in interface com.ibm.xtools.comparemerge.emf.delta.deltagenerator.matcher.Matcher

Parameters:

targetResource - resource of target object

target - target object to match

sourceResource - resource of source object

source - source object to match

canMatch

public boolean canMatch(org.eclipse.emf.ecore.resource.Resource resource,
                        org.eclipse.emf.ecore.EObject eObject)

Specified by:

canMatch in interface com.ibm.xtools.comparemerge.emf.delta.deltagenerator.matcher.Matcher

Returns:

true if a given objects can be manually matched. To be overridden to disable manual matching for objects of specific type, such as diagram elements etc.

unMatch

public void unMatch(org.eclipse.emf.ecore.resource.Resource resource,
                    org.eclipse.emf.ecore.EObject object)

Description copied from interface: com.ibm.xtools.comparemerge.emf.delta.deltagenerator.matcher.Matcher

Makes sure the given object will not match any other object. This will assign a new unique ID to the object and to its children

Specified by:

unMatch in interface com.ibm.xtools.comparemerge.emf.delta.deltagenerator.matcher.Matcher

Parameters:

resource - of the object

object - to un-match

getURI

public org.eclipse.emf.common.util.URI getURI(org.eclipse.emf.ecore.EObject object)

Description copied from interface: com.ibm.xtools.comparemerge.emf.delta.deltagenerator.matcher.Matcher

Get the given URI of the given object. Please refer to EcoreUtil.getURI(eObject)

Specified by:

getURI in interface com.ibm.xtools.comparemerge.emf.delta.deltagenerator.matcher.Matcher

dispose

public void dispose()

Description copied from interface: com.ibm.xtools.comparemerge.emf.delta.deltagenerator.matcher.Matcher

dispose this matcher

Specified by:

dispose in interface com.ibm.xtools.comparemerge.emf.delta.deltagenerator.matcher.Matcher

morph

public int morph(org.eclipse.emf.ecore.resource.Resource resource,
                 org.eclipse.emf.ecore.EObject eObject,
                 java.lang.String matchingId)

Description copied from interface: com.ibm.xtools.comparemerge.emf.delta.deltagenerator.matcher.MorphingMatcher

update matcher's cache by replacing old object with new (morphed) object

Specified by:

morph in interface com.ibm.xtools.comparemerge.emf.delta.deltagenerator.matcher.MorphingMatcher

Parameters:

resource - - resource which contains morphed object

eObject - - morphed object

matchingId - - morphed (and old) object mathicn id

Returns:

- status code