actually use FunctionReturn somewhere

but mark it @Incubating, because it's very unclear we even need this interface

Author: gavinking

hibernate-core/src/main/java/org/hibernate/procedure/FunctionReturn.java

@@ -4,14 +4,23 @@
  */
 package org.hibernate.procedure;
 
+import org.hibernate.Incubating;
 import org.hibernate.query.procedure.ProcedureParameter;
 
 /**
- * Describes the function return for ProcedureCalls that represent calls to
- * a function ({@code "{? = call ...}} syntax) rather that a proc ({@code {call ...}} syntax)
+ * Describes the function return value of a {@link ProcedureCall}
+ * executed via a JDBC escape of form ({@code "{? = call ...}}.
+ * That is, the {@code ?} parameter occurring before the {@code =}.
  *
  * @author Steve Ebersole
+ *
+ * @since 6.0
  */
+@Incubating
 public interface FunctionReturn<T> extends ProcedureParameter<T> {
+	/**
+	 * The {@linkplain org.hibernate.type.SqlTypes JDBC type code}
+	 * representing the SQL type of the function return value.
+	 */
 	int getJdbcTypeCode();
 }

hibernate-core/src/main/java/org/hibernate/procedure/ProcedureCall.java

@@ -14,6 +14,7 @@
 import jakarta.persistence.StoredProcedureQuery;
 import jakarta.persistence.TemporalType;
 
+import org.hibernate.Incubating;
 import org.hibernate.MappingException;
 import org.hibernate.query.BindableType;
 import org.hibernate.query.SynchronizeableQuery;
@@ -234,6 +235,16 @@ <T> ProcedureParameter<T> registerParameter(String parameterName, BindableType<T
 	 */
 	ProcedureOutputs getOutputs();
 
+	/**
+	 * The {@link FunctionReturn} describing the return value of
+	 * the function, or {@code null} if this {@code ProcedureCall}
+	 * is not a function call.
+	 *
+	 * @since 7.0
+	 */
+	@Incubating
+	FunctionReturn<?> getFunctionReturn();
+
 	/**
 	 * Release the underlying JDBC {@link java.sql.CallableStatement}
 	 */

hibernate-core/src/main/java/org/hibernate/procedure/spi/ProcedureCallImplementor.java

@@ -32,6 +32,7 @@ default List<R> getResultList() {
 
 	ParameterStrategy getParameterStrategy();
 
+	@Override
 	FunctionReturnImplementor<R> getFunctionReturn();
 
 	@Override

hibernate-core/src/main/java/org/hibernate/query/procedure/ProcedureParameter.java

@@ -23,5 +23,4 @@ public interface ProcedureParameter<T> extends QueryParameter<T> {
 	 * @return The parameter mode.
 	 */
 	ParameterMode getMode();
-
 }