In our company, we use realm.io as mobile Database with the ROS Cloud to sync data between mobile devices and the server. Main advantage is, that we can build Apps in a fraction of time, without juggling with synchronization.
One of our main challenges was the disability to copy data from one realm to another. But there is still a good solution for this, even though you have to do a lot of coding for that.
Motivation
There are a lot of reasons, why copying realms is a really neat feature. First of all would be versioning your data. But it’s also very neat, when you have several instances (for development, testing etc.) to copy the whole data when you go productive or need some test data in development.
Challenge 1: generating the Schema
When we copy one realm to another, we actually don’t know the used types. We could include a library which contains the types, but then our “RealmCopy” will only work for a specific realm, which is really baloney. That’s as if you develop a copy-program, that can only copy text-files.
So we need to read the source realm, get the schema and create the same schema in the destination. In .Net we can open a realm dynamically, which is pretty cool, because this gives us a chance to get the information we need. Only problem – we can not create or change a schema on a dynamically opened realm.
Solution? We can create dynamic types, and open the destination realm, this will automatically create a schema on the destination realm. (It’s really a little bit awkward, but that’s currently the only chance in .Net – with Javascript, we can mutate the realm directly, but that’s probably due to the nature of that language)
Open a realm as dynamic:
var username = ""; var password = ""; var realmUrl = ""; var realmName = "TestRealm"; var user = await User.LoginAsync(Credentials.UsernamePassword(username, password, false), new Uri(realmUrl)); var configuration = new FullSyncConfiguration(new Uri(realmName, UriKind.Relative), user) { IsDynamic = true }; var srcRealm = await Realm.GetInstanceAsync(configuration);
now we can go through the scheme and create types:
var types = new List(); foreach (var scheme in schemasToProcess) { // create an assembly for our type var assemblyName = new AssemblyName($"SomeAssemblyName{name}"); var assemblyBuilder = AssemblyBuilder.DefineDynamicAssembly(assemblyName, AssemblyBuilderAccess.Run); // create an module for the type var moduleBuilder = assemblyBuilder.DefineDynamicModule("MainModule"); // get the typebuilder as var typeBuilder = moduleBuilder.DefineType(name, TypeAttributes.Public | TypeAttributes.Class , parent); // add properties to type foreach (var prop in schema) { var attributes = new List(); Type propType; // woven property is needed, so Realm will add it to the destination schema attributes.Add(typeof(WovenPropertyAttribute)); if (prop.IsPrimaryKey) { // add primary key attribute attributes.Add(typeof(PrimaryKeyAttribute)); } else if (prop.IsIndexed) { // add indexed attribute attributes.Add(typeof(IndexedAttribute)); } // get the property type propType = prop.GetPropertyType(knownTypes); // set required attribute, when its not nullable if ((prop.Type & PropertyType.Nullable) != PropertyType.Nullable) { attributes.Add(typeof(RequiredAttribute)); } // create the property MyTypeBuilder.CreateProperty(typeBuilder, prop.Name, propType, attributes.ToArray()); } types.Add(typeBuilder.CreateType()); }
In one of my previous blog posts I mentioned how to create types using the TypeBuilder, so I won’t code it out here.
The function GetPropertyType is an extension, it’s just a mapping of the Realm-PropertyType to a CLR type.
Now we can open the destination Realm:
var configuration = new FullSyncConfiguration(new Uri(realmName, UriKind.Relative), user); configuration.ObjectClasses = types; var destRealm = await Realm.GetInstanceAsync(configuration);
Challenge 2: copying the realm
This doesn’t actually seem to be a challenge. We go through all objects in source realm and copy it to a new RealmObject, which is created in destination. You can actually use our generated types to open the source realm and use straight reflection for mapping all properties. But be careful, if you did something wrong, you would probably mutate the source realm (what you might not want). You can stick to the dynamic Realm instead and use CallSiteCache to read the properties and reflection to set it to the destination object. (more infos)
Challenge 3: cascaded objects
An object may not only reference atomic types, but also have other RealmObjects as properties. It can even contain cycles. This is really tricky, I solved it by initially creating a TypeBuilder for each SchemaItem, then we can use this TypeBuilder as a PropertyType, without building the actual type. Creating objects can be done recursively, but keep track of the objects, you already created, so you can avoid cycles.
If you have any questions, feel free to ask. ..have fun coding.