PIA / src / java / org / risource / dps

[..] [files] [ Packages Interfaces Classes Exceptions || about, to-do, done ]
( active handle input namespace output parse process tagset tree util || test )

Document Processing System

This directory contains the all-new, all-singing, all-dancing, SGML-based, XML-ready, buzzword-compliant Document Processing System.

Annotated Contents

Packages

active/: Parse trees made out of ``Active nodes''. This directory contains extensions to the W3C's Document Object Model interfaces (org.w3c.dom).
handle/: The Handler subclasses that implement actions (operations) attached to actors. It turns out that tags is a bad name for a subdirectory, since it's the name used for the ``tag file'' created by the ctags utility. CVS ignores it, and various cleanup and maintenance operations are likely to flag it as deletable.
input/: Sources of nodes.
namespace/: Implementations of the Namespace interface and some associated auxiliary classes, including specialized implementations of ActiveEntity.
output/: Destinations for nodes.
parse/: Parsers (i.e. Readers for nodes). The Parser interface extends Input.
process/: Implementations of the Processor and TopContext interfaces.
tagset/: Tagsets (lookup tables for syntax and semantic Handlers).
test/: test cases
tree/: Classes that implement the ``Active Node'' (parse tree) interfaces in active/
util/: Utility classes, not meant for use by the casual programmer. Includes implementations of several org.risource.dps interfaces. Was named "aux" until we discovered a conflict with DOS filename conventions. (You don't want to know.)

Interfaces

Contexts

Context: An environment in which entity names can be looked up.
Processor: A document processor. Both a consumer and producer of Nodes, it extends Context by adding an Input and Output.
TopContext: A top-level context, containing a Tagset. (An implementation of TopContext is normally a Processor as well.)

Handlers

Action: Semantic handlers for active nodes.
Active: Interface for ``active'' objects (i.e. objects with an Action).
Syntax: Interface for node syntax handlers.
Handler: Combination of Syntax and Action handlers.

Bindings

Namespace: A lookup table for nodes (bindings).
EntityTable: A lookup table for Entity values.
Tagset: A lookup table for both Handlers and Entities. Supports context chaining.

Traversal

Cursor: An interface that allows anything with a ``current node'' to be handled efficiently. The parent for Input and Output.
Input: A source of nodes, essentially a tree traverser.
Parser: An Input that parses nodes from a character stream.
ProcessorInput: An Input that has a reference to the Processor to which it is supplying input. Probably not needed anymore.
Output: A tree constructor.

Classes

``Abstract'' in a name marks an abstract base class; ``Basic'' marks a class with full but perhaps limited functionality.

Filter: A main-program wrapper that allows a TopProcessor to be used as a filter for (gasp!) processing documents.

Exceptions

active/DPSException: Generic RuntimeException for the DPS. Extends DOMException.

      Name                    Last modified      Size  Description
      Parent Directory                             -   
      Action.java             2012-04-01 16:18  3.9K  
      Active.java             2012-04-01 16:18  1.6K  
      Context.java            2012-04-01 16:18  6.9K  
      Cursor.java             2012-04-01 16:18  4.3K  
      EntityTable.java        2012-04-01 16:18  2.0K  
      Filter.java             2012-04-01 16:18  9.5K  
      Handler.java            2012-04-01 16:18  1.7K  
      Input.java              2012-04-01 16:18  6.2K  
      Makefile                2012-04-01 16:18  2.0K  
      Namespace.java          2012-04-01 16:18  4.0K  
      Output.java             2012-04-01 16:18  4.3K  
      Parser.java             2012-04-01 16:18  2.3K  
      Processor.java          2012-04-01 16:18  3.3K  
      ProcessorInput.java     2012-04-01 16:18  2.4K  
      PropertyMap.java        2012-04-01 16:18  3.6K  
      Syntax.java             2012-04-01 16:18  6.7K  
      Tagset.java             2012-04-01 16:18  9.7K  
      TopContext.java         2012-04-01 16:18  6.0K  
      about.html              2012-04-01 16:18   14K  
      active/                 2012-04-01 16:18    -   
      done.html               2012-04-01 16:18   55K  
      handle/                 2012-04-01 16:18    -   
      input/                  2012-04-01 16:18    -   
      namespace/              2012-04-01 16:18    -   
      output/                 2012-04-01 16:18    -   
      parse/                  2012-04-01 16:18    -   
      process/                2012-04-01 16:18    -   
      test/                   2012-04-01 16:18    -   
      to-do.html              2012-04-01 16:18   27K  
      tree/                   2012-04-01 16:18    -   
      util/                   2012-04-01 16:18    -