org.hibernate.Incubating Maven / Gradle / Ivy

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

Hibernate's core ORM functionality

There is a newer version: 7.0.0.Beta1

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

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

import static java.lang.annotation.ElementType.CONSTRUCTOR;
import static java.lang.annotation.ElementType.PACKAGE;
import static java.lang.annotation.ElementType.METHOD;
import static java.lang.annotation.ElementType.TYPE;
import static java.lang.annotation.RetentionPolicy.CLASS;

/**
 * Annotation used to identify a package, class, interface or method
 * as "incubating", meaning it is more subject to change then normally
 * allowed based on its API/SPI distinction.
 * 
 * Generally this is a new feature that has not yet been fully vetted
 * in multiple contexts (typically 3 at a minimum).
 *
 * @author Steve Ebersole
 */
@Target({PACKAGE, TYPE, METHOD, CONSTRUCTOR})
@Retention(CLASS)
public @interface Incubating {
	/**
	 * Define the release (release family ideally) since the annotated
	 * thing has been incubating.
	 */
	String since() default "";
}