HHH-6941 - Erroneous Javadoc for getReferencedProperty, getReferenceablePropertyIterator

This commit is contained in:
Vlad Mihalcea 2016-11-02 16:28:07 +02:00
parent dd4046e3a6
commit e26df5dc2e
1 changed files with 11 additions and 6 deletions

View File

@ -382,11 +382,13 @@ public abstract class PersistentClass implements AttributeContainer, Serializabl
} }
/** /**
* Build an iterator of properties which are "referenceable". * Build an iterator of properties which may be referenced in association mappings.
* * <p>
* @return The property iterator. * Includes properties defined in superclasses of the mapping inheritance.
* Includes all properties defined as part of a join.
* *
* @see #getReferencedProperty for a discussion of "referenceable" * @see #getReferencedProperty for a discussion of "referenceable"
* @return The referenceable property iterator.
*/ */
public Iterator getReferenceablePropertyIterator() { public Iterator getReferenceablePropertyIterator() {
return getPropertyClosureIterator(); return getPropertyClosureIterator();
@ -396,7 +398,7 @@ public abstract class PersistentClass implements AttributeContainer, Serializabl
* Given a property path, locate the appropriate referenceable property reference. * Given a property path, locate the appropriate referenceable property reference.
* <p/> * <p/>
* A referenceable property is a property which can be a target of a foreign-key * A referenceable property is a property which can be a target of a foreign-key
* mapping (an identifier or explcitly named in a property-ref). * mapping (e.g. {@code @ManyToOne}, {@code @OneToOne}).
* *
* @param propertyPath The property path to resolve into a property reference. * @param propertyPath The property path to resolve into a property reference.
* *
@ -686,8 +688,11 @@ public abstract class PersistentClass implements AttributeContainer, Serializabl
* iterator only accounts for "normal" properties (i.e. non-identifier * iterator only accounts for "normal" properties (i.e. non-identifier
* properties). * properties).
* <p/> * <p/>
* Differs from {@link #getUnjoinedPropertyIterator} in that the iterator * Differs from {@link #getUnjoinedPropertyIterator} in that the returned iterator
* we return here will include properties defined as part of a join. * will include properties defined as part of a join.
* <p/>
* Differs from {@link #getReferenceablePropertyIterator} in that the properties
* defined in superclasses of the mapping inheritance are not included.
* *
* @return An iterator over the "normal" properties. * @return An iterator over the "normal" properties.
*/ */