Package org.hibernate.query.sqm

Interface SqmPathSource<J>

All Superinterfaces:

Bindable<J>, PathSource<J>, SqmExpressible<J>, SqmExpressibleAccessor<J>

All Known Subinterfaces:

CompositeSqmPathSource<J>, SqmBagPersistentAttribute<D,E>, SqmEmbeddableDomainType<E>, SqmEntityDomainType<E>, SqmListPersistentAttribute<D,E>, SqmMappedSuperclassDomainType<T>, SqmMapPersistentAttribute<D,K,V>, SqmPluralPersistentAttribute<D,C,E>, SqmSetPersistentAttribute<D,E>, SqmSingularPersistentAttribute<D,J>, SqmTreatableDomainType<T>

All Known Implementing Classes:

AbstractDiscriminatorSqmPathSource, AbstractPluralAttribute, AbstractSqmPathSource, AnonymousTupleSimpleSqmPathSource, AnonymousTupleSqmAssociationPathSource, AnonymousTupleSqmAssociationPathSourceNew, AnonymousTupleSqmPathSource, AnonymousTupleSqmPathSourceNew, AnonymousTupleType, AnyDiscriminatorSqmPathSource, AnyMappingSqmPathSource, BagAttributeImpl, BasicSqmPathSource, EmbeddableTypeImpl, EmbeddedDiscriminatorSqmPathSource, EmbeddedSqmPathSource, EntityDiscriminatorSqmPathSource, EntitySqmPathSource, EntityTypeImpl, ListAttributeImpl, MapAttributeImpl, MappedSuperclassSqmPathSource, MappedSuperclassTypeImpl, NonAggregatedCompositeSqmPathSource, SetAttributeImpl, SingularAttributeImpl, SingularAttributeImpl.Identifier, SingularAttributeImpl.Version, SqmCteTable, SqmPolymorphicRootDescriptor

public interface SqmPathSource<J>
extends SqmExpressible<J>, Bindable<J>, SqmExpressibleAccessor<J>, PathSource<J>

Represents any part of the domain model which can be used to create a SqmPath node.

API Note:

Parallel to the JPA-defined interface Bindable but broader mainly to support @Any mappings

Nested Class Summary

Nested classes/interfaces inherited from interface jakarta.persistence.metamodel.Bindable

Bindable.BindableType

Method Summary

Modifier and Type	Method	Description
SqmPath<J>	createSqmPath(SqmPath<?> lhs, SqmPathSource<?> intermediatePathSource)	Create an SQM path for this source relative to the given left hand side
SqmPathSource<?>	findSubPathSource(String name)	Find a SqmPathSource by name relative to this source.
default SqmPathSource<?>	findSubPathSource(String name, boolean includeSubtypes)	Find a SqmPathSource by name relative to this source.
default SqmBindableType<J>	getExpressible()
default SqmPathSource<?>	getIntermediatePathSource(SqmPathSource<?> pathSource)	Returns the intermediate SqmPathSource for a path source previously acquired via findSubPathSource(String).
SqmDomainType<J>	getPathType()	The type of path this source creates.
default SqmDomainType<J>	getSqmType()
default SqmPathSource<?>	getSubPathSource(String name)	Find a SqmPathSource by name relative to this source.
default SqmPathSource<?>	getSubPathSource(String name, boolean subtypes)	Find a SqmPathSource by name relative to this source.
default boolean	isGeneric()	Indicates if this path source is generically typed

Methods inherited from interface jakarta.persistence.metamodel.Bindable

getBindableJavaType, getBindableType

Methods inherited from interface org.hibernate.metamodel.model.domain.PathSource

getPathName

Methods inherited from interface org.hibernate.query.sqm.SqmExpressible

getExpressibleJavaType, getRelationalJavaType, getTypeName

Methods inherited from interface org.hibernate.query.sqm.tree.SqmExpressibleAccessor

getNodeJavaType

Method Details

getPathType

SqmDomainType<J> getPathType()

The type of path this source creates.

Specified by:

getPathType in interface PathSource<J>

findSubPathSource

SqmPathSource<?> findSubPathSource(String name)

Find a SqmPathSource by name relative to this source.

Specified by:

findSubPathSource in interface PathSource<J>

Parameters:

name - the name of the path source to find

Returns:

null if the subPathSource is not found

Throws:

IllegalStateException - to indicate that this source cannot be de-referenced

findSubPathSource

default SqmPathSource<?> findSubPathSource(String name,
 boolean includeSubtypes)

Find a SqmPathSource by name relative to this source. If includeSubtypes is set to true and this path source is polymorphic, also try finding subtype attributes.

Specified by:

findSubPathSource in interface PathSource<J>

Parameters:

name - the name of the path source to find

includeSubtypes - flag indicating whether to consider subtype attributes

Returns:

null if the subPathSource is not found

Throws:

IllegalStateException - to indicate that this source cannot be de-referenced

getSubPathSource

default SqmPathSource<?> getSubPathSource(String name)

Find a SqmPathSource by name relative to this source.

Parameters:

name - the name of the path source to find

Throws:

IllegalStateException - to indicate that this source cannot be de-referenced

IllegalArgumentException - if the subPathSource is not found

getSubPathSource

default SqmPathSource<?> getSubPathSource(String name,
 boolean subtypes)

Find a SqmPathSource by name relative to this source. If subtypes is set to true and this path source is polymorphic, also try finding subtype attributes.

Parameters:

name - the name of the path source to find

subtypes - flag indicating whether to consider subtype attributes

Throws:

IllegalStateException - to indicate that this source cannot be de-referenced

IllegalArgumentException - if the subPathSource is not found

getIntermediatePathSource

default SqmPathSource<?> getIntermediatePathSource(SqmPathSource<?> pathSource)

Returns the intermediate SqmPathSource for a path source previously acquired via findSubPathSource(String).

createSqmPath

SqmPath<J> createSqmPath(SqmPath<?> lhs,
 SqmPathSource<?> intermediatePathSource)

Create an SQM path for this source relative to the given left hand side

getExpressible

default SqmBindableType<J> getExpressible()

Specified by:

getExpressible in interface SqmExpressibleAccessor<J>

getSqmType

default SqmDomainType<J> getSqmType()

Specified by:

getSqmType in interface SqmExpressible<J>

isGeneric

default boolean isGeneric()

Indicates if this path source is generically typed