InforMatrix LogGui

  1. Resources
  2. Purpose
  3. How to use
  4. Extension Mechanisme
  5. History
  6. Licence Agreement
  7. Feedback

Resources

Program: loggui.jar
Online Demo Applet
Documentation LogGui API
Documentation java.util.logging API
Homepage InforMatrix GmbH

Purpose

The java.util.logging API offers many usefull functionality for logging and debugging. But the configuration with the property config file is inconvenient. And for debugging purpose, it is needed, that loggers can be turned on and off on the fly, as well as beeing configured ad lib. All this is possible with the InforMatrix LogGui, a graphical user interface for the java.util.logging package implemented in Swing.
With LogGui you can configure loggers, handlers, formatters and filters in a running Programm. It also adds handlers, formatters and filters of its own. It allows to add and delete handlers, formatters and filters on the fly. Your configurations can be stored and loaded in files.

LogGui Screen Shot


How to use

General

The application is delivered as a jar file. It needs Java 1.4 to run. The main class and entry point is imx.loggui.LogMaster . There are three main ways, how to use it:

Simple use

Include loggui.jar to your java runtime libraries. Somewhere in your application execute the following statement to bring up the LogGui:

imx.loggui.LogMaster.startLogGui();

That's it :-)

Custom use

Maybe you like to incorporate LogGui into your application in your own way. Here is an example, how you might do this. For the specific meaning of each function please refer to the LogGui API.

import imx.loggui.*;
import javax.swing.*;

...

JFrame yourFrame = new JFrame("your example component");
yourFrame.getContentPane().add(LogMaster.getLogView(), BorderLayout.CENTER);
yourFrame.setJMenuBar(new LogMasterMenuBar(yourFrame));
LogMaster.getLogMaster().configDefault();
LogMaster.getLogMaster().configExternalLHFF();
yourFrame.show();
LogMaster.getLogMaster().refresh();

Demo

The loggui.jar contains a manifest. If you like to try it out and you have your java runtime environment configured properly, simply double click on it, to let the demo run.


Extension Mechanisme

If you wrote your own handler, formatter and filter, you can integrate them in the LogGui. If, as an example, you implemented your own filter called YourFilter. This filter then needs to implement the following interfaces:

java.util.logging.Filter
java.io.Serializable -> can be omitted, but then the configuration of your filter will not be saved.
imx.loggui.lib.NameInterface -> can be omitted, but then you will not be able to change the name of a newly created filter.

Probably your filter also has some unique properties which you would like to configure. Then you implement a view for it named YourFilterView, which derives from java.awt.Component and must implement the imx.lib.listener.ListenerInterface. The following code example shows, how you add this custom filter to the LogGui. Custom handler and formatter work accordingly.

import imx.loggui.LogMaster;

...

LogMaster.getLogMaster().addFilter(new YourFilter());
LogMaster.getLogMaster().addFilterCreator(new DefaultCreator(YourFilter.class, "Your Custom Filter"));
LogMaster.getLogMaster().addView(YourFilter.class, new YourFilterView());


History

26.02.2007 Version 1.0: adapted to Mac OS X, gui improvements, bug fixes
03.01.2004 Version 0.2 published on the internet
01.10.2003 Prototype 0.1 finished


Licence Agreement

Copyright (c) 2003-2007 by InforMatrix GmbH.
All rights reserved. This software is freeware.


Feedback

This software is developed and maintained by InforMatrix GmbH.
All questions, bugs, requests and comments are welcomed at
http://www.informatrix.ch/forum.html or info@informatrix.ch