log4r 1.1.6 → 1.1.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- data/README +3 -3
 - data/Rakefile +2 -2
 - data/doc/rdoc/Log4r.html +519 -0
 - data/doc/rdoc/Log4r/BasicFormatter.html +388 -0
 - data/doc/rdoc/Log4r/ConfigError.html +225 -0
 - data/doc/rdoc/Log4r/Configurator.html +1068 -0
 - data/doc/rdoc/Log4r/DateFileOutputter.html +479 -0
 - data/doc/rdoc/Log4r/DefaultFormatter.html +223 -0
 - data/doc/rdoc/Log4r/EmailOutputter.html +654 -0
 - data/doc/rdoc/Log4r/FileOutputter.html +346 -0
 - data/doc/rdoc/Log4r/Formatter.html +309 -0
 - data/doc/rdoc/Log4r/GDC.html +346 -0
 - data/doc/rdoc/Log4r/GDC_rb.html +80 -0
 - data/doc/rdoc/Log4r/IOOutputter.html +410 -0
 - data/doc/rdoc/Log4r/Log4jXmlFormatter.html +337 -0
 - data/doc/rdoc/Log4r/Log4rConfig.html +211 -0
 - data/doc/rdoc/Log4r/Log4rTools.html +388 -0
 - data/doc/rdoc/Log4r/LogEvent.html +378 -0
 - data/doc/rdoc/Log4r/LogServer.html +340 -0
 - data/doc/rdoc/Log4r/Logger.html +1150 -0
 - data/doc/rdoc/Log4r/Logger/LoggerFactory.html +218 -0
 - data/doc/rdoc/Log4r/Logger/Repository.html +225 -0
 - data/doc/rdoc/Log4r/MDC.html +424 -0
 - data/doc/rdoc/Log4r/MDC_rb.html +83 -0
 - data/doc/rdoc/Log4r/NDC.html +632 -0
 - data/doc/rdoc/Log4r/NDC_rb.html +110 -0
 - data/doc/rdoc/Log4r/ObjectFormatter.html +280 -0
 - data/doc/rdoc/Log4r/Outputter.html +934 -0
 - data/doc/rdoc/Log4r/Outputter/OutputterFactory.html +218 -0
 - data/doc/rdoc/Log4r/Outputter/consoleoutputters_rb.html +57 -0
 - data/doc/rdoc/Log4r/Outputter/datefileoutputter_rb.html +93 -0
 - data/doc/rdoc/Log4r/Outputter/emailoutputter_rb.html +179 -0
 - data/doc/rdoc/Log4r/Outputter/fileoutputter_rb.html +64 -0
 - data/doc/rdoc/Log4r/Outputter/iooutputter_rb.html +59 -0
 - data/doc/rdoc/Log4r/Outputter/outputter_rb.html +222 -0
 - data/doc/rdoc/Log4r/Outputter/outputterfactory_rb.html +62 -0
 - data/doc/rdoc/Log4r/Outputter/remoteoutputter_rb.html +59 -0
 - data/doc/rdoc/Log4r/Outputter/rollingfileoutputter_rb.html +66 -0
 - data/doc/rdoc/Log4r/Outputter/staticoutputter_rb.html +55 -0
 - data/doc/rdoc/Log4r/Outputter/syslogoutputter_rb.html +110 -0
 - data/doc/rdoc/Log4r/Outputter/udpoutputter_rb.html +220 -0
 - data/doc/rdoc/Log4r/PatternFormatter.html +404 -0
 - data/doc/rdoc/Log4r/ROMPClient.html +211 -0
 - data/doc/rdoc/Log4r/ROMPServer.html +211 -0
 - data/doc/rdoc/Log4r/RemoteOutputter.html +402 -0
 - data/doc/rdoc/Log4r/RollingFileOutputter.html +551 -0
 - data/doc/rdoc/Log4r/RootLogger.html +530 -0
 - data/doc/rdoc/Log4r/SimpleFormatter.html +276 -0
 - data/doc/rdoc/Log4r/StderrOutputter.html +268 -0
 - data/doc/rdoc/Log4r/StdoutOutputter.html +268 -0
 - data/doc/rdoc/Log4r/SyslogOutputter.html +551 -0
 - data/doc/rdoc/Log4r/UDPOutputter.html +379 -0
 - data/doc/rdoc/Log4r/YamlConfigurator.html +966 -0
 - data/doc/rdoc/Log4r/base_rb.html +57 -0
 - data/doc/rdoc/Log4r/config_rb.html +122 -0
 - data/doc/rdoc/Log4r/configurator_rb.html +370 -0
 - data/doc/rdoc/Log4r/formatter/formatter_rb.html +121 -0
 - data/doc/rdoc/Log4r/formatter/log4jxmlformatter_rb.html +64 -0
 - data/doc/rdoc/Log4r/formatter/patternformatter_rb.html +239 -0
 - data/doc/rdoc/Log4r/lib/drbloader_rb.html +57 -0
 - data/doc/rdoc/Log4r/lib/xmlloader_rb.html +57 -0
 - data/doc/rdoc/Log4r/logevent_rb.html +55 -0
 - data/doc/rdoc/Log4r/logger_rb.html +293 -0
 - data/doc/rdoc/Log4r/loggerfactory_rb.html +66 -0
 - data/doc/rdoc/Log4r/logserver_rb.html +161 -0
 - data/doc/rdoc/Log4r/rdoc/GDC.html +175 -0
 - data/doc/rdoc/Log4r/rdoc/MDC.html +178 -0
 - data/doc/rdoc/Log4r/rdoc/NDC.html +207 -0
 - data/doc/rdoc/Log4r/rdoc/configurator.html +462 -0
 - data/doc/rdoc/Log4r/rdoc/emailoutputter.html +279 -0
 - data/doc/rdoc/Log4r/rdoc/formatter.html +218 -0
 - data/doc/rdoc/Log4r/rdoc/log4r.html +286 -0
 - data/doc/rdoc/Log4r/rdoc/logger.html +382 -0
 - data/doc/rdoc/Log4r/rdoc/logserver.html +265 -0
 - data/doc/rdoc/Log4r/rdoc/outputter.html +313 -0
 - data/doc/rdoc/Log4r/rdoc/patternformatter.html +331 -0
 - data/doc/rdoc/Log4r/rdoc/syslogoutputter.html +197 -0
 - data/doc/rdoc/Log4r/rdoc/win32eventoutputter.html +165 -0
 - data/doc/rdoc/Log4r/rdoc/yamlconfigurator.html +187 -0
 - data/doc/rdoc/Log4r/repository_rb.html +74 -0
 - data/doc/rdoc/Log4r/staticlogger_rb.html +55 -0
 - data/doc/rdoc/Log4r/yamlconfigurator_rb.html +95 -0
 - data/doc/rdoc/REXML.html +211 -0
 - data/doc/rdoc/created.rid +1 -0
 - data/doc/rdoc/images/brick.png +0 -0
 - data/doc/rdoc/images/brick_link.png +0 -0
 - data/doc/rdoc/images/bug.png +0 -0
 - data/doc/rdoc/images/bullet_black.png +0 -0
 - data/doc/rdoc/images/bullet_toggle_minus.png +0 -0
 - data/doc/rdoc/images/bullet_toggle_plus.png +0 -0
 - data/doc/rdoc/images/date.png +0 -0
 - data/doc/rdoc/images/find.png +0 -0
 - data/doc/rdoc/images/loadingAnimation.gif +0 -0
 - data/doc/rdoc/images/macFFBgHack.png +0 -0
 - data/doc/rdoc/images/package.png +0 -0
 - data/doc/rdoc/images/page_green.png +0 -0
 - data/doc/rdoc/images/page_white_text.png +0 -0
 - data/doc/rdoc/images/page_white_width.png +0 -0
 - data/doc/rdoc/images/plugin.png +0 -0
 - data/doc/rdoc/images/ruby.png +0 -0
 - data/doc/rdoc/images/tag_green.png +0 -0
 - data/doc/rdoc/images/wrench.png +0 -0
 - data/doc/rdoc/images/wrench_orange.png +0 -0
 - data/doc/rdoc/images/zoom.png +0 -0
 - data/doc/rdoc/index.html +585 -0
 - data/doc/rdoc/js/darkfish.js +116 -0
 - data/doc/rdoc/js/jquery.js +32 -0
 - data/doc/rdoc/js/quicksearch.js +114 -0
 - data/doc/rdoc/js/thickbox-compressed.js +10 -0
 - data/doc/rdoc/log4r-rdoc.css +696 -0
 - data/doc/rdoc/log4r_rb.html +207 -0
 - data/doc/rdoc/rdoc.css +696 -0
 - data/examples/rdoc-gen +2 -0
 - data/src/log4r.rb +2 -2
 - data/src/log4r/formatter/patternformatter.rb +15 -15
 - data/src/log4r/outputter/udpoutputter.rb +4 -4
 - data/tests/testchainsaw.rb +1 -1
 - metadata +123 -8
 - data/src/log4r/outputter/datefileoutputter.patch +0 -24
 - data/src/log4r/outputter/diff +0 -14
 - data/src/log4r/outputter/new-datefileoutputter.rb +0 -117
 
