org.eclipse.persistence.internal.jpa.metamodel

Class ManagedTypeImpl<X>

java.lang.Object

org.eclipse.persistence.internal.jpa.metamodel.TypeImpl<X>

org.eclipse.persistence.internal.jpa.metamodel.ManagedTypeImpl<X>

Type Parameters:

X - The represented type.

All Implemented Interfaces:

java.io.Serializable

Direct Known Subclasses:

EmbeddableTypeImpl, IdentifiableTypeImpl

public abstract class ManagedTypeImpl<X>
extends TypeImpl<X>

Purpose: Provides the implementation for the ManagedType interface of the JPA 2.0 Metamodel API (part of the JSR-317 EJB 3.1 Criteria API)

Description: Instances of the type ManagedType represent entities, mapped superclasses and embeddable types.

Since:

EclipseLink 1.2 - JPA 2.0

See Also:

javax.persistence.metamodel.ManagedType, Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected ClassDescriptor	descriptor Native RelationalDescriptor that contains all the mappings of this type
protected MetamodelImpl	metamodel Reference to the metamodel that this managed type belongs to

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	ManagedTypeImpl(MetamodelImpl metamodel, ClassDescriptor descriptor) INTERNAL: This constructor will create a ManagedType but will not initialize its member mappings.

Method Summary

