Java Glossary : throw

Last updated 2004-06-28 by Roedy Green ©1996-2004 Canadian Mind Products

Java definitions: 0-9 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

You are here : home : Java Glossary : T words : throw.

throw

To trigger an exception. What happens to handle the exception depends on enclosing try-catch blocks or failing that in the enclosing try-catch blocks in the calling method, or its caller etc.

public class Test extends StandardTest
{
public static void main (String [] args)
{
try
{
dangerMethod();
}
catch ( StrangeException e )
{
System.out.println("oops" + e.getMessage());
}
} // end main

void dangerMethod() throws StrangeException
{
if ( unexpected ) throw new StrangeException ("oh oh" );
} // end dangerMethod

} // end class Test

For unchecked Exceptions ( i.e. Errors and RuntimeExceptions such as IllegalArgumentException) the throws IllegalArgumentException is optional. I find them useful documentation since they show up in the JavaDoc.

Exception

home	Canadian Mind Products
	mindprod.com IP:[24.87.56.253]
	Your IP:[80.134.30.163]
	You are visitor number 1906.
	Please send errors, omissions and suggestions
	to improve this page to Roedy Green.
	You can get a fresh copy of this page from:	or possibly from your local J: drive mirror:
	http://mindprod.com/jgloss/throw.html	J:\mindprod\jgloss\throw.html