logger/dev.shivathapaa.logger.core/LogContextHolder

LogContextHolder

actual object LogContextHolder(source)

Holds and propagates the active LogContext for the current execution scope.

This object is implemented per-platform to use the most appropriate scoping mechanism (e.g. ThreadLocal on JVM/Android, a thread-local stack on Apple targets).

Contexts are scoped: the previous context is always restored after withContext completes, even if the block throws. Nested calls merge their contexts - inner values override outer values for the same key.

Example:

val requestContext = LogContext(mapOf("requestId" to "req-123"))

val result = LogContextHolder.withContext(requestContext) {
    logger.info { "Handling request" }
    processRequest() // return value is propagated
}
Content copied to clipboard
actual object LogContextHolder(source)

Holds and propagates the active LogContext for the current execution scope.

This object is implemented per-platform to use the most appropriate scoping mechanism (e.g. ThreadLocal on JVM/Android, a thread-local stack on Apple targets).

Contexts are scoped: the previous context is always restored after withContext completes, even if the block throws. Nested calls merge their contexts - inner values override outer values for the same key.

Example:

val requestContext = LogContext(mapOf("requestId" to "req-123"))

val result = LogContextHolder.withContext(requestContext) {
    logger.info { "Handling request" }
    processRequest() // return value is propagated
}
Content copied to clipboard
expect object LogContextHolder(source)

Holds and propagates the active LogContext for the current execution scope.

This object is implemented per-platform to use the most appropriate scoping mechanism (e.g. ThreadLocal on JVM/Android, a thread-local stack on Apple targets).

Contexts are scoped: the previous context is always restored after withContext completes, even if the block throws. Nested calls merge their contexts - inner values override outer values for the same key.

Example:

val requestContext = LogContext(mapOf("requestId" to "req-123"))

val result = LogContextHolder.withContext(requestContext) {
    logger.info { "Handling request" }
    processRequest() // return value is propagated
}
Content copied to clipboard
actual object LogContextHolder(source)

Holds and propagates the active LogContext for the current execution scope.

This object is implemented per-platform to use the most appropriate scoping mechanism (e.g. ThreadLocal on JVM/Android, a thread-local stack on Apple targets).

Contexts are scoped: the previous context is always restored after withContext completes, even if the block throws. Nested calls merge their contexts - inner values override outer values for the same key.

Example:

val requestContext = LogContext(mapOf("requestId" to "req-123"))

val result = LogContextHolder.withContext(requestContext) {
    logger.info { "Handling request" }
    processRequest() // return value is propagated
}
Content copied to clipboard
actual object LogContextHolder(source)

Holds and propagates the active LogContext for the current execution scope.

This object is implemented per-platform to use the most appropriate scoping mechanism (e.g. ThreadLocal on JVM/Android, a thread-local stack on Apple targets).

Contexts are scoped: the previous context is always restored after withContext completes, even if the block throws. Nested calls merge their contexts - inner values override outer values for the same key.

Example:

val requestContext = LogContext(mapOf("requestId" to "req-123"))

val result = LogContextHolder.withContext(requestContext) {
    logger.info { "Handling request" }
    processRequest() // return value is propagated
}
Content copied to clipboard
actual object LogContextHolder(source)

Kotlin/Native coroutines are not single-threaded - Dispatchers.Default is a multi-threaded worker pool. Without ThreadLocal this object's state would be one process-wide slot, so concurrent coroutines on different threads would read each other's context - i.e. silently wrong context data.

ThreadLocal gives each thread its own slot, matching the ThreadLocal used on JVM/Android and NSThread.threadDictionary on Apple. A coroutine that resumes on a different thread therefore sees an empty context rather than another coroutine's: it fails closed. Reinstalling context across a thread hop needs a ThreadContextElement, which kotlinx.coroutines only ships on JVM.

actual object LogContextHolder(source)

Kotlin/Native coroutines are not single-threaded - Dispatchers.Default is a multi-threaded worker pool. Without ThreadLocal this object's state would be one process-wide slot, so concurrent coroutines on different threads would read each other's context - i.e. silently wrong context data.

ThreadLocal gives each thread its own slot, matching the ThreadLocal used on JVM/Android and NSThread.threadDictionary on Apple. A coroutine that resumes on a different thread therefore sees an empty context rather than another coroutine's: it fails closed. Reinstalling context across a thread hop needs a ThreadContextElement, which kotlinx.coroutines only ships on JVM.

actual object LogContextHolder(source)

Holds and propagates the active LogContext for the current execution scope.

This object is implemented per-platform to use the most appropriate scoping mechanism (e.g. ThreadLocal on JVM/Android, a thread-local stack on Apple targets).

Contexts are scoped: the previous context is always restored after withContext completes, even if the block throws. Nested calls merge their contexts - inner values override outer values for the same key.

Example:

val requestContext = LogContext(mapOf("requestId" to "req-123"))

val result = LogContextHolder.withContext(requestContext) {
    logger.info { "Handling request" }
    processRequest() // return value is propagated
}
Content copied to clipboard

Functions

Link copied to clipboard
actual fun current(): LogContext

Returns the currently active LogContext for the current thread or execution scope. Returns an empty LogContext if none has been set.

actual fun current(): LogContext