| 
         @@ -0,0 +1,161 @@ 
     | 
|
| 
      
 1 
     | 
    
         
            +
            <?xml version="1.0" encoding="utf-8"?>
         
     | 
| 
      
 2 
     | 
    
         
            +
            <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
         
     | 
| 
      
 3 
     | 
    
         
            +
            	"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
         
     | 
| 
      
 4 
     | 
    
         
            +
             
     | 
| 
      
 5 
     | 
    
         
            +
            <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
         
     | 
| 
      
 6 
     | 
    
         
            +
            <head>
         
     | 
| 
      
 7 
     | 
    
         
            +
            	<meta content="text/html; charset=utf-8" http-equiv="Content-Type" />
         
     | 
| 
      
 8 
     | 
    
         
            +
             
     | 
| 
      
 9 
     | 
    
         
            +
            	<title>File: logserver.rb [1.1.7 Log4r API]</title>
         
     | 
| 
      
 10 
     | 
    
         
            +
             
     | 
| 
      
 11 
     | 
    
         
            +
            	<link type="text/css" media="screen" href="../rdoc.css" rel="stylesheet" />
         
     | 
| 
      
 12 
     | 
    
         
            +
             
     | 
| 
      
 13 
     | 
    
         
            +
            	<script src="../js/jquery.js" type="text/javascript"
         
     | 
| 
      
 14 
     | 
    
         
            +
            		charset="utf-8"></script>
         
     | 
| 
      
 15 
     | 
    
         
            +
            	<script src="../js/thickbox-compressed.js" type="text/javascript"
         
     | 
| 
      
 16 
     | 
    
         
            +
            		charset="utf-8"></script>
         
     | 
| 
      
 17 
     | 
    
         
            +
            	<script src="../js/quicksearch.js" type="text/javascript"
         
     | 
| 
      
 18 
     | 
    
         
            +
            		charset="utf-8"></script>
         
     | 
| 
      
 19 
     | 
    
         
            +
            	<script src="../js/darkfish.js" type="text/javascript"
         
     | 
| 
      
 20 
     | 
    
         
            +
            		charset="utf-8"></script>
         
     | 
| 
      
 21 
     | 
    
         
            +
            </head>
         
     | 
| 
      
 22 
     | 
    
         
            +
             
     | 
| 
      
 23 
     | 
    
         
            +
            <body class="file file-popup">
         
     | 
| 
      
 24 
     | 
    
         
            +
            	<div id="metadata">
         
     | 
| 
      
 25 
     | 
    
         
            +
            		<dl>
         
     | 
| 
      
 26 
     | 
    
         
            +
            			<dt class="modified-date">Last Modified</dt>
         
     | 
| 
      
 27 
     | 
    
         
            +
            			<dd class="modified-date">Thu Mar 18 19:31:07 -0800 2004</dd>
         
     | 
| 
      
 28 
     | 
    
         
            +
             
     | 
| 
      
 29 
     | 
    
         
            +
            			
         
     | 
| 
      
 30 
     | 
    
         
            +
            			<dt class="requires">Requires</dt>
         
     | 
| 
      
 31 
     | 
    
         
            +
            			<dd class="requires">
         
     | 
| 
      
 32 
     | 
    
         
            +
            				<ul>
         
     | 
| 
      
 33 
     | 
    
         
            +
            				
         
     | 
| 
      
 34 
     | 
    
         
            +
            					<li>log4r/logger</li>
         
     | 
| 
      
 35 
     | 
    
         
            +
            				
         
     | 
| 
      
 36 
     | 
    
         
            +
            					<li>log4r/lib/drbloader</li>
         
     | 
| 
      
 37 
     | 
    
         
            +
            				
         
     | 
| 
      
 38 
     | 
    
         
            +
            				</ul>
         
     | 
| 
      
 39 
     | 
    
         
            +
            			</dd>
         
     | 
| 
      
 40 
     | 
    
         
            +
            			
         
     | 
| 
      
 41 
     | 
    
         
            +
             
     | 
| 
      
 42 
     | 
    
         
            +
            			
         
     | 
| 
      
 43 
     | 
    
         
            +
            		</dl>
         
     | 
| 
      
 44 
     | 
    
         
            +
            	</div>
         
     | 
| 
      
 45 
     | 
    
         
            +
             
     | 
| 
      
 46 
     | 
    
         
            +
            	<div id="documentation">
         
     | 
| 
      
 47 
     | 
    
         
            +
            		
         
     | 
| 
      
 48 
     | 
    
         
            +
            		<div class="description">
         
     | 
| 
      
 49 
     | 
    
         
            +
            			<h2>Description</h2>
         
     | 
| 
      
 50 
     | 
    
         
            +
            			<h1>Remote Logging</h1>
         
     | 
| 
      
 51 
     | 
    
         
            +
            <p>
         
     | 
| 
      
 52 
     | 
    
         
            +
            Want to use <a href="../Log4r.html">Log4r</a> over a network? No problem! A
         
     | 
| 
      
 53 
     | 
    
         
            +
            <a href="../Log4r/RemoteOutputter.html">Log4r::RemoteOutputter</a> will
         
     | 
| 
      
 54 
     | 
    
         
            +
            send its LogEvents to a <a
         
     | 
| 
      
 55 
     | 
    
         
            +
            href="../Log4r/LogServer.html">Log4r::LogServer</a>. These two classes are
         
     | 
| 
      
 56 
     | 
    
         
            +
            as easy to set up and use as the rest of <a href="../Log4r.html">Log4r</a>.
         
     | 
| 
      
 57 
     | 
    
         
            +
            </p>
         
     | 
| 
      
 58 
     | 
    
         
            +
            <h2>Use ROMP</h2>
         
     | 
| 
      
 59 
     | 
    
         
            +
            <p>
         
     | 
| 
      
 60 
     | 
    
         
            +
            There is one catch though: ROMP is required to use this service. It is a
         
     | 
| 
      
 61 
     | 
    
         
            +
            DRb-like system with superb performance and better features. Get ROMP at <a
         
     | 
| 
      
 62 
     | 
    
         
            +
            href="http://rubystuff.org/romp/">rubystuff.org/romp/</a>
         
     | 
| 
      
 63 
     | 
    
         
            +
            </p>
         
     | 
| 
      
 64 
     | 
    
         
            +
            <h2>LogServer</h2>
         
     | 
| 
      
 65 
     | 
    
         
            +
            <p>
         
     | 
| 
      
 66 
     | 
    
         
            +
            LogServer is simply a kind of Logger which embeds a ROMP::Server. Like a
         
     | 
