org.rocksdb

类 Logger

java.lang.Object

org.rocksdb.AbstractNativeReference

org.rocksdb.AbstractImmutableNativeReference

org.rocksdb.RocksCallbackObject

org.rocksdb.Logger

所有已实现的接口:

java.lang.AutoCloseable

public abstract class Logger
extends RocksCallbackObject

This class provides a custom logger functionality in Java which wraps RocksDB logging facilities.

Using this class RocksDB can log with common Java logging APIs like Log4j or Slf4j without keeping database logs in the filesystem.

Performance

There are certain performance penalties using a Java Logger implementation within production code.

A log level can be set using Options or setInfoLogLevel(InfoLogLevel). The set log level influences the underlying native code. Each log message is checked against the set log level and if the log level is more verbose as the set log level, native allocations will be made and data structures are allocated.

Every log message which will be emitted by native code will trigger expensive native to Java transitions. So the preferred setting for production use is either InfoLogLevel.ERROR_LEVEL or InfoLogLevel.FATAL_LEVEL.

字段概要

从类继承的字段 org.rocksdb.RocksCallbackObject

nativeHandle_

从类继承的字段 org.rocksdb.AbstractImmutableNativeReference

owningHandle_

构造器概要

构造器

构造器和说明
Logger(DBOptions dboptions) AbstractLogger constructor.
Logger(Options options) AbstractLogger constructor.

方法概要

限定符和类型	方法和说明
protected long	createNewLoggerDbOptions(long dbOptions)
protected long	createNewLoggerOptions(long options)
protected void	disposeInternal() We override RocksCallbackObject.disposeInternal() as disposing of a rocksdb::LoggerJniCallback requires a slightly different approach as it is a std::shared_ptr
InfoLogLevel	infoLogLevel() Return the loggers log level.
protected byte	infoLogLevel(long handle)
protected long	initializeNative(long... nativeParameterHandles) Construct the Native C++ object which will callback to our object methods
protected abstract void	log(InfoLogLevel infoLogLevel, java.lang.String logMsg)
void	setInfoLogLevel(InfoLogLevel infoLogLevel) Set InfoLogLevel to AbstractLogger.
protected void	setInfoLogLevel(long handle, byte infoLogLevel)

从类继承的方法 org.rocksdb.AbstractImmutableNativeReference

close, disOwnNativeHandle, isOwningHandle

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

Logger

public Logger(Options options)

AbstractLogger constructor.

Important: the log level set within the Options instance will be used as maximum log level of RocksDB.

参数:

options - Options instance.

Logger

public Logger(DBOptions dboptions)

AbstractLogger constructor.

Important: the log level set within the DBOptions instance will be used as maximum log level of RocksDB.

参数:

dboptions - DBOptions instance.

方法详细资料

initializeNative

protected long initializeNative(long... nativeParameterHandles)

从类复制的说明: RocksCallbackObject

Construct the Native C++ object which will callback to our object methods

指定者:

initializeNative 在类中 RocksCallbackObject

参数:

nativeParameterHandles - An array of native handles for any parameter objects that are needed during construction

返回:

The native handle of the C++ object which will callback to us

setInfoLogLevel

public void setInfoLogLevel(InfoLogLevel infoLogLevel)

Set InfoLogLevel to AbstractLogger.

参数:

infoLogLevel - InfoLogLevel instance.

infoLogLevel

public InfoLogLevel infoLogLevel()

Return the loggers log level.

返回:

InfoLogLevel instance.

log

protected abstract void log(InfoLogLevel infoLogLevel,
                            java.lang.String logMsg)

createNewLoggerOptions

protected long createNewLoggerOptions(long options)

createNewLoggerDbOptions

protected long createNewLoggerDbOptions(long dbOptions)

setInfoLogLevel

protected void setInfoLogLevel(long handle,
                               byte infoLogLevel)

infoLogLevel

protected byte infoLogLevel(long handle)

disposeInternal

protected void disposeInternal()

We override RocksCallbackObject.disposeInternal() as disposing of a rocksdb::LoggerJniCallback requires a slightly different approach as it is a std::shared_ptr

覆盖:

disposeInternal 在类中 RocksCallbackObject