• All Implemented Interfaces:
    Serializable

    public class InvalidPathException
    extends IllegalArgumentException

    Unchecked exception thrown when path string cannot be converted into a Path because the path string contains invalid characters, or the path string is invalid for other file system specific reasons.

    Since:
    1.7
    See Also:
    Serialized Form
    • Constructor Detail

      • InvalidPathException

        public InvalidPathException​(String input,
                                    String reason,
                                    int index)

        Constructs an instance from the given input string, reason, and error index.

        Parameters:
        input - the input string
        reason - a string explaining why the input was rejected
        index - the index at which the error occurred, or -1 if the index is not known
        Throws:
        NullPointerException - if either the input or reason strings are null
        IllegalArgumentException - if the error index is less than -1
      • InvalidPathException

        public InvalidPathException​(String input,
                                    String reason)

        Constructs an instance from the given input string and reason. The resulting object will have an error index of -1.

        Parameters:
        input - the input string
        reason - a string explaining why the input was rejected
        Throws:
        NullPointerException - if either the input or reason strings are null
    • Method Detail

      • getInput

        public String getInput()

        Returns the input string.

        Returns:
        the input string
      • getReason

        public String getReason()

        Returns a string explaining why the input string was rejected.

        Returns:
        the reason string
      • getIndex

        public int getIndex()

        Returns an index into the input string of the position at which the error occurred, or -1 if this position is not known.

        Returns:
        the error index
      • getMessage

        public String getMessage()

        Returns a string describing the error. The resulting string consists of the reason string followed by a colon character (':'), a space, and the input string. If the error index is defined then the string " at index " followed by the index, in decimal, is inserted after the reason string and before the colon character.

        Overrides:
        getMessage in class Throwable
        Returns:
        a string describing the error