Modifier and Type	Method and Description
protected static ManagedTypeImpl<?>	create(MetamodelImpl metamodel, ClassDescriptor descriptor) INTERNAL: Return an instance of a ManagedType based on the RelationalDescriptor parameter
<any>	getAttribute(java.lang.String name) Return the attribute of the managed type that corresponds to the specified name.
java.util.Set<<any>>	getAttributes() Return the attributes of the managed type.
<any>	getCollection(java.lang.String name) Return the Collection-valued attribute of the managed type that corresponds to the specified name.
<E> <any>	getCollection(java.lang.String name, java.lang.Class<E> elementType) Return the Collection-valued attribute of the managed type that corresponds to the specified name and Java element type.
<any>	getDeclaredAttribute(java.lang.String name) Return the declared attribute of the managed type that corresponds to the specified name.
protected <any>	getDeclaredAttribute(java.lang.String name, boolean attributeKnownToExistOnLeafTarget) INTERNAL: Return the declared attribute of the managed type that corresponds to the specified name.
java.util.Set<<any>>	getDeclaredAttributes() Return the attributes declared by the managed type.
<any>	getDeclaredCollection(java.lang.String name) Return the Collection-valued attribute declared by the managed type that corresponds to the specified name.
<E> <any>	getDeclaredCollection(java.lang.String name, java.lang.Class<E> elementType) Return the Collection-valued attribute declared by the managed type that corresponds to the specified name and Java element type.
<any>	getDeclaredList(java.lang.String name) Return the List-valued attribute declared by the managed type that corresponds to the specified name.
<E> <any>	getDeclaredList(java.lang.String name, java.lang.Class<E> elementType) Return the List-valued attribute declared by the managed type that corresponds to the specified name and Java element type.
<any>	getDeclaredMap(java.lang.String name) Return the Map-valued attribute of the managed type that corresponds to the specified name.
<K,V> <any>	getDeclaredMap(java.lang.String name, java.lang.Class<K> keyType, java.lang.Class<V> valueType) Return the Map-valued attribute of the managed type that corresponds to the specified name and Java key and value types.
java.util.Set<<any>>	getDeclaredPluralAttributes() Return all collection-valued attributes declared by the managed type.
<any>	getDeclaredSet(java.lang.String name) Return the Set-valued attribute declared by the managed type that corresponds to the specified name.
<E> <any>	getDeclaredSet(java.lang.String name, java.lang.Class<E> elementType) Return the Set-valued attribute declared by the managed type that corresponds to the specified name and Java element type.
<any>	getDeclaredSingularAttribute(java.lang.String name) Return the declared single-valued attribute of the managed type that corresponds to the specified name in the represented type.
<Y> <any>	getDeclaredSingularAttribute(java.lang.String name, java.lang.Class<Y> type) Return the declared single-valued attribute of the managed type that corresponds to the specified name and Java type in the represented type.
java.util.Set<<any>>	getDeclaredSingularAttributes() Return the single-valued attributes declared by the managed type.
ClassDescriptor	getDescriptor() INTERNAL: Return the RelationalDescriptor associated with this ManagedType
<any>	getList(java.lang.String name) Return the List-valued attribute of the managed type that corresponds to the specified name.
<E> <any>	getList(java.lang.String name, java.lang.Class<E> elementType) Return the List-valued attribute of the managed type that corresponds to the specified name and Java element type.
<any>	getMap(java.lang.String name) Return the Map-valued attribute of the managed type that corresponds to the specified name.
<K,V> <any>	getMap(java.lang.String name, java.lang.Class<K> keyType, java.lang.Class<V> valueType) Return the Map-valued attribute of the managed type that corresponds to the specified name and Java key and value types.
protected java.util.Map<java.lang.String,<any>>	getMembers() INTERNAL: Return the Map of AttributeImpl members keyed by String.
protected MetamodelImpl	getMetamodel() INTERNAL: Return the Metamodel that this ManagedType is associated with.
java.util.Set<<any>>	getPluralAttributes() Return all collection-valued attributes of the managed type.
<any>	getSet(java.lang.String name) Return the Set-valued attribute of the managed type that corresponds to the specified name.
<E> <any>	getSet(java.lang.String name, java.lang.Class<E> elementType) Return the Set-valued attribute of the managed type that corresponds to the specified name and Java element type.
<any>	getSingularAttribute(java.lang.String name) Return the single-valued attribute of the managed type that corresponds to the specified name in the represented type.
<Y> <any>	getSingularAttribute(java.lang.String name, java.lang.Class<Y> type) Return the single-valued attribute of the managed type that corresponds to the specified name and Java type in the represented type.
java.util.Set<<any>>	getSingularAttributes() Return the single-valued attributes of the managed type.
protected java.lang.Class	getTypeClassFromAttributeOrMethodLevelAccessor(DatabaseMapping mapping) INTERNAL: Get the elementType directly from the class using a reflective method call directly on the containing java class associated with this managedType.
protected void	initialize() INTERNAL: Initialize the members of this ManagedType based on the mappings defined on the descriptor.
protected boolean	isIdentifiableType() INTERNAL: Return whether this type is identifiable.
protected boolean	isManagedType() INTERNAL: Return whether this type is identifiable.
protected void	toStringHelper(java.lang.StringBuffer aBuffer) INTERNAL: Append the partial string representation of the receiver to the StringBuffer.

Methods inherited from class org.eclipse.persistence.internal.jpa.metamodel.TypeImpl

getJavaType, getJavaType, getJavaTypeName, isEntity, isMappedSuperclass, toString

Methods inherited from class java.lang.Object

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

Field Detail

descriptor

protected ClassDescriptor descriptor

Native RelationalDescriptor that contains all the mappings of this type

metamodel

protected MetamodelImpl metamodel

Reference to the metamodel that this managed type belongs to

Constructor Detail

ManagedTypeImpl

protected ManagedTypeImpl(MetamodelImpl metamodel,
                          ClassDescriptor descriptor)

INTERNAL: This constructor will create a ManagedType but will not initialize its member mappings. This is accomplished by delayed initialization in MetamodelImpl.initialize() in order that we have access to all types when resolving relationships in mappings.

Parameters:

metamodel - - the metamodel that this managedType is associated with

descriptor - - the RelationalDescriptor that defines this managedType

Method Detail

getAttribute

public <any> getAttribute(java.lang.String name)

Return the attribute of the managed type that corresponds to the specified name.

Parameters:

name - the name of the represented attribute

