diff --git a/src/javax/persistence/Entity.java b/src/javax/persistence/Entity.java index 024df1bb5..a4bc1b912 100644 --- a/src/javax/persistence/Entity.java +++ b/src/javax/persistence/Entity.java @@ -40,4 +40,11 @@ public @interface Entity { * @return String */ String name() default ""; + + /** + * (Optional) The comment of the entity. + * + * @return String + */ + String comment() default ""; } diff --git a/src/javax/persistence/GeneratedValue.java b/src/javax/persistence/GeneratedValue.java index 0d66f074a..56056e790 100644 --- a/src/javax/persistence/GeneratedValue.java +++ b/src/javax/persistence/GeneratedValue.java @@ -1,4 +1,4 @@ -/******************************************************************************* +/** ***************************************************************************** * Copyright (c) 2008 - 2013 Oracle Corporation. All rights reserved. * * This program and the accompanying materials are made available under the @@ -12,7 +12,7 @@ * Linda DeMichiel - Java Persistence 2.1 * Linda DeMichiel - Java Persistence 2.0 * - ******************************************************************************/ + ***************************************************************************** */ package javax.persistence; import java.lang.annotation.Target; @@ -23,13 +23,14 @@ import static java.lang.annotation.RetentionPolicy.RUNTIME; /** * Provides for the specification of generation strategies for the - * values of primary keys. + * values of primary keys. * - *
The GeneratedValue annotation
+ *
+ * The GeneratedValue annotation
* may be applied to a primary key property or field of an entity or
* mapped superclass in conjunction with the {@link Id} annotation.
* The use of the GeneratedValue annotation is only
- * required to be supported for simple primary keys. Use of the
+ * required to be supported for simple primary keys. Use of the
* GeneratedValue annotation is not supported for derived
* primary keys.
*
@@ -58,22 +59,5 @@ import static java.lang.annotation.RetentionPolicy.RUNTIME;
@Retention(RUNTIME)
public @interface GeneratedValue {
- /**
- * (Optional) The primary key generation strategy
- * that the persistence provider must use to
- * generate the annotated entity primary key.
- * @return GenerationType
- */
- @Deprecated
- GenerationType strategy() default GenerationType.AUTO;
- /**
- * (Optional) The name of the primary key generator
- * to use as specified in the SequenceGenerator
- * or TableGenerator annotation.
- *
Defaults to the id generator supplied by persistence provider.
- * @return String
- */
- @Deprecated
- String generator() default "";
}
diff --git a/src/javax/persistence/GenerationType.java b/src/javax/persistence/GenerationType.java
deleted file mode 100644
index 9d1980e83..000000000
--- a/src/javax/persistence/GenerationType.java
+++ /dev/null
@@ -1,56 +0,0 @@
-/*******************************************************************************
- * Copyright (c) 2008 - 2013 Oracle Corporation. All rights reserved.
- *
- * This program and the accompanying materials are made available under the
- * terms of the Eclipse Public License v1.0 and Eclipse Distribution License v. 1.0
- * which accompanies this distribution.
- * The Eclipse Public License is available at http://www.eclipse.org/legal/epl-v10.html
- * and the Eclipse Distribution License is available at
- * http://www.eclipse.org/org/documents/edl-v10.php.
- *
- * Contributors:
- * Linda DeMichiel - Java Persistence 2.1
- * Linda DeMichiel - Java Persistence 2.0
- *
- ******************************************************************************/
-package javax.persistence;
-
-/**
- * Defines the types of primary key generation strategies.
- *
- * @see GeneratedValue
- *
- * @since Java Persistence 1.0
- */
-public enum GenerationType {
-
- /**
- * Indicates that the persistence provider must assign
- * primary keys for the entity using an underlying
- * database table to ensure uniqueness.
- */
- TABLE,
-
- /**
- * Indicates that the persistence provider must assign
- * primary keys for the entity using a database sequence.
- */
- SEQUENCE,
-
- /**
- * Indicates that the persistence provider must assign
- * primary keys for the entity using a database identity column.
- */
- IDENTITY,
-
- /**
- * Indicates that the persistence provider should pick an
- * appropriate strategy for the particular database. The
- * AUTO generation strategy may expect a database
- * resource to exist, or it may attempt to create one. A vendor
- * may provide documentation on how to create such resources
- * in the event that it does not support schema generation
- * or cannot create the schema resource at runtime.
- */
- AUTO
-}