# DatabaseProvider

# DatabaseProvider

Artifact:[androidx.media3:media3-database](https://developer.android.com/jetpack/androidx/releases/media3)  
[View Source](https://cs.android.com/search?q=file:androidx/media3/database/DatabaseProvider.java+class:androidx.media3.database.DatabaseProvider)

*** ** * ** ***

Kotlin\|[Java](https://developer.android.com/reference/androidx/media3/database/DatabaseProvider "View this page in Java")

<br />

```
@UnstableApi
interface DatabaseProvider
```

<br />

Known direct subclasses  
[DefaultDatabaseProvider](https://developer.android.com/reference/kotlin/androidx/media3/database/DefaultDatabaseProvider),[StandaloneDatabaseProvider](https://developer.android.com/reference/kotlin/androidx/media3/database/StandaloneDatabaseProvider)  

|----------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [DefaultDatabaseProvider](https://developer.android.com/reference/kotlin/androidx/media3/database/DefaultDatabaseProvider)       | A[DatabaseProvider](https://developer.android.com/reference/kotlin/androidx/media3/database/DatabaseProvider)that provides instances obtained from a[SQLiteOpenHelper](https://developer.android.com/reference/android/database/sqlite/SQLiteOpenHelper.html). |
| [StandaloneDatabaseProvider](https://developer.android.com/reference/kotlin/androidx/media3/database/StandaloneDatabaseProvider) | An[SQLiteOpenHelper](https://developer.android.com/reference/android/database/sqlite/SQLiteOpenHelper.html)that provides instances of a standalone database.                                                                                                   |

Known indirect subclasses  
[ExoDatabaseProvider](https://developer.android.com/reference/kotlin/androidx/media3/database/ExoDatabaseProvider)  

|--------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [ExoDatabaseProvider](https://developer.android.com/reference/kotlin/androidx/media3/database/ExoDatabaseProvider) | **This class is deprecated.** Use[StandaloneDatabaseProvider](https://developer.android.com/reference/kotlin/androidx/media3/database/StandaloneDatabaseProvider). <br /> |

*** ** * ** ***

Provides[SQLiteDatabase](https://developer.android.com/reference/android/database/sqlite/SQLiteDatabase.html)instances to media library components, which may read and write tables prefixed with[TABLE_PREFIX](https://developer.android.com/reference/kotlin/androidx/media3/database/DatabaseProvider#TABLE_PREFIX()).

## Summary

|                                        ### Constants                                         |
|----------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `const `[String](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html)`!` | [TABLE_PREFIX](https://developer.android.com/reference/kotlin/androidx/media3/database/DatabaseProvider#TABLE_PREFIX())` = "ExoPlayer"` Prefix for tables that can be read and written by media library components. |

|                                           ### Public functions                                           |
|----------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [SQLiteDatabase](https://developer.android.com/reference/android/database/sqlite/SQLiteDatabase.html)`!` | [getReadableDatabase](https://developer.android.com/reference/kotlin/androidx/media3/database/DatabaseProvider#getReadableDatabase())`()` Creates and/or opens a database.                                           |
| [SQLiteDatabase](https://developer.android.com/reference/android/database/sqlite/SQLiteDatabase.html)`!` | [getWritableDatabase](https://developer.android.com/reference/kotlin/androidx/media3/database/DatabaseProvider#getWritableDatabase())`()` Creates and/or opens a database that will be used for reading and writing. |

## Constants

### TABLE_PREFIX

```
const val TABLE_PREFIX = "ExoPlayer": String!
```

Prefix for tables that can be read and written by media library components.  

## Public functions

### getReadableDatabase

```
fun getReadableDatabase(): SQLiteDatabase!
```

Creates and/or opens a database. This will be the same object returned by[getWritableDatabase](https://developer.android.com/reference/kotlin/androidx/media3/database/DatabaseProvider#getWritableDatabase())unless some problem, such as a full disk, requires the database to be opened read-only. In that case, a read-only database object will be returned. If the problem is fixed, a future call to[getWritableDatabase](https://developer.android.com/reference/kotlin/androidx/media3/database/DatabaseProvider#getWritableDatabase())may succeed, in which case the read-only database object will be closed and the read/write object will be returned in the future.

Once opened successfully, the database is cached, so you can call this method every time you need to read from the database.  

|                                                 Returns                                                  |
|----------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [SQLiteDatabase](https://developer.android.com/reference/android/database/sqlite/SQLiteDatabase.html)`!` | A database object valid until[getWritableDatabase](https://developer.android.com/reference/kotlin/androidx/media3/database/DatabaseProvider#getWritableDatabase())is called. |

|                                                             Throws                                                              |
|---------------------------------------------------------------------------------------------------------------------------------|-----------------------------------|
| [android.database.sqlite.SQLiteException](https://developer.android.com/reference/android/database/sqlite/SQLiteException.html) | If the database cannot be opened. |

### getWritableDatabase

```
fun getWritableDatabase(): SQLiteDatabase!
```

Creates and/or opens a database that will be used for reading and writing.

Once opened successfully, the database is cached, so you can call this method every time you need to write to the database. Errors such as bad permissions or a full disk may cause this method to fail, but future attempts may succeed if the problem is fixed.  

|                                                 Returns                                                  |
|----------------------------------------------------------------------------------------------------------|-------------------------------|
| [SQLiteDatabase](https://developer.android.com/reference/android/database/sqlite/SQLiteDatabase.html)`!` | A read/write database object. |

|                                                             Throws                                                              |
|---------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------|
| [android.database.sqlite.SQLiteException](https://developer.android.com/reference/android/database/sqlite/SQLiteException.html) | If the database cannot be opened for writing. |