Returns:

attribute with given name

Throws:

java.lang.IllegalArgumentException - if attribute of the given name is not present in the managed type

getAttributes

public java.util.Set<<any>> getAttributes()

Return the attributes of the managed type.

getCollection

public <any> getCollection(java.lang.String name)

Return the Collection-valued attribute of the managed type that corresponds to the specified name.

Parameters:

name - the name of the represented attribute

Returns:

CollectionAttribute of the given name

Throws:

java.lang.IllegalArgumentException - if attribute of the given name is not present in the managed type

getCollection

public <E> <any> getCollection(java.lang.String name,
                               java.lang.Class<E> elementType)

Return the Collection-valued attribute of the managed type that corresponds to the specified name and Java element type.

Parameters:

name - the name of the represented attribute

elementType - the element type of the represented attribute

Returns:

CollectionAttribute of the given name and element type

Throws:

java.lang.IllegalArgumentException - if attribute of the given name and type is not present in the managed type

getPluralAttributes

public java.util.Set<<any>> getPluralAttributes()

Return all collection-valued attributes of the managed type.

Returns:

collection valued attributes

getDeclaredAttribute

protected <any> getDeclaredAttribute(java.lang.String name,
                                     boolean attributeKnownToExistOnLeafTarget)

INTERNAL: Return the declared attribute of the managed type that corresponds to the specified name.

Parameters:

name - the name of the represented attribute

attributeKnownToExistOnLeafTarget - true if we already know the attribute exists on the leaf

Returns:

attribute with given name

Throws:

java.lang.IllegalArgumentException - if attribute of the given name is not declared in the managed type

getDeclaredAttribute

public <any> getDeclaredAttribute(java.lang.String name)

Return the declared attribute of the managed type that corresponds to the specified name.

Parameters:

name - the name of the represented attribute

Returns:

attribute with given name

Throws:

java.lang.IllegalArgumentException - if attribute of the given name is not declared in the managed type

getDeclaredAttributes

public java.util.Set<<any>> getDeclaredAttributes()

Return the attributes declared by the managed type.

getDeclaredCollection

public <any> getDeclaredCollection(java.lang.String name)

Return the Collection-valued attribute declared by the managed type that corresponds to the specified name.

Parameters:

name - the name of the represented attribute

Returns:

declared CollectionAttribute of the given name

Throws:

java.lang.IllegalArgumentException - if attribute of the given name is not declared in the managed type

getDeclaredCollection

public <E> <any> getDeclaredCollection(java.lang.String name,
                                       java.lang.Class<E> elementType)

Return the Collection-valued attribute declared by the managed type that corresponds to the specified name and Java element type.

Parameters:

name - the name of the represented attribute

elementType - the element type of the represented attribute

Returns:

declared CollectionAttribute of the given name and element type

Throws:

java.lang.IllegalArgumentException - if attribute of the given name and type is not declared in the managed type

getDeclaredPluralAttributes

public java.util.Set<<any>> getDeclaredPluralAttributes()

Return all collection-valued attributes declared by the managed type.

Returns:

declared collection valued attributes

create

protected static ManagedTypeImpl<?> create(MetamodelImpl metamodel,
                                           ClassDescriptor descriptor)

INTERNAL: Return an instance of a ManagedType based on the RelationalDescriptor parameter

Parameters:

metamodel -

descriptor -

Returns:

getDeclaredList

public <E> <any> getDeclaredList(java.lang.String name,
                                 java.lang.Class<E> elementType)

Return the List-valued attribute declared by the managed type that corresponds to the specified name and Java element type.

Parameters:

name - the name of the represented attribute

elementType - the element type of the represented attribute

Returns:

declared ListAttribute of the given name and element type

Throws:

java.lang.IllegalArgumentException - if attribute of the given name and type is not declared in the managed type

getDeclaredList

public <any> getDeclaredList(java.lang.String name)

Return the List-valued attribute declared by the managed type that corresponds to the specified name.

