/* |
|
* Copyright (c) 2012, 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 java.io; |
|
import java.util.Objects; |
|
/** |
|
* Wraps an {@link IOException} with an unchecked exception. |
|
* |
|
* @since 1.8 |
|
*/ |
|
public class UncheckedIOException extends RuntimeException { |
|
private static final long serialVersionUID = -8134305061645241065L; |
|
/** |
|
* Constructs an instance of this class. |
|
* |
|
* @param message |
|
* the detail message, can be null |
|
* @param cause |
|
* the {@code IOException} |
|
* |
|
* @throws NullPointerException |
|
* if the cause is {@code null} |
|
*/ |
|
public UncheckedIOException(String message, IOException cause) { |
|
super(message, Objects.requireNonNull(cause)); |
|
} |
|
/** |
|
* Constructs an instance of this class. |
|
* |
|
* @param cause |
|
* the {@code IOException} |
|
* |
|
* @throws NullPointerException |
|
* if the cause is {@code null} |
|
*/ |
|
public UncheckedIOException(IOException cause) { |
|
super(Objects.requireNonNull(cause)); |
|
} |
|
/** |
|
* Returns the cause of this exception. |
|
* |
|
* @return the {@code IOException} which is the cause of this exception. |
|
*/ |
|
@Override |
|
public IOException getCause() { |
|
return (IOException) super.getCause(); |
|
} |
|
/** |
|
* Called to read the object from a stream. |
|
* |
|
* @throws InvalidObjectException |
|
* if the object is invalid or has a cause that is not |
|
* an {@code IOException} |
|
*/ |
|
private void readObject(ObjectInputStream s) |
|
throws IOException, ClassNotFoundException |
|
{ |
|
s.defaultReadObject(); |
|
Throwable cause = super.getCause(); |
|
if (!(cause instanceof IOException)) |
|
throw new InvalidObjectException("Cause must be an IOException"); |
|
} |
|
} |