org.openide.util

Class UserQuestionException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.io.IOException

org.openide.util.UserQuestionException

All Implemented Interfaces:

Serializable

public abstract class UserQuestionException
extends IOException

Exception that is thrown when the process is about to perform some action that requires user confirmation. It can be useful when there is a call to a method which cannot open a dialog, but still would like to ask the user a question. It can raise this exception and higher level parts of the system can/should catch it and present a dialog to the user and if the user agrees reinvoke the action again.

The getLocalizedMessage method should return the user question, which will be shown to the user in a dialog with OK, Cancel options and if the user chooses OK, method ex.confirmed () will be called.

Since version 8.29 one can just catch the exception and report it to the infrastructure of any NetBeans Platform based application (for example via Exceptions.printStackTrace(java.lang.Throwable)) and the question dialog will be displayed automatically.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
UserQuestionException() Creates new exception UserQuestionException
UserQuestionException(String s) Creates new exception UserQuestionException with text specified string s.

Method Summary

Modifier and Type	Method and Description
abstract void	confirmed() Invoke the action if the user confirms the action.

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, 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

UserQuestionException

public UserQuestionException()

Creates new exception UserQuestionException

UserQuestionException

public UserQuestionException(String s)

Creates new exception UserQuestionException with text specified string s.

Parameters:

s - the text describing the exception

Method Detail

confirmed

public abstract void confirmed()
                        throws IOException

Invoke the action if the user confirms the action.

Throws:

IOException - if another I/O problem exists