NoOpCacheEvictor

Artifact: androidx.media3:media3-datasource

Kotlin |Java

@UnstableApi
class NoOpCacheEvictor : CacheEvictor

Evictor that doesn't ever evict cache files.

Warning: Using this evictor might have unforeseeable consequences if cache size is not managed elsewhere.

Summary

Public constructors
`NoOpCacheEvictor()`

Public functions
`Unit`	`onCacheInitialized()` Called when cache has been initialized.
`Unit`	`onSpanAdded(cache: Cache!, span: CacheSpan!)` Called when a `CacheSpan` is added to the cache.
`Unit`	`onSpanRemoved(cache: Cache!, span: CacheSpan!)` Called when a `CacheSpan` is removed from the cache.
`Unit`	`onSpanTouched(cache: Cache!, oldSpan: CacheSpan!, newSpan: CacheSpan!)` Called when an existing `CacheSpan` is touched, causing it to be replaced.
`Unit`	`onStartFile(cache: Cache!, key: String!, position: Long, length: Long)` Called when a writer starts writing to the cache.
`Boolean`	`requiresCacheSpanTouches()` Returns whether the evictor requires the `Cache` to touch `CacheSpans` when it accesses them.

Public constructors

NoOpCacheEvictor

NoOpCacheEvictor()

Public functions

onCacheInitialized

fun onCacheInitialized(): Unit

Called when cache has been initialized.

onSpanAdded

fun onSpanAdded(cache: Cache!, span: CacheSpan!): Unit

Called when a CacheSpan is added to the cache.

Parameters
`cache: Cache!`	The source of the event.
`span: CacheSpan!`	The added `CacheSpan`.

onSpanRemoved

fun onSpanRemoved(cache: Cache!, span: CacheSpan!): Unit

Called when a CacheSpan is removed from the cache.

Parameters
`cache: Cache!`	The source of the event.
`span: CacheSpan!`	The removed `CacheSpan`.

onSpanTouched

fun onSpanTouched(cache: Cache!, oldSpan: CacheSpan!, newSpan: CacheSpan!): Unit

Called when an existing CacheSpan is touched, causing it to be replaced. The new CacheSpan is guaranteed to represent the same data as the one it replaces, however file and lastTouchTimestamp may have changed.

Note that for span replacement, onSpanAdded and onSpanRemoved are not called in addition to this method.

Parameters
`cache: Cache!`	The source of the event.
`oldSpan: CacheSpan!`	The old `CacheSpan`, which has been removed from the cache.
`newSpan: CacheSpan!`	The new `CacheSpan`, which has been added to the cache.

onStartFile

fun onStartFile(cache: Cache!, key: String!, position: Long, length: Long): Unit

Called when a writer starts writing to the cache.

Parameters
`cache: Cache!`	The source of the event.
`key: String!`	The key being written.
`position: Long`	The starting position of the data being written.
`length: Long`	The length of the data being written, or `LENGTH_UNSET` if unknown.

requiresCacheSpanTouches

fun requiresCacheSpanTouches(): Boolean

Returns whether the evictor requires the Cache to touch CacheSpans when it accesses them. Implementations that do not use lastTouchTimestamp should return false.