Class TextInputCallback

java.lang.Object

javax.security.auth.callback.TextInputCallback

All Implemented Interfaces:

Serializable, Callback

Direct Known Subclasses:

RealmCallback

public class TextInputCallback
extends Object
implements Callback, Serializable

Underlying security services instantiate and pass a TextInputCallback to the handle method of a CallbackHandler to retrieve generic text information.

Since:

1.4

See Also:

• CallbackHandler
• Serialized Form

Constructor Summary

Constructors

Constructor	Description
TextInputCallback(String prompt)	Construct a TextInputCallback with a prompt.
TextInputCallback(String prompt, String defaultText)	Construct a TextInputCallback with a prompt and default input value.

Method Summary

Modifier and Type	Method	Description
String	getDefaultText()	Get the default text.
String	getPrompt()	Get the prompt.
String	getText()	Get the retrieved text.
void	setText(String text)	Set the retrieved text.

Methods declared in class Object

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

Modifier and Type	Method	Description
protected Object	clone()	Answers a new instance of the same class as the receiver, whose slots have been filled in with the values in the slots of the receiver.
boolean	equals(Object o)	Compares the argument to the receiver, and answers true if they represent the same object using a class specific comparison.
protected void	finalize()	Deprecated, for removal: This API element is subject to removal in a future version. May cause performance issues, deadlocks and hangs.
final Class<? extends Object>	getClass()	Answers the unique instance of java.lang.Class which represents the class of the receiver.
int	hashCode()	Answers an integer hash code for the receiver.
final void	notify()	Causes one thread which is waiting on the receiver to be made ready to run.
final void	notifyAll()	Causes all threads which are waiting on the receiver to be made ready to run.
String	toString()	Answers a string containing a concise, human-readable description of the receiver.
final void	wait()	Causes the thread which sent this message to be made not ready to run pending some change in the receiver (as indicated by notify or notifyAll).
final void	wait(long time)	Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by notify or notifyAll) or the expiration of the timeout.
final void	wait(long time, int frac)	Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by notify or notifyAll) or the expiration of the timeout.

Constructor Details

TextInputCallback

public TextInputCallback(String prompt)

Construct a TextInputCallback with a prompt.

Parameters:

prompt - the prompt used to request the information.

Throws:

IllegalArgumentException - if prompt is null or if prompt has a length of 0.

TextInputCallback

public TextInputCallback(String prompt,
 String defaultText)

Construct a TextInputCallback with a prompt and default input value.

Parameters:

prompt - the prompt used to request the information.

defaultText - the text to be used as the default text displayed with the prompt.

Throws:

IllegalArgumentException - if prompt is null, if prompt has a length of 0, if defaultText is null or if defaultText has a length of 0.

Method Details

getPrompt

public String getPrompt()

Get the prompt.

Returns:

the prompt.

getDefaultText

public String getDefaultText()

Get the default text.

Returns:

the default text, or null if this TextInputCallback was not instantiated with defaultText.

setText

public void setText(String text)

Set the retrieved text.

Parameters:

text - the retrieved text, which may be null.

See Also:

• getText()

getText

public String getText()

Get the retrieved text.

Returns:

the retrieved text, which may be null.

See Also:

• setText(String)