org.millstone.base.terminal
Class UserError

java.lang.Object
  |
  +--org.millstone.base.terminal.UserError

All Implemented Interfaces:

ErrorMessage, java.util.EventListener, Paintable

public class UserError

extends java.lang.Object

implements ErrorMessage

User error is a controlled error occurred in application. User errors are occur in normal usage of the application and guide the user.

Since:

3.0

Version:

3.0.3

Author:

IT Mill Ltd.

Nested Class Summary

Nested classes inherited from class org.millstone.base.terminal.Paintable

Paintable.RepaintRequestEvent, Paintable.RepaintRequestListener

Field Summary

static int	CONTENT_PREFORMATTED Content mode, where the error contains preformatted text.
static int	CONTENT_TEXT Content mode, where the error contains only plain text.
static int	CONTENT_UIDL Formatted content mode, where the contents is XML restricted to the UIDL 1.0 formatting markups.

Fields inherited from interface org.millstone.base.terminal.ErrorMessage

CRITICAL, ERROR, INFORMATION, SYSTEMERROR, WARNING

Constructor Summary

UserError(java.lang.String textErrorMessage)
Create a textual error message of level ERROR.

UserError(java.lang.String message, int contentMode, int errorLevel)
Create error message with level and content mode.

Method Summary

void	addListener(Paintable.RepaintRequestListener listener) Error messages are inmodifiable and thus listeners are not needed.
int	getErrorLevel() Gets the errors level.
void	paint(PaintTarget target) Paints the paintable into a UIDL stream.
void	removeListener(Paintable.RepaintRequestListener listener) Error messages are inmodifiable and thus listeners are not needed.
void	requestRepaint() Error messages are inmodifiable and thus listeners are not needed.
void	requestRepaintRequests() Request sending of repaint events on any further visible changes.
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

CONTENT_TEXT

public static final int CONTENT_TEXT

Content mode, where the error contains only plain text.

See Also:

Constant Field Values

CONTENT_PREFORMATTED

public static final int CONTENT_PREFORMATTED

Content mode, where the error contains preformatted text.

See Also:

Constant Field Values

CONTENT_UIDL

public static final int CONTENT_UIDL

Formatted content mode, where the contents is XML restricted to the UIDL 1.0 formatting markups.

See Also:

Constant Field Values

Constructor Detail

UserError

public UserError(java.lang.String textErrorMessage)

Create a textual error message of level ERROR.

Parameters:

textErrorMessage - The text of the error message.

UserError

public UserError(java.lang.String message,
                 int contentMode,
                 int errorLevel)

Create error message with level and content mode.

Method Detail

getErrorLevel

public int getErrorLevel()

Description copied from interface: ErrorMessage

Gets the errors level.

Specified by:

getErrorLevel in interface ErrorMessage

Returns:

the level of error as an integer.

addListener

public void addListener(Paintable.RepaintRequestListener listener)

Description copied from interface: ErrorMessage

Error messages are inmodifiable and thus listeners are not needed. This method should be implemented as empty.

Specified by:

addListener in interface ErrorMessage

See Also:

Paintable.addListener(Paintable.RepaintRequestListener)

removeListener

public void removeListener(Paintable.RepaintRequestListener listener)

Description copied from interface: ErrorMessage

Error messages are inmodifiable and thus listeners are not needed. This method should be implemented as empty.

Specified by:

removeListener in interface ErrorMessage

See Also:

Paintable.removeListener(Paintable.RepaintRequestListener)

requestRepaint

public void requestRepaint()

Description copied from interface: ErrorMessage

Error messages are inmodifiable and thus listeners are not needed. This method should be implemented as empty.

Specified by:

requestRepaint in interface ErrorMessage

See Also:

Paintable.requestRepaint()

paint

public void paint(PaintTarget target)
           throws PaintException

Description copied from interface: Paintable

Paints the paintable into a UIDL stream. This method creates the UIDL sequence describing it and outputs it to the given UIDL stream.

It's is called when the contents of the component should be painted in response to the component first being shown or having been altered so that its visual representation is changed.

Specified by:

paint in interface Paintable

Parameters:

target - target UIDL stream where the component should paint itself to

Throws:

PaintException - if the paint operation failed

requestRepaintRequests

public void requestRepaintRequests()

Description copied from interface: Paintable

Request sending of repaint events on any further visible changes. Normally the paintable only send up to one repaint request for listeners after paint as the paintable as the paintable assumes that the listeners already know about the repaint need. This method resets the assumtion. Paint implicitly does the assumtion reset functionality implemented by this method. This method is normally used only by the terminals to note paintables about implicit repaints (painting the component without actually invoking paint method).

Specified by:

requestRepaintRequests in interface Paintable

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object