Parameters:

name - the name of the represented attribute

Returns:

declared ListAttribute of the given name

Throws:

java.lang.IllegalArgumentException - if attribute of the given name is not declared in the managed type

getDeclaredMap

public <any> getDeclaredMap(java.lang.String name)

Return the Map-valued attribute of the managed type that corresponds to the specified name.

Parameters:

name - the name of the represented attribute

Returns:

MapAttribute of the given name

Throws:

java.lang.IllegalArgumentException - if attribute of the given name is not present in the managed type

getDeclaredMap

public <K,V> <any> getDeclaredMap(java.lang.String name,
                                  java.lang.Class<K> keyType,
                                  java.lang.Class<V> valueType)

Return the Map-valued attribute of the managed type that corresponds to the specified name and Java key and value types.

Parameters:

name - the name of the represented attribute

keyType - the key type of the represented attribute

valueType - the value type of the represented attribute

Returns:

MapAttribute of the given name and key and value types

Throws:

java.lang.IllegalArgumentException - if attribute of the given name and type is not present in the managed type

getDeclaredSet

public <any> getDeclaredSet(java.lang.String name)

Return the Set-valued attribute declared by the managed type that corresponds to the specified name.

Parameters:

name - the name of the represented attribute

Returns:

declared SetAttribute of the given name

Throws:

java.lang.IllegalArgumentException - if attribute of the given name is not declared in the managed type

getDeclaredSet

public <E> <any> getDeclaredSet(java.lang.String name,
                                java.lang.Class<E> elementType)

Return the Set-valued attribute declared by the managed type that corresponds to the specified name and Java element type.

Parameters:

name - the name of the represented attribute

elementType - the element type of the represented attribute

Returns:

declared SetAttribute of the given name and element type

Throws:

java.lang.IllegalArgumentException - if attribute of the given name and type is not declared in the managed type

getDeclaredSingularAttribute

public <any> getDeclaredSingularAttribute(java.lang.String name)

Return the declared single-valued attribute of the managed type that corresponds to the specified name in the represented type.

Parameters:

name - the name of the represented attribute

Returns:

declared single-valued attribute of the given name

Throws:

java.lang.IllegalArgumentException - if attribute of the given name is not declared in the managed type

getDeclaredSingularAttribute

public <Y> <any> getDeclaredSingularAttribute(java.lang.String name,
                                              java.lang.Class<Y> type)

Return the declared single-valued attribute of the managed type that corresponds to the specified name and Java type in the represented type.

Parameters:

name - the name of the represented attribute

type - the type of the represented attribute

Returns:

declared single-valued attribute of the given name and type

Throws:

java.lang.IllegalArgumentException - if attribute of the given name and type is not declared in the managed type

getDeclaredSingularAttributes

public java.util.Set<<any>> getDeclaredSingularAttributes()

Return the single-valued attributes declared by the managed type.

Returns:

declared single-valued attributes

getDescriptor

public ClassDescriptor getDescriptor()

INTERNAL: Return the RelationalDescriptor associated with this ManagedType

Returns:

getList

public <any> getList(java.lang.String name)

Return the List-valued attribute of the managed type that corresponds to the specified name.

Parameters:

name - the name of the represented attribute

Returns:

ListAttribute of the given name

Throws:

java.lang.IllegalArgumentException - if attribute of the given name is not present in the managed type

getList

public <E> <any> getList(java.lang.String name,
                         java.lang.Class<E> elementType)

Return the List-valued attribute of the managed type that corresponds to the specified name and Java element type.

Parameters:

name - the name of the represented attribute

elementType - the element type of the represented attribute

Returns:

ListAttribute of the given name and element type

Throws:

java.lang.IllegalArgumentException - if attribute of the given name and type is not present in the managed type

getMap

public <any> getMap(java.lang.String name)

Return the Map-valued attribute of the managed type that corresponds to the specified name.