| 
      
 67 
     | 
    
         
            +
            normal Logger, you can give it Outputters, set its level and so on. Its
         
     | 
| 
      
 68 
     | 
    
         
            +
            logging methods are accessible over a network and are called by a
         
     | 
| 
      
 69 
     | 
    
         
            +
            RemoteOutputter on another host.
         
     | 
| 
      
 70 
     | 
    
         
            +
            </p>
         
     | 
| 
      
 71 
     | 
    
         
            +
            <h3>LogServer Setup</h3>
         
     | 
| 
      
 72 
     | 
    
         
            +
            <p>
         
     | 
| 
      
 73 
     | 
    
         
            +
            Setup is easy. First,
         
     | 
| 
      
 74 
     | 
    
         
            +
            </p>
         
     | 
| 
      
 75 
     | 
    
         
            +
            <pre>
         
     | 
| 
      
 76 
     | 
    
         
            +
              require 'log4r/logserver'
         
     | 
| 
      
 77 
     | 
    
         
            +
            </pre>
         
     | 
| 
      
 78 
     | 
    
         
            +
            <p>
         
     | 
| 
      
 79 
     | 
    
         
            +
            The following sets up a LogServer named ‘central’ on localhost
         
     | 
| 
      
 80 
     | 
    
         
            +
            port 9999:
         
     | 
| 
      
 81 
     | 
    
         
            +
            </p>
         
     | 
| 
      
 82 
     | 
    
         
            +
            <pre>
         
     | 
| 
      
 83 
     | 
    
         
            +
              LogServer.new('central', 'tcpromp://localhost:9999')
         
     | 
| 
      
 84 
     | 
    
         
            +
            </pre>
         
     | 
| 
      
 85 
     | 
    
         
            +
            <p>
         
     | 
| 
      
 86 
     | 
    
         
            +
            We manipulate it and give it outputters as normal:
         
     | 
| 
      
 87 
     | 
    
         
            +
            </p>
         
     | 
| 
      
 88 
     | 
    
         
            +
            <pre>
         
     | 
| 
      
 89 
     | 
    
         
            +
              serv = Logger['central']              # grab our new LogServer
         
     | 
| 
      
 90 
     | 
    
         
            +
              serv.add 'stdout'                     # make it log to $stdout
         
     | 
| 
      
 91 
     | 
    
         
            +
            </pre>
         
     | 
| 
      
 92 
     | 
    
         
            +
            <h2>RemoteOutputter</h2>
         
     | 
| 
      
 93 
     | 
    
         
            +
            <p>
         
     | 
| 
      
 94 
     | 
    
         
            +
            RemoteOutputter is simply a kind of Outputter that embeds a ROMP::Client.
         
     | 
| 
      
 95 
     | 
    
         
            +
            When RemoteOutputter gets a LogEvent, it will forward it to whatever
         
     | 
| 
      
 96 
     | 
    
         
            +
            LogServer it’s connected to. In essence, RemoteOutputter behaves like
         
     | 
| 
      
 97 
     | 
    
         
            +
            a Logger that is forwarding a LogEvent to another Logger (as is done in
         
     | 
| 
      
 98 
     | 
    
         
            +
            hierarchical logging).
         
     | 
| 
      
 99 
     | 
    
         
            +
            </p>
         
     | 
| 
      
 100 
     | 
    
         
            +
            <h3>RemoteOutputter Setup</h3>
         
     | 
| 
      
 101 
     | 
    
         
            +
            <p>
         
     | 
| 
      
 102 
     | 
    
         
            +
            First,
         
     | 
| 
      
 103 
     | 
    
         
            +
            </p>
         
     | 
| 
      
 104 
     | 
    
         
            +
            <pre>
         
     | 
| 
      
 105 
     | 
    
         
            +
              require 'log4r/outputter/remoteoutputter'
         
     | 
| 
      
 106 
     | 
    
         
            +
            </pre>
         
     | 
| 
      
 107 
     | 
    
         
            +
            <p>
         
     | 
| 
      
 108 
     | 
    
         
            +
            Unlike typical outputters, RemoteOutputter doesn’t do any formatting.
         
     | 
| 
      
 109 
     | 
    
         
            +
            That’s up to the LogServer’s outputters. Otherwise,
         
     | 
| 
      
 110 
     | 
    
         
            +
            RemoteOutputter can be set up as usual. The ROMP uri of the LogServer must
         
     | 
| 
      
 111 
     | 
    
         
            +
            be specified.
         
     | 
| 
      
 112 
     | 
    
         
            +
            </p>
         
     | 
| 
      
 113 
     | 
    
         
            +
            <pre>
         
     | 
| 
      
 114 
     | 
    
         
            +
              RemoteOutputter.new 'client', :uri=>'tcpromp://localhost:9999'
         
     | 
| 
      
 115 
     | 
    
         
            +
            </pre>
         
     | 
| 
      
 116 
     | 
    
         
            +
            <h3>Using RemoteOutputter</h3>
         
     | 
| 
      
 117 
     | 
    
         
            +
            <p>
         
     | 
| 
      
 118 
     | 
    
         
            +
            Give our new RemoteOutputter to a logger:
         
     | 
| 
      
 119 
     | 
    
         
            +
            </p>
         
     | 
| 
      
 120 
     | 
    
         
            +
            <pre>
         
     | 
| 
      
 121 
     | 
    
         
            +
              mylog = Logger['mylog']
         
     | 
| 
      
 122 
     | 
    
         
            +
              mylog.add 'client'
         
     | 
| 
      
 123 
     | 
    
         
            +
            </pre>
         
     | 
| 
      
 124 
     | 
    
         
            +
            <p>
         
     | 
| 
      
 125 
     | 
    
         
            +
            Now, whenever mylog generates a LogEvent, LogServer should get a copy.
         
     | 
| 
      
 126 
     | 
    
         
            +
            Doing the following:
         
     | 
| 
      
 127 
     | 
    
         
            +
            </p>
         
     | 
| 
      
 128 
     | 
    
         
            +
            <pre>
         
     | 
| 
      
 129 
     | 
    
         
            +
              mylog.info "This is a message from 'mylog'"
         
     | 
| 
      
 130 
     | 
    
         
            +
            </pre>
         
     | 
| 
      
 131 
     | 
    
         
            +
            <p>
         
     | 
| 
      
 132 
     | 
    
         
            +
            Produces this output on LogServer’s console:
         
     | 
| 
      
 133 
     | 
    
         
            +
            </p>
         
     | 
| 
      
 134 
     | 
    
         
            +
            <pre>
         
     | 
| 
      
 135 
     | 
    
         
            +
              INFO mylog: This is a message from 'mylog'
         
     | 
| 
      
 136 
     | 
    
         
            +
            </pre>
         
     | 
| 
      
 137 
     | 
    
         
            +
            <h2>XML Configuration</h2>
         
     | 
| 
      
 138 
     | 
    
         
            +
            <p>
         
     | 
| 
      
 139 
     | 
    
         
            +
            RemoteOutputter is set up like normal Outputters. LogServer is set up like
         
     | 
| 
      
 140 
     | 
    
         
            +
            a normal Logger, but with an element name of logserver instead of logger:
         
     | 
| 
      
 141 
     | 
    
         
            +
            </p>
         
     | 
| 
      
 142 
     | 
    
         
            +
            <pre>
         
     | 
| 
      
 143 
     | 
    
         
            +
              <log4r_config>
         
     | 
| 
      
 144 
     | 
    
         
            +
                <logserver name="name" uri="tcpromp://localhost:9999">
         
     | 
| 
      
 145 
     | 
    
         
            +
                ...
         
     | 
| 
      
 146 
     | 
    
         
            +
            </pre>
         
     | 
| 
      
 147 
     | 
    
         
            +
            <h2>Debugging</h2>
         
     | 