Returns the currently active LogContext for the current thread or execution scope. Returns an empty LogContext if none has been set.

expect fun current(): LogContext

Returns the currently active LogContext for the current thread or execution scope. Returns an empty LogContext if none has been set.

actual fun current(): LogContext

Returns the currently active LogContext for the current thread or execution scope. Returns an empty LogContext if none has been set.

actual fun current(): LogContext

Returns the currently active LogContext for the current thread or execution scope. Returns an empty LogContext if none has been set.

actual fun current(): LogContext

Returns the currently active LogContext for the current thread or execution scope. Returns an empty LogContext if none has been set.

actual fun current(): LogContext

Returns the currently active LogContext for the current thread or execution scope. Returns an empty LogContext if none has been set.

actual fun current(): LogContext

Returns the currently active LogContext for the current thread or execution scope. Returns an empty LogContext if none has been set.

Link copied to clipboard
actual fun setContext(ctx: LogContext)

Directly sets the active LogContext for the current thread or execution scope, replacing any previously installed context without merging.

actual fun setContext(ctx: LogContext)

Directly sets the active LogContext for the current thread or execution scope, replacing any previously installed context without merging.

expect fun setContext(ctx: LogContext)

Directly sets the active LogContext for the current thread or execution scope, replacing any previously installed context without merging.

actual fun setContext(ctx: LogContext)

Directly sets the active LogContext for the current thread or execution scope, replacing any previously installed context without merging.

actual fun setContext(ctx: LogContext)

Directly sets the active LogContext for the current thread or execution scope, replacing any previously installed context without merging.

actual fun setContext(ctx: LogContext)

Directly sets the active LogContext for the current thread or execution scope, replacing any previously installed context without merging.

actual fun setContext(ctx: LogContext)

Directly sets the active LogContext for the current thread or execution scope, replacing any previously installed context without merging.

actual fun setContext(ctx: LogContext)

Directly sets the active LogContext for the current thread or execution scope, replacing any previously installed context without merging.

Link copied to clipboard
actual fun <T> withContext(ctx: LogContext, block: () -> T): T

Executes block with ctx merged into the current context, then restores the previous context regardless of whether block throws.

actual fun <T> withContext(ctx: LogContext, block: () -> T): T

Executes block with ctx merged into the current context, then restores the previous context regardless of whether block throws.

expect fun <T> withContext(ctx: LogContext, block: () -> T): T

Executes block with ctx merged into the current context, then restores the previous context regardless of whether block throws.

actual fun <T> withContext(ctx: LogContext, block: () -> T): T

Executes block with ctx merged into the current context, then restores the previous context regardless of whether block throws.

actual fun <T> withContext(ctx: LogContext, block: () -> T): T

Executes block with ctx merged into the current context, then restores the previous context regardless of whether block throws.

actual fun <T> withContext(ctx: LogContext, block: () -> T): T

Executes block with ctx merged into the current context, then restores the previous context regardless of whether block throws.

actual fun <T> withContext(ctx: LogContext, block: () -> T): T

Executes block with ctx merged into the current context, then restores the previous context regardless of whether block throws.

actual fun <T> withContext(ctx: LogContext, block: () -> T): T

Executes block with ctx merged into the current context, then restores the previous context regardless of whether block throws.

Link copied to clipboard
actual suspend fun <T> withSuspendingContext(ctx: LogContext, block: suspend () -> T): T

Suspending variant of withContext for use in coroutines. Executes block with ctx merged into the current context, then restores the previous context regardless of whether block throws or suspends.

actual suspend fun <T> withSuspendingContext(ctx: LogContext, block: suspend () -> T): T

Suspending variant of withContext for use in coroutines. Executes block with ctx merged into the current context, then restores the previous context regardless of whether block throws or suspends.

expect suspend fun <T> withSuspendingContext(ctx: LogContext, block: suspend () -> T): T

Suspending variant of withContext for use in coroutines. Executes block with ctx merged into the current context, then restores the previous context regardless of whether block throws or suspends.

actual suspend fun <T> withSuspendingContext(ctx: LogContext, block: suspend () -> T): T

Suspending variant of withContext for use in coroutines. Executes block with ctx merged into the current context, then restores the previous context regardless of whether block throws or suspends.

actual suspend fun <T> withSuspendingContext(ctx: LogContext, block: suspend () -> T): T

Suspending variant of withContext for use in coroutines. Executes block with ctx merged into the current context, then restores the previous context regardless of whether block throws or suspends.

actual suspend fun <T> withSuspendingContext(ctx: LogContext, block: suspend () -> T): T

Suspending variant of withContext for use in coroutines. Executes block with ctx merged into the current context, then restores the previous context regardless of whether block throws or suspends.

actual suspend fun <T> withSuspendingContext(ctx: LogContext, block: suspend () -> T): T

Suspending variant of withContext for use in coroutines. Executes block with ctx merged into the current context, then restores the previous context regardless of whether block throws or suspends.

actual suspend fun <T> withSuspendingContext(ctx: LogContext, block: suspend () -> T): T

Suspending variant of withContext for use in coroutines. Executes block with ctx merged into the current context, then restores the previous context regardless of whether block throws or suspends.

Generated by Dokka
© 2026 Copyright