Merge branch '279-remove-deprecated-apis' into 'dev'

Remove some deprecated APIs #279

See merge request objectbox/objectbox-java!162

Author: greenrobot-team

CHANGELOG.md

@@ -12,6 +12,14 @@ For more insights into what changed in the ObjectBox C++ core, [check the Object
 - When using `BoxStoreBuilder.buildDefault()`, don't leak Store when setting as default fails.
 - To help diagnose, print stacks of all threads in the internal thread pool if shutting it down takes too long when
   closing `BoxStore`.
+- Remove deprecated `Query.setParameters` methods that set a single parameter, use the `setParameter` methods instead.
+- Remove deprecated `Box.removeByKeys`, use `Box.removeByIds` instead.
+- Remove deprecated `BoxStore.sizeOnDisk`, use `getDbSize` or `getDbSizeOnDisk` instead which properly handle in-memory databases.
+- Remove deprecated `BoxStoreBuilder.debugTransactions`, use `debugFlags(DebugFlags.LOG_TRANSACTIONS_READ | DebugFlags.LOG_TRANSACTIONS_WRITE)` instead.
+- Remove deprecated `SyncServerBuilder` `peer` configuration options, use the `clusterPeer` options instead.
+- Remove deprecated `io.objectbox.DebugFlags`, use `io.objectbox.config.DebugFlags` instead.
+- Remove deprecated `ValidateOnOpenMode` constants, use `ValidateOnOpenModePages` instead.
+- Remove deprecated DAOcompat compatibility query methods. Use the regular query API instead.           
 
 ## 4.3.1 - 2025-08-12
 

objectbox-java/src/main/java/io/objectbox/Box.java

@@ -485,14 +485,6 @@ public void remove(@Nullable long... ids) {
         }
     }
 
-    /**
-     * @deprecated use {@link #removeByIds(Collection)} instead.
-     */
-    @Deprecated
-    public void removeByKeys(@Nullable Collection<Long> ids) {
-        removeByIds(ids);
-    }
-
     /**
      * Like {@link #remove(long)}, but removes multiple objects in a single transaction.
      */

objectbox-java/src/main/java/io/objectbox/BoxStore.java

@@ -513,17 +513,6 @@ public static long sysProcStatusKb(String key) {
         return nativeSysProcStatusKb(key);
     }
 
