Embed in a Java Program

This has not yet been documented. It could be that the API needs enhancements to run without a configuration file.

There are two ways to do it,

• either use the complete Jacson process
• or use Jacson as a java.io.FilterReader

Embed Jacson

A brief plan is:

• Create a Jacson instance.
• Setup that instance
  • Either let this parse a configuration file via the init() method.
  • Or construct the configuration in code:
    • Add instances of JacsonFilter from de.spieleck.app.jacson.filter or your own ones.
    • Add instances of JacsonEvaluator from de.spieleck.app.jacson.eval or your own ones.
    • Add instances of JacsonReport from de.spieleck.app.jacson.report or your own ones.
• Obtain one or more JacsonChunkSource instances from de.spieleck.app.jacson.source or your own ones.
• Call the method run(Source) of your Jacson for every such JacsonChunkSource.
• Obtain the final summary via summary().

Have a look at the following source code for sample applications:

• The main() method of Jacson.
• The main() method of JacsonTail.
• The JacsonTask class.
• The JacsonBlocks addFilter and addEval methods.

Use Jacson as a Filter

JacsonReader implements java.io.Filter and can be used whereever such a filter can be used. The most useful application I currently know is the embedding into Ant in a FilterChain.

A snippet how to use it in your program is as simple as

  Reader previousReader = ...
  JacsonReader jr = new JacsonReader(previousReader);
  jr.setConfig("the.path.to.your.config.file");

Note: That the wrapping of Jacson into a filter is slightly costly, it requires a separate thread internally. We are thinking about how to make it somewhat lighter at least in the Ant setting by using a ThreadPool.