/* Woodstox Lite ("wool") XML processor
 *
 * Copyright (c) 2006- Tatu Saloranta, tatu.saloranta@iki.fi
 *
 * Licensed under the License specified in the file LICENSE which is
 * included with the source code.
 * You may not use this file except in compliance with the License.
 *
 * 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 com.fasterxml.aalto;

import javax.xml.stream.*;

Unchecked exception that has to be used for methods of Stax API that do not allow throwing checked XMLStreamException, but where internal methods that need to be called may throw such an exception. It is, then, essentially used to overcome design flaws in Stax API.

This class generally tries to forward all requests to the underlying exception class, in the hopes that it can for the most part look just like if the underlying message was thrown. This may be confusing in some ways ("Why did my catch (XMLStreamException ..) clause catch this exception?"), but usually should make sense.

/** * Unchecked exception that has to be used for methods of Stax API that * do not allow throwing checked XMLStreamException, but where internal * methods that need to be called may throw such an exception. * It is, then, essentially used to overcome design flaws in Stax API. *<p> * This class generally tries to forward all requests to the underlying * exception class, in the hopes that it can for the most part look just * like if the underlying message was thrown. This may be confusing in * some ways ("Why did my catch (XMLStreamException ..) clause catch * this exception?"), but usually should make sense. */
@SuppressWarnings("serial") public class UncheckedStreamException extends RuntimeException { private UncheckedStreamException(XMLStreamException orig) { super(orig); } public static UncheckedStreamException createFrom(XMLStreamException sex) { return new UncheckedStreamException(sex); } @Override public StackTraceElement[] getStackTrace() { return getCause().getStackTrace(); } @Override public String getMessage() { return getCause().getMessage(); } @Override public String getLocalizedMessage() { return getCause().getLocalizedMessage(); } @Override public void printStackTrace() { getCause().printStackTrace(); } @Override public void printStackTrace(java.io.PrintStream p) { getCause().printStackTrace(p); } @Override public void printStackTrace(java.io.PrintWriter p) { getCause().printStackTrace(p); } @Override public String toString() { return getCause().toString(); } }