-    /**
-     * The size in bytes occupied by the data file on disk.
-     *
-     * @return 0 if the size could not be determined (does not throw unless this store was already closed)
-     * @deprecated Use {@link #getDbSize()} or {@link #getDbSizeOnDisk()} instead which properly handle in-memory databases.
-     */
-    @Deprecated
-    public long sizeOnDisk() {
-        return getDbSize();
-    }
-
     /**
      * Get the size of this store. For a disk-based store type, this corresponds to the size on disk, and for the
      * in-memory store type, this is roughly the used memory bytes occupied by the data.

objectbox-java/src/main/java/io/objectbox/BoxStoreBuilder.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2017-2024 ObjectBox Ltd.
+ * Copyright 2017-2025 ObjectBox Ltd.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -512,15 +512,6 @@ public BoxStoreBuilder validateOnOpenKv(short mode) {
         return this;
     }
 
-    /**
-     * @deprecated Use {@link #debugFlags} instead.
-     */
-    @Deprecated
-    public BoxStoreBuilder debugTransactions() {
-        this.debugFlags |= DebugFlags.LOG_TRANSACTIONS_READ | DebugFlags.LOG_TRANSACTIONS_WRITE;
-        return this;
-    }
-
     /**
      * Debug flags typically enable additional logging, see {@link DebugFlags} for valid values.
      * <p>

objectbox-java/src/main/java/io/objectbox/DebugFlags.java

@@ -17,7 +17,6 @@
 package io.objectbox;
 
 import java.io.Serializable;
-import java.util.Collection;
 import java.util.Date;
 
 import javax.annotation.Nullable;
@@ -39,9 +38,9 @@
 import io.objectbox.query.PropertyQueryConditionImpl.StringArrayCondition;
 import io.objectbox.query.PropertyQueryConditionImpl.StringCondition;
 import io.objectbox.query.PropertyQueryConditionImpl.StringCondition.Operation;
-import io.objectbox.query.PropertyQueryConditionImpl.StringStringCondition;
-import io.objectbox.query.PropertyQueryConditionImpl.StringLongCondition;
 import io.objectbox.query.PropertyQueryConditionImpl.StringDoubleCondition;
+import io.objectbox.query.PropertyQueryConditionImpl.StringLongCondition;
+import io.objectbox.query.PropertyQueryConditionImpl.StringStringCondition;
 import io.objectbox.query.Query;
 import io.objectbox.query.QueryBuilder.StringOrder;
 
@@ -721,133 +720,6 @@ public PropertyQueryCondition<ENTITY> lessOrEqual(byte[] value) {
         return new ByteArrayCondition<>(this, ByteArrayCondition.Operation.LESS_OR_EQUAL, value);
     }
 
-    //////
-    // Note: The following are deprecated conditions used with DAOcompat only.
-    // They exist so library users need not update their code where new conditions are named differently.
-    //////
-
-    /**
-     * Creates an "equal ('=')" condition for this property.
-     *
-     * @deprecated Use {@link #equal} instead.
-     */
-    @Deprecated
-    public PropertyQueryCondition<ENTITY> eq(Object value) {
-        if (value instanceof Long) {
-            return equal((Long) value);
-        } else if (value instanceof Integer) {
-            return equal((Integer) value);
-        } else if (value instanceof String) {
-            return equal((String) value);
-        } else {
-            throw new IllegalArgumentException("Only LONG, INTEGER or STRING values are supported.");
-        }
-    }
-
-    /**
-     * Creates an "not equal ('&lt;&gt;')" condition for this property.
-     *
-     * @deprecated Use {@link #notEqual} instead.
-     */
-    @Deprecated
-    public PropertyQueryCondition<ENTITY> notEq(Object value) {
-        if (value instanceof Long) {
-            return notEqual((Long) value);
-        } else if (value instanceof Integer) {
-            return notEqual((Integer) value);
-        } else if (value instanceof String) {
-            return notEqual((String) value);
-        } else {
-            throw new IllegalArgumentException("Only LONG, INTEGER or STRING values are supported.");
-        }
-    }
-
-    /**
-     * Creates an "IN (..., ..., ...)" condition for this property.
-     *
-     * @deprecated Use {@link #oneOf} instead.
-     */
-    @Deprecated
-    public PropertyQueryCondition<ENTITY> in(Object... values) {
-        // just check the first value and assume all others are of the same type
-        // maybe this is too naive and we should properly check values earlier
-        if (values[0] instanceof Long) {
-            long[] inValues = new long[values.length];
-            for (int i = 0; i < values.length; i++) {
-                inValues[i] = (long) values[i];
-            }
-            return oneOf(inValues);
-        } else if (values[0] instanceof Integer) {
-            int[] inValues = new int[values.length];
-            for (int i = 0; i < values.length; i++) {
-                inValues[i] = (int) values[i];
-            }
-            return oneOf(inValues);
-        } else {
-            throw new IllegalArgumentException("The IN condition only supports LONG or INTEGER values.");
-        }
-    }
-
-    /**
-     * Creates an "IN (..., ..., ...)" condition for this property.
-     *
-     * @deprecated Use {@link #oneOf} instead.
-     */
-    @Deprecated
-    public PropertyQueryCondition<ENTITY> in(Collection<?> inValues) {
-        return in(inValues.toArray());
-    }
-
-    /**
-     * Creates an "greater than ('&gt;')" condition for this property.
-     *
-     * @deprecated Use {@link #greater} instead.
-     */
-    @Deprecated
-    public PropertyQueryCondition<ENTITY> gt(Object value) {
-        if (value instanceof Long) {
-            return greater((Long) value);
-        } else if (value instanceof Integer) {
-            return greater((Integer) value);
-        } else if (value instanceof Double) {
-            return greater((Double) value);
-        } else if (value instanceof Float) {
-            return greater((Float) value);
-        } else {
-            throw new IllegalArgumentException("Only LONG, INTEGER, DOUBLE or FLOAT values are supported.");
-        }
-    }
-
-    /**
-     * Creates an "less than ('&lt;')" condition for this property.
-     *
-     * @deprecated Use {@link #less} instead.
-     */
-    @Deprecated
-    public PropertyQueryCondition<ENTITY> lt(Object value) {
-        if (value instanceof Long) {
-            return less((Long) value);
-        } else if (value instanceof Integer) {
-            return less((Integer) value);
-        } else if (value instanceof Double) {
-            return less((Double) value);
-        } else if (value instanceof Float) {
-            return less((Float) value);
-        } else {
-            throw new IllegalArgumentException("Only LONG, INTEGER, DOUBLE or FLOAT values are supported.");
-        }
-    }
-
-    /**
-     * Creates an "IS NOT NULL" condition for this property.
-     *
-     * @deprecated Use {@link #notNull()} instead.
-     */
-    @Deprecated
-    public PropertyQueryCondition<ENTITY> isNotNull() {
-        return notNull();
-    }
-
     @Internal
     public int getEntityId() {
         return entity.getEntityId();