Kolumbus allows you to explore your Realm database from within your Android application.
Note: This library is still under heavy development and a lot of improvements has to done. It was made available to collect feedbacks and feature requests.
- List of tables
- Content of the Category table
- Info about the Category table
- Content of the Product table
- Info about the Product table
In your root build.gradle
file, add the Jitpack url to the list of repositories, if you don't have it yet:
allprojects {
repositories {
maven {
url "https://jitpack.io"
}
}
}
In your module build.gradle
file, add the Kolumbus dependency:
dependencies {
compile 'com.github.MGaetan89.Kolumbus:kolumbus:v0.9'
}
If you only want to use Kolumbus in your debug build, you can use the following configuration instead:
dependencies {
debugCompile 'com.github.MGaetan89.Kolumbus:kolumbus:v0.9'
releaseCompile 'com.github.MGaetan89.Kolumbus:kolumbus-no-op:v0.9'
}
Check the demo application to see how to use Kolumbus.
The following example assumes that you have two classes named Category
and Product
in your project, which both inherits from io.realm.RealmModel
.
// Kotlin
import io.kolumbus.Kolumbus
import io.kolumbus.KolumbusModule
import io.realm.Realm
import io.realm.RealmConfiguration
// Register the Kolumbus module when defining your Realm configuration
val realmConfiguration = RealmConfiguration.Builder(context)
.modules(KolumbusModule())
.build()
Realm.setDefaultConfiguration(realmConfiguration)
// Configure Kolumbus
Kolumbus.explore(Category::class.java)
.explore(Product::class.java)
.navigate(context)
// Java
import io.kolumbus.Kolumbus;
import io.kolumbus.KolumbusModule;
import io.realm.Realm;
import io.realm.RealmConfiguration;
// Register the Kolumbus module when defining your Realm configuration
RealmConfiguration realmConfiguration = new RealmConfiguration.Builder(context)
.modules(new KolumbusModule())
.build();
Realm.setDefaultConfiguration(realmConfiguration);
// Configure Kolumbus
Kolumbus.build()
.explore(Category.class)
.explore(Product.class)
.navigate(context);
One way to customize the behavior/display of Kolumbus is to override the public resources in your application.
Kolumbus provides a basic way to customize how the content of a table is displayed.
To use this feature, you have to extends from Architect
and override the desired methods.
// Kotlin
import android.widget.TextView
import io.kolumbus.Architect
class MyArchitect: Architect() {
override fun displayEmpty(textView: TextView) {
textView.text = "Field is empty"
}
}
// Java
import android.widget.TextView;
import io.kolumbus.Architect;
public class MyArchitect extends Architect {
@Override
public void displayEmpty(@NonNull TextView textView) {
textView.setText("Field is empty")
}
}
Then, you need to pass an instance of your Architect
to Kolumbus
, as follow:
// Kotlin
import io.kolumbus.Kolumbus
Kolumbus
// All `explore()` calls you might need
.withArchitect(MyArchitect())
.navigate(context)
// Java
import io.kolumbus.Kolumbus;
Kolumbus.build()
// All `explore()` calls you might need
.withArchitect(new MyArchitect())
.navigate(context)
The following table presents the compatibility matrix between Kolumbus versions and Realm versions.
Kolumbus version | Realm version |
---|---|
SNAPSHOT | 2.0.0 - 2.0.2 |
0.9 | 1.0.0 - 1.0.1 |
0.7 - 0.8 | 0.89.0 - 1.0.0 |
0.5 - 0.6 | 0.88.0 - 0.88.3 |
0.1 - 0.4 | ? - 0.87.5 |
In no particular order:
- Sort the content of the displayed table
- Filter the fields that are displayed
- Filter the data that are displayed
Copyright 2016 MGaetan89
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.