• Home
• org.beangle.hibernate
• beangle-hibernate-core
• 6.6.1.Final
• source code
• LazyToOneOption.java

×

Project download

Many resources are needed to download a project. Please understand that we have to compensate our server costs. Thank you in advance.
Project price only 1 $

You can buy this project and download/modify it how often you want.

org.hibernate.annotations.LazyToOneOption Maven / Gradle / Ivy

/*
 * Hibernate, Relational Persistence for Idiomatic Java
 *
 * License: GNU Lesser General Public License (LGPL), version 2.1 or later.
 * See the lgpl.txt file in the root directory or .
 */
package org.hibernate.annotations;

/**
 * Enumerates the options for lazy loading of a
 * {@linkplain jakarta.persistence.ManyToOne many to one}
 * or {@linkplain jakarta.persistence.OneToOne one to one}
 * association.
 *
 * @author Emmanuel Bernard
 *
 * @see LazyToOne
 *
 * @deprecated since {@link LazyToOne} is deprecated, use
 *             {@link jakarta.persistence.FetchType} instead
 */
@Deprecated(since="6.2")
public enum LazyToOneOption {
	/**
	 * The association is always loaded eagerly. The identifier
	 * and concrete type of the associated entity instance,
	 * along with all the rest of its non-lazy fields, are always
	 * available immediately.
	 *
	 * @deprecated use {@link jakarta.persistence.FetchType#EAGER}
	 */
	@Deprecated
	FALSE,
	/**
	 * The association is proxied and a delegate entity instance
	 * is lazily fetched when any method of the proxy other than
	 * the getter method for the identifier property is first
	 * called.
	 * 

	 * 
The identifier property of the proxy object is set
	 *     when the proxy is instantiated.
	 *     The program may obtain the entity identifier value
	 *     of an unfetched proxy, without triggering lazy
	 *     fetching, by calling the corresponding getter method.
	 * 
The proxy does not have the same concrete type as the
	 *     proxied delegate, and so
	 *     {@link org.hibernate.Hibernate#getClass(Object)}
	 *     must be used in place of {@link Object#getClass()},
	 *     and this method fetches the entity by side-effect.
	 * 
For a polymorphic association, the concrete type of
	 *     the proxied entity instance is not known until the
	 *     delegate is fetched from the database, and so
	 *     {@link org.hibernate.Hibernate#unproxy(Object, Class)}}
	 *     must be used to perform typecasts, and
	 *     {@link org.hibernate.Hibernate#getClass(Object)}
	 *     must be used instead of the Java {@code instanceof}
	 *     operator.
	 * 
	 *
	 * @deprecated use {@link jakarta.persistence.FetchType#LAZY}
	 */
	@Deprecated
	PROXY,
	/**
	 * The associated entity instance is initially in an unloaded
	 * state, and is loaded lazily when any field other than the
	 * field containing the identifier is first accessed.
	 * 

	 * 
The identifier field of an unloaded entity instance is
	 *     set when the unloaded instance is instantiated.
	 *     The program may obtain the identifier of an unloaded
	 *     entity, without triggering lazy fetching, by accessing
	 *     the field containing the identifier.
	 * 
Typecasts, the Java {@code instanceof} operator, and
	 *     {@link Object#getClass()} may be used as normal.
	 * 
Bytecode enhancement is required. If the class is not
	 *     enhanced, this option is equivalent to {@link #PROXY}.
	 * 
	 * 

	 * Hibernate does not support this setting for polymorphic
	 * associations, and instead falls back to {@link #PROXY}.
	 *
	 * @deprecated this setting no longer has any useful effect
	 */
	@Deprecated
	NO_PROXY
}