StorageError (Javadocs [I2P+ 2.13.0+]

java.lang.Object
- java.lang.Enum<StorageError>
- - org.klomp.snark.StorageError

All Implemented Interfaces:
Serializable, Comparable<StorageError>
```
public enum StorageError
extends Enum<StorageError>
```
Classified storage failures. The JDK maps many errno failures to typed NIO exceptions, so those are matched first without any message parsing; the OS error text carried by the exception message is only a fallback for classic java.io failures (RandomAccessFile paths surface as plain IOException) and for errno cases with no typed exception (ENOSPC, EIO, EMFILE, EDQUOT, ...).
Each constant carries the human-readable label used in console and log messages, and whether the failure is fatal for the torrent (stop) or transient (drop the request and retry later).

Enum Constant Summary

Enum Constants
Enum Constant and Description
`IO_ERROR`
`IS_DIRECTORY`
`MISSING` transient: file vanished, retry
`NAME_TOO_LONG`
`NO_SPACE`
`OTHER` unclassified; the raw exception text is preserved by describe()
`PERMISSION`
`QUOTA`
`READ_ONLY`
`STALE_HANDLE` transient: stale or read-only handle, retry
`TOO_MANY_OPEN` transient: fd exhaustion, retry

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`static StorageError`	`classify(IOException ioe)` Classify a storage failure.
`static String`	`describe(IOException ioe)` Human-readable description of a storage failure, preserving the raw exception text for unclassified errors.
`boolean`	`isFatal()` Whether a torrent should stop on this failure rather than drop the request and retry.
`String`	`toString()` Human-readable label for console and log messages.
`static StorageError`	`valueOf(String name)` Returns the enum constant of this type with the specified name.
`static StorageError[]`	`values()` Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum
clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, valueOf

Methods inherited from class java.lang.Object
getClass, notify, notifyAll, wait, wait, wait

- Enum Constant Detail
  - IO_ERROR
```
public static final StorageError IO_ERROR
```
  - IS_DIRECTORY
```
public static final StorageError IS_DIRECTORY
```
  - MISSING
```
public static final StorageError MISSING
```
    transient: file vanished, retry
  - NAME_TOO_LONG
```
public static final StorageError NAME_TOO_LONG
```
  - NO_SPACE
```
public static final StorageError NO_SPACE
```
  - OTHER
```
public static final StorageError OTHER
```
    unclassified; the raw exception text is preserved by describe()
  - PERMISSION
```
public static final StorageError PERMISSION
```
  - QUOTA
```
public static final StorageError QUOTA
```
  - READ_ONLY
```
public static final StorageError READ_ONLY
```
  - STALE_HANDLE
```
public static final StorageError STALE_HANDLE
```
    transient: stale or read-only handle, retry
  - TOO_MANY_OPEN
```
public static final StorageError TOO_MANY_OPEN
```
    transient: fd exhaustion, retry
- Method Detail
  - classify
```
public static StorageError classify(IOException ioe)
```
    Classify a storage failure. Typed NIO exceptions map directly; otherwise the errno text is matched case-insensitively, using the JVM's canonical English messages for Unix and Windows.
    Parameters:
    ioe - the storage error
    Returns:
    the classified error, never null
  - describe
```
public static String describe(IOException ioe)
```
    Human-readable description of a storage failure, preserving the raw exception text for unclassified errors.
    Parameters:
    ioe - the storage error
    Returns:
    the description
  - isFatal
```
public boolean isFatal()
```
    Whether a torrent should stop on this failure rather than drop the request and retry.
  - toString
```
public String toString()
```
    Human-readable label for console and log messages.
    Overrides:
    toString in class Enum<StorageError>
  - valueOf
```
public static StorageError valueOf(String name)
```
    Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)
    Parameters:
    name - the name of the enum constant to be returned.
    Returns:
    the enum constant with the specified name
    Throws:
    IllegalArgumentException - if this enum type has no constant with the specified name
    NullPointerException - if the argument is null
  - values
```
public static StorageError[] values()
```
    Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:
```
for (StorageError c : StorageError.values())
    System.out.println(c);
```
    Returns:
    an array containing the constants of this enum type, in the order they are declared

Enum StorageError

Enum Constant Summary

Method Summary

Methods inherited from class java.lang.Enum

Methods inherited from class java.lang.Object

Enum Constant Detail

IO_ERROR

IS_DIRECTORY

MISSING

NAME_TOO_LONG

NO_SPACE

OTHER

PERMISSION

QUOTA

READ_ONLY

STALE_HANDLE

TOO_MANY_OPEN

Method Detail

classify

describe

isFatal

toString

valueOf

values