Added in [API level 26](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) Summary: [Ctors](https://developer.android.com/reference/java/nio/file/FileSystemException#pubctors) \| [Methods](https://developer.android.com/reference/java/nio/file/FileSystemException#pubmethods) \| [Inherited Methods](https://developer.android.com/reference/java/nio/file/FileSystemException#inhmethods)

# FileSystemException


`
public


class
FileSystemException
`


`


`

`


`

`


`

`

extends https://developer.android.com/reference/java/io/IOException


`

`


`

|---|---|---|---|---|
| [java.lang.Object](https://developer.android.com/reference/java/lang/Object) |||||
| ↳ | [java.lang.Throwable](https://developer.android.com/reference/java/lang/Throwable) ||||
|   | ↳ | [java.lang.Exception](https://developer.android.com/reference/java/lang/Exception) |||
|   |   | ↳ | [java.io.IOException](https://developer.android.com/reference/java/io/IOException) ||
|   |   |   | ↳ | java.nio.file.FileSystemException |

|---|
| Known direct subclasses [AccessDeniedException](https://developer.android.com/reference/java/nio/file/AccessDeniedException), [AtomicMoveNotSupportedException](https://developer.android.com/reference/java/nio/file/AtomicMoveNotSupportedException), [DirectoryNotEmptyException](https://developer.android.com/reference/java/nio/file/DirectoryNotEmptyException), [FileAlreadyExistsException](https://developer.android.com/reference/java/nio/file/FileAlreadyExistsException), [FileSystemLoopException](https://developer.android.com/reference/java/nio/file/FileSystemLoopException), [NoSuchFileException](https://developer.android.com/reference/java/nio/file/NoSuchFileException), [NotDirectoryException](https://developer.android.com/reference/java/nio/file/NotDirectoryException), [NotLinkException](https://developer.android.com/reference/java/nio/file/NotLinkException) |---|---| | [AccessDeniedException](https://developer.android.com/reference/java/nio/file/AccessDeniedException) | Checked exception thrown when a file system operation is denied, typically due to a file permission or other access check. | | [AtomicMoveNotSupportedException](https://developer.android.com/reference/java/nio/file/AtomicMoveNotSupportedException) | Checked exception thrown when a file cannot be moved as an atomic file system operation. | | [DirectoryNotEmptyException](https://developer.android.com/reference/java/nio/file/DirectoryNotEmptyException) | Checked exception thrown when a file system operation fails because a directory is not empty. | | [FileAlreadyExistsException](https://developer.android.com/reference/java/nio/file/FileAlreadyExistsException) | Checked exception thrown when an attempt is made to create a file or directory and a file of that name already exists. | | [FileSystemLoopException](https://developer.android.com/reference/java/nio/file/FileSystemLoopException) | Checked exception thrown when a file system loop, or cycle, is encountered. | | [NoSuchFileException](https://developer.android.com/reference/java/nio/file/NoSuchFileException) | Checked exception thrown when an attempt is made to access a file that does not exist. | | [NotDirectoryException](https://developer.android.com/reference/java/nio/file/NotDirectoryException) | Checked exception thrown when a file system operation, intended for a directory, fails because the file is not a directory. | | [NotLinkException](https://developer.android.com/reference/java/nio/file/NotLinkException) | Checked exception thrown when a file system operation fails because a file is not a symbolic link. | |

<br />

*** ** * ** ***

Thrown when a file system operation fails on one or two files. This class is
the general class for file system exceptions.

## Summary

| ### Public constructors ||
|---|---|
| ` https://developer.android.com/reference/java/nio/file/FileSystemException#FileSystemException(java.lang.String)(https://developer.android.com/reference/java/lang/String file) ` Constructs an instance of this class. |
| ` https://developer.android.com/reference/java/nio/file/FileSystemException#FileSystemException(java.lang.String,%20java.lang.String,%20java.lang.String)(https://developer.android.com/reference/java/lang/String file, https://developer.android.com/reference/java/lang/String other, https://developer.android.com/reference/java/lang/String reason) ` Constructs an instance of this class. |

| ### Public methods ||
|---|---|
| ` https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/java/nio/file/FileSystemException#getFile()() ` Returns the file used to create this exception. |
| ` https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/java/nio/file/FileSystemException#getMessage()() ` Returns the detail message string. |
| ` https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/java/nio/file/FileSystemException#getOtherFile()() ` Returns the other file used to create this exception. |
| ` https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/java/nio/file/FileSystemException#getReason()() ` Returns the string explaining why the file system operation failed. |

| ### Inherited methods |
|---|---|
| From class ` https://developer.android.com/reference/java/lang/Throwable ` |---|---| | ` final void` | ` https://developer.android.com/reference/java/lang/Throwable#addSuppressed(java.lang.Throwable)(https://developer.android.com/reference/java/lang/Throwable exception) ` Appends the specified exception to the exceptions that were suppressed in order to deliver this exception. | | ` https://developer.android.com/reference/java/lang/Throwable` | ` https://developer.android.com/reference/java/lang/Throwable#fillInStackTrace()() ` Fills in the execution stack trace. | | ` https://developer.android.com/reference/java/lang/Throwable` | ` https://developer.android.com/reference/java/lang/Throwable#getCause()() ` Returns the cause of this throwable or `null` if the cause is nonexistent or unknown. | | ` https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/java/lang/Throwable#getLocalizedMessage()() ` Creates a localized description of this throwable. | | ` https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/java/lang/Throwable#getMessage()() ` Returns the detail message string of this throwable. | | ` https://developer.android.com/reference/java/lang/StackTraceElement` | ` https://developer.android.com/reference/java/lang/Throwable#getStackTrace()() ` Provides programmatic access to the stack trace information printed by `https://developer.android.com/reference/java/lang/Throwable#printStackTrace()`. | | ` final https://developer.android.com/reference/java/lang/Throwable` | ` https://developer.android.com/reference/java/lang/Throwable#getSuppressed()() ` Returns an array containing all of the exceptions that were suppressed, typically by the `try`-with-resources statement, in order to deliver this exception. | | ` https://developer.android.com/reference/java/lang/Throwable` | ` https://developer.android.com/reference/java/lang/Throwable#initCause(java.lang.Throwable)(https://developer.android.com/reference/java/lang/Throwable cause) ` Initializes the *cause* of this throwable to the specified value. | | ` void` | ` https://developer.android.com/reference/java/lang/Throwable#printStackTrace()() ` Prints this throwable and its backtrace to the standard error stream. | | ` void` | ` https://developer.android.com/reference/java/lang/Throwable#printStackTrace(java.io.PrintWriter)(https://developer.android.com/reference/java/io/PrintWriter s) ` Prints this throwable and its backtrace to the specified print writer. | | ` void` | ` https://developer.android.com/reference/java/lang/Throwable#printStackTrace(java.io.PrintStream)(https://developer.android.com/reference/java/io/PrintStream s) ` Prints this throwable and its backtrace to the specified print stream. | | ` void` | ` https://developer.android.com/reference/java/lang/Throwable#setStackTrace(java.lang.StackTraceElement[])(https://developer.android.com/reference/java/lang/StackTraceElement stackTrace) ` Sets the stack trace elements that will be returned by `https://developer.android.com/reference/java/lang/Throwable#getStackTrace()` and printed by `https://developer.android.com/reference/java/lang/Throwable#printStackTrace()` and related methods. | | ` https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/java/lang/Throwable#toString()() ` Returns a short description of this throwable. | ||
| From class ` https://developer.android.com/reference/java/lang/Object ` |---|---| | ` https://developer.android.com/reference/java/lang/Object` | ` https://developer.android.com/reference/java/lang/Object#clone()() ` Creates and returns a copy of this object. | | ` boolean` | ` https://developer.android.com/reference/java/lang/Object#equals(java.lang.Object)(https://developer.android.com/reference/java/lang/Object obj) ` Indicates whether some other object is "equal to" this one. | | ` void` | ` https://developer.android.com/reference/java/lang/Object#finalize()() ` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object. | | ` final https://developer.android.com/reference/java/lang/Class<?>` | ` https://developer.android.com/reference/java/lang/Object#getClass()() ` Returns the runtime class of this `Object`. | | ` int` | ` https://developer.android.com/reference/java/lang/Object#hashCode()() ` Returns a hash code value for the object. | | ` final void` | ` https://developer.android.com/reference/java/lang/Object#notify()() ` Wakes up a single thread that is waiting on this object's monitor. | | ` final void` | ` https://developer.android.com/reference/java/lang/Object#notifyAll()() ` Wakes up all threads that are waiting on this object's monitor. | | ` https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/java/lang/Object#toString()() ` Returns a string representation of the object. | | ` final void` | ` https://developer.android.com/reference/java/lang/Object#wait(long,%20int)(long timeoutMillis, int nanos) ` Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*, or until a certain amount of real time has elapsed. | | ` final void` | ` https://developer.android.com/reference/java/lang/Object#wait(long)(long timeoutMillis) ` Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*, or until a certain amount of real time has elapsed. | | ` final void` | ` https://developer.android.com/reference/java/lang/Object#wait()() ` Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*. | ||

## Public constructors

### FileSystemException

Added in [API level 26](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public FileSystemException (String file)
```

Constructs an instance of this class. This constructor should be used
when an operation involving one file fails and there isn't any additional
information to explain the reason.

<br />

| Parameters ||
|---|---|
| `file` | `String`: a string identifying the file or `null` if not known. <br /> |

### FileSystemException

Added in [API level 26](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public FileSystemException (String file, 
                String other, 
                String reason)
```

Constructs an instance of this class. This constructor should be used
when an operation involving two files fails, or there is additional
information to explain the reason.

<br />

| Parameters ||
|---|---|
| `file` | `String`: a string identifying the file or `null` if not known. <br /> |
| `other` | `String`: a string identifying the other file or `null` if there isn't another file or if not known <br /> |
| `reason` | `String`: a reason message with additional information or `null` <br /> |

## Public methods

### getFile

Added in [API level 26](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public String getFile ()
```

Returns the file used to create this exception.

<br />

| Returns ||
|---|---|
| `https://developer.android.com/reference/java/lang/String` | the file (can be `null`) <br /> |

### getMessage

Added in [API level 26](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public String getMessage ()
```

Returns the detail message string.

<br />

| Returns ||
|---|---|
| `https://developer.android.com/reference/java/lang/String` | the detail message string of this `Throwable` instance (which may be `null`). <br /> |

### getOtherFile

Added in [API level 26](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public String getOtherFile ()
```

Returns the other file used to create this exception.

<br />

| Returns ||
|---|---|
| `https://developer.android.com/reference/java/lang/String` | the other file (can be `null`) <br /> |

### getReason

Added in [API level 26](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public String getReason ()
```

Returns the string explaining why the file system operation failed.

<br />

| Returns ||
|---|---|
| `https://developer.android.com/reference/java/lang/String` | the string explaining why the file system operation failed <br /> |