Class: Log4r::RootLogger

Inherits:
Logger
  • Object
show all
Includes:
Singleton
Defined in:
lib/log4r/logger.rb

Overview

RootLogger should be retrieved with Logger.root or Logger.global. It's supposed to be transparent.

We must guarantee the creation of RootLogger before any other Logger or Outputter gets their logging methods defined. There are two guarantees in the code:

  • Logger#deal_with_inheritance - calls RootLogger.instance when a new Logger is created without a parent. Parents must exist, therefore RootLogger is forced to be created.

  • OutputterFactory.create_methods - Calls Logger.root first. So if an Outputter is created, RootLogger is also created.

When RootLogger is created, it calls Log4r.define_levels(*Log4rConfig::LogLevels). This ensures that the default levels are loaded if no custom ones are.

Instance Attribute Summary

Attributes inherited from Logger

#additive, #fullname, #level, #name, #outputters, #parent, #path, #trace

Instance Method Summary collapse

Methods inherited from Logger

#==, [], each, each_logger, get, global, #levels, log_internal, root

Constructor Details

#initialize ⇒ RootLogger

Returns a new instance of RootLogger.



172
173
174
175
176
177
178
179
 
# File 'lib/log4r/logger.rb', line 172

def initialize
  Log4r.define_levels(*Log4rConfig::LogLevels) # ensure levels are loaded
  @level = ALL
  @outputters = []
  Repository['root'] = self
  Repository['global'] = self
  LoggerFactory.undefine_methods(self)
end

Instance Method Details

#add(*foo) ⇒ Object

Does nothing



195
 
# File 'lib/log4r/logger.rb', line 195

def add(*foo); end

#additive=(foo) ⇒ Object

Does nothing



193
 
# File 'lib/log4r/logger.rb', line 193

def additive=(foo); end

#is_root? ⇒ Boolean

Returns:

  • (Boolean) 


181
 
# File 'lib/log4r/logger.rb', line 181

def is_root?; true end

#level=(alevel) ⇒ Object

Set the global level. Any loggers defined thereafter will not log below the global level regardless of their levels.



186
 
# File 'lib/log4r/logger.rb', line 186

def level=(alevel); @level = alevel end

#outputters=(foo) ⇒ Object

Does nothing



189
 
# File 'lib/log4r/logger.rb', line 189

def outputters=(foo); end

#remove(*foo) ⇒ Object

Does nothing



197
 
# File 'lib/log4r/logger.rb', line 197

def remove(*foo); end

#trace=(foo) ⇒ Object

Does nothing



191
 
# File 'lib/log4r/logger.rb', line 191

def trace=(foo); end