org.apache.commons.scxml.io

A collection of classes for reading in and writing out SCXML documents, to and from the Commons SCXML Java object model.

Two variants of the SCXML parser are present in this package:

• SCXMLDigester represents the parser that corresponds to the July 05 Working Draft, and will be removed in v1.0. It will be present all v0.x releases for backwards compatability reasons.
• SCXMLParser represents the newer version. This will be updated to keep up with the more recent Working Drafts.

The SCXMLDigester provides the ability to digest a SCXML document into the Java object model provided in the model package.

The SCXMLDigester can be used for:

1. Digest a SCXML file into the Commons SCXML Java object model.
2. Obtain a SCXML Digester for further customization of the default ruleset.

NOTE: The SCXMLDigester assumes that the SCXML document to be parsed is well-formed and correct.

The SCXMLParser provides the ability to parse a SCXML document into the Java object model provided in the model package.

The SCXMLParser can be used for:

1. Parse a SCXML file into the Commons SCXML Java object model.
2. Obtain a SCXML Parser for further customization of the default ruleset.

If switching from SCXMLDigester , changes need to be made to the SCXML documents, such as:

• A <parallel> should not be wrapped in a <state> element unless otherwise necessary
• <var> and <exit> elements continue to be supported by Commons SCXML, but in the Commons SCXML namespace: http://commons.apache.org/scxml
• <event> is now supported

See latest version of the SCXML Working Draft for more details.

NOTE: The SCXMLParser assumes that the SCXML document to be parsed is well-formed and correct.

Utility class for serializing the Commons SCXML Java object model.