A blazing fast, powerful, and very simple ORM android database library that writes database code for you.
Java Kotlin
Latest commit 0e06ea8 Dec 28, 2017
agrosner committed Dec 28, 2017 Merge pull request #1505 from Raizlabs/develop
4.2.4
Permalink
Failed to load latest commit information.
.github Add contributing guide Mar 10, 2017
dbflow-core [database] restore in memory compatability, but show it as deprecated. Aug 27, 2017
dbflow-kotlinextensions [processor] fix dependencies. simplify check on oneToMany. Aug 31, 2017
dbflow-processor Merge pull request #1437 from danvwells/tests Dec 28, 2017
dbflow-rx-kotlinextensions [tools] update compile statements into implementation/api dependencies. Aug 26, 2017
dbflow-rx [tools] update compile statements into implementation/api dependencies. Aug 26, 2017
dbflow-rx2-kotlinextensions [tools] update compile statements into implementation/api dependencies. Aug 26, 2017
dbflow-rx2 [rx2] update to latest dependency. Aug 26, 2017
dbflow-sqlcipher [tools] update compile statements into implementation/api dependencies. Aug 26, 2017
dbflow-tests [foreign key] fix issue where single reference non table column defin… Dec 28, 2017
dbflow Merge branch 'develop' into deletetrigger Dec 28, 2017
gradle/wrapper [tools] update tools to latest, building with api 26, new gradle plugin. Aug 26, 2017
usage2 @ 76b48d6 [properties] update property extensions to accept nullable values on … Aug 26, 2017
.editorconfig Support for EditorConfig Dec 4, 2015
.gitignore first commit with most of the implementation. Will not function here … Sep 7, 2014
.gitmodules [version] update to 4.0.1 due to submodule issues. May 12, 2017
ISSUE_TEMPLATE.md [readme] update issue template. Dec 19, 2017
LICENSE Updating License File Jul 24, 2015
README.md [version] 4.2.4 Dec 28, 2017
android-artifacts.gradle removed bintray upload stuff. updated gradle plugin version Apr 15, 2016
bintray_upload.gradle removed bintray upload stuff. updated gradle plugin version Apr 15, 2016
build.gradle [plugins] update to latest dcedents to support 4.0+ of gradle and and… Dec 19, 2017
dbflow_banner.png added banner May 5, 2015
gradle.properties [version] 4.2.4 Dec 28, 2017
gradlew writing the beginnings of the compiler. will begin full run of it. go… Oct 28, 2014
java-artifacts.gradle removed bintray upload stuff. updated gradle plugin version Apr 15, 2016
kotlin-artifacts.gradle removed bintray upload stuff. updated gradle plugin version Apr 15, 2016
proguard-rules.pro first commit with most of the implementation. Will not function here … Sep 7, 2014
settings.gradle add kpoet. replace extensions with kpoet extensions. some more fixes. Apr 7, 2017

README.md

Image

JitPack.io Android Weekly Android Arsenal

A robust, powerful, and very simple ORM android database library with annotation processing.

The library is built on speed, performance, and approachability. It not only eliminates most boiler-plate code for dealing with databases, but also provides a powerful and simple API to manage interactions.

Let DBFlow make SQL code flow like a steady stream so you can focus on writing amazing apps.

Why Use DBFlow

DBFlow is built from a collection of the best features of many database libraries in the most efficient way possible. Also, it is built to not only make it significantly easier to deal with databases on Android, but also to provide extensibility. Don't let an ORM or library get in your way, let the code you write in your applications be the best as possible.

  • Extensibility: No restrictions on inheritance of your table classes. They can be plain POJOs, no subclass required, but as a convenience we recommend using BaseModel. You can extend non-Model classes in different packages and use them as your DB tables. Also you can subclass other tables to join the @Column together, and again they can be in different packages.
  • Speed: Built with java's annotation processing code generation, there's almost zero runtime performance hit by using this library (only reflection is creation of the main, generated database module's constructor). This library saves hours of boilerplate code and maintenance by generating the code for you. With powerful model caching (multiple primary key Model too), you can surpass the speed of SQLite by reusing where possible. We have support for lazy-loading relationships on-demand such as @ForeignKey or @OneToMany that make queries happen super-fast.
  • SQLite Query Flow: The queries in this library adhere as closely as possible to SQLite native queries. select(name, screenSize).from(Android.class).where(name.is("Nexus 5x")).and(version.is(6.0)).querySingle()
  • Open Source: This library is fully open source and contributions are not only welcomed, but encouraged.
  • Robust: We support Trigger, ModelView, Index, Migration, built-in ways to manage database access, and many more features. SQLCipher, RXJava, and more!
  • Multiple Databases, Multiple Modules: we seamlessly support multiple database files, database modules using DBFlow in other dependencies, simultaneously.
  • Built On SQLite: SQLite is the most widely used database engine in world and using it as your base, you are not tied to a limited set of platforms or libraries.

Changelog

Changes exist in the releases tab.

Usage Docs

For more detailed usage, check out it out here

Including in your project

allProjects {
  repositories {
    // required to find the project's artifacts
    maven { url "https://www.jitpack.io" }
  }
}

Add the library to the project-level build.gradle, using the apt plugin to enable Annotation Processing:

  apply plugin: 'kotlin-kapt' // required for kotlin.

  def dbflow_version = "4.2.4"
  // or dbflow_version = "develop-SNAPSHOT" for grabbing latest dependency in your project on the develop branch
  // or 10-digit short-hash of a specific commit. (Useful for bugs fixed in develop, but not in a release yet)

  dependencies {

    // if Java use this. If using Kotlin do NOT use this.
    annotationProcessor "com.github.Raizlabs.DBFlow:dbflow-processor:${dbflow_version}"

    // Use if Kotlin user.
    kapt "com.github.Raizlabs.DBFlow:dbflow-processor:${dbflow_version}"

    compile "com.github.Raizlabs.DBFlow:dbflow-core:${dbflow_version}"
    compile "com.github.Raizlabs.DBFlow:dbflow:${dbflow_version}"

    // sql-cipher database encryption (optional)
    compile "com.github.Raizlabs.DBFlow:dbflow-sqlcipher:${dbflow_version}"
    compile "net.zetetic:android-database-sqlcipher:${sqlcipher_version}@aar"

    // kotlin extensions
    compile "com.github.Raizlabs.DBFlow:dbflow-kotlinextensions:${dbflow_version}"

    // RXJava 1 support
    compile "com.github.Raizlabs.DBFlow:dbflow-rx:${dbflow_version}"

    // RXJava 1 Kotlin Extensions Support
    compile "com.github.Raizlabs.DBFlow:dbflow-rx-kotlinextensions:${dbflow_version}"

    // RXJava 2 support
    compile "com.github.Raizlabs.DBFlow:dbflow-rx2:${dbflow_version}"

    // RXJava 2 Kotlin Extensions Support
    compile "com.github.Raizlabs.DBFlow:dbflow-rx2-kotlinextensions:${dbflow_version}"

  }

Pull Requests

I welcome and encourage all pull requests. Please read over these guidelines to ensure smooth PR attention:

  1. Match coding style (braces, spacing, etc.) This is best achieved using Reformat Code shortcut, command+option+L on Mac and Ctrl+Alt+L on Windows, with Android Studio defaults.
  2. If its a feature, bugfix, or anything please only change code to what you specify.
  3. Please keep PR titles easy to read and descriptive of changes, this will make them easier to merge :)
  4. Pull requests must be made against develop branch. Any other branch (unless specified by the maintainers) will get rejected.
  5. Have fun!

Maintained By

agrosner (@agrosner)