org.hibernate.envers.AuditMappedBy Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of hibernate-envers Show documentation

Hibernate's entity version (audit/history) support

There is a newer version: 7.0.0.Beta2

/*
 * 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.envers;

import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

/**
 * 
 * Annotation to specify a "fake" bi-directional relation. Such a relation uses {@code @OneToMany} +
 * {@code @JoinColumn} on the one side, and {@code @ManyToOne} + {@code @Column(insertable=false, updatable=false)} on
 * the many side. Then, Envers won't use a join table to audit this relation, but will store changes as in a normal
 * bi-directional relation.
 * 
 * 
 * This annotation is experimental and may change in future releases.
 * 
 *
 * @author Adam Warski (adam at warski dot org)
 */
@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.METHOD, ElementType.FIELD})
public @interface AuditMappedBy {
	/**
	 * Name of the property in the related entity which maps back to this entity. The property should be
	 * mapped with {@code @ManyToOne} and {@code @Column(insertable=false, updatable=false)}.
	 */
	String mappedBy();

	/**
	 * Name of the property in the related entity which maps to the position column. Should be specified only
	 * for indexed collection, when @{@link org.hibernate.annotations.IndexColumn} or
	 * {@link jakarta.persistence.OrderColumn} is used on the collection.  The property should be mapped with
	 * {@code @Column(insertable=false, updatable=false)}.
	 */
	String positionMappedBy() default "";
}