Kotlin: How to Work with Collections and Documents in Firestore

Google's Firebase Firestore is a NoSQL cloud database that simplifies application backend development and provides real-time database capabilities. When combined with Kotlin, a popular programming language for Android development, you have a powerful duo for building robust, responsive applications. This article explores how to work with collections and documents in Firestore using Kotlin.

Firestore organizes data in a structure of collections of documents. Each document can hold various types of data and supports complex nested objects to represent your application's data model.

Setting Up Firestore in Kotlin

Before diving into code, ensure you have Firebase set up in your Kotlin project. Here are the basic steps to get started:

• Set up a Firebase project in your Google Cloud console.
• Add the Firebase SDK dependencies to your build.gradle file:
• Initialize Firebase in your Android Application class:

Working with Collections in Firestore

Firestore stores a collection of documents using a simple syntax in Kotlin. Let’s look at how to create, add to, and fetch data from a collection.

Creating and Adding a Document to a Collection

You can add data to a collection by specifying a collection path and creating a document:

val db = Firebase.firestore

val user = hashMapOf(
    "first" to "John",
    "last" to "Doe",
    "born" to 1990
)

db.collection("users")
    .add(user)
    .addOnSuccessListener { documentReference ->
        Log.d(TAG, "DocumentSnapshot added with ID: ${documentReference.id}")
    }
    .addOnFailureListener { e ->
        Log.w(TAG, "Error adding document", e)
    }

Fetching Documents from a Collection

Fetching documents involves querying the Firestore database. Here’s an example of how to retrieve all documents in the "users" collection:

db.collection("users")
    .get()
    .addOnSuccessListener { result ->
        for (document in result) {
            Log.d(TAG, "${document.id} => ${document.data}")
        }
    }
    .addOnFailureListener { exception ->
        Log.w(TAG, "Error getting documents.", exception)
    }

Querying and Sorting Data

Firestore supports robust querying directly in Kotlin. Let’s see some examples.

Querying Data

To query a collection documents with specific field values:

db.collection("users")
    .whereEqualTo("last", "Doe")
    .get()
    .addOnSuccessListener { documents ->
        for (document in documents) {
            Log.d(TAG, "${document.id} => ${document.data}")
        }
    }