ObjectBox Java (Kotlin, Android)
ObjectBox is a superfast object-oriented database with strong relation support. ObjectBox is embedded into your Android, Linux, macOS, or Windows app.
Latest version: 3.0.1 (2021/10/19)
Demo code using ObjectBox:
// Kotlin
val playlist = Playlist("My Favorites")
playlist.songs.add(Song("Lalala"))
playlist.songs.add(Song("Lololo"))
box.put(playlist)
// Java
Playlist playlist = new Playlist("My Favorites");
playlist.songs.add(new Song("Lalala"));
playlist.songs.add(new Song("Lololo"));
box.put(playlist);
Other languages/bindings
ObjectBox supports multiple platforms and languages. Besides JVM based languages like Java and Kotlin, ObjectBox also offers:
- ObjectBox Swift: build fast mobile apps for iOS (and macOS)
- ObjectBox Dart/Flutter: cross-platform for mobile and desktop apps (beta)
- ObjectBox Go: great for data-driven tools and small server applications
- ObjectBox C and C++: native speed with zero copy access to FlatBuffer objects
Gradle setup
For Android projects, add the ObjectBox Gradle plugin to your root build.gradle
:
buildscript {
ext.objectboxVersion = "3.0.1"
repositories {
mavenCentral()
}
dependencies {
classpath("io.objectbox:objectbox-gradle-plugin:$objectboxVersion")
}
}
And in your app's build.gradle
apply the plugin:
// Using plugins syntax:
plugins {
id("io.objectbox") // Add after other plugins.
}
// Or using the old apply syntax:
apply plugin: "io.objectbox" // Add after other plugins.
First steps
Create a data object class @Entity
, for example "Playlist".
// Kotlin
@Entity data class Playlist( ... )
// Java
@Entity public class Playlist { ... }
Now build the project to let ObjectBox generate the class MyObjectBox
for you.
Prepare the BoxStore object once for your app, e.g. in onCreate
in your Application class:
boxStore = MyObjectBox.builder().androidContext(this).build();
Then get a Box
class for the Playlist entity class:
Box<Playlist> box = boxStore.boxFor(Playlist.class);
The Box
object gives you access to all major functions, like put
, get
, remove
, and query
.
For details please check the docs.
Links
License
Copyright 2017-2020 ObjectBox Ltd. All rights reserved.
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.