| /* 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. |
| * <p> |
| * @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; |
| } |