/*
* reserved comment block
* DO NOT REMOVE OR ALTER!
*/
/*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright ownership.
* The ASF licenses this file to You under the Apache License, Version 2.0
* (the "License"); you may not use this file except in compliance with
* the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package com.sun.org.apache.xerces.internal.xni.parser;
import com.sun.org.apache.xerces.internal.xni.XNIException;
An interface for handling errors. If the application is interested
in error notifications, then it can register an error handler object
that implements this interface with the parser configuration.
Author: Andy Clark, IBM See Also: - XMLParserConfiguration
/**
* An interface for handling errors. If the application is interested
* in error notifications, then it can register an error handler object
* that implements this interface with the parser configuration.
*
* @see XMLParserConfiguration
*
* @author Andy Clark, IBM
*
*/
public interface XMLErrorHandler {
//
// XMLErrorHandler methods
//
Reports a warning. Warnings are non-fatal and can be safely ignored
by most applications.
Params: - domain – The domain of the warning. The domain can be any
string but is suggested to be a valid URI. The
domain can be used to conveniently specify a web
site location of the relevent specification or
document pertaining to this warning.
- key – The warning key. This key can be any string and
is implementation dependent.
- exception – Exception.
Throws: - XNIException – Thrown to signal that the parser should stop
parsing the document.
/**
* Reports a warning. Warnings are non-fatal and can be safely ignored
* by most applications.
*
* @param domain The domain of the warning. The domain can be any
* string but is suggested to be a valid URI. The
* domain can be used to conveniently specify a web
* site location of the relevent specification or
* document pertaining to this warning.
* @param key The warning key. This key can be any string and
* is implementation dependent.
* @param exception Exception.
*
* @throws XNIException Thrown to signal that the parser should stop
* parsing the document.
*/
public void warning(String domain, String key,
XMLParseException exception) throws XNIException;
Reports an error. Errors are non-fatal and usually signify that the
document is invalid with respect to its grammar(s).
Params: - domain – The domain of the error. The domain can be any
string but is suggested to be a valid URI. The
domain can be used to conveniently specify a web
site location of the relevent specification or
document pertaining to this error.
- key – The error key. This key can be any string and
is implementation dependent.
- exception – Exception.
Throws: - XNIException – Thrown to signal that the parser should stop
parsing the document.
/**
* Reports an error. Errors are non-fatal and usually signify that the
* document is invalid with respect to its grammar(s).
*
* @param domain The domain of the error. The domain can be any
* string but is suggested to be a valid URI. The
* domain can be used to conveniently specify a web
* site location of the relevent specification or
* document pertaining to this error.
* @param key The error key. This key can be any string and
* is implementation dependent.
* @param exception Exception.
*
* @throws XNIException Thrown to signal that the parser should stop
* parsing the document.
*/
public void error(String domain, String key,
XMLParseException exception) throws XNIException;
Report a fatal error. Fatal errors usually occur when the document
is not well-formed and signifies that the parser cannot continue
normal operation.
Note: The error handler should always
throw an XNIException from this method. This exception
can either be the same exception that is passed as a parameter to
the method or a new XNI exception object. If the registered error
handler fails to throw an exception, the continuing operation of
the parser is undetermined.
Params: - domain – The domain of the fatal error. The domain can be
any string but is suggested to be a valid URI. The
domain can be used to conveniently specify a web
site location of the relevent specification or
document pertaining to this fatal error.
- key – The fatal error key. This key can be any string
and is implementation dependent.
- exception – Exception.
Throws: - XNIException – Thrown to signal that the parser should stop
parsing the document.
/**
* Report a fatal error. Fatal errors usually occur when the document
* is not well-formed and signifies that the parser cannot continue
* normal operation.
* <p>
* <strong>Note:</strong> The error handler should <em>always</em>
* throw an <code>XNIException</code> from this method. This exception
* can either be the same exception that is passed as a parameter to
* the method or a new XNI exception object. If the registered error
* handler fails to throw an exception, the continuing operation of
* the parser is undetermined.
*
* @param domain The domain of the fatal error. The domain can be
* any string but is suggested to be a valid URI. The
* domain can be used to conveniently specify a web
* site location of the relevent specification or
* document pertaining to this fatal error.
* @param key The fatal error key. This key can be any string
* and is implementation dependent.
* @param exception Exception.
*
* @throws XNIException Thrown to signal that the parser should stop
* parsing the document.
*/
public void fatalError(String domain, String key,
XMLParseException exception) throws XNIException;
} // interface XMLErrorHandler