| 
      
 148 
     | 
    
         
            +
            <p>
         
     | 
| 
      
 149 
     | 
    
         
            +
            It is recommended to set up a logger named ‘log4r’ on both the
         
     | 
| 
      
 150 
     | 
    
         
            +
            server and client to see what LogServer and RemoteOutputter are up to. Both
         
     | 
| 
      
 151 
     | 
    
         
            +
            of the classes use Log4r’s internal logging to report any problems.
         
     | 
| 
      
 152 
     | 
    
         
            +
            See the section <b>What’s Going on Inside?</b> in <a
         
     | 
| 
      
 153 
     | 
    
         
            +
            href="../log4r_rb.html">log4r.rb</a> for more info.
         
     | 
| 
      
 154 
     | 
    
         
            +
            </p>
         
     | 
| 
      
 155 
     | 
    
         
            +
             
     | 
| 
      
 156 
     | 
    
         
            +
            		</div>
         
     | 
| 
      
 157 
     | 
    
         
            +
            		
         
     | 
| 
      
 158 
     | 
    
         
            +
            	</div>
         
     | 
| 
      
 159 
     | 
    
         
            +
            </body>
         
     | 
| 
      
 160 
     | 
    
         
            +
            </html>
         
     | 
| 
      
 161 
     | 
    
         
            +
             
     | 
| 
         @@ -0,0 +1,175 @@ 
     | 
|
| 
      
 1 
     | 
    
         
            +
            <?xml version="1.0" encoding="utf-8"?>
         
     | 
| 
      
 2 
     | 
    
         
            +
            <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
         
     | 
| 
      
 3 
     | 
    
         
            +
            	"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
         
     | 
| 
      
 4 
     | 
    
         
            +
             
     | 
| 
      
 5 
     | 
    
         
            +
            <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
         
     | 
| 
      
 6 
     | 
    
         
            +
            <head>
         
     | 
| 
      
 7 
     | 
    
         
            +
            	<meta content="text/html; charset=utf-8" http-equiv="Content-Type" />
         
     | 
| 
      
 8 
     | 
    
         
            +
             
     | 
| 
      
 9 
     | 
    
         
            +
            	<title>File: GDC [1.1.7 Log4r API]</title>
         
     | 
| 
      
 10 
     | 
    
         
            +
             
     | 
| 
      
 11 
     | 
    
         
            +
            	<link type="text/css" media="screen" href="../../rdoc.css" rel="stylesheet" />
         
     | 
| 
      
 12 
     | 
    
         
            +
             
     | 
| 
      
 13 
     | 
    
         
            +
            	<script src="../../js/jquery.js" type="text/javascript"
         
     | 
| 
      
 14 
     | 
    
         
            +
            		charset="utf-8"></script>
         
     | 
| 
      
 15 
     | 
    
         
            +
            	<script src="../../js/thickbox-compressed.js" type="text/javascript"
         
     | 
| 
      
 16 
     | 
    
         
            +
            		charset="utf-8"></script>
         
     | 
| 
      
 17 
     | 
    
         
            +
            	<script src="../../js/quicksearch.js" type="text/javascript"
         
     | 
| 
      
 18 
     | 
    
         
            +
            		charset="utf-8"></script>
         
     | 
| 
      
 19 
     | 
    
         
            +
            	<script src="../../js/darkfish.js" type="text/javascript"
         
     | 
| 
      
 20 
     | 
    
         
            +
            		charset="utf-8"></script>
         
     | 
| 
      
 21 
     | 
    
         
            +
            </head>
         
     | 
| 
      
 22 
     | 
    
         
            +
             
     | 
| 
      
 23 
     | 
    
         
            +
            <body class="file">
         
     | 
| 
      
 24 
     | 
    
         
            +
            	<div id="metadata">
         
     | 
| 
      
 25 
     | 
    
         
            +
            		<div id="project-metadata">
         
     | 
| 
      
 26 
     | 
    
         
            +
            			
         
     | 
| 
      
 27 
     | 
    
         
            +
            			
         
     | 
| 
      
 28 
     | 
    
         
            +
            			<div id="fileindex-section" class="section project-section">
         
     | 
| 
      
 29 
     | 
    
         
            +
            				<h3 class="section-header">Files</h3>
         
     | 
| 
      
 30 
     | 
    
         
            +
            				<ul>
         
     | 
| 
      
 31 
     | 
    
         
            +
            				
         
     | 
| 
      
 32 
     | 
    
         
            +
            					<li class="file"><a href="../../log4r/rdoc/GDC.html">GDC</a></li>
         
     | 
| 
      
 33 
     | 
    
         
            +
            				
         
     | 
| 
      
 34 
     | 
    
         
            +
            					<li class="file"><a href="../../log4r/rdoc/MDC.html">MDC</a></li>
         
     | 
| 
      
 35 
     | 
    
         
            +
            				
         
     | 
| 
      
 36 
     | 
    
         
            +
            					<li class="file"><a href="../../log4r/rdoc/NDC.html">NDC</a></li>
         
     | 
| 
      
 37 
     | 
    
         
            +
            				
         
     | 
| 
      
 38 
     | 
    
         
            +
            					<li class="file"><a href="../../log4r/rdoc/configurator.html">configurator</a></li>
         
     | 
| 
      
 39 
     | 
    
         
            +
            				
         
     | 
| 
      
 40 
     | 
    
         
            +
            					<li class="file"><a href="../../log4r/rdoc/emailoutputter.html">emailoutputter</a></li>
         
     | 
| 
      
 41 
     | 
    
         
            +
            				
         
     | 
| 
      
 42 
     | 
    
         
            +
            					<li class="file"><a href="../../log4r/rdoc/formatter.html">formatter</a></li>
         
     | 
| 
      
 43 
     | 
    
         
            +
            				
         
     | 
| 
      
 44 
     | 
    
         
            +
            					<li class="file"><a href="../../log4r/rdoc/log4r.html">log4r</a></li>
         
     | 
| 
      
 45 
     | 
    
         
            +
            				
         
     | 
| 
      
 46 
     | 
    
         
            +
            					<li class="file"><a href="../../log4r/rdoc/logger.html">logger</a></li>
         
     | 
| 
      
 47 
     | 
    
         
            +
            				
         
     | 
| 
      
 48 
     | 
    
         
            +
            					<li class="file"><a href="../../log4r/rdoc/logserver.html">logserver</a></li>
         
     | 
| 
      
 49 
     | 
    
         
            +
            				
         
     | 
| 
      
 50 
     | 
    
         
            +
            					<li class="file"><a href="../../log4r/rdoc/outputter.html">outputter</a></li>
         
     | 
| 
      
 51 
     | 
    
         
            +
            				
         
     | 
| 
      
 52 
     | 
    
         
            +
            					<li class="file"><a href="../../log4r/rdoc/patternformatter.html">patternformatter</a></li>
         
     | 
| 
      
 53 
     | 
    
         
            +
            				
         
     | 
| 
      
 54 
     | 
    
         
            +
            					<li class="file"><a href="../../log4r/rdoc/syslogoutputter.html">syslogoutputter</a></li>
         
     | 
| 
      
 55 
     | 
    
         
            +
            				
         
     | 
| 
      
 56 
     | 
    
         
            +
            					<li class="file"><a href="../../log4r/rdoc/win32eventoutputter.html">win32eventoutputter</a></li>
         
     | 
| 
      
 57 
     | 
    
         
            +
            				
         
     | 
| 
      
 58 
     | 
    
         
            +
            					<li class="file"><a href="../../log4r/rdoc/yamlconfigurator.html">yamlconfigurator</a></li>
         
     | 
| 
      
 59 
     | 
    
         
            +
            				
         
     | 
| 
      
 60 
     | 
    
         
            +
            				</ul>
         
     | 
| 
      
 61 
     | 
    
         
            +
            			</div>
         
     | 
| 
      
 62 
     | 
    
         
            +
            			
         
     | 
