API_ added @TargetIdProperty, deprecated old annotations

Author: greenrobot

objectbox-java-api/src/main/java/io/objectbox/annotation/Backlink.java

@@ -12,6 +12,8 @@
  * <p>
  * Example: one "Order" references one "Customer" (to-one relation).
  * The backlink to this is a to-many in the reverse direction: one "Customer" has a number of "Order"s.
+ *
+ * Note: backlinks to to-many relations will be supported in the future.
  */
 @Retention(RetentionPolicy.CLASS)
 @Target(ElementType.FIELD)

objectbox-java-api/src/main/java/io/objectbox/annotation/Generated.java

@@ -14,6 +14,7 @@
  */
 @Retention(RetentionPolicy.CLASS)
 @Target({ElementType.FIELD, ElementType.CONSTRUCTOR, ElementType.METHOD})
+@Deprecated
 public @interface Generated {
  /** A hash to identify the generated code */
  int value() default -1;

objectbox-java-api/src/main/java/io/objectbox/annotation/Keep.java

@@ -20,5 +20,6 @@
  */
 @Retention(RetentionPolicy.CLASS)
 @Target({ElementType.FIELD, ElementType.CONSTRUCTOR, ElementType.METHOD, ElementType.TYPE})
+@Deprecated
 public @interface Keep {
 }

objectbox-java-api/src/main/java/io/objectbox/annotation/Relation.java

@@ -16,6 +16,7 @@
 @Target(ElementType.FIELD)
 @Beta
 @Temporary
+@Deprecated
 public @interface Relation {
  /**
  * Name of the property (in the source entity) holding the id (key) as a base for this to-one relation.

objectbox-java-api/src/main/java/io/objectbox/annotation/TargetIdProperty.java

@@ -0,0 +1,20 @@
+package io.objectbox.annotation;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * Defines the property serving as the target ID of a ToOne.
+ * This allows exposing an explicit property, which may be convenient for other parsers/serializers (e.g. JSON).
+ */
+@Retention(RetentionPolicy.CLASS)
+@Target({ElementType.FIELD, ElementType.TYPE})
+public @interface TargetIdProperty {
+ /**
+ * Name used in the database.
+ */
+ String value();
+
+}