Parameters:

name - the name of the represented attribute

Returns:

MapAttribute of the given name

Throws:

java.lang.IllegalArgumentException - if attribute of the given name is not present in the managed type

getMap

public <K,V> <any> getMap(java.lang.String name,
                          java.lang.Class<K> keyType,
                          java.lang.Class<V> valueType)

Return the Map-valued attribute of the managed type that corresponds to the specified name and Java key and value types.

Parameters:

name - the name of the represented attribute

keyType - the key type of the represented attribute

valueType - the value type of the represented attribute

Returns:

MapAttribute of the given name and key and value types

Throws:

java.lang.IllegalArgumentException - if attribute of the given name and type is not present in the managed type

getMembers

protected java.util.Map<java.lang.String,<any>> getMembers()

INTERNAL: Return the Map of AttributeImpl members keyed by String.

Returns:

getMetamodel

protected MetamodelImpl getMetamodel()

INTERNAL: Return the Metamodel that this ManagedType is associated with.

Returns:

getSet

public <any> getSet(java.lang.String name)

Return the Set-valued attribute of the managed type that corresponds to the specified name.

Parameters:

name - the name of the represented attribute

Returns:

SetAttribute of the given name

Throws:

java.lang.IllegalArgumentException - if attribute of the given name is not present in the managed type

getSet

public <E> <any> getSet(java.lang.String name,
                        java.lang.Class<E> elementType)

Return the Set-valued attribute of the managed type that corresponds to the specified name and Java element type.

Parameters:

name - the name of the represented attribute

elementType - the element type of the represented attribute

Returns:

SetAttribute of the given name and element type

Throws:

java.lang.IllegalArgumentException - if attribute of the given name and type is not present in the managed type

getSingularAttribute

public <any> getSingularAttribute(java.lang.String name)

Return the single-valued attribute of the managed type that corresponds to the specified name in the represented type.

Parameters:

name - the name of the represented attribute

Returns:

single-valued attribute with the given name

Throws:

java.lang.IllegalArgumentException - if attribute of the given name is not present in the managed type

getSingularAttribute

public <Y> <any> getSingularAttribute(java.lang.String name,
                                      java.lang.Class<Y> type)

Return the single-valued attribute of the managed type that corresponds to the specified name and Java type in the represented type.

Parameters:

name - the name of the represented attribute

type - the type of the represented attribute

Returns:

single-valued attribute with given name and type

Throws:

java.lang.IllegalArgumentException - if attribute of the given name and type is not present in the managed type

getSingularAttributes

public java.util.Set<<any>> getSingularAttributes()

Return the single-valued attributes of the managed type.

Returns:

single-valued attributes

initialize

protected void initialize()

INTERNAL: Initialize the members of this ManagedType based on the mappings defined on the descriptor. We process the appropriate Map, List, Set, Collection or Object/primitive types.

Initialization should occur after all types in the metamodel have been created already.

getTypeClassFromAttributeOrMethodLevelAccessor

protected java.lang.Class getTypeClassFromAttributeOrMethodLevelAccessor(DatabaseMapping mapping)

INTERNAL: Get the elementType directly from the class using a reflective method call directly on the containing java class associated with this managedType.

Parameters:

mapping -

Returns:

isIdentifiableType

protected boolean isIdentifiableType()

INTERNAL: Return whether this type is identifiable. This would be EntityType and MappedSuperclassType

Specified by:

isIdentifiableType in class TypeImpl<X>

Returns:

isManagedType

protected boolean isManagedType()

INTERNAL: Return whether this type is identifiable. This would be EmbeddableType as well as EntityType and MappedSuperclassType

Specified by:

isManagedType in class TypeImpl<X>

Returns:

toStringHelper

protected void toStringHelper(java.lang.StringBuffer aBuffer)

INTERNAL: Append the partial string representation of the receiver to the StringBuffer.

Specified by:

toStringHelper in class TypeImpl<X>