User Guide

The toolbox is only a jar to import. Then everything in it is usable. The most important documentation ist the API . That will tell you everything necessary.

Command Line
The key to using the Command Line feature is a help text file.

File System

There are two implementations overwriting java.io.File . Additionally there are utility classes for reading and writing text from and into files. File filters are also implemented which work with regular expressions.

Find more to read about the help document in the Package Description .

Logging

There are 2 log formatters. For each one you can find a sample result log. This one is the FileFormatter.log and this one is the ConsoleFormatter.log .

Miscellaneous

There are some conveneance classes to be used in the hashcode() and equals() methods and for dealing with Strings and Properties.

Mock Ups

This package is for testing purposes. In special it deals with mock ups for the own classes and with a mock up for the Logger in the Java 1.4 standard library.

Parsing

This package is usable for parsing strings. There are two parsers available at the moment.

The JunkParser parses text which holds boxed parts surrounded by tokens. You may use standard tokens like '[', ']', '(' and ')' or define your own start and end token. The JunkParser (with parenthesis as start and end tokens) will split up a text like this 'one (box (in) a box) in parenthesis ' into the three parts 'one ', '(box (in) a box) ' and ' in parenthesis '. So you see, inner boxes will be part of outer boxes. Tokens must match to avoid exceptions.

The CommandoParser parses boxes and separates them into parameters by a separator token. The standard separator token is semicolon ';' but as well as the start and end tokens it may be defined for yourself. For example a text like '(one; two; (or) three; parameters) ' will deliver the four parts 'one ', ' two ', ' (or) three ' and ' parameters '. As you see, inner boxes remain untouched. Tokens again must match to avoid exceptions.

In combination these two parsers can be really powerful.

Time Measurement

To measure elapsed time just create your Clock by the ClockFactory at the start of the measurement and measure whenever you want. The clock can be resetted for new measurement.