/*
 * Copyright (c) 2003, 2018 Oracle and/or its affiliates. All rights reserved.
 *
 * This program and the accompanying materials are made available under the
 * terms of the Eclipse Distribution License v. 1.0, which is available at
 * http://www.eclipse.org/org/documents/edl-v10.php.
 *
 * SPDX-License-Identifier: BSD-3-Clause
 */

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 );
    }

}