/*
 * Copyright (c) 2009, 2020, 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.stream;

An error class for reporting factory configuration errors.
Author:Copyright (c) 2009 by Oracle Corporation. All Rights Reserved.
Version:1.0
Since:1.6
/** * An error class for reporting factory configuration errors. * * @version 1.0 * @author Copyright (c) 2009 by Oracle Corporation. All Rights Reserved. * @since 1.6 */
public class FactoryConfigurationError extends Error { private static final long serialVersionUID = -2994412584589975744L;
The nested exception.
/** * The nested exception. */
Exception nested;
Default constructor
/** * Default constructor */
public FactoryConfigurationError(){}
Construct an exception with a nested inner exception
Params:
  • e – the exception to nest
/** * Construct an exception with a nested inner exception * * @param e the exception to nest */
public FactoryConfigurationError(java.lang.Exception e){ nested = e; }
Construct an exception with a nested inner exception and a message
Params:
  • e – the exception to nest
  • msg – the message to report
/** * Construct an exception with a nested inner exception * and a message * * @param e the exception to nest * @param msg the message to report */
public FactoryConfigurationError(java.lang.Exception e, java.lang.String msg){ super(msg); nested = e; }
Construct an exception with a nested inner exception and a message
Params:
  • msg – the message to report
  • e – the exception to nest
/** * Construct an exception with a nested inner exception * and a message * * @param msg the message to report * @param e the exception to nest */
public FactoryConfigurationError(java.lang.String msg, java.lang.Exception e){ super(msg); nested = e; }
Construct an exception with associated message
Params:
  • msg – the message to report
/** * Construct an exception with associated message * * @param msg the message to report */
public FactoryConfigurationError(java.lang.String msg) { super(msg); }
Return the nested exception (if any)
Returns:the nested exception or null
/** * Return the nested exception (if any) * * @return the nested exception or null */
public Exception getException() { return nested; }
use the exception chaining mechanism of JDK1.4
/** * use the exception chaining mechanism of JDK1.4 */
@Override public Throwable getCause() { return nested; }
Report the message associated with this error
Returns:the string value of the message
/** * Report the message associated with this error * * @return the string value of the message */
public String getMessage() { String msg = super.getMessage(); if(msg != null) return msg; if(nested != null){ msg = nested.getMessage(); if(msg == null) msg = nested.getClass().toString(); } return msg; } }