| 
      
 63 
     | 
    
         
            +
             
     | 
| 
      
 64 
     | 
    
         
            +
            			<div id="classindex-section" class="section project-section">
         
     | 
| 
      
 65 
     | 
    
         
            +
            				<h3 class="section-header">Class Index
         
     | 
| 
      
 66 
     | 
    
         
            +
            					<span class="search-toggle"><img src="../../images/find.png"
         
     | 
| 
      
 67 
     | 
    
         
            +
            						height="16" width="16" alt="[+]"
         
     | 
| 
      
 68 
     | 
    
         
            +
            						title="show/hide quicksearch" /></span></h3>
         
     | 
| 
      
 69 
     | 
    
         
            +
            				<form action="#" method="get" accept-charset="utf-8" class="initially-hidden">
         
     | 
| 
      
 70 
     | 
    
         
            +
            				<fieldset>
         
     | 
| 
      
 71 
     | 
    
         
            +
            					<legend>Quicksearch</legend>
         
     | 
| 
      
 72 
     | 
    
         
            +
            					<input type="text" name="quicksearch" value=""
         
     | 
| 
      
 73 
     | 
    
         
            +
            						class="quicksearch-field" />
         
     | 
| 
      
 74 
     | 
    
         
            +
            				</fieldset>
         
     | 
| 
      
 75 
     | 
    
         
            +
            				</form>
         
     | 
| 
      
 76 
     | 
    
         
            +
             
     | 
| 
      
 77 
     | 
    
         
            +
            				<ul class="link-list">
         
     | 
| 
      
 78 
     | 
    
         
            +
            				
         
     | 
| 
      
 79 
     | 
    
         
            +
            					<li><a href="../../Log4r.html">Log4r</a></li>
         
     | 
| 
      
 80 
     | 
    
         
            +
            				
         
     | 
| 
      
 81 
     | 
    
         
            +
            					<li><a href="../../Log4r/BasicFormatter.html">Log4r::BasicFormatter</a></li>
         
     | 
| 
      
 82 
     | 
    
         
            +
            				
         
     | 
| 
      
 83 
     | 
    
         
            +
            					<li><a href="../../Log4r/ConfigError.html">Log4r::ConfigError</a></li>
         
     | 
| 
      
 84 
     | 
    
         
            +
            				
         
     | 
| 
      
 85 
     | 
    
         
            +
            					<li><a href="../../Log4r/Configurator.html">Log4r::Configurator</a></li>
         
     | 
| 
      
 86 
     | 
    
         
            +
            				
         
     | 
| 
      
 87 
     | 
    
         
            +
            					<li><a href="../../Log4r/DateFileOutputter.html">Log4r::DateFileOutputter</a></li>
         
     | 
| 
      
 88 
     | 
    
         
            +
            				
         
     | 
| 
      
 89 
     | 
    
         
            +
            					<li><a href="../../Log4r/DefaultFormatter.html">Log4r::DefaultFormatter</a></li>
         
     | 
| 
      
 90 
     | 
    
         
            +
            				
         
     | 
| 
      
 91 
     | 
    
         
            +
            					<li><a href="../../Log4r/EmailOutputter.html">Log4r::EmailOutputter</a></li>
         
     | 
| 
      
 92 
     | 
    
         
            +
            				
         
     | 
| 
      
 93 
     | 
    
         
            +
            					<li><a href="../../Log4r/FileOutputter.html">Log4r::FileOutputter</a></li>
         
     | 
| 
      
 94 
     | 
    
         
            +
            				
         
     | 
| 
      
 95 
     | 
    
         
            +
            					<li><a href="../../Log4r/Formatter.html">Log4r::Formatter</a></li>
         
     | 
| 
      
 96 
     | 
    
         
            +
            				
         
     | 
| 
      
 97 
     | 
    
         
            +
            					<li><a href="../../Log4r/GDC.html">Log4r::GDC</a></li>
         
     | 
| 
      
 98 
     | 
    
         
            +
            				
         
     | 
| 
      
 99 
     | 
    
         
            +
            					<li><a href="../../Log4r/IOOutputter.html">Log4r::IOOutputter</a></li>
         
     | 
| 
      
 100 
     | 
    
         
            +
            				
         
     | 
| 
      
 101 
     | 
    
         
            +
            					<li><a href="../../Log4r/Log4jXmlFormatter.html">Log4r::Log4jXmlFormatter</a></li>
         
     | 
| 
      
 102 
     | 
    
         
            +
            				
         
     | 
| 
      
 103 
     | 
    
         
            +
            					<li><a href="../../Log4r/Log4rTools.html">Log4r::Log4rTools</a></li>
         
     | 
| 
      
 104 
     | 
    
         
            +
            				
         
     | 
| 
      
 105 
     | 
    
         
            +
            					<li><a href="../../Log4r/LogEvent.html">Log4r::LogEvent</a></li>
         
     | 
| 
      
 106 
     | 
    
         
            +
            				
         
     | 
| 
      
 107 
     | 
    
         
            +
            					<li><a href="../../Log4r/LogServer.html">Log4r::LogServer</a></li>
         
     | 
| 
      
 108 
     | 
    
         
            +
            				
         
     | 
| 
      
 109 
     | 
    
         
            +
            					<li><a href="../../Log4r/Logger.html">Log4r::Logger</a></li>
         
     | 
| 
      
 110 
     | 
    
         
            +
            				
         
     | 
| 
      
 111 
     | 
    
         
            +
            					<li><a href="../../Log4r/MDC.html">Log4r::MDC</a></li>
         
     | 
| 
      
 112 
     | 
    
         
            +
            				
         
     | 
| 
      
 113 
     | 
    
         
            +
            					<li><a href="../../Log4r/NDC.html">Log4r::NDC</a></li>
         
     | 
| 
      
 114 
     | 
    
         
            +
            				
         
     | 
| 
      
 115 
     | 
    
         
            +
            					<li><a href="../../Log4r/ObjectFormatter.html">Log4r::ObjectFormatter</a></li>
         
     | 
| 
      
 116 
     | 
    
         
            +
            				
         
     | 
| 
      
 117 
     | 
    
         
            +
            					<li><a href="../../Log4r/Outputter.html">Log4r::Outputter</a></li>
         
     | 
| 
      
 118 
     | 
    
         
            +
            				
         
     | 
| 
      
 119 
     | 
    
         
            +
            					<li><a href="../../Log4r/PatternFormatter.html">Log4r::PatternFormatter</a></li>
         
     | 
| 
      
 120 
     | 
    
         
            +
            				
         
     | 
| 
      
 121 
     | 
    
         
            +
            					<li><a href="../../Log4r/RemoteOutputter.html">Log4r::RemoteOutputter</a></li>
         
     | 
| 
      
 122 
     | 
    
         
            +
            				
         
     | 
| 
      
 123 
     | 
    
         
            +
            					<li><a href="../../Log4r/RollingFileOutputter.html">Log4r::RollingFileOutputter</a></li>
         
     | 
| 
      
 124 
     | 
    
         
            +
            				
         
     | 
| 
      
 125 
     | 
    
         
            +
            					<li><a href="../../Log4r/RootLogger.html">Log4r::RootLogger</a></li>
         
     | 
| 
      
 126 
     | 
    
         
            +
            				
         
     | 
| 
      
 127 
     | 
    
         
            +
            					<li><a href="../../Log4r/SimpleFormatter.html">Log4r::SimpleFormatter</a></li>
         
     | 
| 
      
 128 
     | 
    
         
            +
            				
         
     | 
| 
      
 129 
     | 
    
         
            +
            					<li><a href="../../Log4r/StderrOutputter.html">Log4r::StderrOutputter</a></li>
         
     | 
| 
      
 130 
     | 
    
         
            +
            				
         
     | 
