HHH-12695 Explicitly mark contracts as @Incubating, since a comment in QueryParameter implies they are in fact incubating

I did not mark ParameterRegistration as incubating, because it's a
pre-existing interface that we can't reasonably consider as incubating.

It's a bit odd to have a non-incubating contract (ParameterRegistration)
extend an incubating one (ProcedureParameter), though...
This commit is contained in:
Yoann Rodière 2018-07-04 09:25:20 +02:00 committed by Guillaume Smet
parent a56ff4ca9c
commit a0d2f53937
3 changed files with 12 additions and 0 deletions

View File

@ -6,12 +6,16 @@
*/ */
package org.hibernate.engine.query.spi; package org.hibernate.engine.query.spi;
import org.hibernate.Incubating;
import org.hibernate.query.QueryParameter; import org.hibernate.query.QueryParameter;
import org.hibernate.type.Type; import org.hibernate.type.Type;
/** /**
* NOTE: Consider this contract (and its sub-contracts) as incubating as we transition to 6.0 and SQM
*
* @author Steve Ebersole * @author Steve Ebersole
*/ */
@Incubating
public abstract class AbstractParameterDescriptor implements QueryParameter { public abstract class AbstractParameterDescriptor implements QueryParameter {
private final int[] sourceLocations; private final int[] sourceLocations;

View File

@ -8,12 +8,16 @@ package org.hibernate.query.procedure;
import javax.persistence.ParameterMode; import javax.persistence.ParameterMode;
import org.hibernate.Incubating;
import org.hibernate.procedure.spi.ParameterRegistrationImplementor; import org.hibernate.procedure.spi.ParameterRegistrationImplementor;
import org.hibernate.query.QueryParameter; import org.hibernate.query.QueryParameter;
/** /**
* NOTE: Consider this contract (and its sub-contracts) as incubating as we transition to 6.0 and SQM
*
* @author Steve Ebersole * @author Steve Ebersole
*/ */
@Incubating
public interface ProcedureParameter<T> extends QueryParameter<T> { public interface ProcedureParameter<T> extends QueryParameter<T> {
/** /**
* Retrieves the parameter "mode". Only really pertinent in regards to procedure/function calls. * Retrieves the parameter "mode". Only really pertinent in regards to procedure/function calls.

View File

@ -6,11 +6,15 @@
*/ */
package org.hibernate.query.procedure.spi; package org.hibernate.query.procedure.spi;
import org.hibernate.Incubating;
import org.hibernate.procedure.spi.ParameterRegistrationImplementor; import org.hibernate.procedure.spi.ParameterRegistrationImplementor;
import org.hibernate.query.procedure.ProcedureParameter; import org.hibernate.query.procedure.ProcedureParameter;
/** /**
* NOTE: Consider this contract (and its sub-contracts) as incubating as we transition to 6.0 and SQM
*
* @author Steve Ebersole * @author Steve Ebersole
*/ */
@Incubating
public interface ProcedureParameterImplementor<T> extends ProcedureParameter<T>, ParameterRegistrationImplementor<T> { public interface ProcedureParameterImplementor<T> extends ProcedureParameter<T>, ParameterRegistrationImplementor<T> {
} }