at

public FluentLogger2.Api at(Level level)

Returns a fluent logging API appropriate for the specified log level.

If a logger implementation determines that logging is definitely disabled at this point then this method is expected to return a "no-op" implementation of that logging API, which will result in all further calls made for the log statement to being silently ignored.

A simple implementation of this method in a concrete subclass might look like:


boolean isLoggable = isLoggable(level);
boolean isForced = Platform.shouldForceLogging(getName(), level, isLoggable);
return (isLoggable | isForced) ? new SubContext(level, isForced) : NO_OP;
where NO_OP is a singleton, no-op instance of the logging API whose methods do nothing and just return noOp().