/*
* Copyright 2015 Realm Inc.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package io.realm.examples.appmodules;
import android.app.Activity;
import android.os.Bundle;
import android.util.Log;
import android.widget.LinearLayout;
import android.widget.TextView;
import io.realm.Realm;
import io.realm.RealmConfiguration;
import io.realm.examples.appmodules.model.Cow;
import io.realm.examples.appmodules.model.Pig;
import io.realm.examples.appmodules.model.Snake;
import io.realm.examples.appmodules.model.Spider;
import io.realm.examples.appmodules.modules.CreepyAnimalsModule;
import io.realm.examples.librarymodules.Zoo;
import io.realm.examples.librarymodules.model.Cat;
import io.realm.examples.librarymodules.model.Dog;
import io.realm.examples.librarymodules.model.Elephant;
import io.realm.examples.librarymodules.model.Lion;
import io.realm.examples.librarymodules.model.Zebra;
import io.realm.examples.librarymodules.modules.DomesticAnimalsModule;
import io.realm.examples.librarymodules.modules.ZooAnimalsModule;
import io.realm.exceptions.RealmException;
/**
* This example demonstrates how you can use modules to control which classes belong to which Realms and how you can
* work with multiple Realms at the same time.
*/
public class ModulesExampleActivity extends Activity {
public static final String TAG = ModulesExampleActivity.class.getName();
private LinearLayout rootLayout = null;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_modules_example);
rootLayout = ((LinearLayout) findViewById(R.id.container));
rootLayout.removeAllViews();
// The default Realm instance implicitly knows about all classes in the realmModuleAppExample Android Studio
// module. This does not include the classes from the realmModuleLibraryExample AS module so a Realm using this
// configuration would know about the following classes: { Cow, Pig, Snake, Spider }
RealmConfiguration defaultConfig = new RealmConfiguration.Builder().build();
// It is possible to extend the default schema by adding additional Realm modules using modules(). This can
// also be Realm modules from libraries. The below Realm contains the following classes: { Cow, Pig, Snake,
// Spider, Cat, Dog }
RealmConfiguration farmAnimalsConfig = new RealmConfiguration.Builder()
.name("farm.realm")
.modules(Realm.getDefaultModule(), new DomesticAnimalsModule())
.build();
// Or you can completely replace the default schema.
// This Realm contains the following classes: { Elephant, Lion, Zebra, Snake, Spider }
RealmConfiguration exoticAnimalsConfig = new RealmConfiguration.Builder()
.name("exotic.realm")
.modules(new ZooAnimalsModule(), new CreepyAnimalsModule())
.build();
// Multiple Realms can be open at the same time
showStatus("Opening multiple Realms");
Realm defaultRealm = Realm.getInstance(defaultConfig);
final Realm farmRealm = Realm.getInstance(farmAnimalsConfig);
Realm exoticRealm = Realm.getInstance(exoticAnimalsConfig);
// Objects can be added to each Realm independantly
showStatus("Create objects in the default Realm");
defaultRealm.executeTransaction(new Realm.Transaction() {
@Override
public void execute(Realm realm) {
realm.createObject(Cow.class);
realm.createObject(Pig.class);
realm.createObject(Snake.class);
realm.createObject(Spider.class);
}
});
showStatus("Create objects in the farm Realm");
farmRealm.executeTransaction(new Realm.Transaction() {
@Override
public void execute(Realm realm) {
realm.createObject(Cow.class);
realm.createObject(Pig.class);
realm.createObject(Cat.class);
realm.createObject(Dog.class);
}
});
showStatus("Create objects in the exotic Realm");
exoticRealm.executeTransaction(new Realm.Transaction() {
@Override
public void execute(Realm realm) {
realm.createObject(Elephant.class);
realm.createObject(Lion.class);
realm.createObject(Zebra.class);
realm.createObject(Snake.class);
realm.createObject(Spider.class);
}
});
// You can copy objects between Realms
showStatus("Copy objects between Realms");
showStatus("Number of pigs on the farm : " + farmRealm.where(Pig.class).count());
showStatus("Copy pig from defaultRealm to farmRealm");
final Pig defaultPig = defaultRealm.where(Pig.class).findFirst();
farmRealm.executeTransaction(new Realm.Transaction() {
@Override
public void execute(Realm realm) {
realm.copyToRealm(defaultPig);
}
});
showStatus("Number of pigs on the farm : " + farmRealm.where(Pig.class).count());
// Each Realm is restricted to only accept the classes in their schema.
showStatus("Trying to add an unsupported class");
defaultRealm.beginTransaction();
try {
defaultRealm.createObject(Elephant.class);
} catch (RealmException expected) {
showStatus("This throws a :" + expected.toString());
} finally {
defaultRealm.cancelTransaction();
}
// And Realms in library projects are independent from Realms in the app code
showStatus("Interacting with library code that uses Realm internally");
int animals = 5;
Zoo libraryZoo = new Zoo();
libraryZoo.open();
showStatus("Adding animals: " + animals);
libraryZoo.addAnimals(5);
showStatus("Number of animals in the library Realm:" + libraryZoo.getNoOfAnimals());
libraryZoo.close();
// Remember to close all open Realms
defaultRealm.close();
farmRealm.close();
exoticRealm.close();
}
private void showStatus(String txt) {
Log.i(TAG, txt);
TextView tv = new TextView(this);
tv.setText(txt);
rootLayout.addView(tv);
}
}