com.bigdata.rdf.error

Class W3CQueryLanguageException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

com.bigdata.rdf.error.W3CQueryLanguageException

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

SparqlDynamicErrorException, SparqlStaticErrorException, SparqlTypeErrorException

public class W3CQueryLanguageException
extends RuntimeException

Exception Base class for errors defined by the W3C for XQuery, XPath, and SPARQL.

Version:

$Id$

Author:

Bryan Thompson

See Also:

http://www.w3.org/TR/xquery/#errors, Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	W3CQueryLanguageException.ErrorCategory Error category.
static class	W3CQueryLanguageException.LanguageFamily Language family for errors.

Field Summary

Fields

Modifier and Type	Field and Description
protected static String	err Namespace for the error URIs.
W3CQueryLanguageException.ErrorCategory	errorCategory The W3CQueryLanguageException.ErrorCategory.
int	errorCode The four digit error code.
W3CQueryLanguageException.LanguageFamily	languageFamily The W3CQueryLanguageException.LanguageFamily.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	W3CQueryLanguageException(W3CQueryLanguageException.LanguageFamily languageFamily, W3CQueryLanguageException.ErrorCategory errorCategory, int errorCode)
protected	W3CQueryLanguageException(W3CQueryLanguageException.LanguageFamily languageFamily, W3CQueryLanguageException.ErrorCategory errorCategory, int errorCode, NV[] params)
protected	W3CQueryLanguageException(W3CQueryLanguageException.LanguageFamily languageFamily, W3CQueryLanguageException.ErrorCategory errorCategory, int errorCode, String msg)

Method Summary

Methods

Modifier and Type	Method and Description
protected static String	toURI(W3CQueryLanguageException.LanguageFamily languageFamily, W3CQueryLanguageException.ErrorCategory errorCategory, int errorCode, NV[] params) Return the URI for the given error.

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

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

Field Detail

err

protected static final transient String err

Namespace for the error URIs.

See Also:

Constant Field Values

languageFamily

public final W3CQueryLanguageException.LanguageFamily languageFamily

The W3CQueryLanguageException.LanguageFamily.

errorCategory

public final W3CQueryLanguageException.ErrorCategory errorCategory

The W3CQueryLanguageException.ErrorCategory.

errorCode

public final int errorCode

The four digit error code.

Constructor Detail

W3CQueryLanguageException

protected W3CQueryLanguageException(W3CQueryLanguageException.LanguageFamily languageFamily,
                         W3CQueryLanguageException.ErrorCategory errorCategory,
                         int errorCode)

Parameters:

languageFamily - The W3CQueryLanguageException.LanguageFamily.

errorCategory - The W3CQueryLanguageException.ErrorCategory.

errorCode - The four digit error code.

W3CQueryLanguageException

protected W3CQueryLanguageException(W3CQueryLanguageException.LanguageFamily languageFamily,
                         W3CQueryLanguageException.ErrorCategory errorCategory,
                         int errorCode,
                         String msg)

Parameters:

languageFamily - The W3CQueryLanguageException.LanguageFamily.

errorCategory - The W3CQueryLanguageException.ErrorCategory.

errorCode - The four digit error code.

msg - The URI corresponding to the error. Frequently used errors should use #toURI(LanguageFamily, ErrorCategory, int) to define the URI statically to avoid heap churn.

W3CQueryLanguageException

protected W3CQueryLanguageException(W3CQueryLanguageException.LanguageFamily languageFamily,
                         W3CQueryLanguageException.ErrorCategory errorCategory,
                         int errorCode,
                         NV[] params)

Parameters:

languageFamily - The W3CQueryLanguageException.LanguageFamily.

errorCategory - The W3CQueryLanguageException.ErrorCategory.

errorCode - The four digit error code.

params - Additional parameters for the error message (optional and may be null). When non-null and non-empty, the parameters are appended to the constructed URI as query parameters.

Method Detail

toURI

protected static String toURI(W3CQueryLanguageException.LanguageFamily languageFamily,
           W3CQueryLanguageException.ErrorCategory errorCategory,
           int errorCode,
           NV[] params)

Return the URI for the given error. This is used to avoid the runtime creation of strings for frequently thrown errors, such as type errors. Various subclasses use this method to declare concrete URIs which are then passed into their constructors for specific kinds of errors.

Parameters:

languageFamily - The W3CQueryLanguageException.LanguageFamily.

errorCategory - The W3CQueryLanguageException.ErrorCategory.

errorCode - The four digit error code.

params - Additional parameters for the error message (optional and may be null). When non-null and non-empty, the parameters are appended to the constructed URI as query parameters.

Returns:

The URI.