com::avpkit::ferry::Logger Class Reference

Internal Only. More...

#include <Logger.h>

Public Types
enum	Level {   LEVEL_ERROR =0 , LEVEL_WARN =1 , LEVEL_INFO =2 , LEVEL_DEBUG =3 ,   LEVEL_TRACE =4 }
	Different logging levels (noiseness) supported by us.
typedef enum com::avpkit::ferry::Logger::Level	Level
	Different logging levels (noiseness) supported by us.

Public Member Functions
bool	log (const char *filename, int lineNo, Level level, const char *format,...)
	Log the message to the logger, using sprintf() format strings. More...
bool	logVA (const char *filename, int lineNo, Level level, const char *format, va_list ap)
bool	error (const char *filename, int lineNo, const char *format,...)
bool	warn (const char *filename, int lineNo, const char *format,...)
bool	info (const char *filename, int lineNo, const char *format,...)
bool	debug (const char *filename, int lineNo, const char *format,...)
bool	trace (const char *filename, int lineNo, const char *format,...)
bool	isLogging (Level level)
void	setIsLogging (Level level, bool value)
const char *	getName ()

Static Public Member Functions
static Logger *	getLogger (const char *aLoggerName)
	Returns a new Logger object for this loggerName. More...
static Logger *	getStaticLogger (const char *aLoggerName)
	Get a Logger object, but ask the Logger code to free it up once the JavaVM shuts down. More...
static bool	isGlobalLogging (Level level)
static void	setGlobalIsLogging (Level level, bool value)

Protected Member Functions
	Logger (const char *loggerName, jobject aJavaLogger)

Detailed Description

Internal Only.

C++ wrapper to SLF4J Java Logging frame work.

If not running inside a JVM, then this class just does a rudimentary printout of log messages to stderr.

Otherwise, it forwards to Java's SLF4J logging framework.

Definition at line 47 of file Logger.h.

Member Function Documentation

getLogger()

Logger * com::avpkit::ferry::Logger::getLogger ( const char *  aLoggerName )

static

Returns a new Logger object for this loggerName.

Parameters

aLoggerName

A name (no spaces allowed) for this logger.

Returns

a New logger for logging; caller must delete when done.

Definition at line 143 of file Logger.cpp.

  {
 
    Logger* retval = 0;
    if (loggerName && *loggerName)
    {
      if (mGetLoggerMethod)
      {
        JNIEnv *env=JNIHelper::sGetEnv();
        if (env)
        {
          jobject javaLogger = 0;
          jstring jLoggerName = env->NewStringUTF(loggerName);
          // Time to get a Java Logger
          javaLogger = env->CallStaticObjectMethod(mClass,
              mGetLoggerMethod, jLoggerName);
          env->DeleteLocalRef(jLoggerName);
          jLoggerName = 0;
 
          retval = new Logger(loggerName, javaLogger);
 
          if (javaLogger)
            env->DeleteLocalRef(javaLogger);
          javaLogger = 0;
        }
      } else {
        retval = new Logger(loggerName, 0);
      }
 
    }
    return retval;
  }

Referenced by getStaticLogger().

getStaticLogger()

Logger * com::avpkit::ferry::Logger::getStaticLogger ( const char *  aLoggerName )

static

Get a Logger object, but ask the Logger code to free it up once the JavaVM shuts down.

Use at your own risk.

Parameters

aLoggerName

A name (no spaces allowed) for this logger.

Returns

A new logger for logging; caller must not call delete and must not use the logger once the JavaVM (or main) has exited.

Definition at line 177 of file Logger.cpp.

  {
    Logger* logger = 0;
 
    logger = Logger::getLogger(aLoggerName);
    if (logger)
    {
        // Register a function to kill it when the JNIHelper says we
        // can
        JNIHelper::sRegisterTerminationCallback(Logger::shutdownJavaBindings,
            logger);
    }
    return logger;
  }

References getLogger().

log()

bool com::avpkit::ferry::Logger::log	(	const char *	filename,
		int	lineNo,
		Level	level,
		const char *	format,
			...
	)

Log the message to the logger, using sprintf() format strings.

Parameters

filename	The filename that is logging, or NULL.
lineNo	The line number where this log statement is executed from. or 0.
level	Level to log at.
format	A format specification string, in sprintf format.

Returns

if the message was actually logged.

Definition at line 324 of file Logger.cpp.

  {
    bool didLog = false;
    va_list ap;
 
    va_start(ap, fmt);
    didLog = this->logVA(filename, line, level, fmt, ap);
    va_end(ap);
    return didLog;
  }

---

The documentation for this class was generated from the following files:

• csrc/com/avpkit/ferry/Logger.h
• csrc/com/avpkit/ferry/Logger.cpp