java.net

Class URISyntaxException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.net.URISyntaxException

All Implemented Interfaces:

java.io.Serializable

public class URISyntaxException
extends java.lang.Exception

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

Since:

1.4

See Also:

URI, Serialized Form

Constructor Summary

Constructors

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

Method Summary

Methods

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

Methods inherited from class java.lang.Throwable

fillInStackTrace, getCause, getLocalizedMessage, getStackTrace, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

URISyntaxException

public URISyntaxException(java.lang.String input,
                  java.lang.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:

java.lang.NullPointerException - if input or msg are null

URISyntaxException

public URISyntaxException(java.lang.String input,
                  java.lang.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:

java.lang.NullPointerException - if input or msg are null

java.lang.IllegalArgumentException - if index < -1

Method Detail

getInput

public java.lang.String getInput()

Returns the bad input string.

Returns:

the bad URI, guaranteed non-null

getReason

public java.lang.String getReason()

Returns the reason for the failure.

Returns:

the message, guaranteed non-null

getIndex

public int getIndex()

Returns the index of the failure, or -1.

Returns:

the index of failure

getMessage

public java.lang.String getMessage()

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

Overrides:

getMessage in class java.lang.Throwable

Returns:

the message string