FileDocCategorySizeDatePackage
URISyntaxException.javaAPI DocJava SE 6 API3152Tue Jun 10 00:25:42 BST 2008java.net

URISyntaxException

public class URISyntaxException extends Exception
Checked exception thrown to indicate that a string could not be parsed as a URI reference.
author
Mark Reinhold
version
1.7, 06/04/07
see
URI
since
1.4

Fields Summary
private String
input
private int
index
Constructors Summary
public URISyntaxException(String input, String reason, int index)
Constructs an instance from the given input string, reason, and error index.

param
input The input string
param
reason A string explaining why the input could not be parsed
param
index The index at which the parse error occurred, or -1 if the index is not known
throws
NullPointerException If either the input or reason strings are null
throws
IllegalArgumentException If the error index is less than -1

	super(reason);
	if ((input == null) || (reason == null))
	    throw new NullPointerException();
	if (index < -1)
	    throw new IllegalArgumentException();
	this.input = input;
	this.index = index;
    
public URISyntaxException(String input, String reason)
Constructs an instance from the given input string and reason. The resulting object will have an error index of -1.

param
input The input string
param
reason A string explaining why the input could not be parsed
throws
NullPointerException If either the input or reason strings are null

	this(input, reason, -1);
    
Methods Summary
public intgetIndex()
Returns an index into the input string of the position at which the parse error occurred, or -1 if this position is not known.

return
The error index

	return index;
    
public java.lang.StringgetInput()
Returns the input string.

return
The input string

	return input;
    
public java.lang.StringgetMessage()
Returns a string describing the parse 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.

return
A string describing the parse error

	StringBuffer sb = new StringBuffer();
	sb.append(getReason());
	if (index > -1) {
	    sb.append(" at index ");
	    sb.append(index);
	}
	sb.append(": ");
	sb.append(input);
	return sb.toString();
    
public java.lang.StringgetReason()
Returns a string explaining why the input string could not be parsed.

return
The reason string

	return super.getMessage();