# RxDataStoreBuilder

# RxDataStoreBuilder

Artifact:[androidx.datastore:datastore-rxjava2](https://developer.android.com/jetpack/androidx/releases/datastore)  
[View Source](https://cs.android.com/search?q=file:androidx/datastore/rxjava2/RxDataStoreBuilder.kt+class:androidx.datastore.rxjava2.RxDataStoreBuilder)  
Added in[1.0.0](https://developer.android.com/jetpack/androidx/releases/datastore#1.0.0)

*** ** * ** ***

Kotlin\|[Java](https://developer.android.com/reference/androidx/datastore/rxjava2/RxDataStoreBuilder "View this page in Java")

<br />

```
class RxDataStoreBuilder<T : Any>
```

<br />

*** ** * ** ***

Builder class for an RxDataStore that works on a single process.

## Summary

|                                                                                                                                                                                                                                                                                                                                                     ### Public constructors                                                                                                                                                                                                                                                                                                                                                      |
|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `<T : `[Any](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-any/index.html)`> `[RxDataStoreBuilder](https://developer.android.com/reference/kotlin/androidx/datastore/rxjava2/RxDataStoreBuilder#RxDataStoreBuilder(java.util.concurrent.Callable,androidx.datastore.core.Serializer))`(` ` produceFile: `[Callable](https://developer.android.com/reference/java/util/concurrent/Callable.html)`<`[File](https://developer.android.com/reference/java/io/File.html)`>,` ` serializer: `[Serializer](https://developer.android.com/reference/kotlin/androidx/datastore/core/Serializer)`<T>` `)` Create a RxDataStoreBuilder with the callable which returns the File that DataStore acts on.                             |
| `<T : `[Any](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-any/index.html)`> `[RxDataStoreBuilder](https://developer.android.com/reference/kotlin/androidx/datastore/rxjava2/RxDataStoreBuilder#RxDataStoreBuilder(android.content.Context,kotlin.String,androidx.datastore.core.Serializer))`(` ` context: `[Context](https://developer.android.com/reference/android/content/Context.html)`,` ` fileName: `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`,` ` serializer: `[Serializer](https://developer.android.com/reference/kotlin/androidx/datastore/core/Serializer)`<T>` `)` Create a RxDataStoreBuilder with the Context and name from which to derive the DataStore file. |

|                                                  ### Public functions                                                   |
|-------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [RxDataStoreBuilder](https://developer.android.com/reference/kotlin/androidx/datastore/rxjava2/RxDataStoreBuilder)`<T>` | [addDataMigration](https://developer.android.com/reference/kotlin/androidx/datastore/rxjava2/RxDataStoreBuilder#addDataMigration(androidx.datastore.core.DataMigration))`(dataMigration: `[DataMigration](https://developer.android.com/reference/kotlin/androidx/datastore/core/DataMigration)`<T>)` Add a DataMigration to the Datastore.                                                                                                        |
| [RxDataStoreBuilder](https://developer.android.com/reference/kotlin/androidx/datastore/rxjava2/RxDataStoreBuilder)`<T>` | [addRxDataMigration](https://developer.android.com/reference/kotlin/androidx/datastore/rxjava2/RxDataStoreBuilder#addRxDataMigration(androidx.datastore.rxjava2.RxDataMigration))`(rxDataMigration: `[RxDataMigration](https://developer.android.com/reference/kotlin/androidx/datastore/rxjava2/RxDataMigration)`<T>)` Add an RxDataMigration to the DataStore.                                                                                   |
| [RxDataStore](https://developer.android.com/reference/kotlin/androidx/datastore/rxjava2/RxDataStore)`<T>`               | [build](https://developer.android.com/reference/kotlin/androidx/datastore/rxjava2/RxDataStoreBuilder#build())`()` Build the DataStore.                                                                                                                                                                                                                                                                                                             |
| [RxDataStoreBuilder](https://developer.android.com/reference/kotlin/androidx/datastore/rxjava2/RxDataStoreBuilder)`<T>` | [setCorruptionHandler](https://developer.android.com/reference/kotlin/androidx/datastore/rxjava2/RxDataStoreBuilder#setCorruptionHandler(androidx.datastore.core.handlers.ReplaceFileCorruptionHandler))`(` ` corruptionHandler: `[ReplaceFileCorruptionHandler](https://developer.android.com/reference/kotlin/androidx/datastore/core/handlers/ReplaceFileCorruptionHandler)`<T>` `)` Sets the corruption handler to install into the DataStore. |
| [RxDataStoreBuilder](https://developer.android.com/reference/kotlin/androidx/datastore/rxjava2/RxDataStoreBuilder)`<T>` | [setIoScheduler](https://developer.android.com/reference/kotlin/androidx/datastore/rxjava2/RxDataStoreBuilder#setIoScheduler(io.reactivex.Scheduler))`(ioScheduler: `[Scheduler](https://reactivex.io/RxJava/2.x/javadoc/io/reactivex/Scheduler.html)`)` Set the Scheduler on which to perform IO and transform operations.                                                                                                                        |

## Public constructors

### RxDataStoreBuilder

```
<T : Any> RxDataStoreBuilder(
    produceFile: Callable<File>,
    serializer: Serializer<T>
)
```

Create a RxDataStoreBuilder with the callable which returns the File that DataStore acts on. The user is responsible for ensuring that there is never more than one DataStore acting on a file at a time.  

|                                                                                  Parameters                                                                                  |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `produceFile: `[Callable](https://developer.android.com/reference/java/util/concurrent/Callable.html)`<`[File](https://developer.android.com/reference/java/io/File.html)`>` | Function which returns the file that the new DataStore will act on. The function must return the same path every time. No two instances of DataStore should act on the same file at the same time. |
| `serializer: `[Serializer](https://developer.android.com/reference/kotlin/androidx/datastore/core/Serializer)`<T>`                                                           | the serializer for the type that this DataStore acts on.                                                                                                                                           |

### RxDataStoreBuilder

```
<T : Any> RxDataStoreBuilder(
    context: Context,
    fileName: String,
    serializer: Serializer<T>
)
```

Create a RxDataStoreBuilder with the Context and name from which to derive the DataStore file. The file is generated by File(this.filesDir, "datastore/$fileName"). The user is responsible for ensuring that there is never more than one DataStore acting on a file at a time.  

|                                                     Parameters                                                     |
|--------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `context: `[Context](https://developer.android.com/reference/android/content/Context.html)                         | the context from which we retrieve files directory.                                                                                                                           |
| `fileName: `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)                      | the filename relative to Context.applicationContext.filesDir that DataStore acts on. The File is obtained from dataStoreFile. It is created in the "/datastore" subdirectory. |
| `serializer: `[Serializer](https://developer.android.com/reference/kotlin/androidx/datastore/core/Serializer)`<T>` | the serializer for the type that this DataStore acts on.                                                                                                                      |

## Public functions

### addDataMigration

Added in[1.0.0](https://developer.android.com/jetpack/androidx/releases/datastore#1.0.0)  

```
fun addDataMigration(dataMigration: DataMigration<T>): RxDataStoreBuilder<T>
```

Add a DataMigration to the Datastore. Migrations are run in the order they are added.  

|                                                         Parameters                                                          |
|-----------------------------------------------------------------------------------------------------------------------------|----------------------|
| `dataMigration: `[DataMigration](https://developer.android.com/reference/kotlin/androidx/datastore/core/DataMigration)`<T>` | the migration to add |

|                                                         Returns                                                         |
|-------------------------------------------------------------------------------------------------------------------------|------|
| [RxDataStoreBuilder](https://developer.android.com/reference/kotlin/androidx/datastore/rxjava2/RxDataStoreBuilder)`<T>` | this |

### addRxDataMigration

Added in[1.0.0](https://developer.android.com/jetpack/androidx/releases/datastore#1.0.0)  

```
fun addRxDataMigration(rxDataMigration: RxDataMigration<T>): RxDataStoreBuilder<T>
```

Add an RxDataMigration to the DataStore. Migrations are run in the order they are added.  

|                                                              Parameters                                                              |
|--------------------------------------------------------------------------------------------------------------------------------------|-----------------------|
| `rxDataMigration: `[RxDataMigration](https://developer.android.com/reference/kotlin/androidx/datastore/rxjava2/RxDataMigration)`<T>` | the migration to add. |

|                                                         Returns                                                         |
|-------------------------------------------------------------------------------------------------------------------------|------|
| [RxDataStoreBuilder](https://developer.android.com/reference/kotlin/androidx/datastore/rxjava2/RxDataStoreBuilder)`<T>` | this |

### build

Added in[1.0.0](https://developer.android.com/jetpack/androidx/releases/datastore#1.0.0)  

```
fun build(): RxDataStore<T>
```

Build the DataStore.  

|                                                  Returns                                                  |
|-----------------------------------------------------------------------------------------------------------|--------------------------------------------|
| [RxDataStore](https://developer.android.com/reference/kotlin/androidx/datastore/rxjava2/RxDataStore)`<T>` | the DataStore with the provided parameters |

### setCorruptionHandler

Added in[1.0.0](https://developer.android.com/jetpack/androidx/releases/datastore#1.0.0)  

```
fun setCorruptionHandler(
    corruptionHandler: ReplaceFileCorruptionHandler<T>
): RxDataStoreBuilder<T>
```

Sets the corruption handler to install into the DataStore.

This parameter is optional and defaults to no corruption handler.  

|                                                                               Parameters                                                                               |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|
| `corruptionHandler: `[ReplaceFileCorruptionHandler](https://developer.android.com/reference/kotlin/androidx/datastore/core/handlers/ReplaceFileCorruptionHandler)`<T>` |   |

|                                                         Returns                                                         |
|-------------------------------------------------------------------------------------------------------------------------|------|
| [RxDataStoreBuilder](https://developer.android.com/reference/kotlin/androidx/datastore/rxjava2/RxDataStoreBuilder)`<T>` | this |

### setIoScheduler

Added in[1.0.0](https://developer.android.com/jetpack/androidx/releases/datastore#1.0.0)  

```
fun setIoScheduler(ioScheduler: Scheduler): RxDataStoreBuilder<T>
```

Set the Scheduler on which to perform IO and transform operations. This is converted into a CoroutineDispatcher before being added to DataStore.

This parameter is optional and defaults to Schedulers.io().  

|                                           Parameters                                            |
|-------------------------------------------------------------------------------------------------|------------------------------------------------------------|
| `ioScheduler: `[Scheduler](https://reactivex.io/RxJava/2.x/javadoc/io/reactivex/Scheduler.html) | the scheduler on which IO and transform operations are run |

|                                                         Returns                                                         |
|-------------------------------------------------------------------------------------------------------------------------|------|
| [RxDataStoreBuilder](https://developer.android.com/reference/kotlin/androidx/datastore/rxjava2/RxDataStoreBuilder)`<T>` | this |