gzz.client
Class ClientException

java.lang.Object
  |
  +--java.lang.Throwable
        |
        +--java.lang.Exception
              |
              +--gzz.client.ClientException

All Implemented Interfaces:

java.io.Serializable

public class ClientException

extends java.lang.Exception

An exception that is not due to a programming error, but an incapability to perform the user's request. If the computer can't do something, it needs to apologize to the user for not understanding what they want. (This is often called an "error message" which frightens non-power users, so let's keep our language polite and remember if the user violated a rule, that's only because computers are so stupid that they need all those rules...)

For example, the home cell cannot be deleted, as we always need to be able to send a cursor back there; so when the user attempts to delete the home cell, we show an apology saying, "Sorry, I can't delete the home cell."

Subclasses can be created to:

• Distinguish different types of ClientExceptions, to allow some to be handled automatically.
• Render apologies with non-textual elements (for example, images of cells).

See Also:

Serialized Form

Field Summary

protected java.lang.String

apology

Constructor Summary

ClientException(java.lang.String apology)
Create a new ClientException.

Method Summary

void	renderApology(gzz.vob.linebreaking.HChain ch, TextStyle style) Render an apology to the user into an HChain (usually the status bar).

Methods inherited from class java.lang.Throwable

fillInStackTrace, getCause, 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

Field Detail

apology

protected java.lang.String apology

Constructor Detail

ClientException

public ClientException(java.lang.String apology)

Create a new ClientException.

Method Detail

renderApology

public void renderApology(gzz.vob.linebreaking.HChain ch,
                          TextStyle style)

Render an apology to the user into an HChain (usually the status bar).

Parameters:

ch - The HChain to render the apology into.

style - The text style to render the apology in. (Scale is 1.)