• Home
• org.mule.runtime
• mule-module-spring-config
• 4.1.1
• source code
• XmlGathererErrorHandler.java

×

Project download

Many resources are needed to download a project. Please understand that we have to compensate our server costs. Thank you in advance.
Project price only 1 $

You can buy this project and download/modify it how often you want.

org.mule.runtime.config.api.XmlGathererErrorHandler Maven / Gradle / Ivy

/*
 * Copyright (c) MuleSoft, Inc.  All rights reserved.  http://www.mulesoft.com
 * The software in this package is published under the terms of the CPAL v1.0
 * license, a copy of which has been included with this distribution in the
 * LICENSE.txt file.
 */
package org.mule.runtime.config.api;

import org.mule.api.annotation.NoImplement;

import java.io.InputStream;
import java.util.List;
import java.util.Optional;

import org.xml.sax.ErrorHandler;
import org.xml.sax.SAXParseException;

/**
 * Represents a specific type of {@link ErrorHandler} which gathers as many errors as possible to be displayed later for
 * either logging purposes or to propagate an exception with the full list of errors.
 * 

 * Any implementation must be careful on how to treat the {@link ErrorHandler#fatalError(SAXParseException)} method, as
 * if the exception is not propagated immediately, breaking the current file parsing, the state of the DOM is in most
 * of the cases unusable.
 *
 * @see {@link XmlConfigurationDocumentLoader#loadDocument(Optional, String, InputStream)}
 *
 * @since 4.0
 */
@NoImplement
public interface XmlGathererErrorHandler extends ErrorHandler {

  /**
   * @return a collection with all the {@link SAXParseException} exceptions gathered from {@link ErrorHandler#error(SAXParseException)}.
   * 

   * An empty list means there were no error while parsing the file. Non null.
   */
  List getErrors();
}