realm-java v10.6.0-BETA.1 Release Notes
Release Date: 2021-05-17 // almost 3 years ago-
๐ฅ Breaking Changes
- ๐ [RealmApp] Sync protocol version increased to 3. This version adds support for the new data types introduced in file format version 21.
- ๐ File format version bumped to 21. In this version we support new basic datatypes
UUID
andRealmAny
, as well asRealmSet
andRealmMap
collections with string-based keys (i.e.RealmDictionary
). - Queries no longer do nullability checks on non-nullable fields, so using
null
as an argument will not throw anIllegalArgumentException
. - ๐ป String query filters
contains
,beginsWith
,endsWith
, andlike
, now throw a null pointer exception on null values. - ๐ The query builder no longer throw
IllegalStateException
butIllegalArgumentException
. - ๐ป The
distinct
query filter on unsupported fields no longer throws an exception when applied through when querying across relationships. - ๐ป The
distinct
query filter no longer throws an exception when applied on non-existent fields.
โจ Enhancements
- โ Added support for
java.util.UUID
as supported field in model classes. - โ Added support for
java.util.UUID
as a primary key. - โ Added support for
RealmAny
as supported field in model classes. ARealmAny
is used to represent a polymorphic Realm value or Realm Object, is indexable but cannot be used as a primary key. See Javadoc for RealmAny. - โ Added support for
RealmDictionary
as supported field in model classes. ARealmDictionary
is aMap
of strings to values - all types under theRealmAny
umbrella can be used as values. See Javadoc for RealmDictionary and Javadoc for RealmMap.RealmDictionary
is not yet supported by any of theRealm.insert
andRealm.createFromJson
methods - This support will be added in a future release. - โ Added support for
RealmSet
as supported field in model classes. ARealmSet
is a collection that implements the JavaSet
interface and contains no duplicate values - all types under theRealmAny
umbrella can be used as values. See Javadoc for RealmSet.RealmSet
is not yet supported by any of theRealm.insert
andRealm.createFromJson
methods - This support will be added in a future release. - ๐ Allow UTF8 encoded characters in property names in string-based queries (#4467)
- The error message when the initial steps of opening a Realm file fails is now more descriptive.
- ๐ Make conversion of Decimal128 to/from string work for numbers with more than 19 significant digits. (#4548)
- โ Remove type coercion on bool and ObjectId when doing queries.
- ๐ Allow passing arguments into string-based query predicates.
- ๐ Queries across relationships now support the
between
operator. - Queries on numerical fields (byte, short, int, long, float, double, decimal128) now accept any numerical value as an argument.
isEmpty
query filter can now be applied onRealmList
andRealmObject
fields.
๐ Fixed
- Fix assertion failures such as "!m_notifier_skip_version.version" or "m_notifier_sg->get_version() + 1 == new_version.version" when performing writes inside change notification callbacks. Previously refreshing the Realm by beginning a write transaction would skip delivering notifications, leaving things in an inconsistent state. Notifications are now delivered recursively when needed instead. (Cocoa #7165).
- ๐ Fixed name aliasing not working in sort/distinct clauses when doing string-based queries. (#4550, never before working).
- Potential/unconfirmed fix for crashes associated with failure to memory map (low on memory, low on virtual address space). For example (#4514).
- ๐ Syncing large Decimal128 values will cause "Assertion failed: cx.w[1] == 0" (#4519, since v10.0.0)
- Classes names "class_class_..." were not handled correctly when doing queries (#4480)
- ๐ Fix collection notification reporting for modifications. This could be observed by receiving the wrong indices of modifications on sorted or distinct results, or notification blocks sometimes not being called when only modifications have occurred. (#4573 since v6).
Compatibility
- โฌ๏ธ File format: Generates Realms with format v21. Unsynced Realms will be upgraded from Realm Java 2.0 and later. Synced Realms can only be read and upgraded if created with Realm Java v10.0.0-BETA.1.
- ๐ APIs are backwards compatible with all previous release of realm-java in the 10.6.y series.
- Realm Studio 11.0.0-alpha.0 or above is required to open Realms created by this version.
Internal
- โก๏ธ Updated to Realm Core 11.0.0-beta.4, commit: d50aef63a8aaf435e3afed82b589b47d8e1ab1ab.