| 
      
 131 
     | 
    
         
            +
            					<li><a href="../../Log4r/StdoutOutputter.html">Log4r::StdoutOutputter</a></li>
         
     | 
| 
      
 132 
     | 
    
         
            +
            				
         
     | 
| 
      
 133 
     | 
    
         
            +
            					<li><a href="../../Log4r/SyslogOutputter.html">Log4r::SyslogOutputter</a></li>
         
     | 
| 
      
 134 
     | 
    
         
            +
            				
         
     | 
| 
      
 135 
     | 
    
         
            +
            					<li><a href="../../Log4r/UDPOutputter.html">Log4r::UDPOutputter</a></li>
         
     | 
| 
      
 136 
     | 
    
         
            +
            				
         
     | 
| 
      
 137 
     | 
    
         
            +
            					<li><a href="../../Log4r/YamlConfigurator.html">Log4r::YamlConfigurator</a></li>
         
     | 
| 
      
 138 
     | 
    
         
            +
            				
         
     | 
| 
      
 139 
     | 
    
         
            +
            				</ul>
         
     | 
| 
      
 140 
     | 
    
         
            +
            				<div id="no-class-search-results" style="display: none;">No matching classes.</div>
         
     | 
| 
      
 141 
     | 
    
         
            +
            			</div>
         
     | 
| 
      
 142 
     | 
    
         
            +
             
     | 
| 
      
 143 
     | 
    
         
            +
            			
         
     | 
| 
      
 144 
     | 
    
         
            +
            		</div>
         
     | 
| 
      
 145 
     | 
    
         
            +
            	</div>
         
     | 
| 
      
 146 
     | 
    
         
            +
             
     | 
| 
      
 147 
     | 
    
         
            +
            	<div id="documentation">
         
     | 
| 
      
 148 
     | 
    
         
            +
            		<h1>GDC</h1>
         
     | 
| 
      
 149 
     | 
    
         
            +
            <p>
         
     | 
| 
      
 150 
     | 
    
         
            +
            The GDC class implements a copy of the Global Diagnostic Context, which is
         
     | 
| 
      
 151 
     | 
    
         
            +
            not part of the Apache Log4j library, as of this writing (10 Jan 2009).
         
     | 
| 
      
 152 
     | 
    
         
            +
            </p>
         
     | 
| 
      
 153 
     | 
    
         
            +
            <p>
         
     | 
| 
      
 154 
     | 
    
         
            +
            The GDC is like the NDC and MDC classes, only it is global to the
         
     | 
| 
      
 155 
     | 
    
         
            +
            application (see NDC and MDC for details on those classes).
         
     | 
| 
      
 156 
     | 
    
         
            +
            </p>
         
     | 
| 
      
 157 
     | 
    
         
            +
            <p>
         
     | 
| 
      
 158 
     | 
    
         
            +
            The GDC is local to the main thread, and any new threads will return the
         
     | 
| 
      
 159 
     | 
    
         
            +
            value of the current GDC set in the main thread.
         
     | 
| 
      
 160 
     | 
    
         
            +
            </p>
         
     | 
| 
      
 161 
     | 
    
         
            +
            <p>
         
     | 
| 
      
 162 
     | 
    
         
            +
            Only the main thread can set the GDC, any other threads that attempt to
         
     | 
| 
      
 163 
     | 
    
         
            +
            will raise an exception.
         
     | 
| 
      
 164 
     | 
    
         
            +
            </p>
         
     | 
| 
      
 165 
     | 
    
         
            +
             
     | 
| 
      
 166 
     | 
    
         
            +
            	</div>
         
     | 
| 
      
 167 
     | 
    
         
            +
             
     | 
| 
      
 168 
     | 
    
         
            +
            	<div id="validator-badges">
         
     | 
| 
      
 169 
     | 
    
         
            +
            		<p><small><a href="http://validator.w3.org/check/referer">[Validate]</a></small></p>
         
     | 
| 
      
 170 
     | 
    
         
            +
            		<p><small>Generated with the <a href="http://deveiate.org/projects/Darkfish-Rdoc/">Darkfish
         
     | 
| 
      
 171 
     | 
    
         
            +
            			Rdoc Generator</a> 1.1.6</small>.</p>
         
     | 
| 
      
 172 
     | 
    
         
            +
            	</div>
         
     | 
| 
      
 173 
     | 
    
         
            +
            </body>
         
     | 
| 
      
 174 
     | 
    
         
            +
            </html>
         
     | 
| 
      
 175 
     | 
    
         
            +
             
     | 
| 
         @@ -0,0 +1,178 @@ 
     | 
|
| 
      
 1 
     | 
    
         
            +
            <?xml version="1.0" encoding="utf-8"?>
         
     | 
| 
      
 2 
     | 
    
         
            +
            <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
         
     | 
| 
      
 3 
     | 
    
         
            +
            	"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
         
     | 
| 
      
 4 
     | 
    
         
            +
             
     | 
| 
      
 5 
     | 
    
         
            +
            <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
         
     | 
| 
      
 6 
     | 
    
         
            +
            <head>
         
     | 
| 
      
 7 
     | 
    
         
            +
            	<meta content="text/html; charset=utf-8" http-equiv="Content-Type" />
         
     | 
| 
      
 8 
     | 
    
         
            +
             
     | 
| 
      
 9 
     | 
    
         
            +
            	<title>File: MDC [1.1.7 Log4r API]</title>
         
     | 
| 
      
 10 
     | 
    
         
            +
             
     | 
| 
      
 11 
     | 
    
         
            +
            	<link type="text/css" media="screen" href="../../rdoc.css" rel="stylesheet" />
         
     | 
| 
      
 12 
     | 
    
         
            +
             
     | 
| 
      
 13 
     | 
    
         
            +
            	<script src="../../js/jquery.js" type="text/javascript"
         
     | 
| 
      
 14 
     | 
    
         
            +
            		charset="utf-8"></script>
         
     | 
| 
      
 15 
     | 
    
         
            +
            	<script src="../../js/thickbox-compressed.js" type="text/javascript"
         
     | 
| 
      
 16 
     | 
    
         
            +
            		charset="utf-8"></script>
         
     | 
| 
      
 17 
     | 
    
         
            +
            	<script src="../../js/quicksearch.js" type="text/javascript"
         
     | 
| 
      
 18 
     | 
    
         
            +
            		charset="utf-8"></script>
         
     | 
| 
      
 19 
     | 
    
         
            +
            	<script src="../../js/darkfish.js" type="text/javascript"
         
     | 
| 
      
 20 
     | 
    
         
            +
            		charset="utf-8"></script>
         
     | 
| 
      
 21 
     | 
    
         
            +
            </head>
         
     | 
| 
      
 22 
     | 
    
         
            +
             
     | 
| 
      
 23 
     | 
    
         
            +
            <body class="file">
         
     | 
| 
      
 24 
     | 
    
         
            +
            	<div id="metadata">
         
     | 
| 
      
 25 
     | 
    
         
            +
            		<div id="project-metadata">
         
     | 
| 
      
 26 
     | 
    
         
            +
            			
         
     | 
| 
      
 27 
     | 
    
         
            +
            			
         
     | 
| 
      
 28 
     | 
    
         
            +
            			<div id="fileindex-section" class="section project-section">
         
     | 
| 
      
 29 
     | 
    
         
            +
            				<h3 class="section-header">Files</h3>
         
     | 
| 
      
 30 
     | 
    
         
            +
            				<ul>
         
     | 
| 
      
 31 
     | 
    
         
            +
            				
         
     | 
| 
      
 32 
     | 
    
         
            +
            					<li class="file"><a href="../../log4r/rdoc/GDC.html">GDC</a></li>
         
     | 
| 
      
 33 
     | 
    
         
            +
            				
         
     | 
| 
      
 34 
     | 
    
         
            +
            					<li class="file"><a href="../../log4r/rdoc/MDC.html">MDC</a></li>
         
     | 
