This package contains the JAST 1.1 XML Processing Toolkit, © Anthony J H Simons, 2010-2015. This software is currently on experimental alpha release, and is offered as-is, under a free experimental license (see full terms below).

Java Abstract Syntax Trees, v1.1

This top-level package org.jast is the root of a collection of sub-packages that contain the actual JAST XML Processing Toolkit. This top-level package otherwise only contains a collection of short demonstration programs and example Java classes used to build an abstract syntax tree from XML. Please refer to one of the sub-packages for details of the tools:

• The package org.jast.ast contains tools for mapping XML files to user-defined Java syntax trees, and vice-versa.
• The package org.jast.xml contains tools for mapping XML files to JAST's standard XML memory model, and vice-versa.
• The package org.jast.xpath contains an XPath search engine for use with the standard XML model.
• The package org.jast.dtd contains a document validation engine for use with the standard XML model.
• The package org.jast.filter contains filters for searching and validating the standard XML model.

http://staffwww.dcs.shef.ac.uk/people/A.Simons/jast/.

Licensing Terms

This alpha-release software is free to use by academic and commercial users. The terms of the license are that you are free to use the software in any product (whether free or commercial), provided that any usage is acknowledged by citing "©Anthony J H Simons" as the copyright holder and referring to the JAST website "http://staffwww.dcs.shef.ac.uk/people/A.Simons/jast/" as the source. While this alpha license is perpetual and not subject to any restriction, we reserve the right to change the licensing terms of subsequent releases. The software is offered as-is, without any implied warranty for fitness of purpose. Please refer to the JAST website for further details:

http://staffwww.dcs.shef.ac.uk/people/A.Simons/jast/

The Demonstration Programs

The following assumes that you, the developer, wish to run some of the demonstration programs that come with the JAST 1.1 XML Processing Toolkit. The following short demonstration programs are available, which require a number of XML files as input:

• Test_XML: reads an XML file into the standard domain object model and writes the model back to XML
• Test_AST: unmarshals an XML file into a user-defined abstract syntax tree and marshals the tree back to XML
• Test_XPath: reads an XML file into the standard DOM and performs an XPath search for a set of nodes
• Test_DTD: reads an XML file into the standard DOM and validates it using a document type definition
• Test_XSD: reads an XML document and XML schema file and validates the XML using the XML schema definition
• Test_Filter: tests a number of the standard node filters on both positive and negative examples

To run any of these demonstrations, the appropriate XML files must exist and be in the working directory. The program which requires a user-defined abstract syntax tree expects to use the example AST node classes provided in this package, org.jast.