96 lines
3.2 KiB
Java
96 lines
3.2 KiB
Java
/*
|
|
* Copyright (c) 2012, 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 java.io;
|
|
|
|
import java.util.Objects;
|
|
|
|
/**
|
|
* Wraps an {@link IOException} with an unchecked exception.
|
|
*
|
|
* @since 1.8
|
|
*/
|
|
public class UncheckedIOException extends RuntimeException {
|
|
@java.io.Serial
|
|
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.
|
|
*
|
|
* @param s the {@code ObjectInputStream} from which data is read
|
|
* @throws IOException if an I/O error occurs
|
|
* @throws ClassNotFoundException if a serialized class cannot be loaded
|
|
* @throws InvalidObjectException
|
|
* if the object is invalid or has a cause that is not
|
|
* an {@code IOException}
|
|
*/
|
|
@java.io.Serial
|
|
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");
|
|
}
|
|
}
|