org.hibernate.engine.spi

Class EffectiveEntityGraph

java.lang.Object

org.hibernate.engine.spi.EffectiveEntityGraph

All Implemented Interfaces:

Serializable, AppliedGraph

public class EffectiveEntityGraph
extends Object
implements AppliedGraph, Serializable

Think of this as the composite modeling of a graph and the semantic. Its graph and semantic can be obtained by getGraph() and getSemantic() They can be managed by calls to applyGraph(org.hibernate.graph.spi.RootGraphImplementor<?>, org.hibernate.graph.GraphSemantic), applyConfiguredGraph(java.util.Map<java.lang.String, ?>) and clear()

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
EffectiveEntityGraph()
EffectiveEntityGraph(boolean allowOverwrite)

Method Summary

Modifier and Type	Method and Description
void	applyConfiguredGraph(Map<String,?> properties) Apply a graph and semantic based on configuration properties or hints based on GraphSemantic.getJpaHintName() for GraphSemantic.LOAD or GraphSemantic.FETCH.
void	applyGraph(RootGraphImplementor<?> graph, GraphSemantic semantic) Apply the graph and semantic.
void	clear()
RootGraphImplementor<?>	getGraph() The applied graph
GraphSemantic	getSemantic() The semantic (fetch/load) under which the graph should be applied

Methods inherited from class java.lang.Object

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

Constructor Detail

EffectiveEntityGraph

public EffectiveEntityGraph()

EffectiveEntityGraph

public EffectiveEntityGraph(boolean allowOverwrite)

Method Detail

getSemantic

public GraphSemantic getSemantic()

Description copied from interface: AppliedGraph

The semantic (fetch/load) under which the graph should be applied

Specified by:

getSemantic in interface AppliedGraph

getGraph

public RootGraphImplementor<?> getGraph()

Description copied from interface: AppliedGraph

The applied graph

Specified by:

getGraph in interface AppliedGraph

applyGraph

public void applyGraph(RootGraphImplementor<?> graph,
                       GraphSemantic semantic)

Apply the graph and semantic. The semantic is required. The graph may be null, but that should generally be considered mis-use.

Throws:

IllegalArgumentException - Thrown if the semantic is null

IllegalStateException - If previous state is still available (hasn't been cleared).

applyConfiguredGraph

public void applyConfiguredGraph(Map<String,?> properties)

Apply a graph and semantic based on configuration properties or hints based on GraphSemantic.getJpaHintName() for GraphSemantic.LOAD or GraphSemantic.FETCH. The semantic is required. The graph may be null, but that should generally be considered mis-use.

Throws:

IllegalArgumentException - If both kinds of graphs were present in the properties/hints

IllegalStateException - If previous state is still available (hasn't been cleared).

clear

public void clear()