diff --git a/docs/src/main/asciidoc/hibernate-orm-panache.adoc b/docs/src/main/asciidoc/hibernate-orm-panache.adoc index 066a76ffe51ca..669db45ce2186 100644 --- a/docs/src/main/asciidoc/hibernate-orm-panache.adoc +++ b/docs/src/main/asciidoc/hibernate-orm-panache.adoc @@ -758,12 +758,12 @@ You can reference a named query instead of a (simplified) HQL query by prefixing package org.acme; import java.time.LocalDate; +import java.util.Map; import jakarta.persistence.Entity; import jakarta.persistence.NamedQueries; import jakarta.persistence.NamedQuery; import io.quarkus.hibernate.orm.panache.PanacheEntity; -import io.quarkus.panache.common.Parameters; @Entity @NamedQueries({ @@ -783,11 +783,11 @@ public class Person extends PanacheEntity { } public static long countByStatus(Status status) { - return count("#Person.countByStatus", Parameters.with("status", status).map()); + return count("#Person.countByStatus", Map.of("status", status)); } public static long updateStatusById(Status status, long id) { - return update("#Person.updateStatusById", Parameters.with("status", status).and("id", id)); + return update("#Person.updateStatusById", Map.of("status", status, "id", id)); } public static long deleteById(long id) { @@ -815,29 +815,12 @@ Or by name using a `Map`: [source,java] ---- -import java.util.HashMap; import java.util.Map; -Map params = new HashMap<>(); -params.put("name", "stef"); -params.put("status", Status.Alive); -Person.find("name = :name and status = :status", params); ----- - -Or using the convenience class `Parameters` either as is or to build a `Map`: - -[source,java] ----- -// generate a Map -Person.find("name = :name and status = :status", - Parameters.with("name", "stef").and("status", Status.Alive).map()); - -// use it as-is -Person.find("name = :name and status = :status", - Parameters.with("name", "stef").and("status", Status.Alive)); +Person.find("name = :name and status = :status", Map.of("name", "stef", "status", Status.Alive)); ---- -Every query operation accepts passing parameters by index (`Object...`), or by name (`Map` or `Parameters`). +Every query operation accepts passing parameters by index (`Object...`), or by name (`Map`). === Query projection diff --git a/docs/src/main/asciidoc/hibernate-reactive-panache.adoc b/docs/src/main/asciidoc/hibernate-reactive-panache.adoc index cba0456b934be..198e4124bf317 100644 --- a/docs/src/main/asciidoc/hibernate-reactive-panache.adoc +++ b/docs/src/main/asciidoc/hibernate-reactive-panache.adoc @@ -538,11 +538,11 @@ public class Person extends PanacheEntity { } public static Uni countByStatus(Status status) { - return count("#Person.countByStatus", Parameters.with("status", status).map()); + return count("#Person.countByStatus", Map.of("status", status); } public static Uni updateStatusById(Status status, Long id) { - return update("#Person.updateStatusById", Parameters.with("status", status).and("id", id)); + return update("#Person.updateStatusById", Map.of("status", status, "id", id)); } public static Uni deleteById(Long id) { @@ -570,26 +570,10 @@ Or by name using a `Map`: [source,java] ---- -Map params = new HashMap<>(); -params.put("name", "stef"); -params.put("status", Status.Alive); -Person.find("name = :name and status = :status", params); +Person.find("name = :name and status = :status", Map.of("name", "stef", "status", Status.Alive)); ---- -Or using the convenience class `Parameters` either as is or to build a `Map`: - -[source,java] ----- -// generate a Map -Person.find("name = :name and status = :status", - Parameters.with("name", "stef").and("status", Status.Alive).map()); - -// use it as-is -Person.find("name = :name and status = :status", - Parameters.with("name", "stef").and("status", Status.Alive)); ----- - -Every query operation accepts passing parameters by index (`Object...`), or by name (`Map` or `Parameters`). +Every query operation accepts passing parameters by index (`Object...`), or by name (`Map`). === Query projection diff --git a/docs/src/main/asciidoc/mongodb-panache.adoc b/docs/src/main/asciidoc/mongodb-panache.adoc index 0dda68727ac6b..c473235b484ea 100644 --- a/docs/src/main/asciidoc/mongodb-panache.adoc +++ b/docs/src/main/asciidoc/mongodb-panache.adoc @@ -622,27 +622,12 @@ Or by name using a `Map`: [source,java] ---- -Map params = new HashMap<>(); -params.put("name", "Loïc"); -params.put("status", Status.Alive); +Map params = Map.of("name", "Loïc", "status", Status.Alive); Person.find("name = :name and status = :status", params); Person.find("{'name': :name, 'status', :status}", params); ---- -Or using the convenience class `Parameters` either as is or to build a `Map`: - -[source,java] ----- -// generate a Map -Person.find("name = :name and status = :status", - Parameters.with("name", "Loïc").and("status", Status.Alive).map()); - -// use it as-is -Person.find("{'name': :name, 'status': :status}", - Parameters.with("name", "Loïc").and("status", Status.Alive)); ----- - -Every query operation accepts passing parameters by index (`Object...`), or by name (`Map` or `Parameters`). +Every query operation accepts passing parameters by index (`Object...`), or by name (`Map`). When you use query parameters, be careful that PanacheQL queries will refer to the Object parameters name but native queries will refer to MongoDB field names. diff --git a/extensions/panache/hibernate-orm-panache/runtime/src/main/java/io/quarkus/hibernate/orm/panache/Panache.java b/extensions/panache/hibernate-orm-panache/runtime/src/main/java/io/quarkus/hibernate/orm/panache/Panache.java index 18d85adf9eaa3..927c6fce33c46 100644 --- a/extensions/panache/hibernate-orm-panache/runtime/src/main/java/io/quarkus/hibernate/orm/panache/Panache.java +++ b/extensions/panache/hibernate-orm-panache/runtime/src/main/java/io/quarkus/hibernate/orm/panache/Panache.java @@ -113,7 +113,9 @@ public static int executeUpdate(String query, Map params) { * @param query a normal HQL query * @param params {@link Parameters} of named parameters * @return the number of rows operated on. + * @deprecated Use {@link #executeUpdate(String, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") public static int executeUpdate(String query, Parameters params) { return JpaOperations.INSTANCE.executeUpdate(query, params.map()); } diff --git a/extensions/panache/hibernate-orm-panache/runtime/src/main/java/io/quarkus/hibernate/orm/panache/PanacheEntityBase.java b/extensions/panache/hibernate-orm-panache/runtime/src/main/java/io/quarkus/hibernate/orm/panache/PanacheEntityBase.java index 3c8ae53596339..6d0f378f70104 100644 --- a/extensions/panache/hibernate-orm-panache/runtime/src/main/java/io/quarkus/hibernate/orm/panache/PanacheEntityBase.java +++ b/extensions/panache/hibernate-orm-panache/runtime/src/main/java/io/quarkus/hibernate/orm/panache/PanacheEntityBase.java @@ -85,7 +85,6 @@ public void persistAndFlush() { * @see #isPersistent() * @see #delete(String, Object...) * @see #delete(String, Map) - * @see #delete(String, Parameters) * @see #deleteAll() */ public void delete() { @@ -182,7 +181,6 @@ public static List findByIds(List ids) { * @return a new {@link PanacheQuery} instance for the given query * @see #find(String, Sort, Object...) * @see #find(String, Map) - * @see #find(String, Parameters) * @see #list(String, Object...) * @see #stream(String, Object...) */ @@ -200,7 +198,6 @@ public static PanacheQuery find(String query, O * @return a new {@link PanacheQuery} instance for the given query * @see #find(String, Object...) * @see #find(String, Sort, Map) - * @see #find(String, Sort, Parameters) * @see #list(String, Sort, Object...) * @see #stream(String, Sort, Object...) */ @@ -217,7 +214,6 @@ public static PanacheQuery find(String query, S * @return a new {@link PanacheQuery} instance for the given query * @see #find(String, Sort, Map) * @see #find(String, Object...) - * @see #find(String, Parameters) * @see #list(String, Map) * @see #stream(String, Map) */ @@ -235,7 +231,6 @@ public static PanacheQuery find(String query, M * @return a new {@link PanacheQuery} instance for the given query * @see #find(String, Map) * @see #find(String, Sort, Object...) - * @see #find(String, Sort, Parameters) * @see #list(String, Sort, Map) * @see #stream(String, Sort, Map) */ @@ -250,12 +245,10 @@ public static PanacheQuery find(String query, S * @param query a {@link io.quarkus.hibernate.orm.panache query string} * @param params {@link Parameters} of named parameters * @return a new {@link PanacheQuery} instance for the given query - * @see #find(String, Sort, Parameters) * @see #find(String, Map) - * @see #find(String, Parameters) - * @see #list(String, Parameters) - * @see #stream(String, Parameters) + * @deprecated Use {@link #find(String, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") @GenerateBridge public static PanacheQuery find(String query, Parameters params) { throw implementationInjectionMissing(); @@ -268,12 +261,10 @@ public static PanacheQuery find(String query, P * @param sort the sort strategy to use * @param params {@link Parameters} of indexed parameters * @return a new {@link PanacheQuery} instance for the given query - * @see #find(String, Parameters) * @see #find(String, Sort, Map) - * @see #find(String, Sort, Parameters) - * @see #list(String, Sort, Parameters) - * @see #stream(String, Sort, Parameters) + * @deprecated Use {@link #find(String, Sort, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") @GenerateBridge public static PanacheQuery find(String query, Sort sort, Parameters params) { throw implementationInjectionMissing(); @@ -315,7 +306,6 @@ public static PanacheQuery findAll(Sort sort) { * @return a {@link List} containing all results, without paging * @see #list(String, Sort, Object...) * @see #list(String, Map) - * @see #list(String, Parameters) * @see #find(String, Object...) * @see #stream(String, Object...) */ @@ -334,7 +324,6 @@ public static List list(String query, Object... * @return a {@link List} containing all results, without paging * @see #list(String, Object...) * @see #list(String, Sort, Map) - * @see #list(String, Sort, Parameters) * @see #find(String, Sort, Object...) * @see #stream(String, Sort, Object...) */ @@ -352,7 +341,6 @@ public static List list(String query, Sort sort * @return a {@link List} containing all results, without paging * @see #list(String, Sort, Map) * @see #list(String, Object...) - * @see #list(String, Parameters) * @see #find(String, Map) * @see #stream(String, Map) */ @@ -371,7 +359,6 @@ public static List list(String query, Map List list(String query, Sort sort * @param query a {@link io.quarkus.hibernate.orm.panache query string} * @param params {@link Parameters} of named parameters * @return a {@link List} containing all results, without paging - * @see #list(String, Sort, Parameters) * @see #list(String, Object...) * @see #list(String, Map) - * @see #find(String, Parameters) - * @see #stream(String, Parameters) + * @deprecated Use {@link #list(String, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") @GenerateBridge public static List list(String query, Parameters params) { throw implementationInjectionMissing(); @@ -406,12 +392,11 @@ public static List list(String query, Parameter * @param sort the sort strategy to use * @param params {@link Parameters} of indexed parameters * @return a {@link List} containing all results, without paging - * @see #list(String, Parameters) * @see #list(String, Sort, Object...) * @see #list(String, Sort, Map) - * @see #find(String, Sort, Parameters) - * @see #stream(String, Sort, Parameters) + * @deprecated Use {@link #list(String, Sort, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") @GenerateBridge public static List list(String query, Sort sort, Parameters params) { throw implementationInjectionMissing(); @@ -457,7 +442,6 @@ public static List listAll(Sort sort) { * @return a {@link Stream} containing all results, without paging * @see #stream(String, Sort, Object...) * @see #stream(String, Map) - * @see #stream(String, Parameters) * @see #find(String, Object...) * @see #list(String, Object...) */ @@ -478,7 +462,6 @@ public static Stream stream(String query, Objec * @return a {@link Stream} containing all results, without paging * @see #stream(String, Object...) * @see #stream(String, Sort, Map) - * @see #stream(String, Sort, Parameters) * @see #find(String, Sort, Object...) * @see #list(String, Sort, Object...) */ @@ -498,7 +481,6 @@ public static Stream stream(String query, Sort * @return a {@link Stream} containing all results, without paging * @see #stream(String, Sort, Map) * @see #stream(String, Object...) - * @see #stream(String, Parameters) * @see #find(String, Map) * @see #list(String, Map) */ @@ -519,7 +501,6 @@ public static Stream stream(String query, Map Stream stream(String query, Sort * @param query a {@link io.quarkus.hibernate.orm.panache query string} * @param params {@link Parameters} of named parameters * @return a {@link Stream} containing all results, without paging - * @see #stream(String, Sort, Parameters) * @see #stream(String, Object...) * @see #stream(String, Map) - * @see #find(String, Parameters) - * @see #list(String, Parameters) + * @deprecated Use {@link #stream(String, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") @GenerateBridge public static Stream stream(String query, Parameters params) { throw implementationInjectionMissing(); @@ -558,12 +538,11 @@ public static Stream stream(String query, Param * @param sort the sort strategy to use * @param params {@link Parameters} of indexed parameters * @return a {@link Stream} containing all results, without paging - * @see #stream(String, Parameters) * @see #stream(String, Sort, Object...) * @see #stream(String, Sort, Map) - * @see #find(String, Sort, Parameters) - * @see #list(String, Sort, Parameters) + * @deprecated Use {@link #stream(String, Sort, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") @GenerateBridge public static Stream stream(String query, Sort sort, Parameters params) { throw implementationInjectionMissing(); @@ -608,7 +587,6 @@ public static Stream streamAll(Sort sort) { * @return the number of this type of entity in the database. * @see #count(String, Object...) * @see #count(String, Map) - * @see #count(String, Parameters) */ @GenerateBridge public static long count() { @@ -623,7 +601,6 @@ public static long count() { * @return the number of entities counted. * @see #count() * @see #count(String, Map) - * @see #count(String, Parameters) */ @GenerateBridge public static long count(String query, Object... params) { @@ -638,7 +615,6 @@ public static long count(String query, Object... params) { * @return the number of entities counted. * @see #count() * @see #count(String, Object...) - * @see #count(String, Parameters) */ @GenerateBridge public static long count(String query, Map params) { @@ -654,7 +630,9 @@ public static long count(String query, Map params) { * @see #count() * @see #count(String, Object...) * @see #count(String, Map) + * @deprecated Use {@link #count(String, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") @GenerateBridge public static long count(String query, Parameters params) { throw implementationInjectionMissing(); @@ -669,7 +647,6 @@ public static long count(String query, Parameters params) { * @return the number of entities deleted. * @see #delete(String, Object...) * @see #delete(String, Map) - * @see #delete(String, Parameters) */ @GenerateBridge public static long deleteAll() { @@ -698,7 +675,6 @@ public static boolean deleteById(Object id) { * @return the number of entities deleted. * @see #deleteAll() * @see #delete(String, Map) - * @see #delete(String, Parameters) */ @GenerateBridge public static long delete(String query, Object... params) { @@ -716,7 +692,6 @@ public static long delete(String query, Object... params) { * @return the number of entities deleted. * @see #deleteAll() * @see #delete(String, Object...) - * @see #delete(String, Parameters) */ @GenerateBridge public static long delete(String query, Map params) { @@ -735,7 +710,9 @@ public static long delete(String query, Map params) { * @see #deleteAll() * @see #delete(String, Object...) * @see #delete(String, Map) + * @deprecated Use {@link #delete(String, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") @GenerateBridge public static long delete(String query, Parameters params) { throw implementationInjectionMissing(); @@ -787,7 +764,6 @@ public static void persist(Object firstEntity, Object... entities) { * @param params optional sequence of indexed parameters * @return the number of entities updated. * @see #update(String, Map) - * @see #update(String, Parameters) */ @GenerateBridge public static int update(String query, Object... params) { @@ -801,7 +777,6 @@ public static int update(String query, Object... params) { * @param params {@link Map} of named parameters * @return the number of entities updated. * @see #update(String, Object...) - * @see #update(String, Parameters) * */ @GenerateBridge @@ -817,7 +792,9 @@ public static int update(String query, Map params) { * @return the number of entities updated. * @see #update(String, Object...) * @see #update(String, Map) + * @deprecated Use {@link #update(String, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") @GenerateBridge public static int update(String query, Parameters params) { throw implementationInjectionMissing(); diff --git a/extensions/panache/hibernate-orm-panache/runtime/src/main/java/io/quarkus/hibernate/orm/panache/PanacheQuery.java b/extensions/panache/hibernate-orm-panache/runtime/src/main/java/io/quarkus/hibernate/orm/panache/PanacheQuery.java index 692d3806ffd27..e2d88c75900d4 100644 --- a/extensions/panache/hibernate-orm-panache/runtime/src/main/java/io/quarkus/hibernate/orm/panache/PanacheQuery.java +++ b/extensions/panache/hibernate-orm-panache/runtime/src/main/java/io/quarkus/hibernate/orm/panache/PanacheQuery.java @@ -197,7 +197,9 @@ public interface PanacheQuery { * @param filterName The name of the filter to enable * @param parameters The set of parameters for the filter, if the filter requires parameters * @return this query, modified + * @deprecated Use {@link #filter(String, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") public PanacheQuery filter(String filterName, Parameters parameters); /** diff --git a/extensions/panache/hibernate-orm-panache/runtime/src/main/java/io/quarkus/hibernate/orm/panache/PanacheRepositoryBase.java b/extensions/panache/hibernate-orm-panache/runtime/src/main/java/io/quarkus/hibernate/orm/panache/PanacheRepositoryBase.java index 7408df58f4dd1..9ed1ee6ea1daf 100644 --- a/extensions/panache/hibernate-orm-panache/runtime/src/main/java/io/quarkus/hibernate/orm/panache/PanacheRepositoryBase.java +++ b/extensions/panache/hibernate-orm-panache/runtime/src/main/java/io/quarkus/hibernate/orm/panache/PanacheRepositoryBase.java @@ -88,7 +88,6 @@ default void persistAndFlush(Entity entity) { * @see #isPersistent(Object) * @see #delete(String, Object...) * @see #delete(String, Map) - * @see #delete(String, Parameters) * @see #deleteAll() */ default void delete(Entity entity) { @@ -181,7 +180,6 @@ default List findByIds(List ids) { * @return a new {@link PanacheQuery} instance for the given query * @see #find(String, Sort, Object...) * @see #find(String, Map) - * @see #find(String, Parameters) * @see #list(String, Object...) * @see #stream(String, Object...) */ @@ -199,7 +197,6 @@ default PanacheQuery find(String query, Object... params) { * @return a new {@link PanacheQuery} instance for the given query * @see #find(String, Object...) * @see #find(String, Sort, Map) - * @see #find(String, Sort, Parameters) * @see #list(String, Sort, Object...) * @see #stream(String, Sort, Object...) */ @@ -216,7 +213,6 @@ default PanacheQuery find(String query, Sort sort, Object... params) { * @return a new {@link PanacheQuery} instance for the given query * @see #find(String, Sort, Map) * @see #find(String, Object...) - * @see #find(String, Parameters) * @see #list(String, Map) * @see #stream(String, Map) */ @@ -234,7 +230,6 @@ default PanacheQuery find(String query, Map params) { * @return a new {@link PanacheQuery} instance for the given query * @see #find(String, Map) * @see #find(String, Sort, Object...) - * @see #find(String, Sort, Parameters) * @see #list(String, Sort, Map) * @see #stream(String, Sort, Map) */ @@ -249,12 +244,10 @@ default PanacheQuery find(String query, Sort sort, Map p * @param query a {@link io.quarkus.hibernate.orm.panache query string} * @param params {@link Parameters} of named parameters * @return a new {@link PanacheQuery} instance for the given query - * @see #find(String, Sort, Parameters) * @see #find(String, Map) - * @see #find(String, Parameters) - * @see #list(String, Parameters) - * @see #stream(String, Parameters) + * @deprecated Use {@link #find(String, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") @GenerateBridge default PanacheQuery find(String query, Parameters params) { throw implementationInjectionMissing(); @@ -267,12 +260,10 @@ default PanacheQuery find(String query, Parameters params) { * @param sort the sort strategy to use * @param params {@link Parameters} of indexed parameters * @return a new {@link PanacheQuery} instance for the given query - * @see #find(String, Parameters) * @see #find(String, Sort, Map) - * @see #find(String, Sort, Parameters) - * @see #list(String, Sort, Parameters) - * @see #stream(String, Sort, Parameters) + * @deprecated Use {@link #find(String, Sort, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") @GenerateBridge default PanacheQuery find(String query, Sort sort, Parameters params) { throw implementationInjectionMissing(); @@ -314,7 +305,6 @@ default PanacheQuery findAll(Sort sort) { * @return a {@link List} containing all results, without paging * @see #list(String, Sort, Object...) * @see #list(String, Map) - * @see #list(String, Parameters) * @see #find(String, Object...) * @see #stream(String, Object...) */ @@ -333,7 +323,6 @@ default List list(String query, Object... params) { * @return a {@link List} containing all results, without paging * @see #list(String, Object...) * @see #list(String, Sort, Map) - * @see #list(String, Sort, Parameters) * @see #find(String, Sort, Object...) * @see #stream(String, Sort, Object...) */ @@ -351,7 +340,6 @@ default List list(String query, Sort sort, Object... params) { * @return a {@link List} containing all results, without paging * @see #list(String, Sort, Map) * @see #list(String, Object...) - * @see #list(String, Parameters) * @see #find(String, Map) * @see #stream(String, Map) */ @@ -370,7 +358,6 @@ default List list(String query, Map params) { * @return a {@link List} containing all results, without paging * @see #list(String, Map) * @see #list(String, Sort, Object...) - * @see #list(String, Sort, Parameters) * @see #find(String, Sort, Map) * @see #stream(String, Sort, Map) */ @@ -386,12 +373,11 @@ default List list(String query, Sort sort, Map params) { * @param query a {@link io.quarkus.hibernate.orm.panache query string} * @param params {@link Parameters} of named parameters * @return a {@link List} containing all results, without paging - * @see #list(String, Sort, Parameters) * @see #list(String, Object...) * @see #list(String, Map) - * @see #find(String, Parameters) - * @see #stream(String, Parameters) + * @deprecated Use {@link #list(String, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") @GenerateBridge default List list(String query, Parameters params) { throw implementationInjectionMissing(); @@ -405,12 +391,11 @@ default List list(String query, Parameters params) { * @param sort the sort strategy to use * @param params {@link Parameters} of indexed parameters * @return a {@link List} containing all results, without paging - * @see #list(String, Parameters) * @see #list(String, Sort, Object...) * @see #list(String, Sort, Map) - * @see #find(String, Sort, Parameters) - * @see #stream(String, Sort, Parameters) + * @deprecated Use {@link #list(String, Sort, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") @GenerateBridge default List list(String query, Sort sort, Parameters params) { throw implementationInjectionMissing(); @@ -456,7 +441,6 @@ default List listAll(Sort sort) { * @return a {@link Stream} containing all results, without paging * @see #stream(String, Sort, Object...) * @see #stream(String, Map) - * @see #stream(String, Parameters) * @see #find(String, Object...) * @see #list(String, Object...) */ @@ -477,7 +461,6 @@ default Stream stream(String query, Object... params) { * @return a {@link Stream} containing all results, without paging * @see #stream(String, Object...) * @see #stream(String, Sort, Map) - * @see #stream(String, Sort, Parameters) * @see #find(String, Sort, Object...) * @see #list(String, Sort, Object...) */ @@ -497,7 +480,6 @@ default Stream stream(String query, Sort sort, Object... params) { * @return a {@link Stream} containing all results, without paging * @see #stream(String, Sort, Map) * @see #stream(String, Object...) - * @see #stream(String, Parameters) * @see #find(String, Map) * @see #list(String, Map) */ @@ -518,7 +500,6 @@ default Stream stream(String query, Map params) { * @return a {@link Stream} containing all results, without paging * @see #stream(String, Map) * @see #stream(String, Sort, Object...) - * @see #stream(String, Sort, Parameters) * @see #find(String, Sort, Map) * @see #list(String, Sort, Map) */ @@ -536,12 +517,11 @@ default Stream stream(String query, Sort sort, Map param * @param query a {@link io.quarkus.hibernate.orm.panache query string} * @param params {@link Parameters} of named parameters * @return a {@link Stream} containing all results, without paging - * @see #stream(String, Sort, Parameters) * @see #stream(String, Object...) * @see #stream(String, Map) - * @see #find(String, Parameters) - * @see #list(String, Parameters) + * @deprecated Use {@link #stream(String, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") @GenerateBridge default Stream stream(String query, Parameters params) { throw implementationInjectionMissing(); @@ -557,12 +537,11 @@ default Stream stream(String query, Parameters params) { * @param sort the sort strategy to use * @param params {@link Parameters} of indexed parameters * @return a {@link Stream} containing all results, without paging - * @see #stream(String, Parameters) * @see #stream(String, Sort, Object...) * @see #stream(String, Sort, Map) - * @see #find(String, Sort, Parameters) - * @see #list(String, Sort, Parameters) + * @deprecated Use {@link #stream(String, Sort, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") @GenerateBridge default Stream stream(String query, Sort sort, Parameters params) { throw implementationInjectionMissing(); @@ -606,7 +585,6 @@ default Stream streamAll() { * @return the number of this type of entity in the database. * @see #count(String, Object...) * @see #count(String, Map) - * @see #count(String, Parameters) */ @GenerateBridge default long count() { @@ -621,7 +599,6 @@ default long count() { * @return the number of entities counted. * @see #count() * @see #count(String, Map) - * @see #count(String, Parameters) */ @GenerateBridge default long count(String query, Object... params) { @@ -636,7 +613,6 @@ default long count(String query, Object... params) { * @return the number of entities counted. * @see #count() * @see #count(String, Object...) - * @see #count(String, Parameters) */ @GenerateBridge default long count(String query, Map params) { @@ -652,7 +628,9 @@ default long count(String query, Map params) { * @see #count() * @see #count(String, Object...) * @see #count(String, Map) + * @deprecated Use {@link #count(String, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") @GenerateBridge default long count(String query, Parameters params) { throw implementationInjectionMissing(); @@ -667,7 +645,6 @@ default long count(String query, Parameters params) { * @return the number of entities deleted. * @see #delete(String, Object...) * @see #delete(String, Map) - * @see #delete(String, Parameters) */ @GenerateBridge default long deleteAll() { @@ -696,7 +673,6 @@ default boolean deleteById(Id id) { * @return the number of entities deleted. * @see #deleteAll() * @see #delete(String, Map) - * @see #delete(String, Parameters) */ @GenerateBridge default long delete(String query, Object... params) { @@ -714,7 +690,6 @@ default long delete(String query, Object... params) { * @return the number of entities deleted. * @see #deleteAll() * @see #delete(String, Object...) - * @see #delete(String, Parameters) */ @GenerateBridge default long delete(String query, Map params) { @@ -733,7 +708,9 @@ default long delete(String query, Map params) { * @see #deleteAll() * @see #delete(String, Object...) * @see #delete(String, Map) + * @deprecated Use {@link #delete(String, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") @GenerateBridge default long delete(String query, Parameters params) { throw implementationInjectionMissing(); @@ -782,7 +759,6 @@ default void persist(Entity firstEntity, @SuppressWarnings("unchecked") Entity.. * @param params optional sequence of indexed parameters * @return the number of entities updated. * @see #update(String, Map) - * @see #update(String, Parameters) */ @GenerateBridge default int update(String query, Object... params) { @@ -796,7 +772,6 @@ default int update(String query, Object... params) { * @param params {@link Map} of named parameters * @return the number of entities updated. * @see #update(String, Object...) - * @see #update(String, Parameters) */ @GenerateBridge default int update(String query, Map params) { @@ -811,7 +786,9 @@ default int update(String query, Map params) { * @return the number of entities updated. * @see #update(String, Object...) * @see #update(String, Map) + * @deprecated Use {@link #update(String, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") @GenerateBridge default int update(String query, Parameters params) { throw implementationInjectionMissing(); diff --git a/extensions/panache/hibernate-panache-next/runtime/src/main/java/io/quarkus/hibernate/panache/PanacheRepositoryQueries.java b/extensions/panache/hibernate-panache-next/runtime/src/main/java/io/quarkus/hibernate/panache/PanacheRepositoryQueries.java index 1fcc024235618..bfb9da80840c3 100644 --- a/extensions/panache/hibernate-panache-next/runtime/src/main/java/io/quarkus/hibernate/panache/PanacheRepositoryQueries.java +++ b/extensions/panache/hibernate-panache-next/runtime/src/main/java/io/quarkus/hibernate/panache/PanacheRepositoryQueries.java @@ -4,7 +4,6 @@ import jakarta.persistence.LockModeType; -import io.quarkus.panache.common.Parameters; import io.quarkus.panache.common.Sort; public interface PanacheRepositoryQueries, Count, Confirmation, Id> { @@ -36,7 +35,6 @@ public interface PanacheRepositoryQueries params); @@ -235,7 +223,6 @@ public interface PanacheRepositoryQueries params); @@ -284,7 +269,6 @@ public interface PanacheRepositoryQueries params); } diff --git a/extensions/panache/hibernate-panache-next/runtime/src/main/java/io/quarkus/hibernate/panache/blocking/PanacheRepositoryBlockingQueries.java b/extensions/panache/hibernate-panache-next/runtime/src/main/java/io/quarkus/hibernate/panache/blocking/PanacheRepositoryBlockingQueries.java index 038c2cb1dbcc4..d413b0d940601 100644 --- a/extensions/panache/hibernate-panache-next/runtime/src/main/java/io/quarkus/hibernate/panache/blocking/PanacheRepositoryBlockingQueries.java +++ b/extensions/panache/hibernate-panache-next/runtime/src/main/java/io/quarkus/hibernate/panache/blocking/PanacheRepositoryBlockingQueries.java @@ -8,7 +8,6 @@ import jakarta.persistence.LockModeType; import io.quarkus.hibernate.panache.PanacheRepositoryQueries; -import io.quarkus.panache.common.Parameters; import io.quarkus.panache.common.Sort; public interface PanacheRepositoryBlockingQueries @@ -43,7 +42,6 @@ public interface PanacheRepositoryBlockingQueries * @return a {@link Stream} containing all results, without paging * @see #stream(String, Sort, Object...) * @see #stream(String, Map) - * @see #stream(String, Parameters) * @see #find(String, Object...) * @see #list(String, Object...) */ @@ -61,7 +59,6 @@ public interface PanacheRepositoryBlockingQueries * @return a {@link Stream} containing all results, without paging * @see #stream(String, Object...) * @see #stream(String, Sort, Map) - * @see #stream(String, Sort, Parameters) * @see #find(String, Sort, Object...) * @see #list(String, Sort, Object...) */ @@ -78,7 +75,6 @@ public interface PanacheRepositoryBlockingQueries * @return a {@link Stream} containing all results, without paging * @see #stream(String, Sort, Map) * @see #stream(String, Object...) - * @see #stream(String, Parameters) * @see #find(String, Map) * @see #list(String, Map) */ @@ -96,7 +92,6 @@ public interface PanacheRepositoryBlockingQueries * @return a {@link Stream} containing all results, without paging * @see #stream(String, Map) * @see #stream(String, Sort, Object...) - * @see #stream(String, Sort, Parameters) * @see #find(String, Sort, Map) * @see #list(String, Sort, Map) */ diff --git a/extensions/panache/hibernate-panache-next/runtime/src/main/java/io/quarkus/hibernate/panache/managed/PanacheManagedEntityOperations.java b/extensions/panache/hibernate-panache-next/runtime/src/main/java/io/quarkus/hibernate/panache/managed/PanacheManagedEntityOperations.java index 142ab0eb83927..cd7373e4ab46d 100644 --- a/extensions/panache/hibernate-panache-next/runtime/src/main/java/io/quarkus/hibernate/panache/managed/PanacheManagedEntityOperations.java +++ b/extensions/panache/hibernate-panache-next/runtime/src/main/java/io/quarkus/hibernate/panache/managed/PanacheManagedEntityOperations.java @@ -8,7 +8,6 @@ import com.fasterxml.jackson.annotation.JsonIgnore; import io.quarkus.hibernate.panache.PanacheEntityMarker; -import io.quarkus.panache.common.Parameters; public interface PanacheManagedEntityOperations extends PanacheEntityMarker { /** @@ -38,7 +37,6 @@ public interface PanacheManagedEntityOperations extend * @see #isPersistent() * @see #delete(String, Object...) * @see #delete(String, Map) - * @see #delete(String, Parameters) * @see #deleteAll() */ public Completion delete(); diff --git a/extensions/panache/hibernate-panache-next/runtime/src/main/java/io/quarkus/hibernate/panache/managed/blocking/PanacheManagedBlockingEntity.java b/extensions/panache/hibernate-panache-next/runtime/src/main/java/io/quarkus/hibernate/panache/managed/blocking/PanacheManagedBlockingEntity.java index c130f6eecb17e..4f36840313e29 100644 --- a/extensions/panache/hibernate-panache-next/runtime/src/main/java/io/quarkus/hibernate/panache/managed/blocking/PanacheManagedBlockingEntity.java +++ b/extensions/panache/hibernate-panache-next/runtime/src/main/java/io/quarkus/hibernate/panache/managed/blocking/PanacheManagedBlockingEntity.java @@ -10,7 +10,6 @@ import io.quarkus.hibernate.panache.managed.PanacheManagedEntityOperations; import io.quarkus.hibernate.panache.runtime.spi.PanacheBlockingOperations; import io.quarkus.hibernate.panache.runtime.spi.PanacheOperations; -import io.quarkus.panache.common.Parameters; public interface PanacheManagedBlockingEntity extends PanacheManagedEntityOperations { @@ -51,7 +50,6 @@ public default Void persistAndFlush() { * @see #isPersistent() * @see #delete(String, Object...) * @see #delete(String, Map) - * @see #delete(String, Parameters) * @see #deleteAll() */ @Override diff --git a/extensions/panache/hibernate-panache-next/runtime/src/main/java/io/quarkus/hibernate/panache/managed/reactive/PanacheManagedReactiveEntity.java b/extensions/panache/hibernate-panache-next/runtime/src/main/java/io/quarkus/hibernate/panache/managed/reactive/PanacheManagedReactiveEntity.java index e12d953104bc2..39c315aa78664 100644 --- a/extensions/panache/hibernate-panache-next/runtime/src/main/java/io/quarkus/hibernate/panache/managed/reactive/PanacheManagedReactiveEntity.java +++ b/extensions/panache/hibernate-panache-next/runtime/src/main/java/io/quarkus/hibernate/panache/managed/reactive/PanacheManagedReactiveEntity.java @@ -10,7 +10,6 @@ import io.quarkus.hibernate.panache.managed.PanacheManagedEntityOperations; import io.quarkus.hibernate.panache.runtime.spi.PanacheOperations; import io.quarkus.hibernate.panache.runtime.spi.PanacheReactiveOperations; -import io.quarkus.panache.common.Parameters; import io.smallrye.mutiny.Uni; public interface PanacheManagedReactiveEntity extends PanacheManagedEntityOperations, Uni> { @@ -52,7 +51,6 @@ public default Uni persistAndFlush() { * @see #isPersistent() * @see #delete(String, Object...) * @see #delete(String, Map) - * @see #delete(String, Parameters) * @see #deleteAll() */ @Override diff --git a/extensions/panache/hibernate-panache-next/runtime/src/main/java/io/quarkus/hibernate/panache/stateless/blocking/PanacheStatelessBlockingEntity.java b/extensions/panache/hibernate-panache-next/runtime/src/main/java/io/quarkus/hibernate/panache/stateless/blocking/PanacheStatelessBlockingEntity.java index f65dabc70d015..aa267afa3ee36 100644 --- a/extensions/panache/hibernate-panache-next/runtime/src/main/java/io/quarkus/hibernate/panache/stateless/blocking/PanacheStatelessBlockingEntity.java +++ b/extensions/panache/hibernate-panache-next/runtime/src/main/java/io/quarkus/hibernate/panache/stateless/blocking/PanacheStatelessBlockingEntity.java @@ -6,7 +6,6 @@ import io.quarkus.hibernate.panache.runtime.spi.PanacheBlockingOperations; import io.quarkus.hibernate.panache.runtime.spi.PanacheOperations; import io.quarkus.hibernate.panache.stateless.PanacheStatelessEntityOperations; -import io.quarkus.panache.common.Parameters; public interface PanacheStatelessBlockingEntity extends PanacheStatelessEntityOperations { @@ -31,7 +30,6 @@ public default Void insert() { * * @see #delete(String, Object...) * @see #delete(String, Map) - * @see #delete(String, Parameters) * @see #deleteAll() */ @Override diff --git a/extensions/panache/hibernate-reactive-panache-kotlin/runtime/src/main/kotlin/io/quarkus/hibernate/reactive/panache/Panache.java b/extensions/panache/hibernate-reactive-panache-kotlin/runtime/src/main/kotlin/io/quarkus/hibernate/reactive/panache/Panache.java index b1eb8d4a517e3..d284726a341e9 100644 --- a/extensions/panache/hibernate-reactive-panache-kotlin/runtime/src/main/kotlin/io/quarkus/hibernate/reactive/panache/Panache.java +++ b/extensions/panache/hibernate-reactive-panache-kotlin/runtime/src/main/kotlin/io/quarkus/hibernate/reactive/panache/Panache.java @@ -119,7 +119,9 @@ public static Uni executeUpdate(String query, Map param * @param query a normal HQL query * @param params {@link Parameters} of named parameters * @return the number of rows operated on. + * @deprecated Use {@link #executeUpdate(String, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") public static Uni executeUpdate(String query, Parameters params) { return KotlinJpaOperations.INSTANCE.executeUpdate(query, params.map()); } diff --git a/extensions/panache/hibernate-reactive-panache-kotlin/runtime/src/main/kotlin/io/quarkus/hibernate/reactive/panache/kotlin/Panache.java b/extensions/panache/hibernate-reactive-panache-kotlin/runtime/src/main/kotlin/io/quarkus/hibernate/reactive/panache/kotlin/Panache.java index 2910badff4242..58fc9cd7bd8e1 100644 --- a/extensions/panache/hibernate-reactive-panache-kotlin/runtime/src/main/kotlin/io/quarkus/hibernate/reactive/panache/kotlin/Panache.java +++ b/extensions/panache/hibernate-reactive-panache-kotlin/runtime/src/main/kotlin/io/quarkus/hibernate/reactive/panache/kotlin/Panache.java @@ -112,7 +112,9 @@ public static Uni executeUpdate(String query, Map param * @param query a normal HQL query * @param params {@link Parameters} of named parameters * @return the number of rows operated on. + * @deprecated Use {@link #executeUpdate(String, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") public static Uni executeUpdate(String query, Parameters params) { return KotlinJpaOperations.INSTANCE.executeUpdate(query, params.map()); } diff --git a/extensions/panache/hibernate-reactive-panache/runtime/src/main/java/io/quarkus/hibernate/reactive/panache/Panache.java b/extensions/panache/hibernate-reactive-panache/runtime/src/main/java/io/quarkus/hibernate/reactive/panache/Panache.java index 3f7d38682da54..8d14d728dcf5f 100644 --- a/extensions/panache/hibernate-reactive-panache/runtime/src/main/java/io/quarkus/hibernate/reactive/panache/Panache.java +++ b/extensions/panache/hibernate-reactive-panache/runtime/src/main/java/io/quarkus/hibernate/reactive/panache/Panache.java @@ -112,7 +112,9 @@ public static Uni executeUpdate(String query, Map param * @param query a normal HQL query * @param params {@link Parameters} of named parameters * @return the number of rows operated on. + * @deprecated Use {@link #executeUpdate(String, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") public static Uni executeUpdate(String query, Parameters params) { return JpaOperations.INSTANCE.executeUpdate(query, params.map()); } diff --git a/extensions/panache/hibernate-reactive-panache/runtime/src/main/java/io/quarkus/hibernate/reactive/panache/PanacheEntityBase.java b/extensions/panache/hibernate-reactive-panache/runtime/src/main/java/io/quarkus/hibernate/reactive/panache/PanacheEntityBase.java index 06e7cf4f59731..251150d0be0ea 100644 --- a/extensions/panache/hibernate-reactive-panache/runtime/src/main/java/io/quarkus/hibernate/reactive/panache/PanacheEntityBase.java +++ b/extensions/panache/hibernate-reactive-panache/runtime/src/main/java/io/quarkus/hibernate/reactive/panache/PanacheEntityBase.java @@ -83,7 +83,6 @@ public Uni persistAndFlush() { * @see #isPersistent() * @see #delete(String, Object...) * @see #delete(String, Map) - * @see #delete(String, Parameters) * @see #deleteAll() */ @CheckReturnValue @@ -149,7 +148,6 @@ public static Uni findById(Object id, LockModeT * @return a new {@link PanacheQuery} instance for the given query * @see #find(String, Sort, Object...) * @see #find(String, Map) - * @see #find(String, Parameters) * @see #list(String, Object...) */ @GenerateBridge @@ -166,7 +164,6 @@ public static PanacheQuery find(String query, O * @return a new {@link PanacheQuery} instance for the given query * @see #find(String, Object...) * @see #find(String, Sort, Map) - * @see #find(String, Sort, Parameters) * @see #list(String, Sort, Object...) */ @GenerateBridge @@ -182,7 +179,6 @@ public static PanacheQuery find(String query, S * @return a new {@link PanacheQuery} instance for the given query * @see #find(String, Sort, Map) * @see #find(String, Object...) - * @see #find(String, Parameters) * @see #list(String, Map) */ @GenerateBridge @@ -199,7 +195,6 @@ public static PanacheQuery find(String query, M * @return a new {@link PanacheQuery} instance for the given query * @see #find(String, Map) * @see #find(String, Sort, Object...) - * @see #find(String, Sort, Parameters) * @see #list(String, Sort, Map) */ @GenerateBridge @@ -213,11 +208,10 @@ public static PanacheQuery find(String query, S * @param query a {@link io.quarkus.hibernate.reactive.panache query string} * @param params {@link Parameters} of named parameters * @return a new {@link PanacheQuery} instance for the given query - * @see #find(String, Sort, Parameters) * @see #find(String, Map) - * @see #find(String, Parameters) - * @see #list(String, Parameters) + * @deprecated Use {@link #find(String, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") @GenerateBridge public static PanacheQuery find(String query, Parameters params) { throw INSTANCE.implementationInjectionMissing(); @@ -230,11 +224,10 @@ public static PanacheQuery find(String query, P * @param sort the sort strategy to use * @param params {@link Parameters} of indexed parameters * @return a new {@link PanacheQuery} instance for the given query - * @see #find(String, Parameters) * @see #find(String, Sort, Map) - * @see #find(String, Sort, Parameters) - * @see #list(String, Sort, Parameters) + * @deprecated Use {@link #find(String, Sort, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") @GenerateBridge public static PanacheQuery find(String query, Sort sort, Parameters params) { throw INSTANCE.implementationInjectionMissing(); @@ -274,7 +267,6 @@ public static PanacheQuery findAll(Sort sort) { * @return a {@link List} containing all results, without paging * @see #list(String, Sort, Object...) * @see #list(String, Map) - * @see #list(String, Parameters) * @see #find(String, Object...) */ @CheckReturnValue @@ -293,7 +285,6 @@ public static Uni> list(String query, Obje * @return a {@link List} containing all results, without paging * @see #list(String, Object...) * @see #list(String, Sort, Map) - * @see #list(String, Sort, Parameters) * @see #find(String, Sort, Object...) */ @CheckReturnValue @@ -311,7 +302,6 @@ public static Uni> list(String query, Sort * @return a {@link List} containing all results, without paging * @see #list(String, Sort, Map) * @see #list(String, Object...) - * @see #list(String, Parameters) * @see #find(String, Map) */ @CheckReturnValue @@ -330,7 +320,6 @@ public static Uni> list(String query, Map< * @return a {@link List} containing all results, without paging * @see #list(String, Map) * @see #list(String, Sort, Object...) - * @see #list(String, Sort, Parameters) * @see #find(String, Sort, Map) */ @CheckReturnValue @@ -346,11 +335,11 @@ public static Uni> list(String query, Sort * @param query a {@link io.quarkus.hibernate.reactive.panache query string} * @param params {@link Parameters} of named parameters * @return a {@link List} containing all results, without paging - * @see #list(String, Sort, Parameters) * @see #list(String, Object...) * @see #list(String, Map) - * @see #find(String, Parameters) + * @deprecated Use {@link #list(String, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") @CheckReturnValue @GenerateBridge public static Uni> list(String query, Parameters params) { @@ -365,11 +354,11 @@ public static Uni> list(String query, Para * @param sort the sort strategy to use * @param params {@link Parameters} of indexed parameters * @return a {@link List} containing all results, without paging - * @see #list(String, Parameters) * @see #list(String, Sort, Object...) * @see #list(String, Sort, Map) - * @see #find(String, Sort, Parameters) + * @deprecated Use {@link #list(String, Sort, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") @CheckReturnValue @GenerateBridge public static Uni> list(String query, Sort sort, Parameters params) { @@ -411,7 +400,6 @@ public static Uni> listAll(Sort sort) { * @return the number of this type of entity in the database. * @see #count(String, Object...) * @see #count(String, Map) - * @see #count(String, Parameters) */ @CheckReturnValue @GenerateBridge @@ -427,7 +415,6 @@ public static Uni count() { * @return the number of entities counted. * @see #count() * @see #count(String, Map) - * @see #count(String, Parameters) */ @CheckReturnValue @GenerateBridge @@ -443,7 +430,6 @@ public static Uni count(String query, Object... params) { * @return the number of entities counted. * @see #count() * @see #count(String, Object...) - * @see #count(String, Parameters) */ @CheckReturnValue @GenerateBridge @@ -460,7 +446,9 @@ public static Uni count(String query, Map params) { * @see #count() * @see #count(String, Object...) * @see #count(String, Map) + * @deprecated Use {@link #count(String, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") @CheckReturnValue @GenerateBridge public static Uni count(String query, Parameters params) { @@ -476,7 +464,6 @@ public static Uni count(String query, Parameters params) { * @return the number of entities deleted. * @see #delete(String, Object...) * @see #delete(String, Map) - * @see #delete(String, Parameters) */ @CheckReturnValue @GenerateBridge @@ -507,7 +494,6 @@ public static Uni deleteById(Object id) { * @return the number of entities deleted. * @see #deleteAll() * @see #delete(String, Map) - * @see #delete(String, Parameters) */ @CheckReturnValue @GenerateBridge @@ -526,7 +512,6 @@ public static Uni delete(String query, Object... params) { * @return the number of entities deleted. * @see #deleteAll() * @see #delete(String, Object...) - * @see #delete(String, Parameters) */ @CheckReturnValue @GenerateBridge @@ -546,7 +531,9 @@ public static Uni delete(String query, Map params) { * @see #deleteAll() * @see #delete(String, Object...) * @see #delete(String, Map) + * @deprecated Use {@link #delete(String, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") @CheckReturnValue @GenerateBridge public static Uni delete(String query, Parameters params) { @@ -605,7 +592,6 @@ public static Uni persist(Object firstEntity, Object... entities) { * @param params optional sequence of indexed parameters * @return the number of entities updated. * @see #update(String, Map) - * @see #update(String, Parameters) */ @CheckReturnValue @GenerateBridge @@ -620,7 +606,6 @@ public static Uni update(String query, Object... params) { * @param params {@link Map} of named parameters * @return the number of entities updated. * @see #update(String, Object...) - * @see #update(String, Parameters) * */ @CheckReturnValue @@ -637,7 +622,9 @@ public static Uni update(String query, Map params) { * @return the number of entities updated. * @see #update(String, Object...) * @see #update(String, Map) + * @deprecated Use {@link #update(String, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") @CheckReturnValue @GenerateBridge public static Uni update(String query, Parameters params) { diff --git a/extensions/panache/hibernate-reactive-panache/runtime/src/main/java/io/quarkus/hibernate/reactive/panache/PanacheQuery.java b/extensions/panache/hibernate-reactive-panache/runtime/src/main/java/io/quarkus/hibernate/reactive/panache/PanacheQuery.java index f1b4e781c1fca..1b501a44ab9d6 100644 --- a/extensions/panache/hibernate-reactive-panache/runtime/src/main/java/io/quarkus/hibernate/reactive/panache/PanacheQuery.java +++ b/extensions/panache/hibernate-reactive-panache/runtime/src/main/java/io/quarkus/hibernate/reactive/panache/PanacheQuery.java @@ -200,7 +200,9 @@ public interface PanacheQuery { * @param filterName The name of the filter to enable * @param parameters The set of parameters for the filter, if the filter requires parameters * @return this query, modified + * @deprecated Use {@link #filter(String, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") public PanacheQuery filter(String filterName, Parameters parameters); /** diff --git a/extensions/panache/hibernate-reactive-panache/runtime/src/main/java/io/quarkus/hibernate/reactive/panache/PanacheRepositoryBase.java b/extensions/panache/hibernate-reactive-panache/runtime/src/main/java/io/quarkus/hibernate/reactive/panache/PanacheRepositoryBase.java index b6dc49b298f63..12cf2cff1e86c 100644 --- a/extensions/panache/hibernate-reactive-panache/runtime/src/main/java/io/quarkus/hibernate/reactive/panache/PanacheRepositoryBase.java +++ b/extensions/panache/hibernate-reactive-panache/runtime/src/main/java/io/quarkus/hibernate/reactive/panache/PanacheRepositoryBase.java @@ -82,7 +82,6 @@ public default Uni persistAndFlush(Entity entity) { * @see #isPersistent(Object) * @see #delete(String, Object...) * @see #delete(String, Map) - * @see #delete(String, Parameters) * @see #deleteAll() */ @CheckReturnValue @@ -147,7 +146,6 @@ public default Uni findById(Id id, LockModeType lockModeType) { * @return a new {@link PanacheQuery} instance for the given query * @see #find(String, Sort, Object...) * @see #find(String, Map) - * @see #find(String, Parameters) * @see #list(String, Object...) */ @GenerateBridge @@ -164,7 +162,6 @@ public default PanacheQuery find(String query, Object... params) { * @return a new {@link PanacheQuery} instance for the given query * @see #find(String, Object...) * @see #find(String, Sort, Map) - * @see #find(String, Sort, Parameters) * @see #list(String, Sort, Object...) */ @GenerateBridge @@ -180,7 +177,6 @@ public default PanacheQuery find(String query, Sort sort, Object... para * @return a new {@link PanacheQuery} instance for the given query * @see #find(String, Sort, Map) * @see #find(String, Object...) - * @see #find(String, Parameters) * @see #list(String, Map) */ @GenerateBridge @@ -197,7 +193,6 @@ public default PanacheQuery find(String query, Map param * @return a new {@link PanacheQuery} instance for the given query * @see #find(String, Map) * @see #find(String, Sort, Object...) - * @see #find(String, Sort, Parameters) * @see #list(String, Sort, Map) */ @GenerateBridge @@ -211,11 +206,10 @@ public default PanacheQuery find(String query, Sort sort, Map find(String query, Parameters params) { throw INSTANCE.implementationInjectionMissing(); @@ -228,11 +222,10 @@ public default PanacheQuery find(String query, Parameters params) { * @param sort the sort strategy to use * @param params {@link Parameters} of indexed parameters * @return a new {@link PanacheQuery} instance for the given query - * @see #find(String, Parameters) * @see #find(String, Sort, Map) - * @see #find(String, Sort, Parameters) - * @see #list(String, Sort, Parameters) + * @deprecated Use {@link #find(String, Sort, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") @GenerateBridge public default PanacheQuery find(String query, Sort sort, Parameters params) { throw INSTANCE.implementationInjectionMissing(); @@ -272,7 +265,6 @@ public default PanacheQuery findAll(Sort sort) { * @return a {@link List} containing all results, without paging * @see #list(String, Sort, Object...) * @see #list(String, Map) - * @see #list(String, Parameters) * @see #find(String, Object...) */ @CheckReturnValue @@ -291,7 +283,6 @@ public default Uni> list(String query, Object... params) { * @return a {@link List} containing all results, without paging * @see #list(String, Object...) * @see #list(String, Sort, Map) - * @see #list(String, Sort, Parameters) * @see #find(String, Sort, Object...) */ @CheckReturnValue @@ -309,7 +300,6 @@ public default Uni> list(String query, Sort sort, Object... params) * @return a {@link List} containing all results, without paging * @see #list(String, Sort, Map) * @see #list(String, Object...) - * @see #list(String, Parameters) * @see #find(String, Map) */ @CheckReturnValue @@ -328,7 +318,6 @@ public default Uni> list(String query, Map params) * @return a {@link List} containing all results, without paging * @see #list(String, Map) * @see #list(String, Sort, Object...) - * @see #list(String, Sort, Parameters) * @see #find(String, Sort, Map) */ @CheckReturnValue @@ -344,11 +333,11 @@ public default Uni> list(String query, Sort sort, Map> list(String query, Parameters params) { @@ -363,11 +352,11 @@ public default Uni> list(String query, Parameters params) { * @param sort the sort strategy to use * @param params {@link Parameters} of indexed parameters * @return a {@link List} containing all results, without paging - * @see #list(String, Parameters) * @see #list(String, Sort, Object...) * @see #list(String, Sort, Map) - * @see #find(String, Sort, Parameters) + * @deprecated Use {@link #list(String, Sort, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") @CheckReturnValue @GenerateBridge public default Uni> list(String query, Sort sort, Parameters params) { @@ -409,7 +398,6 @@ public default Uni> listAll(Sort sort) { * @return the number of this type of entity in the database. * @see #count(String, Object...) * @see #count(String, Map) - * @see #count(String, Parameters) */ @CheckReturnValue @GenerateBridge @@ -425,7 +413,6 @@ public default Uni count() { * @return the number of entities counted. * @see #count() * @see #count(String, Map) - * @see #count(String, Parameters) */ @CheckReturnValue @GenerateBridge @@ -441,7 +428,6 @@ public default Uni count(String query, Object... params) { * @return the number of entities counted. * @see #count() * @see #count(String, Object...) - * @see #count(String, Parameters) */ @CheckReturnValue @GenerateBridge @@ -458,7 +444,9 @@ public default Uni count(String query, Map params) { * @see #count() * @see #count(String, Object...) * @see #count(String, Map) + * @deprecated Use {@link #count(String, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") @CheckReturnValue @GenerateBridge public default Uni count(String query, Parameters params) { @@ -474,7 +462,6 @@ public default Uni count(String query, Parameters params) { * @return the number of entities deleted. * @see #delete(String, Object...) * @see #delete(String, Map) - * @see #delete(String, Parameters) */ @CheckReturnValue @GenerateBridge @@ -505,7 +492,6 @@ public default Uni deleteById(Id id) { * @return the number of entities deleted. * @see #deleteAll() * @see #delete(String, Map) - * @see #delete(String, Parameters) */ @CheckReturnValue @GenerateBridge @@ -524,7 +510,6 @@ public default Uni delete(String query, Object... params) { * @return the number of entities deleted. * @see #deleteAll() * @see #delete(String, Object...) - * @see #delete(String, Parameters) */ @CheckReturnValue @GenerateBridge @@ -544,7 +529,9 @@ public default Uni delete(String query, Map params) { * @see #deleteAll() * @see #delete(String, Object...) * @see #delete(String, Map) + * @deprecated Use {@link #delete(String, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") @CheckReturnValue @GenerateBridge public default Uni delete(String query, Parameters params) { @@ -600,7 +587,6 @@ public default Uni persist(Entity firstEntity, @SuppressWarnings("unchecke * @param params optional sequence of indexed parameters * @return the number of entities updated. * @see #update(String, Map) - * @see #update(String, Parameters) */ @CheckReturnValue @GenerateBridge @@ -615,7 +601,6 @@ public default Uni update(String query, Object... params) { * @param params {@link Map} of named parameters * @return the number of entities updated. * @see #update(String, Object...) - * @see #update(String, Parameters) */ @CheckReturnValue @GenerateBridge @@ -631,7 +616,9 @@ public default Uni update(String query, Map params) { * @return the number of entities updated. * @see #update(String, Object...) * @see #update(String, Map) + * @deprecated Use {@link #update(String, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") @CheckReturnValue @GenerateBridge public default Uni update(String query, Parameters params) { diff --git a/extensions/panache/mongodb-panache-common/runtime/src/main/java/io/quarkus/mongodb/panache/common/PanacheUpdate.java b/extensions/panache/mongodb-panache-common/runtime/src/main/java/io/quarkus/mongodb/panache/common/PanacheUpdate.java index 6e2c0c5825a1b..05192e7da0ab4 100644 --- a/extensions/panache/mongodb-panache-common/runtime/src/main/java/io/quarkus/mongodb/panache/common/PanacheUpdate.java +++ b/extensions/panache/mongodb-panache-common/runtime/src/main/java/io/quarkus/mongodb/panache/common/PanacheUpdate.java @@ -37,7 +37,9 @@ public interface PanacheUpdate { * @param query a {@link io.quarkus.mongodb.panache query string} * @param params {@link Parameters} of named parameters * @return the number of entities updated. + * @deprecated Use {@link #where(String, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") public long where(String query, Parameters params); /** diff --git a/extensions/panache/mongodb-panache-common/runtime/src/main/java/io/quarkus/mongodb/panache/common/reactive/ReactivePanacheUpdate.java b/extensions/panache/mongodb-panache-common/runtime/src/main/java/io/quarkus/mongodb/panache/common/reactive/ReactivePanacheUpdate.java index 18dc831215e5f..c7371c1157de2 100644 --- a/extensions/panache/mongodb-panache-common/runtime/src/main/java/io/quarkus/mongodb/panache/common/reactive/ReactivePanacheUpdate.java +++ b/extensions/panache/mongodb-panache-common/runtime/src/main/java/io/quarkus/mongodb/panache/common/reactive/ReactivePanacheUpdate.java @@ -37,7 +37,9 @@ public interface ReactivePanacheUpdate { * @param query a {@link io.quarkus.mongodb.panache query string} * @param params {@link Parameters} of named parameters * @return the number of entities updated. + * @deprecated Use {@link #where(String, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") public Uni where(String query, Parameters params); /** diff --git a/extensions/panache/mongodb-panache/runtime/src/main/java/io/quarkus/mongodb/panache/PanacheMongoEntityBase.java b/extensions/panache/mongodb-panache/runtime/src/main/java/io/quarkus/mongodb/panache/PanacheMongoEntityBase.java index 09522030708d9..8132b1b48adfe 100644 --- a/extensions/panache/mongodb-panache/runtime/src/main/java/io/quarkus/mongodb/panache/PanacheMongoEntityBase.java +++ b/extensions/panache/mongodb-panache/runtime/src/main/java/io/quarkus/mongodb/panache/PanacheMongoEntityBase.java @@ -63,7 +63,6 @@ public void persistOrUpdate() { * * @see #delete(String, Object...) * @see #delete(String, Map) - * @see #delete(String, Parameters) * @see #deleteAll() */ public void delete() { @@ -113,7 +112,6 @@ public static List findByIds(List ids) * @return a new {@link PanacheQuery} instance for the given query * @see #find(String, Sort, Object...) * @see #find(String, Map) - * @see #find(String, Parameters) * @see #list(String, Object...) * @see #stream(String, Object...) */ @@ -131,7 +129,6 @@ public static PanacheQuery find(String que * @return a new {@link PanacheQuery} instance for the given query * @see #find(String, Object...) * @see #find(String, Sort, Map) - * @see #find(String, Sort, Parameters) * @see #list(String, Sort, Object...) * @see #stream(String, Sort, Object...) */ @@ -148,7 +145,6 @@ public static PanacheQuery find(String que * @return a new {@link PanacheQuery} instance for the given query * @see #find(String, Sort, Map) * @see #find(String, Object...) - * @see #find(String, Parameters) * @see #list(String, Map) * @see #stream(String, Map) */ @@ -166,7 +162,6 @@ public static PanacheQuery find(String que * @return a new {@link PanacheQuery} instance for the given query * @see #find(String, Map) * @see #find(String, Sort, Object...) - * @see #find(String, Sort, Parameters) * @see #list(String, Sort, Map) * @see #stream(String, Sort, Map) */ @@ -181,12 +176,10 @@ public static PanacheQuery find(String que * @param query a {@link io.quarkus.mongodb.panache query string} * @param params {@link Parameters} of named parameters * @return a new {@link PanacheQuery} instance for the given query - * @see #find(String, Sort, Parameters) * @see #find(String, Map) - * @see #find(String, Parameters) - * @see #list(String, Parameters) - * @see #stream(String, Parameters) + * @deprecated Use {@link #find(String, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") @GenerateBridge public static PanacheQuery find(String query, Parameters params) { throw INSTANCE.implementationInjectionMissing(); @@ -199,12 +192,10 @@ public static PanacheQuery find(String que * @param sort the sort strategy to use * @param params {@link Parameters} of indexed parameters * @return a new {@link PanacheQuery} instance for the given query - * @see #find(String, Parameters) * @see #find(String, Sort, Map) - * @see #find(String, Sort, Parameters) - * @see #list(String, Sort, Parameters) - * @see #stream(String, Sort, Parameters) + * @deprecated Use {@link #find(String, Sort, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") @GenerateBridge public static PanacheQuery find(String query, Sort sort, Parameters params) { throw INSTANCE.implementationInjectionMissing(); @@ -279,7 +270,6 @@ public static PanacheQuery findAll(Sort so * @return a {@link List} containing all results, without paging * @see #list(String, Sort, Object...) * @see #list(String, Map) - * @see #list(String, Parameters) * @see #find(String, Object...) * @see #stream(String, Object...) */ @@ -298,7 +288,6 @@ public static List list(String query, Obje * @return a {@link List} containing all results, without paging * @see #list(String, Object...) * @see #list(String, Sort, Map) - * @see #list(String, Sort, Parameters) * @see #find(String, Sort, Object...) * @see #stream(String, Sort, Object...) */ @@ -316,7 +305,6 @@ public static List list(String query, Sort * @return a {@link List} containing all results, without paging * @see #list(String, Sort, Map) * @see #list(String, Object...) - * @see #list(String, Parameters) * @see #find(String, Map) * @see #stream(String, Map) */ @@ -335,7 +323,6 @@ public static List list(String query, Map< * @return a {@link List} containing all results, without paging * @see #list(String, Map) * @see #list(String, Sort, Object...) - * @see #list(String, Sort, Parameters) * @see #find(String, Sort, Map) * @see #stream(String, Sort, Map) */ @@ -351,12 +338,11 @@ public static List list(String query, Sort * @param query a {@link io.quarkus.mongodb.panache query string} * @param params {@link Parameters} of named parameters * @return a {@link List} containing all results, without paging - * @see #list(String, Sort, Parameters) * @see #list(String, Object...) * @see #list(String, Map) - * @see #find(String, Parameters) - * @see #stream(String, Parameters) + * @deprecated Use {@link #list(String, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") @GenerateBridge public static List list(String query, Parameters params) { throw INSTANCE.implementationInjectionMissing(); @@ -370,12 +356,11 @@ public static List list(String query, Para * @param sort the sort strategy to use * @param params {@link Parameters} of indexed parameters * @return a {@link List} containing all results, without paging - * @see #list(String, Parameters) * @see #list(String, Sort, Object...) * @see #list(String, Sort, Map) - * @see #find(String, Sort, Parameters) - * @see #stream(String, Sort, Parameters) + * @deprecated Use {@link #list(String, Sort, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") @GenerateBridge public static List list(String query, Sort sort, Parameters params) { throw INSTANCE.implementationInjectionMissing(); @@ -454,7 +439,6 @@ public static List listAll(Sort sort) { * @return a {@link Stream} containing all results, without paging * @see #stream(String, Sort, Object...) * @see #stream(String, Map) - * @see #stream(String, Parameters) * @see #find(String, Object...) * @see #list(String, Object...) */ @@ -473,7 +457,6 @@ public static Stream stream(String query, * @return a {@link Stream} containing all results, without paging * @see #stream(String, Object...) * @see #stream(String, Sort, Map) - * @see #stream(String, Sort, Parameters) * @see #find(String, Sort, Object...) * @see #list(String, Sort, Object...) */ @@ -491,7 +474,6 @@ public static Stream stream(String query, * @return a {@link Stream} containing all results, without paging * @see #stream(String, Sort, Map) * @see #stream(String, Object...) - * @see #stream(String, Parameters) * @see #find(String, Map) * @see #list(String, Map) */ @@ -510,7 +492,6 @@ public static Stream stream(String query, * @return a {@link Stream} containing all results, without paging * @see #stream(String, Map) * @see #stream(String, Sort, Object...) - * @see #stream(String, Sort, Parameters) * @see #find(String, Sort, Map) * @see #list(String, Sort, Map) */ @@ -526,12 +507,11 @@ public static Stream stream(String query, * @param query a {@link io.quarkus.mongodb.panache query string} * @param params {@link Parameters} of named parameters * @return a {@link Stream} containing all results, without paging - * @see #stream(String, Sort, Parameters) * @see #stream(String, Object...) * @see #stream(String, Map) - * @see #find(String, Parameters) - * @see #list(String, Parameters) + * @deprecated Use {@link #stream(String, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") @GenerateBridge public static Stream stream(String query, Parameters params) { throw INSTANCE.implementationInjectionMissing(); @@ -545,12 +525,11 @@ public static Stream stream(String query, * @param sort the sort strategy to use * @param params {@link Parameters} of indexed parameters * @return a {@link Stream} containing all results, without paging - * @see #stream(String, Parameters) * @see #stream(String, Sort, Object...) * @see #stream(String, Sort, Map) - * @see #find(String, Sort, Parameters) - * @see #list(String, Sort, Parameters) + * @deprecated Use {@link #stream(String, Sort, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") @GenerateBridge public static Stream stream(String query, Sort sort, Parameters params) { throw INSTANCE.implementationInjectionMissing(); @@ -626,7 +605,6 @@ public static Stream streamAll(Sort sort) * @return the number of this type of entity in the database. * @see #count(String, Object...) * @see #count(String, Map) - * @see #count(String, Parameters) */ @GenerateBridge public static long count() { @@ -641,7 +619,6 @@ public static long count() { * @return the number of entities counted. * @see #count() * @see #count(String, Map) - * @see #count(String, Parameters) */ @GenerateBridge public static long count(String query, Object... params) { @@ -656,7 +633,6 @@ public static long count(String query, Object... params) { * @return the number of entities counted. * @see #count() * @see #count(String, Object...) - * @see #count(String, Parameters) */ @GenerateBridge public static long count(String query, Map params) { @@ -672,7 +648,9 @@ public static long count(String query, Map params) { * @see #count() * @see #count(String, Object...) * @see #count(String, Map) + * @deprecated Use {@link #count(String, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") @GenerateBridge public static long count(String query, Parameters params) { throw INSTANCE.implementationInjectionMissing(); @@ -698,7 +676,6 @@ public static long count(Bson query) { * @return the number of entities deleted. * @see #delete(String, Object...) * @see #delete(String, Map) - * @see #delete(String, Parameters) */ @GenerateBridge public static long deleteAll() { @@ -724,7 +701,6 @@ public static boolean deleteById(Object id) { * @return the number of entities deleted. * @see #deleteAll() * @see #delete(String, Map) - * @see #delete(String, Parameters) */ @GenerateBridge public static long delete(String query, Object... params) { @@ -739,7 +715,6 @@ public static long delete(String query, Object... params) { * @return the number of entities deleted. * @see #deleteAll() * @see #delete(String, Object...) - * @see #delete(String, Parameters) */ @GenerateBridge public static long delete(String query, Map params) { @@ -755,7 +730,9 @@ public static long delete(String query, Map params) { * @see #deleteAll() * @see #delete(String, Object...) * @see #delete(String, Map) + * @deprecated Use {@link #delete(String, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") @GenerateBridge public static long delete(String query, Parameters params) { throw INSTANCE.implementationInjectionMissing(); @@ -902,7 +879,6 @@ public static void persistOrUpdate(Object firstEntity, Object... entities) { * @param params optional sequence of indexed parameters * @return a new {@link io.quarkus.mongodb.panache.common.PanacheUpdate} instance for the given update document * @see #update(String, Map) - * @see #update(String, Parameters) * @see #update(Bson) */ @GenerateBridge @@ -920,7 +896,6 @@ public static io.quarkus.mongodb.panache.common.PanacheUpdate update(String upda * @param params {@link Map} of named parameters * @return a new {@link io.quarkus.mongodb.panache.common.PanacheUpdate} instance for the given update document * @see #update(String, Object...) - * @see #update(String, Parameters) * @see #update(Bson) * */ @@ -941,7 +916,9 @@ public static io.quarkus.mongodb.panache.common.PanacheUpdate update(String upda * @see #update(String, Object...) * @see #update(String, Map) * @see #update(Bson) + * @deprecated Use {@link #update(String, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") @GenerateBridge public static io.quarkus.mongodb.panache.common.PanacheUpdate update(String update, Parameters params) { throw INSTANCE.implementationInjectionMissing(); @@ -957,7 +934,6 @@ public static io.quarkus.mongodb.panache.common.PanacheUpdate update(String upda * @return a new {@link io.quarkus.mongodb.panache.common.PanacheUpdate} instance for the given update document * @see #update(String, Object...) * @see #update(String, Map) - * @see #update(String, Parameters) */ @GenerateBridge public static io.quarkus.mongodb.panache.common.PanacheUpdate update(Bson update) { diff --git a/extensions/panache/mongodb-panache/runtime/src/main/java/io/quarkus/mongodb/panache/PanacheMongoRepositoryBase.java b/extensions/panache/mongodb-panache/runtime/src/main/java/io/quarkus/mongodb/panache/PanacheMongoRepositoryBase.java index 588462fb69f82..c9921d7b541d5 100644 --- a/extensions/panache/mongodb-panache/runtime/src/main/java/io/quarkus/mongodb/panache/PanacheMongoRepositoryBase.java +++ b/extensions/panache/mongodb-panache/runtime/src/main/java/io/quarkus/mongodb/panache/PanacheMongoRepositoryBase.java @@ -71,7 +71,6 @@ default void persistOrUpdate(Entity entity) { * @param entity the entity to delete. * @see #delete(String, Object...) * @see #delete(String, Map) - * @see #delete(String, Parameters) * @see #deleteAll() */ default void delete(Entity entity) { @@ -121,7 +120,6 @@ default List findByIds(List ids) { * @return a new {@link PanacheQuery} instance for the given query * @see #find(String, Sort, Object...) * @see #find(String, Map) - * @see #find(String, Parameters) * @see #list(String, Object...) * @see #stream(String, Object...) */ @@ -139,7 +137,6 @@ default PanacheQuery find(String query, Object... params) { * @return a new {@link PanacheQuery} instance for the given query * @see #find(String, Object...) * @see #find(String, Sort, Map) - * @see #find(String, Sort, Parameters) * @see #list(String, Sort, Object...) * @see #stream(String, Sort, Object...) */ @@ -156,7 +153,6 @@ default PanacheQuery find(String query, Sort sort, Object... params) { * @return a new {@link PanacheQuery} instance for the given query * @see #find(String, Sort, Map) * @see #find(String, Object...) - * @see #find(String, Parameters) * @see #list(String, Map) * @see #stream(String, Map) */ @@ -174,7 +170,6 @@ default PanacheQuery find(String query, Map params) { * @return a new {@link PanacheQuery} instance for the given query * @see #find(String, Map) * @see #find(String, Sort, Object...) - * @see #find(String, Sort, Parameters) * @see #list(String, Sort, Map) * @see #stream(String, Sort, Map) */ @@ -189,12 +184,10 @@ default PanacheQuery find(String query, Sort sort, Map p * @param query a {@link io.quarkus.mongodb.panache query string} * @param params {@link Parameters} of named parameters * @return a new {@link PanacheQuery} instance for the given query - * @see #find(String, Sort, Parameters) * @see #find(String, Map) - * @see #find(String, Parameters) - * @see #list(String, Parameters) - * @see #stream(String, Parameters) + * @deprecated Use {@link #find(String, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") @GenerateBridge default PanacheQuery find(String query, Parameters params) { throw INSTANCE.implementationInjectionMissing(); @@ -207,12 +200,10 @@ default PanacheQuery find(String query, Parameters params) { * @param sort the sort strategy to use * @param params {@link Parameters} of indexed parameters * @return a new {@link PanacheQuery} instance for the given query - * @see #find(String, Parameters) * @see #find(String, Sort, Map) - * @see #find(String, Sort, Parameters) - * @see #list(String, Sort, Parameters) - * @see #stream(String, Sort, Parameters) + * @deprecated Use {@link #find(String, Sort, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") @GenerateBridge default PanacheQuery find(String query, Sort sort, Parameters params) { throw INSTANCE.implementationInjectionMissing(); @@ -287,7 +278,6 @@ default PanacheQuery findAll(Sort sort) { * @return a {@link List} containing all results, without paging * @see #list(String, Sort, Object...) * @see #list(String, Map) - * @see #list(String, Parameters) * @see #find(String, Object...) * @see #stream(String, Object...) */ @@ -306,7 +296,6 @@ default List list(String query, Object... params) { * @return a {@link List} containing all results, without paging * @see #list(String, Object...) * @see #list(String, Sort, Map) - * @see #list(String, Sort, Parameters) * @see #find(String, Sort, Object...) * @see #stream(String, Sort, Object...) */ @@ -324,7 +313,6 @@ default List list(String query, Sort sort, Object... params) { * @return a {@link List} containing all results, without paging * @see #list(String, Sort, Map) * @see #list(String, Object...) - * @see #list(String, Parameters) * @see #find(String, Map) * @see #stream(String, Map) */ @@ -343,7 +331,6 @@ default List list(String query, Map params) { * @return a {@link List} containing all results, without paging * @see #list(String, Map) * @see #list(String, Sort, Object...) - * @see #list(String, Sort, Parameters) * @see #find(String, Sort, Map) * @see #stream(String, Sort, Map) */ @@ -359,12 +346,11 @@ default List list(String query, Sort sort, Map params) { * @param query a {@link io.quarkus.mongodb.panache query string} * @param params {@link Parameters} of named parameters * @return a {@link List} containing all results, without paging - * @see #list(String, Sort, Parameters) * @see #list(String, Object...) * @see #list(String, Map) - * @see #find(String, Parameters) - * @see #stream(String, Parameters) + * @deprecated Use {@link #list(String, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") @GenerateBridge default List list(String query, Parameters params) { throw INSTANCE.implementationInjectionMissing(); @@ -378,12 +364,11 @@ default List list(String query, Parameters params) { * @param sort the sort strategy to use * @param params {@link Parameters} of indexed parameters * @return a {@link List} containing all results, without paging - * @see #list(String, Parameters) * @see #list(String, Sort, Object...) * @see #list(String, Sort, Map) - * @see #find(String, Sort, Parameters) - * @see #stream(String, Sort, Parameters) + * @deprecated Use {@link #list(String, Sort, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") @GenerateBridge default List list(String query, Sort sort, Parameters params) { throw INSTANCE.implementationInjectionMissing(); @@ -462,7 +447,6 @@ default List listAll(Sort sort) { * @return a {@link Stream} containing all results, without paging * @see #stream(String, Sort, Object...) * @see #stream(String, Map) - * @see #stream(String, Parameters) * @see #find(String, Object...) * @see #list(String, Object...) */ @@ -481,7 +465,6 @@ default Stream stream(String query, Object... params) { * @return a {@link Stream} containing all results, without paging * @see #stream(String, Object...) * @see #stream(String, Sort, Map) - * @see #stream(String, Sort, Parameters) * @see #find(String, Sort, Object...) * @see #list(String, Sort, Object...) */ @@ -499,7 +482,6 @@ default Stream stream(String query, Sort sort, Object... params) { * @return a {@link Stream} containing all results, without paging * @see #stream(String, Sort, Map) * @see #stream(String, Object...) - * @see #stream(String, Parameters) * @see #find(String, Map) * @see #list(String, Map) */ @@ -518,7 +500,6 @@ default Stream stream(String query, Map params) { * @return a {@link Stream} containing all results, without paging * @see #stream(String, Map) * @see #stream(String, Sort, Object...) - * @see #stream(String, Sort, Parameters) * @see #find(String, Sort, Map) * @see #list(String, Sort, Map) */ @@ -534,12 +515,11 @@ default Stream stream(String query, Sort sort, Map param * @param query a {@link io.quarkus.mongodb.panache query string} * @param params {@link Parameters} of named parameters * @return a {@link Stream} containing all results, without paging - * @see #stream(String, Sort, Parameters) * @see #stream(String, Object...) * @see #stream(String, Map) - * @see #find(String, Parameters) - * @see #list(String, Parameters) + * @deprecated Use {@link #stream(String, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") @GenerateBridge default Stream stream(String query, Parameters params) { throw INSTANCE.implementationInjectionMissing(); @@ -553,12 +533,11 @@ default Stream stream(String query, Parameters params) { * @param sort the sort strategy to use * @param params {@link Parameters} of indexed parameters * @return a {@link Stream} containing all results, without paging - * @see #stream(String, Parameters) * @see #stream(String, Sort, Object...) * @see #stream(String, Sort, Map) - * @see #find(String, Sort, Parameters) - * @see #list(String, Sort, Parameters) + * @deprecated Use {@link #stream(String, Sort, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") @GenerateBridge default Stream stream(String query, Sort sort, Parameters params) { throw INSTANCE.implementationInjectionMissing(); @@ -633,7 +612,6 @@ default Stream streamAll() { * @return the number of this type of entity in the database. * @see #count(String, Object...) * @see #count(String, Map) - * @see #count(String, Parameters) */ @GenerateBridge default long count() { @@ -648,7 +626,6 @@ default long count() { * @return the number of entities counted. * @see #count() * @see #count(String, Map) - * @see #count(String, Parameters) */ @GenerateBridge default long count(String query, Object... params) { @@ -663,7 +640,6 @@ default long count(String query, Object... params) { * @return the number of entities counted. * @see #count() * @see #count(String, Object...) - * @see #count(String, Parameters) */ @GenerateBridge default long count(String query, Map params) { @@ -679,7 +655,9 @@ default long count(String query, Map params) { * @see #count() * @see #count(String, Object...) * @see #count(String, Map) + * @deprecated Use {@link #count(String, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") @GenerateBridge default long count(String query, Parameters params) { throw INSTANCE.implementationInjectionMissing(); @@ -705,7 +683,6 @@ default long count(Bson query) { * @return the number of entities deleted. * @see #delete(String, Object...) * @see #delete(String, Map) - * @see #delete(String, Parameters) */ @GenerateBridge default long deleteAll() { @@ -731,7 +708,6 @@ default boolean deleteById(Id id) { * @return the number of entities deleted. * @see #deleteAll() * @see #delete(String, Map) - * @see #delete(String, Parameters) */ @GenerateBridge default long delete(String query, Object... params) { @@ -746,7 +722,6 @@ default long delete(String query, Object... params) { * @return the number of entities deleted. * @see #deleteAll() * @see #delete(String, Object...) - * @see #delete(String, Parameters) */ @GenerateBridge default long delete(String query, Map params) { @@ -762,7 +737,9 @@ default long delete(String query, Map params) { * @see #deleteAll() * @see #delete(String, Object...) * @see #delete(String, Map) + * @deprecated Use {@link #delete(String, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") @GenerateBridge default long delete(String query, Parameters params) { throw INSTANCE.implementationInjectionMissing(); @@ -900,7 +877,6 @@ default void persistOrUpdate(Entity firstEntity, @SuppressWarnings("unchecked") * @param params optional sequence of indexed parameters * @return a new {@link io.quarkus.mongodb.panache.common.PanacheUpdate} instance for the given update document * @see #update(String, Map) - * @see #update(String, Parameters) * @see #update(Bson) */ @GenerateBridge @@ -918,7 +894,6 @@ default io.quarkus.mongodb.panache.common.PanacheUpdate update(String update, Ob * @param params {@link Map} of named parameters * @return a new {@link io.quarkus.mongodb.panache.common.PanacheUpdate} instance for the given update document * @see #update(String, Object...) - * @see #update(String, Parameters) * @see #update(Bson) */ @GenerateBridge @@ -938,7 +913,9 @@ default io.quarkus.mongodb.panache.common.PanacheUpdate update(String update, Ma * @see #update(String, Object...) * @see #update(String, Map) * @see #update(Bson) + * @deprecated Use {@link #update(String, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") @GenerateBridge default io.quarkus.mongodb.panache.common.PanacheUpdate update(String update, Parameters params) { throw INSTANCE.implementationInjectionMissing(); @@ -954,7 +931,6 @@ default io.quarkus.mongodb.panache.common.PanacheUpdate update(String update, Pa * @return a new {@link io.quarkus.mongodb.panache.common.PanacheUpdate} instance for the given update document * @see #update(String, Object...) * @see #update(String, Map) - * @see #update(String, Parameters) */ @GenerateBridge default io.quarkus.mongodb.panache.common.PanacheUpdate update(Bson update) { diff --git a/extensions/panache/mongodb-panache/runtime/src/main/java/io/quarkus/mongodb/panache/reactive/ReactivePanacheMongoEntityBase.java b/extensions/panache/mongodb-panache/runtime/src/main/java/io/quarkus/mongodb/panache/reactive/ReactivePanacheMongoEntityBase.java index c2d8b62688ffa..8f4eb80d94359 100644 --- a/extensions/panache/mongodb-panache/runtime/src/main/java/io/quarkus/mongodb/panache/reactive/ReactivePanacheMongoEntityBase.java +++ b/extensions/panache/mongodb-panache/runtime/src/main/java/io/quarkus/mongodb/panache/reactive/ReactivePanacheMongoEntityBase.java @@ -66,7 +66,6 @@ public Uni persistOrUpdate() { * * @see #delete(String, Object...) * @see #delete(String, Map) - * @see #delete(String, Parameters) * @see #deleteAll() */ public Uni delete() { @@ -116,7 +115,6 @@ public static Uni> findByIds( * @return a new {@link ReactivePanacheQuery} instance for the given query * @see #find(String, Sort, Object...) * @see #find(String, Map) - * @see #find(String, Parameters) * @see #list(String, Object...) * @see #stream(String, Object...) */ @@ -134,7 +132,6 @@ public static ReactivePanacheQuery * @return a new {@link ReactivePanacheQuery} instance for the given query * @see #find(String, Object...) * @see #find(String, Sort, Map) - * @see #find(String, Sort, Parameters) * @see #list(String, Sort, Object...) * @see #stream(String, Sort, Object...) */ @@ -152,7 +149,6 @@ public static ReactivePanacheQuery * @return a new {@link ReactivePanacheQuery} instance for the given query * @see #find(String, Sort, Map) * @see #find(String, Object...) - * @see #find(String, Parameters) * @see #list(String, Map) * @see #stream(String, Map) */ @@ -171,7 +167,6 @@ public static ReactivePanacheQuery * @return a new {@link ReactivePanacheQuery} instance for the given query * @see #find(String, Map) * @see #find(String, Sort, Object...) - * @see #find(String, Sort, Parameters) * @see #list(String, Sort, Map) * @see #stream(String, Sort, Map) */ @@ -187,12 +182,10 @@ public static ReactivePanacheQuery * @param query a {@link io.quarkus.mongodb.panache query string} * @param params {@link Parameters} of named parameters * @return a new {@link ReactivePanacheQuery} instance for the given query - * @see #find(String, Sort, Parameters) * @see #find(String, Map) - * @see #find(String, Parameters) - * @see #list(String, Parameters) - * @see #stream(String, Parameters) + * @deprecated Use {@link #find(String, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") @GenerateBridge public static ReactivePanacheQuery find(String query, Parameters params) { throw INSTANCE.implementationInjectionMissing(); @@ -205,12 +198,10 @@ public static ReactivePanacheQuery * @param sort the sort strategy to use * @param params {@link Parameters} of indexed parameters * @return a new {@link ReactivePanacheQuery} instance for the given query - * @see #find(String, Parameters) * @see #find(String, Sort, Map) - * @see #find(String, Sort, Parameters) - * @see #list(String, Sort, Parameters) - * @see #stream(String, Sort, Parameters) + * @deprecated Use {@link #find(String, Sort, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") @GenerateBridge public static ReactivePanacheQuery find(String query, Sort sort, Parameters params) { @@ -286,7 +277,6 @@ public static ReactivePanacheQuery * @return a {@link List} containing all results, without paging * @see #list(String, Sort, Object...) * @see #list(String, Map) - * @see #list(String, Parameters) * @see #find(String, Object...) * @see #stream(String, Object...) */ @@ -305,7 +295,6 @@ public static Uni> list(Strin * @return a {@link List} containing all results, without paging * @see #list(String, Object...) * @see #list(String, Sort, Map) - * @see #list(String, Sort, Parameters) * @see #find(String, Sort, Object...) * @see #stream(String, Sort, Object...) */ @@ -324,7 +313,6 @@ public static Uni> list(Strin * @return a {@link List} containing all results, without paging * @see #list(String, Sort, Map) * @see #list(String, Object...) - * @see #list(String, Parameters) * @see #find(String, Map) * @see #stream(String, Map) */ @@ -344,7 +332,6 @@ public static Uni> list(Strin * @return a {@link List} containing all results, without paging * @see #list(String, Map) * @see #list(String, Sort, Object...) - * @see #list(String, Sort, Parameters) * @see #find(String, Sort, Map) * @see #stream(String, Sort, Map) */ @@ -361,12 +348,11 @@ public static Uni> list(Strin * @param query a {@link io.quarkus.mongodb.panache query string} * @param params {@link Parameters} of named parameters * @return a {@link List} containing all results, without paging - * @see #list(String, Sort, Parameters) * @see #list(String, Object...) * @see #list(String, Map) - * @see #find(String, Parameters) - * @see #stream(String, Parameters) + * @deprecated Use {@link #list(String, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") @GenerateBridge public static Uni> list(String query, Parameters params) { throw INSTANCE.implementationInjectionMissing(); @@ -380,12 +366,11 @@ public static Uni> list(Strin * @param sort the sort strategy to use * @param params {@link Parameters} of indexed parameters * @return a {@link List} containing all results, without paging - * @see #list(String, Parameters) * @see #list(String, Sort, Object...) * @see #list(String, Sort, Map) - * @see #find(String, Sort, Parameters) - * @see #stream(String, Sort, Parameters) + * @deprecated Use {@link #list(String, Sort, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") @GenerateBridge public static Uni> list(String query, Sort sort, Parameters params) { @@ -465,7 +450,6 @@ public static Uni> listAll(So * @return a {@link Multi} containing all results, without paging * @see #stream(String, Sort, Object...) * @see #stream(String, Map) - * @see #stream(String, Parameters) * @see #find(String, Object...) * @see #list(String, Object...) */ @@ -484,7 +468,6 @@ public static Multi stream(String * @return a {@link Multi} containing all results, without paging * @see #stream(String, Object...) * @see #stream(String, Sort, Map) - * @see #stream(String, Sort, Parameters) * @see #find(String, Sort, Object...) * @see #list(String, Sort, Object...) */ @@ -502,7 +485,6 @@ public static Multi stream(String * @return a {@link Multi} containing all results, without paging * @see #stream(String, Sort, Map) * @see #stream(String, Object...) - * @see #stream(String, Parameters) * @see #find(String, Map) * @see #list(String, Map) */ @@ -521,7 +503,6 @@ public static Multi stream(String * @return a {@link Multi} containing all results, without paging * @see #stream(String, Map) * @see #stream(String, Sort, Object...) - * @see #stream(String, Sort, Parameters) * @see #find(String, Sort, Map) * @see #list(String, Sort, Map) */ @@ -538,12 +519,11 @@ public static Multi stream(String * @param query a {@link io.quarkus.mongodb.panache query string} * @param params {@link Parameters} of named parameters * @return a {@link Multi} containing all results, without paging - * @see #stream(String, Sort, Parameters) * @see #stream(String, Object...) * @see #stream(String, Map) - * @see #find(String, Parameters) - * @see #list(String, Parameters) + * @deprecated Use {@link #stream(String, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") @GenerateBridge public static Multi stream(String query, Parameters params) { throw INSTANCE.implementationInjectionMissing(); @@ -557,12 +537,11 @@ public static Multi stream(String * @param sort the sort strategy to use * @param params {@link Parameters} of indexed parameters * @return a {@link Multi} containing all results, without paging - * @see #stream(String, Parameters) * @see #stream(String, Sort, Object...) * @see #stream(String, Sort, Map) - * @see #find(String, Sort, Parameters) - * @see #list(String, Sort, Parameters) + * @deprecated Use {@link #stream(String, Sort, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") @GenerateBridge public static Multi stream(String query, Sort sort, Parameters params) { throw INSTANCE.implementationInjectionMissing(); @@ -574,11 +553,7 @@ public static Multi stream(String * * @param query a {@link Bson} query * @return a {@link Multi} containing all results, without paging - * @see #find(String, Parameters) * @see #find(String, Sort, Map) - * @see #find(String, Sort, Parameters) - * @see #list(String, Sort, Parameters) - * @see #stream(String, Sort, Parameters) */ @GenerateBridge public static Multi stream(Bson query) { @@ -592,11 +567,7 @@ public static Multi stream(Bson qu * @param query a {@link Bson} query * @param sort the {@link Bson} sort * @return a {@link Multi} containing all results, without paging - * @see #find(String, Parameters) * @see #find(String, Sort, Map) - * @see #find(String, Sort, Parameters) - * @see #list(String, Sort, Parameters) - * @see #stream(String, Sort, Parameters) */ @GenerateBridge public static Multi stream(Bson query, Bson sort) { @@ -638,7 +609,6 @@ public static Multi streamAll(Sort * @return the number of this type of entity in the database. * @see #count(String, Object...) * @see #count(String, Map) - * @see #count(String, Parameters) */ @GenerateBridge public static Uni count() { @@ -653,7 +623,6 @@ public static Uni count() { * @return the number of entities counted. * @see #count() * @see #count(String, Map) - * @see #count(String, Parameters) */ @GenerateBridge public static Uni count(String query, Object... params) { @@ -668,7 +637,6 @@ public static Uni count(String query, Object... params) { * @return the number of entities counted. * @see #count() * @see #count(String, Object...) - * @see #count(String, Parameters) */ @GenerateBridge public static Uni count(String query, Map params) { @@ -684,7 +652,9 @@ public static Uni count(String query, Map params) { * @see #count() * @see #count(String, Object...) * @see #count(String, Map) + * @deprecated Use {@link #count(String, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") @GenerateBridge public static Uni count(String query, Parameters params) { throw INSTANCE.implementationInjectionMissing(); @@ -710,7 +680,6 @@ public static Uni count(Bson query) { * @return the number of entities deleted. * @see #delete(String, Object...) * @see #delete(String, Map) - * @see #delete(String, Parameters) */ @GenerateBridge public static Uni deleteAll() { @@ -736,7 +705,6 @@ public static Uni deleteById(Object id) { * @return the number of entities deleted. * @see #deleteAll() * @see #delete(String, Map) - * @see #delete(String, Parameters) */ @GenerateBridge public static Uni delete(String query, Object... params) { @@ -751,7 +719,6 @@ public static Uni delete(String query, Object... params) { * @return the number of entities deleted. * @see #deleteAll() * @see #delete(String, Object...) - * @see #delete(String, Parameters) */ @GenerateBridge public static Uni delete(String query, Map params) { @@ -767,7 +734,9 @@ public static Uni delete(String query, Map params) { * @see #deleteAll() * @see #delete(String, Object...) * @see #delete(String, Map) + * @deprecated Use {@link #delete(String, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") @GenerateBridge public static Uni delete(String query, Parameters params) { throw INSTANCE.implementationInjectionMissing(); @@ -915,7 +884,6 @@ public static Uni persistOrUpdate(Object firstEntity, Object... entities) * @return a new {@link io.quarkus.mongodb.panache.common.reactive.ReactivePanacheUpdate } instance for the given update * document * @see #update(String, Map) - * @see #update(String, Parameters) * @see #update(Bson) */ @GenerateBridge @@ -934,7 +902,6 @@ public static io.quarkus.mongodb.panache.common.reactive.ReactivePanacheUpdate u * @return a new {@link io.quarkus.mongodb.panache.common.reactive.ReactivePanacheUpdate } instance for the given update * document * @see #update(String, Object...) - * @see #update(String, Parameters) * @see #update(Bson) */ @GenerateBridge @@ -956,7 +923,9 @@ public static io.quarkus.mongodb.panache.common.reactive.ReactivePanacheUpdate u * @see #update(String, Object...) * @see #update(String, Map) * @see #update(Bson) + * @deprecated Use {@link #update(String, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") @GenerateBridge public static io.quarkus.mongodb.panache.common.reactive.ReactivePanacheUpdate update(String update, Parameters params) { throw INSTANCE.implementationInjectionMissing(); @@ -972,7 +941,6 @@ public static io.quarkus.mongodb.panache.common.reactive.ReactivePanacheUpdate u * document * @see #update(String, Object...) * @see #update(String, Map) - * @see #update(String, Parameters) */ @GenerateBridge public static io.quarkus.mongodb.panache.common.reactive.ReactivePanacheUpdate update(Bson update) { diff --git a/extensions/panache/mongodb-panache/runtime/src/main/java/io/quarkus/mongodb/panache/reactive/ReactivePanacheMongoRepositoryBase.java b/extensions/panache/mongodb-panache/runtime/src/main/java/io/quarkus/mongodb/panache/reactive/ReactivePanacheMongoRepositoryBase.java index 2f77315b48b9b..b09ae65c1ec61 100644 --- a/extensions/panache/mongodb-panache/runtime/src/main/java/io/quarkus/mongodb/panache/reactive/ReactivePanacheMongoRepositoryBase.java +++ b/extensions/panache/mongodb-panache/runtime/src/main/java/io/quarkus/mongodb/panache/reactive/ReactivePanacheMongoRepositoryBase.java @@ -72,7 +72,6 @@ default Uni persistOrUpdate(Entity entity) { * @param entity the entity to delete. * @see #delete(String, Object...) * @see #delete(String, Map) - * @see #delete(String, Parameters) * @see #deleteAll() */ default Uni delete(Entity entity) { @@ -122,7 +121,6 @@ default Uni> findByIds(List ids) { * @return a new {@link ReactivePanacheQuery} instance for the given query * @see #find(String, Sort, Object...) * @see #find(String, Map) - * @see #find(String, Parameters) * @see #list(String, Object...) * @see #stream(String, Object...) */ @@ -140,7 +138,6 @@ default ReactivePanacheQuery find(String query, Object... params) { * @return a new {@link ReactivePanacheQuery} instance for the given query * @see #find(String, Object...) * @see #find(String, Sort, Map) - * @see #find(String, Sort, Parameters) * @see #list(String, Sort, Object...) * @see #stream(String, Sort, Object...) */ @@ -157,7 +154,6 @@ default ReactivePanacheQuery find(String query, Sort sort, Object... par * @return a new {@link ReactivePanacheQuery} instance for the given query * @see #find(String, Sort, Map) * @see #find(String, Object...) - * @see #find(String, Parameters) * @see #list(String, Map) * @see #stream(String, Map) */ @@ -175,7 +171,6 @@ default ReactivePanacheQuery find(String query, Map para * @return a new {@link ReactivePanacheQuery} instance for the given query * @see #find(String, Map) * @see #find(String, Sort, Object...) - * @see #find(String, Sort, Parameters) * @see #list(String, Sort, Map) * @see #stream(String, Sort, Map) */ @@ -190,12 +185,10 @@ default ReactivePanacheQuery find(String query, Sort sort, Map find(String query, Parameters params) { throw INSTANCE.implementationInjectionMissing(); @@ -208,12 +201,10 @@ default ReactivePanacheQuery find(String query, Parameters params) { * @param sort the sort strategy to use * @param params {@link Parameters} of indexed parameters * @return a new {@link ReactivePanacheQuery} instance for the given query - * @see #find(String, Parameters) * @see #find(String, Sort, Map) - * @see #find(String, Sort, Parameters) - * @see #list(String, Sort, Parameters) - * @see #stream(String, Sort, Parameters) + * @deprecated Use {@link #find(String, Sort, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") @GenerateBridge default ReactivePanacheQuery find(String query, Sort sort, Parameters params) { throw INSTANCE.implementationInjectionMissing(); @@ -288,7 +279,6 @@ default ReactivePanacheQuery findAll(Sort sort) { * @return a {@link List} containing all results, without paging * @see #list(String, Sort, Object...) * @see #list(String, Map) - * @see #list(String, Parameters) * @see #find(String, Object...) * @see #stream(String, Object...) */ @@ -307,7 +297,6 @@ default Uni> list(String query, Object... params) { * @return a {@link List} containing all results, without paging * @see #list(String, Object...) * @see #list(String, Sort, Map) - * @see #list(String, Sort, Parameters) * @see #find(String, Sort, Object...) * @see #stream(String, Sort, Object...) */ @@ -325,7 +314,6 @@ default Uni> list(String query, Sort sort, Object... params) { * @return a {@link List} containing all results, without paging * @see #list(String, Sort, Map) * @see #list(String, Object...) - * @see #list(String, Parameters) * @see #find(String, Map) * @see #stream(String, Map) */ @@ -344,7 +332,6 @@ default Uni> list(String query, Map params) { * @return a {@link List} containing all results, without paging * @see #list(String, Map) * @see #list(String, Sort, Object...) - * @see #list(String, Sort, Parameters) * @see #find(String, Sort, Map) * @see #stream(String, Sort, Map) */ @@ -360,12 +347,11 @@ default Uni> list(String query, Sort sort, Map para * @param query a {@link io.quarkus.mongodb.panache query string} * @param params {@link Parameters} of named parameters * @return a {@link List} containing all results, without paging - * @see #list(String, Sort, Parameters) * @see #list(String, Object...) * @see #list(String, Map) - * @see #find(String, Parameters) - * @see #stream(String, Parameters) + * @deprecated Use {@link #list(String, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") @GenerateBridge default Uni> list(String query, Parameters params) { throw INSTANCE.implementationInjectionMissing(); @@ -379,12 +365,11 @@ default Uni> list(String query, Parameters params) { * @param sort the sort strategy to use * @param params {@link Parameters} of indexed parameters * @return a {@link List} containing all results, without paging - * @see #list(String, Parameters) * @see #list(String, Sort, Object...) * @see #list(String, Sort, Map) - * @see #find(String, Sort, Parameters) - * @see #stream(String, Sort, Parameters) + * @deprecated Use {@link #list(String, Sort, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") @GenerateBridge default Uni> list(String query, Sort sort, Parameters params) { throw INSTANCE.implementationInjectionMissing(); @@ -463,7 +448,6 @@ default Uni> listAll(Sort sort) { * @return a {@link Multi} containing all results, without paging * @see #stream(String, Sort, Object...) * @see #stream(String, Map) - * @see #stream(String, Parameters) * @see #find(String, Object...) * @see #list(String, Object...) */ @@ -482,7 +466,6 @@ default Multi stream(String query, Object... params) { * @return a {@link Multi} containing all results, without paging * @see #stream(String, Object...) * @see #stream(String, Sort, Map) - * @see #stream(String, Sort, Parameters) * @see #find(String, Sort, Object...) * @see #list(String, Sort, Object...) */ @@ -500,7 +483,6 @@ default Multi stream(String query, Sort sort, Object... params) { * @return a {@link Multi} containing all results, without paging * @see #stream(String, Sort, Map) * @see #stream(String, Object...) - * @see #stream(String, Parameters) * @see #find(String, Map) * @see #list(String, Map) */ @@ -519,7 +501,6 @@ default Multi stream(String query, Map params) { * @return a {@link Multi} containing all results, without paging * @see #stream(String, Map) * @see #stream(String, Sort, Object...) - * @see #stream(String, Sort, Parameters) * @see #find(String, Sort, Map) * @see #list(String, Sort, Map) */ @@ -535,12 +516,11 @@ default Multi stream(String query, Sort sort, Map params * @param query a {@link io.quarkus.mongodb.panache query string} * @param params {@link Parameters} of named parameters * @return a {@link Multi} containing all results, without paging - * @see #stream(String, Sort, Parameters) * @see #stream(String, Object...) * @see #stream(String, Map) - * @see #find(String, Parameters) - * @see #list(String, Parameters) + * @deprecated Use {@link #stream(String, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") @GenerateBridge default Multi stream(String query, Parameters params) { throw INSTANCE.implementationInjectionMissing(); @@ -554,12 +534,11 @@ default Multi stream(String query, Parameters params) { * @param sort the sort strategy to use * @param params {@link Parameters} of indexed parameters * @return a {@link Multi} containing all results, without paging - * @see #stream(String, Parameters) * @see #stream(String, Sort, Object...) * @see #stream(String, Sort, Map) - * @see #find(String, Sort, Parameters) - * @see #list(String, Sort, Parameters) + * @deprecated Use {@link #stream(String, Sort, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") @GenerateBridge default Multi stream(String query, Sort sort, Parameters params) { throw INSTANCE.implementationInjectionMissing(); @@ -636,7 +615,6 @@ default Multi streamAll() { * @return the number of this type of entity in the database. * @see #count(String, Object...) * @see #count(String, Map) - * @see #count(String, Parameters) */ @GenerateBridge default Uni count() { @@ -651,7 +629,6 @@ default Uni count() { * @return the number of entities counted. * @see #count() * @see #count(String, Map) - * @see #count(String, Parameters) */ @GenerateBridge default Uni count(String query, Object... params) { @@ -666,7 +643,6 @@ default Uni count(String query, Object... params) { * @return the number of entities counted. * @see #count() * @see #count(String, Object...) - * @see #count(String, Parameters) */ @GenerateBridge default Uni count(String query, Map params) { @@ -682,7 +658,9 @@ default Uni count(String query, Map params) { * @see #count() * @see #count(String, Object...) * @see #count(String, Map) + * @deprecated Use {@link #count(String, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") @GenerateBridge default Uni count(String query, Parameters params) { throw INSTANCE.implementationInjectionMissing(); @@ -708,7 +686,6 @@ default Uni count(Bson query) { * @return the number of entities deleted. * @see #delete(String, Object...) * @see #delete(String, Map) - * @see #delete(String, Parameters) */ @GenerateBridge default Uni deleteAll() { @@ -734,7 +711,6 @@ default Uni deleteById(Id id) { * @return the number of entities deleted. * @see #deleteAll() * @see #delete(String, Map) - * @see #delete(String, Parameters) */ @GenerateBridge default Uni delete(String query, Object... params) { @@ -749,7 +725,6 @@ default Uni delete(String query, Object... params) { * @return the number of entities deleted. * @see #deleteAll() * @see #delete(String, Object...) - * @see #delete(String, Parameters) */ @GenerateBridge default Uni delete(String query, Map params) { @@ -765,7 +740,9 @@ default Uni delete(String query, Map params) { * @see #deleteAll() * @see #delete(String, Object...) * @see #delete(String, Map) + * @deprecated Use {@link #delete(String, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") @GenerateBridge default Uni delete(String query, Parameters params) { throw INSTANCE.implementationInjectionMissing(); @@ -904,7 +881,6 @@ default Uni persistOrUpdate(Entity firstEntity, Entity... entities) { * @return a new {@link io.quarkus.mongodb.panache.common.reactive.ReactivePanacheUpdate } instance for the given update * document * @see #update(String, Map) - * @see #update(String, Parameters) */ @GenerateBridge default io.quarkus.mongodb.panache.common.reactive.ReactivePanacheUpdate update(String update, Object... params) { @@ -922,7 +898,6 @@ default io.quarkus.mongodb.panache.common.reactive.ReactivePanacheUpdate update( * @return a new {@link io.quarkus.mongodb.panache.common.reactive.ReactivePanacheUpdate } instance for the given update * document * @see #update(String, Object...) - * @see #update(String, Parameters) * */ @GenerateBridge @@ -942,7 +917,9 @@ default io.quarkus.mongodb.panache.common.reactive.ReactivePanacheUpdate update( * document * @see #update(String, Object...) * @see #update(String, Map) + * @deprecated Use {@link #update(String, Map)} with {@link Map#of()} */ + @Deprecated(since = "3.34") @GenerateBridge default io.quarkus.mongodb.panache.common.reactive.ReactivePanacheUpdate update(String update, Parameters params) { throw INSTANCE.implementationInjectionMissing(); @@ -959,7 +936,6 @@ default io.quarkus.mongodb.panache.common.reactive.ReactivePanacheUpdate update( * document * @see #update(String, Object...) * @see #update(String, Map) - * @see #update(String, Parameters) */ @GenerateBridge default io.quarkus.mongodb.panache.common.reactive.ReactivePanacheUpdate update(Bson update) { diff --git a/extensions/panache/panache-common/runtime/src/main/java/io/quarkus/panache/common/Parameters.java b/extensions/panache/panache-common/runtime/src/main/java/io/quarkus/panache/common/Parameters.java index 574b240aa319f..2376dfb0f075e 100644 --- a/extensions/panache/panache-common/runtime/src/main/java/io/quarkus/panache/common/Parameters.java +++ b/extensions/panache/panache-common/runtime/src/main/java/io/quarkus/panache/common/Parameters.java @@ -21,7 +21,9 @@ * * * @author Stéphane Épardaud + * @deprecated Use {@link Map#of()} */ +@Deprecated(since = "3.34") public class Parameters { private final Map values = new HashMap<>(); @@ -32,7 +34,9 @@ public class Parameters { * @param value value of the parameter to add * @return this instance, modified. * @see {@link Parameters#map()} + * @deprecated Use {@link Map#of(Object, Object)} */ + @Deprecated(since = "3.34") public Parameters and(String name, Object value) { values.put(name, value); return this; @@ -42,7 +46,9 @@ public Parameters and(String name, Object value) { * Constructs an unmodifiable {@link Map} with the current parameters. * * @return an unmodifiable {@link Map} with the current parameters. + * @deprecated Use {@link Map#of(Object, Object)} */ + @Deprecated(since = "3.34") public Map map() { return Collections.unmodifiableMap(values); } @@ -55,7 +61,9 @@ public Map map() { * @return a {@link Parameters} with a single parameter. * @see {@link Parameters#and(String, Object)} * @see {@link Parameters#map()} + * @deprecated Use {@link Map#of(Object, Object)} */ + @Deprecated(since = "3.34") public static Parameters with(String name, Object value) { return new Parameters().and(name, value); }