<h2>org.das2.util.LoggerManager</h2><p>Central place that keeps track of loggers. Note that both org.das.datum and org.das2.datum have this same class, which is there to avoid coupling between the packages.</p> <h2>LoggerManager( )</h2> <p></p> <hr> <a name="addHandlerToAll"></a> <h2>addHandlerToAll</h2> addHandlerToAll( <a href='https://docs.oracle.com/javase/8/docs/api/java/util/logging/Handler.html'>java.util.logging.Handler</a> handler ) → void <p>Add the handler to all loggers created by this manager, and all future. Only call this once! I would think that adding a handler to the root would essentially add the handler to all loggers, but it doesn't seem to.</p> <h3>Parameters</h3> handler - e.g. GraphicalLogHandler <h3>Returns:</h3> void (returns nothing) <br><br> <a href="https://github.com/autoplot/dev/search?q=addHandlerToAll&unscoped_q=addHandlerToAll">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/util/LoggerManager.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/util/LoggerManager.html#addHandlerToAll">[view on old javadoc]</a> <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreUtil/src/org/das2/util/LoggerManager.java">[view source]</a> <br> <br> <hr> <a name="clearTimer"></a> <h2>clearTimer</h2> clearTimer( ) → void <p>explicitly remove this timer.</p> <h3>Returns:</h3> void (returns nothing) <h3>See Also:</h3> <a href='null'>resetTimer()</a> <br> <br><br> <a href="https://github.com/autoplot/dev/search?q=clearTimer&unscoped_q=clearTimer">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/util/LoggerManager.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/util/LoggerManager.html#clearTimer">[view on old javadoc]</a> <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreUtil/src/org/das2/util/LoggerManager.java">[view source]</a> <br> <br> <hr> <a name="getLogger"></a> <h2>getLogger</h2> getLogger( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> id ) → <a href='https://docs.oracle.com/javase/8/docs/api/java/util/logging/Logger.html'>java.util.logging.Logger</a> <p>return the requested logger, but add it to the list of known loggers.</p> <h3>Parameters</h3> id - the name <h3>Returns:</h3> the Logger <br><br> <a href="https://github.com/autoplot/dev/search?q=getLogger&unscoped_q=getLogger">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/util/LoggerManager.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/util/LoggerManager.html#getLogger">[view on old javadoc]</a> <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreUtil/src/org/das2/util/LoggerManager.java">[view source]</a> <br> <br> <hr> <a name="getLoggers"></a> <h2>getLoggers</h2> getLoggers( ) → <a href='https://docs.oracle.com/javase/8/docs/api/java/util/Set.html'>java.util.Set</a> <p>return the list of known loggers.</p> <h3>Returns:</h3> the list of known loggers. <br><br> <a href="https://github.com/autoplot/dev/search?q=getLoggers&unscoped_q=getLoggers">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/util/LoggerManager.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/util/LoggerManager.html#getLoggers">[view on old javadoc]</a> <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreUtil/src/org/das2/util/LoggerManager.java">[view source]</a> <br> <br> <hr> <a name="isEnableTimers"></a> <h2>isEnableTimers</h2> isEnableTimers( ) → boolean <p>return enableTimers property.</p> <h3>Returns:</h3> enableTimers property. <br><br> <a href="https://github.com/autoplot/dev/search?q=isEnableTimers&unscoped_q=isEnableTimers">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/util/LoggerManager.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/util/LoggerManager.html#isEnableTimers">[view on old javadoc]</a> <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreUtil/src/org/das2/util/LoggerManager.java">[view source]</a> <br> <br> <hr> <a name="isUseTimeTaggingLoggers"></a> <h2>isUseTimeTaggingLoggers</h2> isUseTimeTaggingLoggers( ) → boolean <p>are we keeping track of log message times, so we can sort loggers by how recently messages were posted?</p> <h3>Returns:</h3> true if we are keeping track of log message times. <br><br> <a href="https://github.com/autoplot/dev/search?q=isUseTimeTaggingLoggers&unscoped_q=isUseTimeTaggingLoggers">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/util/LoggerManager.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/util/LoggerManager.html#isUseTimeTaggingLoggers">[view on old javadoc]</a> <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreUtil/src/org/das2/util/LoggerManager.java">[view source]</a> <br> <br> <hr> <a name="logExitGuiEvent"></a> <h2>logExitGuiEvent</h2> logExitGuiEvent( <a href='https://docs.oracle.com/javase/8/docs/api/java/awt/event/ActionEvent.html'>java.awt.event.ActionEvent</a> e ) → void <p>call this at the end of the GUI event to measure time to respond.</p> <h3>Parameters</h3> e - the focus event. <h3>Returns:</h3> void (returns nothing) <br><br> <a href="https://github.com/autoplot/dev/search?q=logExitGuiEvent&unscoped_q=logExitGuiEvent">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/util/LoggerManager.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/util/LoggerManager.html#logExitGuiEvent">[view on old javadoc]</a> <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreUtil/src/org/das2/util/LoggerManager.java">[view source]</a> <br> <br> logExitGuiEvent( <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/javax/swing/event/ChangeEvent.html'>javax.swing.event.ChangeEvent</a> e ) → void<br> logExitGuiEvent( <a href='https://docs.oracle.com/javase/8/docs/api/java/awt/event/ItemEvent.html'>java.awt.event.ItemEvent</a> e ) → void<br> logExitGuiEvent( <a href='https://docs.oracle.com/javase/8/docs/api/java/awt/event/FocusEvent.html'>java.awt.event.FocusEvent</a> e ) → void<br> <hr> <a name="logGuiEvent"></a> <h2>logGuiEvent</h2> logGuiEvent( <a href='https://docs.oracle.com/javase/8/docs/api/java/awt/event/ActionEvent.html'>java.awt.event.ActionEvent</a> e ) → void <p>provide easy way to log all GUI events.</p> <h3>Parameters</h3> e - an ActionEvent <h3>Returns:</h3> void (returns nothing) <br><br> <a href="https://github.com/autoplot/dev/search?q=logGuiEvent&unscoped_q=logGuiEvent">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/util/LoggerManager.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/util/LoggerManager.html#logGuiEvent">[view on old javadoc]</a> <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreUtil/src/org/das2/util/LoggerManager.java">[view source]</a> <br> <br> logGuiEvent( <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/javax/swing/event/ChangeEvent.html'>javax.swing.event.ChangeEvent</a> e ) → void<br> logGuiEvent( <a href='https://docs.oracle.com/javase/8/docs/api/java/awt/event/ItemEvent.html'>java.awt.event.ItemEvent</a> e ) → void<br> logGuiEvent( <a href='https://docs.oracle.com/javase/8/docs/api/java/awt/event/FocusEvent.html'>java.awt.event.FocusEvent</a> e ) → void<br> <hr> <a name="logPropertyChangeEvent"></a> <h2>logPropertyChangeEvent</h2> logPropertyChangeEvent( <a href='https://docs.oracle.com/javase/8/docs/api/java/beans/PropertyChangeEvent.html'>java.beans.PropertyChangeEvent</a> e ) → void <p>log property change events. (I realized I spend a lot of time debugging walking through the property change fire event code, and I should just add a log message to all propertyChange codes.)</p> <h3>Parameters</h3> e - a PropertyChangeEvent <h3>Returns:</h3> void (returns nothing) <br><br> <a href="https://github.com/autoplot/dev/search?q=logPropertyChangeEvent&unscoped_q=logPropertyChangeEvent">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/util/LoggerManager.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/util/LoggerManager.html#logPropertyChangeEvent">[view on old javadoc]</a> <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreUtil/src/org/das2/util/LoggerManager.java">[view source]</a> <br> <br> logPropertyChangeEvent( <a href='https://docs.oracle.com/javase/8/docs/api/java/beans/PropertyChangeEvent.html'>java.beans.PropertyChangeEvent</a> e, <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> source ) → void<br> <hr> <a name="markTime"></a> <h2>markTime</h2> markTime( ) → void <p>mark the time using the thread name.</p> <h3>Returns:</h3> void (returns nothing) <br><br> <a href="https://github.com/autoplot/dev/search?q=markTime&unscoped_q=markTime">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/util/LoggerManager.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/util/LoggerManager.html#markTime">[view on old javadoc]</a> <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreUtil/src/org/das2/util/LoggerManager.java">[view source]</a> <br> <br> markTime( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> message ) → void<br> <hr> <a name="readConfiguration"></a> <h2>readConfiguration</h2> readConfiguration( ) → void <p>A slightly more transparent logging configuration would provide feedback about what configuration file it's loading. This will echo when the configuration file would be. The idea is when you are completely frustrated with not getting the logger to behave, you can add: org.das2.util.LoggerManager.readConfiguration() to your code.</p> <h3>Returns:</h3> void (returns nothing) <br><br> <a href="https://github.com/autoplot/dev/search?q=readConfiguration&unscoped_q=readConfiguration">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/util/LoggerManager.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/util/LoggerManager.html#readConfiguration">[view on old javadoc]</a> <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreUtil/src/org/das2/util/LoggerManager.java">[view source]</a> <br> <br> readConfiguration( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> configfile ) → void<br> <hr> <a name="resetTimer"></a> <h2>resetTimer</h2> resetTimer( ) → void <p>reset the timer. The lifecycle is like so:<ul> <li>LoggerManager.setTimerLogfile("/tmp/mylogfile.txt") <li>LoggerManager.resetTimer("big task"); <li>LoggerManager.markTime("done loading"); <li>LoggerManager.markTime("calculated data"); <li>LoggerManager.clearTimer(); </ul> Note the timers are stored with weak references to the threads, so clearTimer needn't be called.</p> <h3>Returns:</h3> void (returns nothing) <br><br> <a href="https://github.com/autoplot/dev/search?q=resetTimer&unscoped_q=resetTimer">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/util/LoggerManager.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/util/LoggerManager.html#resetTimer">[view on old javadoc]</a> <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreUtil/src/org/das2/util/LoggerManager.java">[view source]</a> <br> <br> resetTimer( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> task ) → void<br> <hr> <a name="setEnableTimers"></a> <h2>setEnableTimers</h2> setEnableTimers( boolean enableTimers ) → void <p>if enableTimers is true, then resetTimer and markTime have an effect. Each thread can have a timer to measure the execution time for a process.</p> <h3>Parameters</h3> enableTimers - true to enable timers <h3>Returns:</h3> void (returns nothing) <br><br> <a href="https://github.com/autoplot/dev/search?q=setEnableTimers&unscoped_q=setEnableTimers">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/util/LoggerManager.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/util/LoggerManager.html#setEnableTimers">[view on old javadoc]</a> <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreUtil/src/org/das2/util/LoggerManager.java">[view source]</a> <br> <br> <hr> <a name="setTimerLogfile"></a> <h2>setTimerLogfile</h2> setTimerLogfile( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> f ) → void <p>channel the logging information to here, setEnableTimers(false) to close.</p> <h3>Parameters</h3> f - a String <h3>Returns:</h3> void (returns nothing) <br><br> <a href="https://github.com/autoplot/dev/search?q=setTimerLogfile&unscoped_q=setTimerLogfile">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/util/LoggerManager.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/util/LoggerManager.html#setTimerLogfile">[view on old javadoc]</a> <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreUtil/src/org/das2/util/LoggerManager.java">[view source]</a> <br> <br> <hr> <a name="setUseTimeTaggingLoggers"></a> <h2>setUseTimeTaggingLoggers</h2> setUseTimeTaggingLoggers( boolean t ) → void <p></p> <h3>Parameters</h3> t - a boolean <h3>Returns:</h3> void (returns nothing) <br><br> <a href="https://github.com/autoplot/dev/search?q=setUseTimeTaggingLoggers&unscoped_q=setUseTimeTaggingLoggers">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/util/LoggerManager.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/util/LoggerManager.html#setUseTimeTaggingLoggers">[view on old javadoc]</a> <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreUtil/src/org/das2/util/LoggerManager.java">[view source]</a> <br> <br>