EventGet 50% off your ticket to MongoDB.local NYC on May 2. Use code Web50!Learn more >>
MongoDB Developer
Realm
plus
Sign in to follow topics
MongoDB Developer Centerchevron-right
Developer Topicschevron-right
Productschevron-right
Realmchevron-right

Source Generated Classes and Nullability in Realm .NET

Ferdinando Papale3 min read • Published Feb 27, 2023 • Updated Feb 27, 2023
.NETRealm
Facebook Icontwitter iconlinkedin icon
Rate this article
star-empty
star-empty
star-empty
star-empty
star-empty
The latest releases of Realm .NET have included some interesting updates that we would love to share — in particular, source generated classes and support for nullability annotation.

Source generated classes

Realm 10.18.0 introduced Realm.SourceGenerator, a source generator that can generate Realm model classes. This is part of our ongoing effort to modernize the Realm library, and will allow us to introduce certain language level features more easily in the future.
The migration to the new source generated classes is quite straightforward. All you need to do is:
  • Declare the Realm classes as partial, including all the eventual containing classes.
  • Swap out the base Realm classes (RealmObject, EmbeddedObject, AsymmetricObject) for the equivalent interfaces (IRealmObject, IEmbeddedObject, IAsymmetricObject).
  • Declare OnManaged and OnPropertyChanged methods as partial instead of overriding them, if they are used.
The property definition remains the same, and the source generator will take care of adding the full implementation of the interfaces.
To give an example, if your model definition looks like this:
This is how it should look like after you migrated it:
The classic Realm model definition is still supported, but it will not receive some of the new updates, such as the support for nullability annotations, and will be phased out in the future.

Nullability annotations

Realm 10.20.0 introduced full support for nullability annotations in the model definition for source generated classes. This allows you to use Realm models as usual when nullable context is active, and removes the need to use the Required attribute to indicate required properties, as this information will be inferred directly from the nullability status.
To sum up the expected nullability annotations:
  • Value type properties, such as int, can be declared as before, either nullable or not.
  • string and byte[] properties now cannot be decorated anymore with the Required attribute, as this information will be inferred from the nullability. If the property is not nullable, then it is considered equivalent as declaring it with the Required attribute.
  • Collections (list, sets, dictionaries, and backlinks) cannot be declared nullable, but their parameters may be.
  • Properties that link to a single Realm object are inherently nullable, and thus the type must be defined as nullable.
  • Lists, sets, and backlinks of objects cannot contain null values, and thus the type parameter must be non-nullable.
  • Dictionaries of object values can contain null, and thus the type parameter must be nullable.
Defining the properties with a different nullability annotation than what has been outlined will raise a diagnostic error. For instance:
We realize that some developers would prefer to have more freedom in the nullability annotation of object properties, and it is possible to do so by setting realm.ignore_objects_nullability = true in a global configuration file (more information about this can be found in the .NET documentation). If this option is enabled, all the object properties (including collections) will be considered valid, and the nullability annotations will be ignored.
Finally, please note that this will only work with source generated classes, and not with the classic Realm model definition. If you want more information, you can take a look at the Realm .NET repository and at our documentation.
Want to continue the conversation? Head over to our community forums!

Facebook Icontwitter iconlinkedin icon
Rate this article
star-empty
star-empty
star-empty
star-empty
star-empty
Related
Article

Announcing the GA of the Realm Flutter SDK


Jun 14, 2023 | 6 min read
Article

A Preview of Flexible Sync


Jun 14, 2023 | 5 min read
Tutorial

Migrating a SwiftUI iOS App from Core Data to Realm


Sep 23, 2022 | 7 min read
Tutorial

How to Write Integration Tests for MongoDB Atlas Functions


Aug 26, 2022 | 5 min read
Table of Contents
  • Source generated classes