net.sf.saxon.om

Class QNameParser

java.lang.Object

net.sf.saxon.om.QNameParser

public class QNameParser
extends java.lang.Object

Parser to handle QNames in either lexical QName or EQName syntax, including resolving any prefix against a URIResolver. The parser can be instantiated with various options to control the returned error code, the handling of defaults, etc.

Constructor Summary

Constructors

Constructor and Description
QNameParser(NamespaceResolver resolver)

Method Summary

Modifier and Type	Method and Description
StructuredQName	parse(java.lang.CharSequence lexicalName, java.lang.String defaultNS) Make a structured QName from a lexical QName, using a supplied NamespaceResolver to resolve the prefix.
void	setAcceptEQName(boolean acceptEQName)
void	setErrorOnBadSyntax(java.lang.String code)
void	setErrorOnUnresolvedPrefix(java.lang.String code)
void	setNamespaceResolver(NamespaceResolver resolver)
void	setUnescaper(XQueryParser.Unescaper unescaper)

Methods inherited from class java.lang.Object

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

Constructor Detail

QNameParser

public QNameParser(NamespaceResolver resolver)

Method Detail

setNamespaceResolver

public void setNamespaceResolver(NamespaceResolver resolver)

setAcceptEQName

public void setAcceptEQName(boolean acceptEQName)

setUnescaper

public void setUnescaper(XQueryParser.Unescaper unescaper)

setErrorOnBadSyntax

public void setErrorOnBadSyntax(java.lang.String code)

setErrorOnUnresolvedPrefix

public void setErrorOnUnresolvedPrefix(java.lang.String code)

parse

public StructuredQName parse(java.lang.CharSequence lexicalName,
                             java.lang.String defaultNS)
                      throws XPathException

Make a structured QName from a lexical QName, using a supplied NamespaceResolver to resolve the prefix. The local part of the QName is checked for validity; the prefix is not checked, on the grounds that an invalid prefix will fail to resolve to a URI.

Parameters:

lexicalName - the QName as a lexical name (prefix:local)

defaultNS - the default namespace to use if there is no prefix

Returns:

the StructuredQName object corresponding to this lexical QName

Throws:

XPathException - if the namespace prefix is not in scope or if the value is lexically invalid. Error code FONS0004 is set if the namespace prefix has not been declared; error code FOCA0002 is set if the name is lexically invalid. These may need to be changed on return depending on the caller's requirements.