The javax.xml.transform.ErrorListener Class

Members

Overview

This interface is analogous to ErrorHandler in SAX, and provides error notification for transformation. Use the setErrorListener method to register an instance of the implmentation with the Transformer. The Transformer then reports all errors and warnings through this interface.

If an application does not register an ErrorListener, errors are reported to System.err.

For transformation errors, a Transformer must use this interface instead of throwing an exception: it is up to the application to decide whether to throw an exception for different types of errors and warnings. Note however that the Transformer is not required to continue with the transformation after a call to fatalError.

Transformers may use this mechanism to report XML parsing errors as well as transformation errors.

Method Overviews

Important methods of this class are error(TransformerException exception), fatalError(TransformerException exception), warning(TransformerException exception).

Example of how to use ErrorListener

package topxml;

import javax.xml.transform.ErrorListener;

import javax.xml.transform.TransformerException;

public class ErrorListenerImpl implements ErrorListener

{

  public ErrorListenerImpl()

  {

  }

  /**

   * Receive notification of a recoverable error.

   * @param exception

   */

  public void             error(TransformerException exception)

  {

    System.out.println("Error occurred :"+exception.getMessage());

  }

   /**

   * Receive notification of a non-recoverable error.

   * @param exception

   */

  public void             fatalError(TransformerException exception)

  {

    System.out.println("Fatal Error occurred :"+exception.getMessage());

  }

   /**

   * Receive notification of a warning.

   * @param exception

   */

  public void             warning(TransformerException exception)

  {

    System.out.println("Warning occurred :"+exception.getMessage());

  }

}

Use this ErrorListenerImpl class for any errors during transformation.

transformer.setErrorListener(new ErrorListenerImpl());

String sourcesystemURI = "E:\\topxml\\persoan.xml"; //this file doesn’t exist

During transformation the error output will be :

Fatal Error occurred :File "file:///E:/topxml/persoan.xml" not found.