oracle.odi.domain.mapping

Class ReusableMapping

java.lang.Object

oracle.odi.domain.support.BusinessObject

oracle.odi.domain.support.AbstractRepositoryEntity

oracle.odi.domain.root.Root

oracle.odi.domain.root.NamedObject

oracle.odi.domain.root.PropertyOwner

oracle.odi.domain.mapping.MapComponentOwner

oracle.odi.domain.mapping.FCOMapComponentOwner

oracle.odi.domain.mapping.MapRootContainer

oracle.odi.domain.mapping.ReusableMapping

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable, oracle.odi.core.audit.support.IAuditableFirstClassObject, IModelObject, IModelObjectBase, IShortcutableModelObject, IMapping, IReusableMapping, oracle.odi.domain.impexp.IExportable, IOdiEntity, IRepositoryEntity, IWorkDevelopmentOdiEntity, IMapComponentOwner, IMapRootContainer, IMapSignatureOwner, IFCORoot, IMappingObject, INamedObject, IPropertyOwner, IRoot, oracle.odi.domain.shortcuts.IOdiShortcutable, oracle.odi.impexp.smartie.ISmartExportable

public class ReusableMapping
extends oracle.odi.domain.mapping.MapRootContainer
implements IReusableMapping, IMapSignatureOwner, oracle.odi.domain.shortcuts.IOdiShortcutable, oracle.odi.domain.impexp.IExportable, oracle.odi.impexp.smartie.ISmartExportable, IShortcutableModelObject, oracle.odi.core.audit.support.IAuditableFirstClassObject

A Reusable Mapping is a special sub mapping that can be reused in other mappings or other reusable mappings. A reusable mapping can contain any mapping component that can be contained by a Mapping, plus 2 additional components: InputSignature and OutputSignature. A reusable mapping component must be used in association with a reusable mapping, as an interface to the parent mapping.

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class oracle.odi.domain.mapping.MapRootContainer

oracle.odi.domain.mapping.MapRootContainer.MapContainerType, oracle.odi.domain.mapping.MapRootContainer.MappingChange

Nested classes/interfaces inherited from class oracle.odi.domain.root.PropertyOwner

oracle.odi.domain.root.PropertyOwner.IMapPropertyChangeListener, oracle.odi.domain.root.PropertyOwner.MapPropertyChangeEvent

Field Summary

Fields

Modifier and Type	Field and Description
static int	NAME_MAX_LENGTH Maximum length of a reusable mapping.
static java.lang.String	PROPKEY_TARGET_LOAD_ORDER Property key name value for the target load order property.

Fields inherited from class oracle.odi.domain.root.PropertyOwner

PROPERTY_CHANGE_EVENT

Fields inherited from class oracle.odi.domain.root.NamedObject

mGlobalNamespaceId

Fields inherited from interface oracle.odi.domain.mapping.IMapRootContainer

METADATA_VERSION_11, METADATA_VERSION_12

Constructor Summary

Constructors

Constructor and Description
ReusableMapping(java.lang.String pName) Constructs a new reusable mapping in the global workspace.
ReusableMapping(java.lang.String pName, IFolder pFolder) Constructs a new reusable mapping under the specified folder.
ReusableMapping(java.lang.String pName, IFolder pFolder, ReusableMapping referenceReusableMapping) Constructs a new shortcut reusable mapping under the specified folder, referencing the specified reusable mapping.

Method Summary

