/*
 * Copyright (c) 2003, 2013, Oracle and/or its affiliates. All rights reserved.
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
 *
 * This code is free software; you can redistribute it and/or modify it
 * under the terms of the GNU General Public License version 2 only, as
 * published by the Free Software Foundation.  Oracle designates this
 * particular file as subject to the "Classpath" exception as provided
 * by Oracle in the LICENSE file that accompanied this code.
 *
 * This code is distributed in the hope that it will be useful, but WITHOUT
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
 * version 2 for more details (a copy is included in the LICENSE file that
 * accompanied this code).
 *
 * You should have received a copy of the GNU General Public License version
 * 2 along with this work; if not, write to the Free Software Foundation,
 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
 *
 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
 * or visit www.oracle.com if you need additional information or have any
 * questions.
 */

package javax.xml.bind;

This exception indicates that an error has occurred while performing
an unmarshal operation that prevents the JAXB Provider from completing
the operation.
 The ValidationEventHandler can cause this exception to be thrown during the unmarshal operations. See 
ValidationEventHandler.handleEvent(ValidationEvent). 
Author:
Ryan Shoemaker, Sun Microsystems, Inc.
See Also:
JAXBException
Unmarshaller
ValidationEventHandler
Since:
1.6, JAXB 1.0/**
 * This exception indicates that an error has occurred while performing
 * an unmarshal operation that prevents the JAXB Provider from completing
 * the operation.
 *
 * <p>
 * The {@code ValidationEventHandler} can cause this exception to be thrown
 * during the unmarshal operations.  See
 * {@link ValidationEventHandler#handleEvent(ValidationEvent)
 * ValidationEventHandler.handleEvent(ValidationEvent)}.
 *
 * @author <ul><li>Ryan Shoemaker, Sun Microsystems, Inc.</li></ul>
 * @see JAXBException
 * @see Unmarshaller
 * @see ValidationEventHandler
 * @since 1.6, JAXB 1.0
 */
public class UnmarshalException extends JAXBException {

    
Construct an UnmarshalException with the specified detail message.  The
errorCode and linkedException will default to null.
Params:
message – a description of the exception/**
     * Construct an UnmarshalException with the specified detail message.  The
     * errorCode and linkedException will default to null.
     *
     * @param message a description of the exception
     */
    public UnmarshalException( String message ) {
        this( message, null, null );
    }

    
Construct an UnmarshalException with the specified detail message and vendor
specific errorCode.  The linkedException will default to null.
Params:
message – a description of the exception
errorCode – a string specifying the vendor specific error code/**
     * Construct an UnmarshalException with the specified detail message and vendor
     * specific errorCode.  The linkedException will default to null.
     *
     * @param message a description of the exception
     * @param errorCode a string specifying the vendor specific error code
     */
    public UnmarshalException( String message, String errorCode ) {
        this( message, errorCode, null );
    }

    
Construct an UnmarshalException with a linkedException.  The detail message and
vendor specific errorCode will default to null.
Params:
exception – the linked exception/**
     * Construct an UnmarshalException with a linkedException.  The detail message and
     * vendor specific errorCode will default to null.
     *
     * @param exception the linked exception
     */
    public UnmarshalException( Throwable exception ) {
        this( null, null, exception );
    }

    
Construct an UnmarshalException with the specified detail message and
linkedException.  The errorCode will default to null.
Params:
message – a description of the exception
exception – the linked exception/**
     * Construct an UnmarshalException with the specified detail message and
     * linkedException.  The errorCode will default to null.
     *
     * @param message a description of the exception
     * @param exception the linked exception
     */
    public UnmarshalException( String message, Throwable exception ) {
        this( message, null, exception );
    }

    
Construct an UnmarshalException with the specified detail message, vendor
specific errorCode, and linkedException.
Params:
message – a description of the exception
errorCode – a string specifying the vendor specific error code
exception – the linked exception/**
     * Construct an UnmarshalException with the specified detail message, vendor
     * specific errorCode, and linkedException.
     *
     * @param message a description of the exception
     * @param errorCode a string specifying the vendor specific error code
     * @param exception the linked exception
     */
    public UnmarshalException( String message, String errorCode, Throwable exception ) {
        super( message, errorCode, exception );
    }

}