NativeQuery support

- javadoc

design/6.0-changes.adoc

@@ -9,7 +9,9 @@ Document in release-notes:
 
 * `@SqlTypeCode`
 * `@SqlType`
+* `@SqlTypeRegistration`
 * `@JavaType`
+* `@JavaTypeRegistration`
 * `NativeQuery#addScalar(Class)`
 * `NativeQuery#addScalar(Class,AttributeConverter)`
 * `NativeQuery#addScalar(Class,Class<AttributeConverter>)`

hibernate-core/src/main/java/org/hibernate/annotations/JavaType.java

@@ -17,7 +17,11 @@ import static java.lang.annotation.ElementType.METHOD;
 import static java.lang.annotation.RetentionPolicy.RUNTIME;
 
 /**
+ * Explicit BasicJavaDescriptor for the associated attribute
+ *
  * @author Steve Ebersole
+ *
+ * @since 6.0
  */
 @Inherited
 @java.lang.annotation.Target({METHOD, FIELD, ANNOTATION_TYPE})

hibernate-core/src/main/java/org/hibernate/annotations/JavaTypeRegistration.java

@@ -11,7 +11,6 @@ import java.lang.annotation.Repeatable;
 import java.lang.annotation.Retention;
 
 import org.hibernate.type.descriptor.java.BasicJavaDescriptor;
-import org.hibernate.type.descriptor.java.JavaTypeDescriptor;
 
 import static java.lang.annotation.ElementType.ANNOTATION_TYPE;
 import static java.lang.annotation.ElementType.PACKAGE;
@@ -19,7 +18,11 @@ import static java.lang.annotation.ElementType.TYPE;
 import static java.lang.annotation.RetentionPolicy.RUNTIME;
 
 /**
+ * Registers the BasicJavaDescriptor to use for the given {@link #javaType}
+ *
  * @author Steve Ebersole
+ *
+ * @since 6.0
  */
 @java.lang.annotation.Target({PACKAGE, TYPE, ANNOTATION_TYPE})
 @Inherited

hibernate-core/src/main/java/org/hibernate/annotations/JavaTypeRegistrations.java

@@ -15,7 +15,11 @@ import static java.lang.annotation.ElementType.TYPE;
 import static java.lang.annotation.RetentionPolicy.RUNTIME;
 
 /**
+ * Grouping of {@link JavaTypeRegistration}
+ *
  * @author Steve Ebersole
+ *
+ * @since 6.0
  */
 @java.lang.annotation.Target({PACKAGE, TYPE, ANNOTATION_TYPE})
 @Inherited

hibernate-core/src/main/java/org/hibernate/annotations/MapKeyJavaType.java

@@ -15,7 +15,12 @@ import static java.lang.annotation.ElementType.METHOD;
 import static java.lang.annotation.RetentionPolicy.RUNTIME;
 
 /**
+ * Same function as {@link JavaType}, but used to define the Java type descriptor to
+ * use for the map-key
+ *
  * @author Steve Ebersole
+ *
+ * @since 6.0
  */
 @java.lang.annotation.Target({METHOD, FIELD, ANNOTATION_TYPE})
 @Inherited

hibernate-core/src/main/java/org/hibernate/annotations/MapKeySqlType.java

@@ -19,6 +19,8 @@ import static java.lang.annotation.RetentionPolicy.RUNTIME;
  * use for the map-key
  *
  * @author Steve Ebersole
+ *
+ * @since 6.0
  */
 @java.lang.annotation.Target({METHOD, FIELD, ANNOTATION_TYPE})
 @Inherited

hibernate-core/src/main/java/org/hibernate/annotations/MapKeySqlTypeCode.java

@@ -19,6 +19,8 @@ import static java.lang.annotation.RetentionPolicy.RUNTIME;
  * use for the map-key
  *
  * @author Steve Ebersole
+ *
+ * @since 6.0
  */
 @java.lang.annotation.Target({METHOD, FIELD, ANNOTATION_TYPE})
 @Inherited

hibernate-core/src/main/java/org/hibernate/annotations/SqlType.java

@@ -41,6 +41,8 @@ import static java.lang.annotation.RetentionPolicy.RUNTIME;
  * @see org.hibernate.type.descriptor.sql.spi.SqlTypeDescriptorRegistry
  *
  * @author Steve Ebersole
+ *
+ * @since 6.0
  */
 @java.lang.annotation.Target({METHOD, FIELD, ANNOTATION_TYPE})
 @Inherited

hibernate-core/src/main/java/org/hibernate/annotations/SqlTypeCode.java

@@ -53,6 +53,8 @@ import static java.lang.annotation.RetentionPolicy.RUNTIME;
  * @see SqlTypeRegistration
  *
  * @author Steve Ebersole
+ *
+ * @since 6.0
  */
 @java.lang.annotation.Target({METHOD, FIELD, ANNOTATION_TYPE})
 @Inherited

hibernate-core/src/main/java/org/hibernate/annotations/SqlTypeRegistration.java

@@ -13,8 +13,6 @@ import java.lang.annotation.Retention;
 import org.hibernate.type.descriptor.sql.SqlTypeDescriptor;
 
 import static java.lang.annotation.ElementType.ANNOTATION_TYPE;
-import static java.lang.annotation.ElementType.FIELD;
-import static java.lang.annotation.ElementType.METHOD;
 import static java.lang.annotation.ElementType.PACKAGE;
 import static java.lang.annotation.ElementType.TYPE;
 import static java.lang.annotation.RetentionPolicy.RUNTIME;
@@ -24,6 +22,8 @@ import static java.lang.annotation.RetentionPolicy.RUNTIME;
  * {@link org.hibernate.type.descriptor.sql.spi.SqlTypeDescriptorRegistry}
  *
  * @author Steve Ebersole
+ *
+ * @since 6.0
  */
 @java.lang.annotation.Target({PACKAGE, TYPE, ANNOTATION_TYPE})
 @Inherited

hibernate-core/src/main/java/org/hibernate/annotations/SqlTypeRegistrations.java

@@ -15,7 +15,11 @@ import static java.lang.annotation.ElementType.TYPE;
 import static java.lang.annotation.RetentionPolicy.RUNTIME;
 
 /**
+ * Grouping of {@link SqlTypeRegistration}
+ *
  * @author Steve Ebersole
+ *
+ * @since 6.0
  */
 @java.lang.annotation.Target({PACKAGE, TYPE, ANNOTATION_TYPE})
 @Inherited