Modifier and Type	Method and Description
boolean	changeShortcutReferenceObject(ReusableMapping pReferenceObject)
void	checkValidReference(ReusableMapping pReferenceObject)
void	deleteReferencesTo(MapExpression expr)
java.util.List	findReferencingMappings(oracle.odi.domain.adapter.AdapterBase adapter) Return a list of all mappings that use this reusable map in a reusable mapping component, including nested usages.
IContext	getDefaultContext() Get the default context for the mapping.
java.lang.String	getDisplayableTypeName() Get a user-displayable type name for the object.
java.lang.String	getFullName()
IRoot	getOwner() Gets the mapping owner (or parent) of this object.
IProject	getProject() Gets the project owning this reusable mapping.
IModelObject	getRealModelObject() Returns the real model object of the current shortcut
ReusableMapping	getRealObject()
IReleaseTag	getReleaseTag()
ReusableMapping	getShortcutBaseObject()
java.lang.Number	getShortcutBigNumericId() Gets a numeric ID of the shortcut object, for repositories that support numeric id.
java.lang.String	getShortcutGlobalId() Gets the global ID of the shortcut object, which should be unique across the repository.
java.lang.Integer	getShortcutNumericId() Deprecated.
ReusableMapping	getShortcutOrigObject() Deprecated.
ReusableMapping	getShortcutReferenceObject()
boolean	isShortcut() Returns true if this reusable mapping is a shortcut.
boolean	isShortcutModelObject() Returns true if the model object is shortcut.
void	setName(java.lang.String name) Set the name of the object.
boolean	setShortcutBaseObject(ReusableMapping pBaseObject)
boolean	setShortcutReferenceObject(ReusableMapping pReferenceObject)
boolean	supportComponentOfType(java.lang.String type) Determine if this component owner can support (own) a component of the given type.

Methods inherited from class oracle.odi.domain.mapping.MapRootContainer

addLookupEntry, buildSequenceAndVariableLookups, clearProperties, clearSequenceVariableLookup, findReference, getAllComponents, getAllMapReferenceOwners, getAllReferences, getAllUsedMapReferences, getCachedChangeType, getComponents, getFolder, getLongAdapterInterfaceType, getReference, getReference, getReferenceKey, getReferenceKey, getReferenceKey, getShortAdapterInterfaceType, getShortAdapterInterfaceType, getSyncState, handleMapChangeEvent, initializeExpressionReferences, initializeProperties, internalGetAllReferences, internalGetReference, isModelObjectLookupAvailable, isReadOnlyMapping, isReusableMapping, isTransientMapping, lookUpSequenceOrVariable, persistReferenceOwner, rebuildPropertiesList, removeAllRefPathPoints, removeUnusedReferences, removeUnusedReferences, setAdapter, setDisableCompressReferences, setEntityManager, setExtendedEntityManager, setFolder, setIsTransientMapping, setReferenceValue, syncMapping, syncMapping, syncMapping, syncMapping, syncMapping, syncOdiMapping, toString, unpersistReference, updateReferencesInfo, useExtendedEntityManager

Methods inherited from class oracle.odi.domain.mapping.FCOMapComponentOwner

getFirstDate, getFirstUser, getInternalVersion, getLastDate, getLastUser, isInstanceLevelSecurityNeeded, isNew

Methods inherited from class oracle.odi.domain.mapping.MapComponentOwner

addComponent, afterConnect, containsComponent, createComponent, createComponent, createComponent, doExpandableComponentCallback, findAllComponents, findAllSplitPaths, findAttributeByGlobalId, findAttributeByInternalId, findAttributeByName, findComponent, findComponentBoundTo, findComponentByGlobalId, findComponentByInternalId, findComponentByName, findComponentOfType, findComponentsBoundTo, findConnector, findConnectorPointByGlobalId, findConnectorPointByInternalId, findConnectorPointByName, findExpressionByGlobalId, findExpressionByName, findExpressionByQualifiedName, findSubComponentOwner, getAllComponentsOfType, getAllGlobalExpressions, getAllSignatureOwnerHolders, getAllSubComponentOwners, getComponentCount, getComponentOwner, getLeafLevelComponents, getLeafLevelEndpoints, getLeafLevelTargets, getMapRootContainer, getSortedComponents, getSources, getTargets, getTopLevelComponentsOfType, getTopLevelSources, getTopLevelTargets, getUpstreamLeafAttributes, getUpstreamLeafAttributes, getUpstreamLeafConnectorPoints, getUpstreamLeafSources, handleChildMapChangeEvent, invalidateExpressions, isComponent, isExpandableComponent, isRootContainer, isSignatureOwner, navigateUpstreamThroughRMC, rebuildComponentList, removeComponent, removeComponent, reorderComponent, validate, validate

