public class Dataset extends DefaultDelegate
Contents within a Dataset are created by user based on an entity-relationship model, rather than the flow-based model. During validation, this E-R model is converted to a flow-based mapping, which is in turn merged with surrounding flow-based components.
Modifier and Type | Class and Description |
---|---|
static class |
Dataset.EntityRelationship
This class represents an entity relationship in a Dataset.
|
DefaultDelegate.DefaultAttributeDelegate, DefaultDelegate.DefaultConnectorPointDelegate
oracle.odi.domain.mapping.MapComponentDelegate.AttributeDelegate, oracle.odi.domain.mapping.MapComponentDelegate.MapConnectorPointDelegate
IMapComponent.ComponentCategory
Modifier and Type | Field and Description |
---|---|
static java.lang.String |
COMPONENT_TYPE_NAME
The component type name.
|
static java.lang.String |
DATASET_DEFAULT_JOIN_NAME
The name of the default Join component.
|
VARIABLE_COMPONENT_TYPE_NAME
Modifier and Type | Method and Description |
---|---|
JoinComponent |
addJoin(java.lang.String joinCondition)
Adds a join to the dataset, with the specified join condition text.
|
LookupComponent |
addLookup(DatastoreComponent driverComp,
IDataStore lookupDatastore,
java.lang.String lookupCondition)
Adds a lookup component with the given driver component, lookup datastore, and the lookup condition.
|
DataStorageDelegate |
addSource(IDataStore datastoreObject,
java.lang.String joinCondition)
Creates a new source data storage delegate bound to the specified model datastore object, and
add it to the dataset.
|
IMapComponent |
addSource(IModelObject boundObject,
boolean autoJoinEnabled)
Creates a datastore delegate in this dataset and binds it to the given model object.
|
IMapComponent |
createComponent(java.lang.String type,
IModelObject boundObject)
Create a component with the specified type and name, and bound to the specified object.
|
IMapComponent |
createComponent(java.lang.String type,
IModelObject boundObject,
boolean enableAutoJoin)
Create a component with the specified type and name, and bound to the specified object.
|
java.util.List |
findDerivedJoins(JoinComponent join)
Gets derived joins of a join in this Dataset.
|
JoinComponent |
findJoinForSources(java.util.List sources)
Gets the first join in the join connect order that references all of the specified sources.
|
LookupComponent |
findLookupForSources(java.util.List sources)
Gets a lookup component in the dataset that uses the first source as a driver
and the second source as a lookup table.
|
static Dataset |
getContainingDataset(IMapComponent comp)
Gets the owning Dataset of the given component.
|
static java.util.List |
getDatasets(MapComponentOwner componentOwner)
Gets all Datasets owned by the given owner.
|
java.util.List |
getEntityRelationships()
Gets a list of EntityRelationship objects representing entity relationships in this Dataset.
|
java.util.List |
getSupportedSourceComponents()
Gets a list of components in this dataset that can be used as sources.
|
java.lang.String |
getTypeName()
Return the component type name for this component.
|
void |
invalidateExpressions()
Invalidates the expressions for this component.
|
static boolean |
isInDataset(IMapComponent comp)
Checks if the given component is within this Dataset.
|
boolean |
isValidForTechnology(ITechnology techno,
java.util.List issues)
Check whether component is valid for a technology.
|
IMapComponent |
removeSourceFromDataset(MapComponent source,
boolean recreate)
Removes the specified source component from this Dataset.
|
customSyncComponent, fixExpressions, getBlockExpressionReferencedAttributes, getExecuteOnHint, getExecuteOnHintString, getIntegrationType, getNextAvailableInput, getNextAvailableInput, getNextAvailableOutput, isAddInputConnectorPointAllowed, isAddOutputConnectorPointAllowed, isPassive, setExecuteOnHint, setExecuteOnHintByString
afterPropertyChange, allowInputAttribute, connectFrom, createInputConnectorPoint, createInputConnectorPoint, createOutputConnectorPoint, createOutputConnectorPoint, equals, getBoundObjectFullName, getBoundObjectName, getBoundShortcutFullName, getComponentContext, getComponentCustomLocation, getComponentType, getInScopeAttributeXMap, getSQLAccessName, getTechnicalDescription, handleChildMapChangeEvent, handleMapChangeEvent, hashCode, initPhysicalNode, isBoundObjectDeleted, notifyPropertyChange, setComponentType, toString, validateReorderComponent
addComponent, addProperty, bindTo, bindTo, connectTo, connectTo, connectTo, connectTo, containsComponent, createComponent, createExpressionAttribute, createExpressionAttribute, createOutputConnectorPoint, createProperty, dump, dump, findAllComponents, findAllSplitPaths, findComponent, findComponentBoundTo, findComponentOfType, findConnector, findConnectorPoint, findInputAttribute, findOutputAttribute, findSubComponentOwner, generateUniqueComponentName, generateUniqueComponentName, generateUniqueConnectorName, generateUniqueName, generateUniqueName, getAdapter, getAlias, getAllComponents, getAllComponentsOfType, getAllExpressions, getAllPathsFrom, getAllPathsFrom, getAllProperties, getAllSubComponentOwners, getAttributeExpressions, getAttributes, getBooleanPropertyValue, getBoundObject, getBoundShortcut, getBoundTechnology, getBusinessName, getCachedIssues, getComponentAttributeMap, getComponentCategory, getComponentCount, getComponentLocation, getComponentOwner, getComponents, getComponentTypeName, getCompositeQualifier, getConnectorPointCount, getConnectorPointCount, getConnectorPoints, getConnectorPoints, getConnectorPointToLeaf, getConnectorTo, getDelegate, getDescription, getDisplayableObjectName, getDisplayableProperties, getDisplayableTypeName, getDomainInterfaceType, getDownstreamConnectedLeafComponents, getDownstreamConnectedPoints, getExpressionPropertyValue, getExpressionReferences, getExpressionValidationCode, getExtraCreatedObjects, getFlowConstraints, getFullName, getGlobalId, getGUID, getInputConnectorPoint, getInputConnectorPoint, getInputConnectorPointCount, getInputConnectorPoints, getInputPoint, getInScopeAttributes, getInScopeAttributeXMap, getInternalId, getIntPropertyValue, getLeafLevelComponents, getLeafLevelTargets, getMapRootContainer, getName, getNumericId, getOutputAttributeExpressions, getOutputAttributes, getOutputConnectorPoint, getOutputConnectorPoint, getOutputConnectorPointCount, getOutputConnectorPoints, getOutputPoint, getOwner, getOwningComponent, getPersistentClassName, getPersistentComponent, getPrefix, getProjectedAttributes, getProjectorOrMultiInputSource, getProperties, getProperty, getPropertyDefinitionOwner, getPropertyValue, getPropertyValueReference, getProposedConnectionIssues, getProposedConnectionIssues, getProposedScopingIssues, getQualifiedName, getRootComponentOwner, getRootContainer, getScopingInputPointForSource, getSecurityContainer, getSources, getStringPropertyValue, getStrongTypeClassName, getSyncState, getTargets, getTopLevelComponentsOfType, getTopLevelSources, getTopLevelTargets, getTopmostComponent, getUpstreamAttributeXMap, getUpstreamComponentOwner, getUpstreamConnectedLeafComponents, getUpstreamConnectedLeafPoints, getUpstreamConnectedPoints, getUpstreamInScopeLeafAttributes, getUpstreamInScopeLeafPoints, getUpstreamLeafAttributes, getUpstreamLeafAttributes, getUpstreamLeafConnectorPoints, getUpstreamLeafSources, getUpstreamSources, getUpstreamSplitPaths, hasCustomizedPersistenceMethodFor, invalidateDownstreamExpressions, invokeCustomizedPersistenceMethodFor, invokeMethod, isBound, isComponent, isCompositeComponent, isDecorator, isEndpoint, isHidden, isInScope, isInScope, isMultiInputSelector, isOfType, isProjector, isPropertyDefined, isProposedConnectionValid, isProposedConnectionValid, isProposedScopingValid, isSelector, isSource, isSubComponent, isTarget, isUniqueComponentName, isUniqueComponentName, referencesObject, removeAllConnections, removeAllConnections, removeAllConnectionsAndReroute, removeAllConnectionsAndReroute, removeAllInputConnections, removeComponent, removeComponent, removeInputConnectorPoint, removeInputConnectorPoint, removeInputConnectorPoint, removeOutputConnectorPoint, removeOutputConnectorPoint, removeProperty, reorderInputConnectorPoint, reorderOutputConnectorPoint, rerouteConnections, setAlias, setAttributeExpressionText, setAttributeExpressionText, setBooleanPropertyValue, setBusinessName, setDescription, setIntPropertyValue, setIsHidden, setName, setPropertyValue, syncComponent, validate, validate, validateProperties
public static final java.lang.String COMPONENT_TYPE_NAME
public static final java.lang.String DATASET_DEFAULT_JOIN_NAME
public Dataset(MapComponent component) throws MappingException
IMapComponent
,
which will create the delegate if necessary.
FOR INTERNAL USE ONLY.
component
- the input mapping component for which a Dataset is to be constructedMappingException
- if the map component cannot function as a Dataset.IMapComponent.getDelegate()
public Dataset(MapComponentType componentType) throws oracle.odi.domain.mapping.exception.MapComponentException
IMapComponentOwner
.
FOR INTERNAL USE ONLY
componentType
- the component type of the persistent mapping componentoracle.odi.domain.mapping.exception.MapComponentException
IMapComponentOwner.createComponent(String, String)
public Dataset(MapComponentOwner owner, java.lang.String name) throws MappingException, AdapterException
IMapComponentOwner
.
FOR INTERNAL USE ONLY.
owner
- the component owner that will own the new componentname
- the name for the new componentAdapterException
MappingException
IMapComponentOwner.createComponent(String, String)
public Dataset(MapComponentOwner owner, java.lang.String componentTypeName, java.lang.String name) throws MappingException, AdapterException
IMapComponentOwner
.
FOR INTERNAL USE ONLY.
owner
- the component owner that will own the new componentcomponentTypeName
- the type name for the new componentname
- the name for the new componentAdapterException
MappingException
IMapComponentOwner.createComponent(String, String)
public java.lang.String getTypeName()
IMapComponent
getTypeName
in class oracle.odi.domain.mapping.MapComponentDelegate
MapComponentRegistry
public void invalidateExpressions()
IMapComponent
invalidateExpressions
in class DefaultDelegate
public IMapComponent createComponent(java.lang.String type, IModelObject boundObject, boolean enableAutoJoin) throws MappingException, AdapterException
IMapComponentOwner
createComponent
in interface IMapComponentOwner
createComponent
in class oracle.odi.domain.mapping.MapComponentDelegator
type
- The type name of the component. The type name is not a full class name, it
is a short component type name string recognized by the component type registry. The component
name for each component is part of its definition. The component type
names are normally defined as a static variable in the component delegate class. For
example the component type name for the join component is found in
JoinComponent.COMPONENT_TYPE_NAME. The standard built-in component delegate classes
are found in package oracle.odi.domain.mapping.component.boundObject
- An object to which the component is bound. The bound object will typically
be a repository object that is associated with this component and from
which this component will derive attribute information. The bound object
must implement the IModelObject mapping. It can be a native ODI object,
a native non-ODI repository object, or an adapter that wraps a native repository
object and implements IModelObject. If a raw native object that does not
implement IModelObject is passed in, the appropriate adapter will be invoked
to attempt to create an adapter wrapper object for it. If this cannot be done,
an exception will be thrown.enableAutoJoin
- If true, enables the auto-creation of join components that
that join new source components based on relationships between the bound objects.oracle.odi.domain.mapping.exception.MapComponentException
PropertyException
oracle.odi.domain.mapping.expression.parser.ExpressionParseException
MapPhysicalException
MappingException
AdapterException
public IMapComponent createComponent(java.lang.String type, IModelObject boundObject) throws MappingException, AdapterException
IMapComponentOwner
createComponent
in interface IMapComponentOwner
createComponent
in class oracle.odi.domain.mapping.MapComponentDelegator
type
- The type name of the component. The type name is not a full class name, it
is a short component type name string recognized by the component type registry. The component
name for each component is part of its definition. The component type
names are normally defined as a static variable in the component delegate class. For
example the component type name for the join component is found in
JoinComponent.COMPONENT_TYPE_NAME. The standard built-in component delegate classes
are found in package oracle.odi.domain.mapping.component.boundObject
- An object to which the component is bound. The bound object will typically
be a repository object that is associated with this component and from
which this component will derive attribute information. The bound object
must implement the IModelObject mapping. It can be a native ODI object,
a native non-ODI repository object, or an adapter that wraps a native repository
object and implements IModelObject. If a raw native object that does not
implement IModelObject is passed in, the appropriate adapter will be invoked
to attempt to create an adapter wrapper object for it. If this cannot be done,
an exception will be thrown.oracle.odi.domain.mapping.exception.MapComponentException
PropertyException
oracle.odi.domain.mapping.expression.parser.ExpressionParseException
MapPhysicalException
MappingException
AdapterException
public DataStorageDelegate addSource(IDataStore datastoreObject, java.lang.String joinCondition) throws MappingException, AdapterException, MapPhysicalException
datastoreObject
- the external datastore instance that will be bound to the new source component.joinCondition
- the join condition string that will join the new source to existing sources.
If null, no join will be added.MappingtException
- if datastoreObject is already a datastore delegate.AdapterException
- if accessing repository object hits an error.MapPhysicalException
- if accessing repository object hits an error.MappingException
public IMapComponent addSource(IModelObject boundObject, boolean autoJoinEnabled) throws MappingException, AdapterException
boundObject
- the model object to be bound to the new datastore delegate.autoJoinEnabled
- a boolean flag indicating if auto join is to be performed.
If true, the mapping framework may automatically create a join component
that joins the newly bound component to other existing components, based
on model relationships (foreign keys) between the bound objects.MappingException
- if an error is encountered in mapping framework.AdapterException
- if accessing repository hits an error.public JoinComponent addJoin(java.lang.String joinCondition) throws AdapterException, MappingException
joinCondition
- the join condition text.AdapterException
- if accessing repository hits an error.MappingException
- if an error is encountered in mapping framework.public LookupComponent addLookup(DatastoreComponent driverComp, IDataStore lookupDatastore, java.lang.String lookupCondition) throws AdapterException, MappingException
driverComp
- the datastore mapping component used as the driver of the lookup.lookupDatastore
- the datastore model object used as the lookup table for the lookup.lookupCondition
- the join condition between the driver and lookup.AdapterException
- if accessing repository hits an error.MappingException
- if an error is encountered in mapping framework.public java.util.List getEntityRelationships() throws AdapterException, MappingException
AdapterException
- if an error is encountered accessing repository.MappingException
- if an error is encountered in mapping framework.public JoinComponent findJoinForSources(java.util.List sources) throws AdapterException, MappingException
sources
- The list of source components for which to find the associated joinAdapterException
- if accessing repository hits an error.MappingException
- if an error is encountered in mapping framework.public LookupComponent findLookupForSources(java.util.List sources) throws AdapterException, MappingException
sources
- a list of 2 source components for which to find the associated lookup.AdapterException
- if accessing repository hits an error.MappingException
- if an error is encountered in mapping framework.public static java.util.List getDatasets(MapComponentOwner componentOwner) throws MappingException
componentOwner
- the owner of Datasets.MappingException
public static Dataset getContainingDataset(IMapComponent comp) throws oracle.odi.domain.mapping.exception.MapComponentException
comp
- the component for which to get the owning dataset.oracle.odi.domain.mapping.exception.MapComponentException
public IMapComponent removeSourceFromDataset(MapComponent source, boolean recreate) throws MappingException, AdapterException
source
- the source component to be removed.recreate
- a flag indicating if the source needs to be recreated.MappingException
- if an error is encountered accessing mapping objects.AdapterException
- if accessing repository object hits an error.public static boolean isInDataset(IMapComponent comp) throws oracle.odi.domain.mapping.exception.MapComponentException
comp
- a mapping component whose membership in this Dataset is to be checked.oracle.odi.domain.mapping.exception.MapComponentException
public java.util.List getSupportedSourceComponents() throws MappingException
MappingException
public java.util.List findDerivedJoins(JoinComponent join) throws PropertyException, oracle.odi.domain.mapping.exception.MapComponentException
join
- a join whose derived joins are to be retrieved.PropertyException
- if retrieving properties of the join component hits an error.oracle.odi.domain.mapping.exception.MapComponentException
- if searching for derived join component hits an error.JoinComponent.getDerivedJoins(Dataset)
public boolean isValidForTechnology(ITechnology techno, java.util.List issues) throws MappingException
IMapComponent
isValidForTechnology
in class DefaultDelegate
techno
- The technology to validate againstMappingException