org.apache.xmlbeans.XmlException Maven / Gradle / Ivy
/* Copyright 2004 The Apache Software Foundation
*
* Licensed 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 org.apache.xmlbeans;
import java.util.List;
import java.util.Collections;
import java.util.Collection;
import java.util.ArrayList;
/**
* A checked exception that can be thrown while processing,
* parsing, or compiling XML. May contain any number of {@link XmlError}
* objects.
*
* @see XmlError
* @see XmlRuntimeException
*/
public class XmlException extends Exception
{
private static final long serialVersionUID = 1L;
/**
* Constructs an XmlException from a message.
*/
public XmlException ( String m ) { super( m ); }
/**
* Constructs an XmlException from a message and a cause.
*/
public XmlException ( String m, Throwable t ) { super( m, t ); }
/**
* Constructs an XmlException from a cause.
*/
public XmlException ( Throwable t ) { super( t ); }
/**
* Constructs an XmlException from an {@link XmlError}.
*/
public XmlException ( XmlError error )
{
this( error.toString(), null, error );
}
/**
* Constructs an XmlException from a message, a cause, and an {@link XmlError}.
*/
public XmlException ( String m, Throwable t, XmlError error )
{
this( m, t, Collections.singletonList( error ) );
}
/**
* Constructs an XmlException from a message, a cause, and a collection of {@link XmlError XmlErrors}.
*/
public XmlException ( String m, Throwable t, Collection errors )
{
super( m, t );
if (errors != null)
_errors = Collections.unmodifiableList( new ArrayList( errors ) );
}
/**
* Constructs an XmlException from an {@link XmlRuntimeException}.
*/
public XmlException ( XmlRuntimeException xmlRuntimeException )
{
super(
xmlRuntimeException.getMessage(), xmlRuntimeException.getCause() );
Collection errors = xmlRuntimeException.getErrors();
if (errors != null)
_errors = Collections.unmodifiableList( new ArrayList( errors ) );
}
/**
* Returns the first {@link XmlError XmlErrors} that caused the exception, if any.
*/
public XmlError getError ( )
{
if (_errors == null || _errors.size() == 0)
return null;
return (XmlError) _errors.get( 0 );
}
/**
* Returns the collection of {@link XmlError XmlErrors} that caused the exception, if any.
*/
public Collection getErrors ( )
{
return _errors;
}
private List _errors;
}