Methods inherited from class oracle.odi.domain.root.PropertyOwner

addProperty, addPropertyChangeListener, adjustPropertyPersistency, createProperty, createProperty, delete, getAllProperties, getAllProperties, getAllPropertyMapReferenceOwners, getBooleanPropertyValue, getChildNamespaceId, getDisplayableProperties, getExpressionPropertyValue, getIntPropertyValue, getProperties, getProperties, getProperty, getPropertyMetadataOwner, getPropertyValue, getPropertyValueReference, getStringPropertyValue, initiateDynamicProperties, internalGetAllProperties, internalGetProperties, internalIsPropertyDefined, internalSetPropertyValue, isPropertyDefined, notifyPropertyChange, notifyPropertyChangeListeners, onSave, propertyValueGetterHook, removeAllProperties, removeProperty, removePropertyChangeListener, setBooleanPropertyValue, setIntPropertyValue, setPropertyValue

Methods inherited from class oracle.odi.domain.root.NamedObject

getBusinessName, getDescription, getGlobalNamespaceId, getName, getNamespaceId, setBusinessName, setDescription

Methods inherited from class oracle.odi.domain.root.Root

addCachedIssue, addCachedIssues, clearIssueCache, displayIssues, displayIssues, displayIssues, dump, dump, dump, dump, dumpToString, equals, getCachedErrors, getCachedSyncState, getCachedValidationErrorMessage, getDisplayableObjectName, getFCOContainer, getGUID, getInternalId, getPropertyDefinitionOwner, getRootContainer, getStrongTypeClassName, getValueHolderValue, hasAdapter, hashCode, setCachedSyncState, validate

Methods inherited from class oracle.odi.domain.support.AbstractRepositoryEntity

getBigNumericId, getGlobalId, getNumericId, getParent

Methods inherited from class oracle.odi.domain.support.BusinessObject

clone

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface oracle.odi.domain.adapter.project.IReusableMapping

getFolder

Methods inherited from interface oracle.odi.domain.adapter.IModelObject

getName

Methods inherited from interface oracle.odi.domain.adapter.IModelObjectBase

getBigNumericId, getGlobalId, getNumericId

Methods inherited from interface oracle.odi.domain.mapping.IMapComponentOwner

addComponent, containsComponent, createComponent, createComponent, createComponent, findAllComponents, findComponent, findComponentBoundTo, findComponentOfType, findComponentsBoundTo, findConnector, findSubComponentOwner, getAllComponents, getAllComponentsOfType, getAllSignatureOwnerHolders, getAllSubComponentOwners, getComponentCount, getComponents, getLeafLevelComponents, getLeafLevelEndpoints, getLeafLevelTargets, getMapRootContainer, getSources, getTargets, getTopLevelComponentsOfType, getTopLevelSources, getTopLevelTargets, getUpstreamLeafAttributes, getUpstreamLeafAttributes, getUpstreamLeafConnectorPoints, getUpstreamLeafSources, isComponent, isExpandableComponent, isSignatureOwner, removeComponent, removeComponent

Methods inherited from interface oracle.odi.domain.root.IPropertyOwner

addProperty, createProperty, getAllProperties, getBooleanPropertyValue, getDisplayableProperties, getExpressionPropertyValue, getIntPropertyValue, getProperties, getProperty, getPropertyValue, getStringPropertyValue, isPropertyDefined, setBooleanPropertyValue, setIntPropertyValue, setPropertyValue

Methods inherited from interface oracle.odi.domain.root.INamedObject

getBusinessName, getDescription, getName, setBusinessName, setDescription

Methods inherited from interface oracle.odi.domain.root.IRoot

dump, dump, getDisplayableObjectName, getGUID, getStrongTypeClassName, validate, validate, validate

Methods inherited from interface oracle.odi.domain.root.IMappingObject

getRootContainer

Methods inherited from interface oracle.odi.domain.IRepositoryEntity

getGlobalId, getInternalId, getParent

Methods inherited from interface oracle.odi.domain.IOdiEntity

getFirstDate, getFirstUser, getLastDate, getLastUser, getName, isInstanceLevelSecurityNeeded

