oracle.jbo.server
Class EntityAssociation

java.lang.Object
  |
  +--oracle.jbo.common.NamedObjectImpl
        |
        +--oracle.jbo.mom.DefinitionObject
              |
              +--oracle.jbo.server.DefObject
                    |
                    +--oracle.jbo.server.AssociationDefBase
                          |
                          +--oracle.jbo.server.EntityAssociation

All Implemented Interfaces:

oracle.jbo.server.Association

public class EntityAssociation

extends AssociationDefBase

Describes the relationship between two Entity Objects. An association selects attributes from source and destination Entity Objects. Typically, these attributes represent key fields in a database table, but an association can be defined using any Entity Object attributes. Although an association identifies a source and destination end, the association can be navigated in either direction. Associations have package scope.

The EntityAssociation class determines the content of the AssociationDefImpl attributes on the Entity definitions. The AssociationDefImpl attributes are the attributes at the source Entity and the destination Entity. There are two AssociationDefImpls for each EntityAssociation. For example, in the case of an association between Dept and Emp, Dept will have one AssociationDefImpl attribute for Emp; Emp will have one AssociationDefImpl attribute for Dept. The EntityAssociation links the two AssociationDefImpls.

An instance of the EntityAssociation class maps to the XML file for the association. At runtime, when the XML for the EntityAssociation is read, the framework creates the two AssociationDefImpls and determines whether they are source or destination attributes.

Since:

JDevloper 3.0

Field Summary

Type	Field
protected AttributeDefImpl[]	mBindVars The list of AttributeDefImpls as bind variables on one end.
protected AttributeDefImpl[]	mOtherBindVars The list of bind variable AttributeDefImpls on one end.

Fields inherited from class oracle.jbo.server.AssociationDefBase

mComponentClass

Fields inherited from class oracle.jbo.mom.DefinitionObject

mBaseDefObject, mExtendedDefObjects, mObjectResolved

Fields inherited from class oracle.jbo.common.NamedObjectImpl

mFullName, mObjName, mParent, mProperties

Method Summary

Type	Method
static EntityAssociation	findEntityAssociation(java.lang.String entityAssocName) Finds the named entity association from the statically maintained list of metaobjects.
oracle.jbo.server.AssociationDefImpl	getAccessorByEndName(java.lang.String endName) Deprecated. Deprecated since 5.0. Instead, use AssociationDefBase.findEndAccessorByName().
oracle.jbo.server.AssociationEnd	getAssociationEnd(java.lang.String endName) Deprecated. Deprecated since 5.0. Instead, use AssociationDefBase.findEndByName().
AttributeDefImpl[]	getBindVariables() Returns the bind variables for one end of the association.
java.lang.Class	getComponentClass() Returns the class name of this Entity association's reference.
EntityDefImpl	getEntityDef() Deprecated. Deprecated since 5.0. Instead, use AssociationDefBase.getSourceOwner() and down cast it to EntityDefImpl.
AttributeDefImpl[]	getOtherBindVariables() Returns the bind variables for the other end of the association.
EntityDefImpl	getOtherEntityDef() Deprecated. Deprecated since 5.0. Instead, use AssociationDefBase.getDestinationOwner() and down cast it to EntityDefImpl.
void	link(oracle.jbo.server.AssociationDefImpl srcAccr, oracle.jbo.server.AssociationDefImpl dstAccr) Establishes a link between two Entity Objects.
protected void	resolveReferences()
void	setBindVariables(AttributeDefImpl[] vars) Sets the bind variables for one end of the association.
void	setOtherBindVariables(AttributeDefImpl[] vars) Sets the bind variables for the other end of the association.

Methods inherited from class oracle.jbo.server.AssociationDefBase

findEndAccessorByName, finishedLoading, getAccessors, getAttributeDefImpls, getAttributeDefImplsByEndName, getBaseDefObject, getDefs, getName, getOtherAttributeDefImpls, getPackageDef, getPackageName, loadProperties, setBaseDefObject, setName, setParent

