Module java.base
Package java.nio.file

Class InvalidPathException

  • 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