Methods inherited from interface oracle.odi.domain.mapping.IMapRootContainer

findComponent

Field Detail

NAME_MAX_LENGTH

public static final int NAME_MAX_LENGTH

Maximum length of a reusable mapping.

See Also:

Constant Field Values

PROPKEY_TARGET_LOAD_ORDER

public static final java.lang.String PROPKEY_TARGET_LOAD_ORDER

Property key name value for the target load order property. Must match the property name in Definitions.xml

See Also:

Constant Field Values

Constructor Detail

ReusableMapping

public ReusableMapping(java.lang.String pName)
                throws MappingException

Constructs a new reusable mapping in the global workspace.

Parameters:

pName - the name of the Reusable Mapping

Throws:

PropertyException

MappingException

ReusableMapping

public ReusableMapping(java.lang.String pName,
                       IFolder pFolder)
                throws MappingException

Constructs a new reusable mapping under the specified folder.

Parameters:

pName - the name of the Reusable Mapping

pFolder - the folder in which the Reusable Mapping will be created.

Throws:

PropertyException

MappingException

ReusableMapping

public ReusableMapping(java.lang.String pName,
                       IFolder pFolder,
                       ReusableMapping referenceReusableMapping)
                throws MappingException

Constructs a new shortcut reusable mapping under the specified folder, referencing the specified reusable mapping.

Parameters:

pName - the name of the Reusable Mapping

pFolder - the folder in which the Reusable Mapping will be created.

referenceReusableMapping - the reusable mapping referenced by this shortcut.

Throws:

PropertyException

MappingException

Method Detail

getFullName

public java.lang.String getFullName()

Overrides:

getFullName in class oracle.odi.domain.mapping.MapRootContainer

setName

public void setName(java.lang.String name)
             throws MappingException

Description copied from interface: INamedObject

Set the name of the object.

Specified by:

setName in interface INamedObject

Overrides:

setName in class oracle.odi.domain.root.NamedObject

Throws:

MappingException - TODO

getOwner

public IRoot getOwner()

Description copied from interface: IRoot

Gets the mapping owner (or parent) of this object. Some objects may have an external adapter owner and would return null from this method - for example the mapping object is owned by an adapter container (e.g. OdiFolder) object, which is not an instance of IRoot, so null would be returned.

Specified by:

getOwner in interface IRoot

Specified by:

getOwner in class oracle.odi.domain.root.Root

Returns:

The owner class instance.

getDisplayableTypeName

public java.lang.String getDisplayableTypeName()

Description copied from interface: IRoot

Get a user-displayable type name for the object.

Specified by:

getDisplayableTypeName in interface IPropertyOwner

Specified by:

getDisplayableTypeName in interface IRoot

Specified by:

getDisplayableTypeName in class oracle.odi.domain.root.PropertyOwner

Returns:

The displayable type name.

getDefaultContext

public IContext getDefaultContext()
                           throws AdapterException

Description copied from interface: IMapRootContainer

Get the default context for the mapping. The default context is used to set the optimization context for new physical designs (Mapping only).

Specified by:

getDefaultContext in interface IMapRootContainer

Throws:

AdapterException

getProject

public IProject getProject()

Description copied from interface: IReusableMapping

Gets the project owning this reusable mapping. Some reusable mappings may be global and will not be owned by a project.

Specified by:

getProject in interface IReusableMapping

Specified by:

getProject in interface IMapRootContainer

Returns:

owning project, or null if this is a global reusable mapping.

getShortcutBaseObject

public ReusableMapping getShortcutBaseObject()

Specified by:

getShortcutBaseObject in interface oracle.odi.domain.shortcuts.IOdiShortcutable

setShortcutBaseObject

public boolean setShortcutBaseObject(ReusableMapping pBaseObject)

Specified by:

setShortcutBaseObject in interface oracle.odi.domain.shortcuts.IOdiShortcutable

getShortcutReferenceObject

public ReusableMapping getShortcutReferenceObject()

Specified by:

getShortcutReferenceObject in interface oracle.odi.domain.shortcuts.IOdiShortcutable