Methods inherited from class oracle.jbo.mom.DefinitionObject

addExtendedDefObject, getContainerDef, getContainerName, getExtendedDefObjects, isBaseDefFor, isDynamicDefinitionObject, isObjectResolved, setObjectResolved

Methods inherited from class oracle.jbo.common.NamedObjectImpl

getFullName, getParent, getProperties, getPropertiesAsStrings, getPropertiesMap, getProperty, refreshProperty, setFullName, setPropertiesMap, setProperty

Methods inherited from class java.lang.Object

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

Field Detail

mBindVars

protected AttributeDefImpl[] mBindVars

The list of AttributeDefImpls as bind variables on one end. This field is unused. Will be removed eventually.

mOtherBindVars

protected AttributeDefImpl[] mOtherBindVars

The list of bind variable AttributeDefImpls on one end. This field is unused. Will be removed eventually.

Method Detail

findEntityAssociation

public static EntityAssociation findEntityAssociation(java.lang.String entityAssocName)

Finds the named entity association from the statically maintained list of metaobjects.

Parameters:

entityAssocName - the fully qualified name of the entity association.

Returns:

an entity association.

getComponentClass

public java.lang.Class getComponentClass()

Returns the class name of this Entity association's reference.

Returns:

an EntityAssociationReference class name.

link

public void link(oracle.jbo.server.AssociationDefImpl srcAccr,
                 oracle.jbo.server.AssociationDefImpl dstAccr)

Establishes a link between two Entity Objects.

Parameters:

srcAccr - the source Entity Object's association accessor.

dstAccr - the destination Entity Object's association accessor.

setBindVariables

public void setBindVariables(AttributeDefImpl[] vars)

Sets the bind variables for one end of the association.

Parameters:

vars - an array of bind variables.

See Also:

setOtherBindVariables(oracle.jbo.server.AttributeDefImpl[])

getBindVariables

public AttributeDefImpl[] getBindVariables()

Returns the bind variables for one end of the association.

Returns:

an array of bind variables.

See Also:

getOtherBindVariables()

setOtherBindVariables

public void setOtherBindVariables(AttributeDefImpl[] vars)

Sets the bind variables for the other end of the association.

Parameters:

vars - an array of bind variables.

See Also:

setBindVariables(oracle.jbo.server.AttributeDefImpl[])

getOtherBindVariables

public AttributeDefImpl[] getOtherBindVariables()

Returns the bind variables for the other end of the association.

Returns:

an array of bind variables.

See Also:

getBindVariables()

resolveReferences

protected void resolveReferences()

Overrides:

resolveReferences in class oracle.jbo.server.DefObject

getEntityDef

public EntityDefImpl getEntityDef()

Deprecated. Deprecated since 5.0. Instead, use AssociationDefBase.getSourceOwner() and down cast it to EntityDefImpl.

Gets the entity definition of the source end of the association.

Returns:

the source entity definition.

getOtherEntityDef

public EntityDefImpl getOtherEntityDef()

Deprecated. Deprecated since 5.0. Instead, use AssociationDefBase.getDestinationOwner() and down cast it to EntityDefImpl.

Gets the entity definition of the destination end of the association.

Returns:

the destination entity definition.

getAccessorByEndName

public oracle.jbo.server.AssociationDefImpl getAccessorByEndName(java.lang.String endName)

Deprecated. Deprecated since 5.0. Instead, use AssociationDefBase.findEndAccessorByName().

Finds the association accessor given the association end name.

Parameters:

endName - the name of one of the association end.

Returns:

the association accessor definition .

getAssociationEnd

public oracle.jbo.server.AssociationEnd getAssociationEnd(java.lang.String endName)

Deprecated. Deprecated since 5.0. Instead, use AssociationDefBase.findEndByName().

Finds the association end given the name.

Parameters:

endName - the name of one of the association end.

Returns:

the association end.