/*

* Copyright (c) 2010, 2011, Oracle and/or its affiliates. All rights reserved.

* ORACLE PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.

*

*

*

*

*

*

*

*

*

*

*

*

*

*

*

*

*

*

*

*

*/

package java.nio.file;

import java.util.ConcurrentModificationException;

import java.util.Objects;

import java.io.IOException;

import java.io.ObjectInputStream;

import java.io.InvalidObjectException;

/**

* Runtime exception thrown if an I/O error is encountered when iterating over

* the entries in a directory. The I/O error is retrieved as an {@link

* IOException} using the {@link #getCause() getCause()} method.

*

* @since 1.7

* @see DirectoryStream

*/

public final class DirectoryIteratorException

extends ConcurrentModificationException

{

private static final long serialVersionUID = -6012699886086212874L;

/**

* Constructs an instance of this class.

*

* @param cause

* the {@code IOException} that caused the directory iteration

* to fail

*

* @throws NullPointerException

* if the cause is {@code null}

*/

public DirectoryIteratorException(IOException cause) {

super(Objects.requireNonNull(cause));

}

/**

* Returns the cause of this exception.

*

* @return the cause

*/

@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");

}

}