setShortcutReferenceObject

public boolean setShortcutReferenceObject(ReusableMapping pReferenceObject)

Specified by:

setShortcutReferenceObject in interface oracle.odi.domain.shortcuts.IOdiShortcutable

getShortcutOrigObject

public ReusableMapping getShortcutOrigObject()

Deprecated.

Specified by:

getShortcutOrigObject in interface oracle.odi.domain.shortcuts.IOdiShortcutable

isShortcut

public boolean isShortcut()

Description copied from interface: IReusableMapping

Returns true if this reusable mapping is a shortcut.

Specified by:

isShortcut in interface IReusableMapping

Specified by:

isShortcut in interface oracle.odi.domain.shortcuts.IOdiShortcutable

Specified by:

isShortcut in class oracle.odi.domain.mapping.MapRootContainer

Returns:

true if this object is a shortcut, false otherwise

getReleaseTag

public IReleaseTag getReleaseTag()

Specified by:

getReleaseTag in interface oracle.odi.domain.shortcuts.IOdiShortcutable

getRealObject

public ReusableMapping getRealObject()

Specified by:

getRealObject in interface IMapSignatureOwner

Specified by:

getRealObject in interface oracle.odi.domain.shortcuts.IOdiShortcutable

Specified by:

getRealObject in class oracle.odi.domain.mapping.MapRootContainer

checkValidReference

public void checkValidReference(ReusableMapping pReferenceObject)

Specified by:

checkValidReference in interface oracle.odi.domain.shortcuts.IOdiShortcutable

changeShortcutReferenceObject

public boolean changeShortcutReferenceObject(ReusableMapping pReferenceObject)

Specified by:

changeShortcutReferenceObject in interface oracle.odi.domain.shortcuts.IOdiShortcutable

getRealModelObject

public IModelObject getRealModelObject()

Description copied from interface: IShortcutableModelObject

Returns the real model object of the current shortcut

Specified by:

getRealModelObject in interface IShortcutableModelObject

Returns:

IModelObject

getShortcutGlobalId

public java.lang.String getShortcutGlobalId()

Description copied from interface: IShortcutableModelObject

Gets the global ID of the shortcut object, which should be unique across the repository. The global ID, or GUID, is used as the primary way to look up references to the shortcut model object.

Specified by:

getShortcutGlobalId in interface IShortcutableModelObject

Returns:

global ID of the object.

getShortcutNumericId

@Deprecated
public java.lang.Integer getShortcutNumericId()

Deprecated.

Specified by:

getShortcutNumericId in interface IShortcutableModelObject

Returns:

numeric ID of the object, or null if not supported.

getShortcutBigNumericId

public java.lang.Number getShortcutBigNumericId()

Description copied from interface: IShortcutableModelObject

Gets a numeric ID of the shortcut object, for repositories that support numeric id. Otherwise return null.

Specified by:

getShortcutBigNumericId in interface IShortcutableModelObject

Returns:

numeric ID of the object, or null if not supported.

isShortcutModelObject

public boolean isShortcutModelObject()

Description copied from interface: IShortcutableModelObject

Returns true if the model object is shortcut.

Specified by:

isShortcutModelObject in interface IShortcutableModelObject

Returns:

true if this object is a shortcut, otherwise false.

deleteReferencesTo

public void deleteReferencesTo(MapExpression expr)

Overrides:

deleteReferencesTo in class oracle.odi.domain.mapping.MapRootContainer

findReferencingMappings

public java.util.List findReferencingMappings(oracle.odi.domain.adapter.AdapterBase adapter)
                                       throws AdapterException

Return a list of all mappings that use this reusable map in a reusable mapping component, including nested usages.

Returns:

A list of mappings that use this reusable map via binding to a reusable mapping component.

Throws:

AdapterException

supportComponentOfType

public boolean supportComponentOfType(java.lang.String type)

Determine if this component owner can support (own) a component of the given type.

Overrides:

supportComponentOfType in class oracle.odi.domain.mapping.MapComponentOwner

Parameters:

type - The component type for the component.

Returns:

True if this component can own a component of the given type, false otherwise.