| 
      
 35 
     | 
    
         
            +
            				
         
     | 
| 
      
 36 
     | 
    
         
            +
            					<li class="file"><a href="../../log4r/rdoc/NDC.html">NDC</a></li>
         
     | 
| 
      
 37 
     | 
    
         
            +
            				
         
     | 
| 
      
 38 
     | 
    
         
            +
            					<li class="file"><a href="../../log4r/rdoc/configurator.html">configurator</a></li>
         
     | 
| 
      
 39 
     | 
    
         
            +
            				
         
     | 
| 
      
 40 
     | 
    
         
            +
            					<li class="file"><a href="../../log4r/rdoc/emailoutputter.html">emailoutputter</a></li>
         
     | 
| 
      
 41 
     | 
    
         
            +
            				
         
     | 
| 
      
 42 
     | 
    
         
            +
            					<li class="file"><a href="../../log4r/rdoc/formatter.html">formatter</a></li>
         
     | 
| 
      
 43 
     | 
    
         
            +
            				
         
     | 
| 
      
 44 
     | 
    
         
            +
            					<li class="file"><a href="../../log4r/rdoc/log4r.html">log4r</a></li>
         
     | 
| 
      
 45 
     | 
    
         
            +
            				
         
     | 
| 
      
 46 
     | 
    
         
            +
            					<li class="file"><a href="../../log4r/rdoc/logger.html">logger</a></li>
         
     | 
| 
      
 47 
     | 
    
         
            +
            				
         
     | 
| 
      
 48 
     | 
    
         
            +
            					<li class="file"><a href="../../log4r/rdoc/logserver.html">logserver</a></li>
         
     | 
| 
      
 49 
     | 
    
         
            +
            				
         
     | 
| 
      
 50 
     | 
    
         
            +
            					<li class="file"><a href="../../log4r/rdoc/outputter.html">outputter</a></li>
         
     | 
| 
      
 51 
     | 
    
         
            +
            				
         
     | 
| 
      
 52 
     | 
    
         
            +
            					<li class="file"><a href="../../log4r/rdoc/patternformatter.html">patternformatter</a></li>
         
     | 
| 
      
 53 
     | 
    
         
            +
            				
         
     | 
| 
      
 54 
     | 
    
         
            +
            					<li class="file"><a href="../../log4r/rdoc/syslogoutputter.html">syslogoutputter</a></li>
         
     | 
| 
      
 55 
     | 
    
         
            +
            				
         
     | 
| 
      
 56 
     | 
    
         
            +
            					<li class="file"><a href="../../log4r/rdoc/win32eventoutputter.html">win32eventoutputter</a></li>
         
     | 
| 
      
 57 
     | 
    
         
            +
            				
         
     | 
| 
      
 58 
     | 
    
         
            +
            					<li class="file"><a href="../../log4r/rdoc/yamlconfigurator.html">yamlconfigurator</a></li>
         
     | 
| 
      
 59 
     | 
    
         
            +
            				
         
     | 
| 
      
 60 
     | 
    
         
            +
            				</ul>
         
     | 
| 
      
 61 
     | 
    
         
            +
            			</div>
         
     | 
| 
      
 62 
     | 
    
         
            +
            			
         
     | 
| 
      
 63 
     | 
    
         
            +
             
     | 
| 
      
 64 
     | 
    
         
            +
            			<div id="classindex-section" class="section project-section">
         
     | 
| 
      
 65 
     | 
    
         
            +
            				<h3 class="section-header">Class Index
         
     | 
| 
      
 66 
     | 
    
         
            +
            					<span class="search-toggle"><img src="../../images/find.png"
         
     | 
| 
      
 67 
     | 
    
         
            +
            						height="16" width="16" alt="[+]"
         
     | 
| 
      
 68 
     | 
    
         
            +
            						title="show/hide quicksearch" /></span></h3>
         
     | 
| 
      
 69 
     | 
    
         
            +
            				<form action="#" method="get" accept-charset="utf-8" class="initially-hidden">
         
     | 
| 
      
 70 
     | 
    
         
            +
            				<fieldset>
         
     | 
| 
      
 71 
     | 
    
         
            +
            					<legend>Quicksearch</legend>
         
     | 
| 
      
 72 
     | 
    
         
            +
            					<input type="text" name="quicksearch" value=""
         
     | 
| 
      
 73 
     | 
    
         
            +
            						class="quicksearch-field" />
         
     | 
| 
      
 74 
     | 
    
         
            +
            				</fieldset>
         
     | 
| 
      
 75 
     | 
    
         
            +
            				</form>
         
     | 
| 
      
 76 
     | 
    
         
            +
             
     | 
| 
      
 77 
     | 
    
         
            +
            				<ul class="link-list">
         
     | 
| 
      
 78 
     | 
    
         
            +
            				
         
     | 
| 
      
 79 
     | 
    
         
            +
            					<li><a href="../../Log4r.html">Log4r</a></li>
         
     | 
| 
      
 80 
     | 
    
         
            +
            				
         
     | 
| 
      
 81 
     | 
    
         
            +
            					<li><a href="../../Log4r/BasicFormatter.html">Log4r::BasicFormatter</a></li>
         
     | 
| 
      
 82 
     | 
    
         
            +
            				
         
     | 
| 
      
 83 
     | 
    
         
            +
            					<li><a href="../../Log4r/ConfigError.html">Log4r::ConfigError</a></li>
         
     | 
| 
      
 84 
     | 
    
         
            +
            				
         
     | 
| 
      
 85 
     | 
    
         
            +
            					<li><a href="../../Log4r/Configurator.html">Log4r::Configurator</a></li>
         
     | 
| 
      
 86 
     | 
    
         
            +
            				
         
     | 
| 
      
 87 
     | 
    
         
            +
            					<li><a href="../../Log4r/DateFileOutputter.html">Log4r::DateFileOutputter</a></li>
         
     | 
| 
      
 88 
     | 
    
         
            +
            				
         
     | 
| 
      
 89 
     | 
    
         
            +
            					<li><a href="../../Log4r/DefaultFormatter.html">Log4r::DefaultFormatter</a></li>
         
     | 
| 
      
 90 
     | 
    
         
            +
            				
         
     | 
| 
      
 91 
     | 
    
         
            +
            					<li><a href="../../Log4r/EmailOutputter.html">Log4r::EmailOutputter</a></li>
         
     | 
| 
      
 92 
     | 
    
         
            +
            				
         
     | 
| 
      
 93 
     | 
    
         
            +
            					<li><a href="../../Log4r/FileOutputter.html">Log4r::FileOutputter</a></li>
         
     | 
| 
      
 94 
     | 
    
         
            +
            				
         
     | 
| 
      
 95 
     | 
    
         
            +
            					<li><a href="../../Log4r/Formatter.html">Log4r::Formatter</a></li>
         
     | 
| 
      
 96 
     | 
    
         
            +
            				
         
     | 
| 
      
 97 
     | 
    
         
            +
            					<li><a href="../../Log4r/GDC.html">Log4r::GDC</a></li>
         
     | 
| 
      
 98 
     | 
    
         
            +
            				
         
     | 
| 
      
 99 
     | 
    
         
            +
            					<li><a href="../../Log4r/IOOutputter.html">Log4r::IOOutputter</a></li>
         
     | 
| 
      
 100 
     | 
    
         
            +
            				
         
     | 
| 
      
 101 
     | 
    
         
            +
            					<li><a href="../../Log4r/Log4jXmlFormatter.html">Log4r::Log4jXmlFormatter</a></li>
         
     | 
| 
      
 102 
     | 
    
         
            +
            				
         
     | 
| 
      
 103 
     | 
    
         
            +
            					<li><a href="../../Log4r/Log4rTools.html">Log4r::Log4rTools</a></li>
         
     | 
| 
      
 104 
     | 
    
         
            +
            				
         
     | 
