org.ka2ddo.yaac.io

Class ConfigImporter

java.lang.Object

org.xml.sax.helpers.DefaultHandler

org.ka2ddo.yaac.io.ConfigImporter

All Implemented Interfaces:

org.xml.sax.ContentHandler, org.xml.sax.DTDHandler, org.xml.sax.EntityResolver, org.xml.sax.ErrorHandler

public class ConfigImporter
extends org.xml.sax.helpers.DefaultHandler

This class implements an XML parser that can interpret the XML export of a YAAC configuration (as dumped by the Java Preferences code). It tries to provide enough smarts to validate parts of the configuration that might be different when restoring on a different computer (such as directory paths to the tile or log directories, serial port device names, etc.).

Author:

Andrew Pavlin, KA2DDO

Method Summary

Modifier and Type	Method and Description
void	endElement(java.lang.String uri, java.lang.String localName, java.lang.String qName) Receive notification of the end of an element.
static void	parseYAACXMLConfigFile(java.io.InputStream is, long fileLength) Read an InputStream of a YAAC-exported XML configuration file into this YAAC instance to create its configuration.
void	setDocumentLocator(org.xml.sax.Locator locator) Receive a Locator object for document events.
void	startElement(java.lang.String uri, java.lang.String localName, java.lang.String qName, org.xml.sax.Attributes attributes) Receive notification of the start of an element.

Methods inherited from class org.xml.sax.helpers.DefaultHandler

characters, endDocument, endPrefixMapping, error, fatalError, ignorableWhitespace, notationDecl, processingInstruction, resolveEntity, skippedEntity, startDocument, startPrefixMapping, unparsedEntityDecl, warning

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

parseYAACXMLConfigFile

public static void parseYAACXMLConfigFile(java.io.InputStream is,
                                          long fileLength)
                                   throws UserAbort

Read an InputStream of a YAAC-exported XML configuration file into this YAAC instance to create its configuration.

Parameters:

is - InputStream of the opened file

fileLength - number of bytes in the input file, used for progress dialog

Throws:

UserAbort - if the user clicks a Cancel button in a progress dialog or any prompting dialogs

setDocumentLocator

public void setDocumentLocator(org.xml.sax.Locator locator)

Receive a Locator object for document events.

Specified by:

setDocumentLocator in interface org.xml.sax.ContentHandler

Overrides:

setDocumentLocator in class org.xml.sax.helpers.DefaultHandler

Parameters:

locator - A locator for all SAX document events.

See Also:

ContentHandler.setDocumentLocator(org.xml.sax.Locator), Locator

startElement

public void startElement(java.lang.String uri,
                         java.lang.String localName,
                         java.lang.String qName,
                         org.xml.sax.Attributes attributes)
                  throws org.xml.sax.SAXException

Receive notification of the start of an element.

Specified by:

startElement in interface org.xml.sax.ContentHandler

Overrides:

startElement in class org.xml.sax.helpers.DefaultHandler

Parameters:

uri - The Namespace URI, or the empty string if the element has no Namespace URI or if Namespace processing is not being performed.

localName - The local name (without prefix), or the empty string if Namespace processing is not being performed.

qName - The qualified name (with prefix), or the empty string if qualified names are not available.

attributes - The attributes attached to the element. If there are no attributes, it shall be an empty Attributes object.

Throws:

org.xml.sax.SAXException - Any SAX exception, possibly wrapping another exception.

endElement

public void endElement(java.lang.String uri,
                       java.lang.String localName,
                       java.lang.String qName)
                throws org.xml.sax.SAXException

Receive notification of the end of an element.

Specified by:

endElement in interface org.xml.sax.ContentHandler

Overrides:

endElement in class org.xml.sax.helpers.DefaultHandler

Parameters:

uri - The Namespace URI, or the empty string if the element has no Namespace URI or if Namespace processing is not being performed.

localName - The local name (without prefix), or the empty string if Namespace processing is not being performed.

qName - The qualified name (with prefix), or the empty string if qualified names are not available.

Throws:

org.xml.sax.SAXException - Any SAX exception, possibly wrapping another exception.