org.millstone.base.data
Class Buffered.SourceException

java.lang.Object
  |
  +--java.lang.Throwable
        |
        +--java.lang.Exception
              |
              +--java.lang.RuntimeException
                    |
                    +--org.millstone.base.data.Buffered.SourceException

All Implemented Interfaces:

ErrorMessage, java.util.EventListener, Paintable, java.io.Serializable

Enclosing class:

Buffered

public static class Buffered.SourceException

extends java.lang.RuntimeException

implements ErrorMessage

An exception that signals that one or more exceptions occurred while a buffered object tried to access its data source.

Since:

3.0

Version:

3.0.3

Author:

IT Mill Ltd.

See Also:

Serialized Form

Nested Class Summary

class

Buffered.SourceException.MoreThanOneCauseException An exception signaling that there are more than one causes for a SourceException.

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

Paintable.RepaintRequestEvent, Paintable.RepaintRequestListener

Field Summary

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

CRITICAL, ERROR, INFORMATION, SYSTEMERROR, WARNING

Constructor Summary

Buffered.SourceException(Buffered source)
Creates a source exception that does not include a cause.

Buffered.SourceException(Buffered source, java.lang.Throwable cause)
Creates a source exception from a cause exception.

Buffered.SourceException(Buffered source, java.lang.Throwable[] causes)
Creates a source exception from multiplse causes.

Method Summary

void	addListener(Paintable.RepaintRequestListener listener) Error messages are inmodifiable and thus listeners are not needed.
java.lang.Throwable	getCause() Get the cause of the exception.
java.lang.Throwable[]	getCauses() Get all the causes for this exception.
int	getErrorLevel() Get the error level of this buffered source exception.
Buffered	getSource() Get the source of the exception.
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.

Methods inherited from class java.lang.Throwable

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

Buffered.SourceException

public Buffered.SourceException(Buffered source)

Creates a source exception that does not include a cause.

Parameters:

source - the source object implementing the Buffered interface.

Buffered.SourceException

public Buffered.SourceException(Buffered source,
                                java.lang.Throwable cause)

Creates a source exception from a cause exception.

Parameters:

source - the source object implementing the Buffered interface.

cause - the original cause for this exception.

Buffered.SourceException

public Buffered.SourceException(Buffered source,
                                java.lang.Throwable[] causes)

Creates a source exception from multiplse causes.

Parameters:

source - the source object implementing the Buffered interface.

causes - the original causes for this exception.

Method Detail

getCause

public final java.lang.Throwable getCause()
                                   throws Buffered.SourceException.MoreThanOneCauseException

Get the cause of the exception.

Overrides:

getCause in class java.lang.Throwable

Returns:

The cause for the exception.

Throws:

Buffered.SourceException.MoreThanOneCauseException - if there is more than one cause for the exception. This is possible if the commit operation triggers more than one error at the same time.

getCauses

public final java.lang.Throwable[] getCauses()

Get all the causes for this exception.

Returns:

throwables that caused this exception

getSource

public Buffered getSource()

Get the source of the exception.

Returns:

the Buffered object which generated this exception.

getErrorLevel

public int getErrorLevel()

Get the error level of this buffered source exception. The level of the exception is maximum error level of all the contained causes. The causes that do not specify error level default to ERROR level. Also source exception without any causes are of level ERROR.

Specified by:

getErrorLevel in interface ErrorMessage

Returns:

the level of error as an integer.

See Also:

ErrorMessage.getErrorLevel()

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

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()

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