Package com.linecorp.armeria.common.logging

Interface ResponseLogLevelMapper

All Superinterfaces:

Function<RequestLog,LogLevel>

Functional Interface:

This is a functional interface and can therefore be used as the assignment target for a lambda expression or method reference.

@UnstableApi
@FunctionalInterface
public interface ResponseLogLevelMapper
extends Function<RequestLog,LogLevel>

A Function that determines the LogLevel of an HttpResponse from a given RequestLog.

See Also:

• LogWriterBuilder.responseLogLevelMapper(ResponseLogLevelMapper)

Method Summary

Modifier and Type	Method	Description
default <V> Function<RequestLog,V>	andThen(Function<? super LogLevel,? extends V> after)	Deprecated. Do not use this method.
@Nullable LogLevel	apply(RequestLog log)	Returns a LogLevel for the given RequestLog.
default <V> Function<V,LogLevel>	compose(Function<? super V,? extends RequestLog> before)	Deprecated. Do not use this method.
static ResponseLogLevelMapper	of(HttpStatusClass statusClass, LogLevel logLevel)	Creates a new ResponseLogLevelMapper which returns the specified LogLevel if the given RequestLog.responseStatus() belongs to the specified HttpStatusClass.
static ResponseLogLevelMapper	of(HttpStatus status, LogLevel logLevel)	Creates a new ResponseLogLevelMapper which returns the specified LogLevel if the given RequestLog.responseStatus() is equal to the specified HttpStatus.
static ResponseLogLevelMapper	of(LogLevel successfulResponseLogLevel, LogLevel failureResponseLogLevel)	Returns the default ResponseLogLevelMapper which returns the specified successfulResponseLogLevel when logging successful responses (e.g., no unhandled exception) and failureResponseLogLevel if failure.
static ResponseLogLevelMapper	of(Class<? extends Throwable> clazz, LogLevel logLevel)	Creates a new ResponseLogLevelMapper which returns the specified LogLevel if the given class of RequestLog.responseCause() is assignable from the specified Throwable class.
default ResponseLogLevelMapper	orElse(ResponseLogLevelMapper other)	Returns a composed ResponseLogLevelMapper which represents a logical OR of this ResponseLogLevelMapper and the given other.

Method Details

of

static ResponseLogLevelMapper of(LogLevel successfulResponseLogLevel,
 LogLevel failureResponseLogLevel)

Returns the default ResponseLogLevelMapper which returns the specified successfulResponseLogLevel when logging successful responses (e.g., no unhandled exception) and failureResponseLogLevel if failure.

of

static ResponseLogLevelMapper of(HttpStatus status,
 LogLevel logLevel)

Creates a new ResponseLogLevelMapper which returns the specified LogLevel if the given RequestLog.responseStatus() is equal to the specified HttpStatus.

of

static ResponseLogLevelMapper of(HttpStatusClass statusClass,
 LogLevel logLevel)

Creates a new ResponseLogLevelMapper which returns the specified LogLevel if the given RequestLog.responseStatus() belongs to the specified HttpStatusClass.

of

static ResponseLogLevelMapper of(Class<? extends Throwable> clazz,
 LogLevel logLevel)

Creates a new ResponseLogLevelMapper which returns the specified LogLevel if the given class of RequestLog.responseCause() is assignable from the specified Throwable class.

apply

@Nullable
@Nullable LogLevel apply(RequestLog log)

Returns a LogLevel for the given RequestLog. Returning null lets the next handler specified with orElse(ResponseLogLevelMapper) map the RequestLog.

Specified by:

apply in interface Function<RequestLog,LogLevel>

orElse

default ResponseLogLevelMapper orElse(ResponseLogLevelMapper other)

Returns a composed ResponseLogLevelMapper which represents a logical OR of this ResponseLogLevelMapper and the given other. If this apply(RequestLog) returns null, then the other ResponseLogLevelMapper will be applied.

compose

@Deprecated
default <V> Function<V,LogLevel> compose(Function<? super V,? extends RequestLog> before)

Deprecated.

Do not use this method.

Returns a composed function that first applies the before function to its input, and then applies this function to the result. If evaluation of either function throws an exception, it is relayed to the caller of the composed function.

Specified by:

compose in interface Function<RequestLog,LogLevel>

andThen

@Deprecated
default <V> Function<RequestLog,V> andThen(Function<? super LogLevel,? extends V> after)

Deprecated.

Do not use this method.

Returns a composed function that first applies this function to its input, and then applies the after function to the result. If evaluation of either function throws an exception, it is relayed to the caller of the composed function.

Specified by:

andThen in interface Function<RequestLog,LogLevel>