| 
      
 105 
     | 
    
         
            +
            					<li><a href="../../Log4r/LogEvent.html">Log4r::LogEvent</a></li>
         
     | 
| 
      
 106 
     | 
    
         
            +
            				
         
     | 
| 
      
 107 
     | 
    
         
            +
            					<li><a href="../../Log4r/LogServer.html">Log4r::LogServer</a></li>
         
     | 
| 
      
 108 
     | 
    
         
            +
            				
         
     | 
| 
      
 109 
     | 
    
         
            +
            					<li><a href="../../Log4r/Logger.html">Log4r::Logger</a></li>
         
     | 
| 
      
 110 
     | 
    
         
            +
            				
         
     | 
| 
      
 111 
     | 
    
         
            +
            					<li><a href="../../Log4r/MDC.html">Log4r::MDC</a></li>
         
     | 
| 
      
 112 
     | 
    
         
            +
            				
         
     | 
| 
      
 113 
     | 
    
         
            +
            					<li><a href="../../Log4r/NDC.html">Log4r::NDC</a></li>
         
     | 
| 
      
 114 
     | 
    
         
            +
            				
         
     | 
| 
      
 115 
     | 
    
         
            +
            					<li><a href="../../Log4r/ObjectFormatter.html">Log4r::ObjectFormatter</a></li>
         
     | 
| 
      
 116 
     | 
    
         
            +
            				
         
     | 
| 
      
 117 
     | 
    
         
            +
            					<li><a href="../../Log4r/Outputter.html">Log4r::Outputter</a></li>
         
     | 
| 
      
 118 
     | 
    
         
            +
            				
         
     | 
| 
      
 119 
     | 
    
         
            +
            					<li><a href="../../Log4r/PatternFormatter.html">Log4r::PatternFormatter</a></li>
         
     | 
| 
      
 120 
     | 
    
         
            +
            				
         
     | 
| 
      
 121 
     | 
    
         
            +
            					<li><a href="../../Log4r/RemoteOutputter.html">Log4r::RemoteOutputter</a></li>
         
     | 
| 
      
 122 
     | 
    
         
            +
            				
         
     | 
| 
      
 123 
     | 
    
         
            +
            					<li><a href="../../Log4r/RollingFileOutputter.html">Log4r::RollingFileOutputter</a></li>
         
     | 
| 
      
 124 
     | 
    
         
            +
            				
         
     | 
| 
      
 125 
     | 
    
         
            +
            					<li><a href="../../Log4r/RootLogger.html">Log4r::RootLogger</a></li>
         
     | 
| 
      
 126 
     | 
    
         
            +
            				
         
     | 
| 
      
 127 
     | 
    
         
            +
            					<li><a href="../../Log4r/SimpleFormatter.html">Log4r::SimpleFormatter</a></li>
         
     | 
| 
      
 128 
     | 
    
         
            +
            				
         
     | 
| 
      
 129 
     | 
    
         
            +
            					<li><a href="../../Log4r/StderrOutputter.html">Log4r::StderrOutputter</a></li>
         
     | 
| 
      
 130 
     | 
    
         
            +
            				
         
     | 
| 
      
 131 
     | 
    
         
            +
            					<li><a href="../../Log4r/StdoutOutputter.html">Log4r::StdoutOutputter</a></li>
         
     | 
| 
      
 132 
     | 
    
         
            +
            				
         
     | 
| 
      
 133 
     | 
    
         
            +
            					<li><a href="../../Log4r/SyslogOutputter.html">Log4r::SyslogOutputter</a></li>
         
     | 
| 
      
 134 
     | 
    
         
            +
            				
         
     | 
| 
      
 135 
     | 
    
         
            +
            					<li><a href="../../Log4r/UDPOutputter.html">Log4r::UDPOutputter</a></li>
         
     | 
| 
      
 136 
     | 
    
         
            +
            				
         
     | 
| 
      
 137 
     | 
    
         
            +
            					<li><a href="../../Log4r/YamlConfigurator.html">Log4r::YamlConfigurator</a></li>
         
     | 
| 
      
 138 
     | 
    
         
            +
            				
         
     | 
| 
      
 139 
     | 
    
         
            +
            				</ul>
         
     | 
| 
      
 140 
     | 
    
         
            +
            				<div id="no-class-search-results" style="display: none;">No matching classes.</div>
         
     | 
| 
      
 141 
     | 
    
         
            +
            			</div>
         
     | 
| 
      
 142 
     | 
    
         
            +
             
     | 
| 
      
 143 
     | 
    
         
            +
            			
         
     | 
| 
      
 144 
     | 
    
         
            +
            		</div>
         
     | 
| 
      
 145 
     | 
    
         
            +
            	</div>
         
     | 
| 
      
 146 
     | 
    
         
            +
             
     | 
| 
      
 147 
     | 
    
         
            +
            	<div id="documentation">
         
     | 
| 
      
 148 
     | 
    
         
            +
            		<h1>MDC</h1>
         
     | 
| 
      
 149 
     | 
    
         
            +
            <p>
         
     | 
| 
      
 150 
     | 
    
         
            +
            The MDC class implements a copy of the Mapped Diagnostic Context, which is
         
     | 
| 
      
 151 
     | 
    
         
            +
            part of the Apache Log4j library. See the NDC documentation for more
         
     | 
| 
      
 152 
     | 
    
         
            +
            details. MDCs are much like NDCs, but instead of a stack context it uses a
         
     | 
| 
      
 153 
     | 
    
         
            +
            map for holding this information.
         
     | 
| 
      
 154 
     | 
    
         
            +
            </p>
         
     | 
| 
      
 155 
     | 
    
         
            +
            <p>
         
     | 
| 
      
 156 
     | 
    
         
            +
            This allows for selection of information out of the map when the log
         
     | 
| 
      
 157 
     | 
    
         
            +
            message is being created.
         
     | 
| 
      
 158 
     | 
    
         
            +
            </p>
         
     | 
| 
      
 159 
     | 
    
         
            +
            <p>
         
     | 
| 
      
 160 
     | 
    
         
            +
            MDCs are thread safe, and are unique to each thread.
         
     | 
| 
      
 161 
     | 
    
         
            +
            </p>
         
     | 
| 
      
 162 
     | 
    
         
            +
            <p>
         
     | 
| 
      
 163 
     | 
    
         
            +
            An important difference between MDCs in <a
         
     | 
| 
      
 164 
     | 
    
         
            +
            href="../../Log4r.html">Log4r</a> vs Log4j is that they only inherit from
         
     | 
| 
      
 165 
     | 
    
         
            +
            the main thread. Ruby treats all new threads as being the children of the
         
     | 
| 
      
 166 
     | 
    
         
            +
            main thread, even if they are started from a thread that is not main.
         
     | 
| 
      
 167 
     | 
    
         
            +
            </p>
         
     | 
| 
      
 168 
     | 
    
         
            +
             
     | 
| 
      
 169 
     | 
    
         
            +
            	</div>
         
     | 
| 
      
 170 
     | 
    
         
            +
             
     | 
| 
      
 171 
     | 
    
         
            +
            	<div id="validator-badges">
         
     | 
| 
      
 172 
     | 
    
         
            +
            		<p><small><a href="http://validator.w3.org/check/referer">[Validate]</a></small></p>
         
     | 
| 
      
 173 
     | 
    
         
            +
            		<p><small>Generated with the <a href="http://deveiate.org/projects/Darkfish-Rdoc/">Darkfish
         
     | 
| 
      
 174 
     | 
    
         
            +
            			Rdoc Generator</a> 1.1.6</small>.</p>
         
     | 
| 
      
 175 
     | 
    
         
            +
            	</div>
         
     | 
| 
      
 176 
     | 
    
         
            +
            </body>
         
     | 
| 
      
 177 
     | 
    
         
            +
            </html>
         
     | 
| 
      
 178 
     | 
    
         
            +
             
     |