java.net

Class URISyntaxException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.net.URISyntaxException

public class URISyntaxException
extends Exception

This exception is thrown when a String cannot be parsed as a URI.

Since:

1.4

Author:

Eric Blake (ebb9@email.byu.edu)

See Also:

URI

Constructor Summary

Constructors

Constructor and Description
URISyntaxException(String input, String msg) Create an exception from the invalid string, with the index set to -1.
URISyntaxException(String input, String msg, int index) Create an exception from the invalid string, with the index of the point of failure.

Method Summary

Modifier and Type	Method and Description
int	getIndex() Returns the index of the failure, or -1.
String	getInput() Returns the bad input string.
String	getMessage() Returns a message describing the parse error, as if by getReason() + (getIndex() >= 0 ? " at index " + getIndex() : "") + ": " + getInput().
String	getReason() Returns the reason for the failure.

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, initCause, printStackTrace, printStackTrace, toString

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

URISyntaxException

public URISyntaxException(String input,
                          String msg)

Create an exception from the invalid string, with the index set to -1.

Parameters:

input - the bad URI

msg - the descriptive error message

Throws:

NullPointerException - if input or msg are null

URISyntaxException

public URISyntaxException(String input,
                          String msg,
                          int index)

Create an exception from the invalid string, with the index of the point of failure.

Parameters:

input - the bad URI

msg - the descriptive error message

index - the index of the parse error, or -1

Throws:

NullPointerException - if input or msg are null

IllegalArgumentException - if index < -1

Method Detail

getIndex

public int getIndex()

Returns the index of the failure, or -1.

Returns:

the index of failure

getInput

public String getInput()

Returns the bad input string.

Returns:

the bad URI, guaranteed non-null

getMessage

public String getMessage()

Returns a message describing the parse error, as if by getReason() + (getIndex() >= 0 ? " at index " + getIndex() : "") + ": " + getInput().

Overrides:

getMessage in class Throwable

Returns:

the message string

getReason

public String getReason()

Returns the reason for the failure.

Returns:

the message, guaranteed non-null