org.gvsig.tools.exception

Class BaseException

java.lang.Object

java.lang.Throwable

java.lang.Exception

org.gvsig.tools.exception.BaseException

All Implemented Interfaces:

java.io.Serializable, IBaseException

Direct Known Subclasses:

AbortActionException, AnnotationException, BandAccessException, BandException, BufferCreationException, BufferException, BufferOperationException, CallableException, CancelEditingLayerException, ColorTableException, ColorTableIOException, CreateEnvelopeException, CreateJFeatureFormException, CreateWizardException, DataException, DefaultPackageManager.BaseIOException, DerivedGeometriesException, DiscoveryServiceException, DownloadingException, DownloadingException, DynObjectException, DyschromatopsiaException, EmptyPanelGroupException, EmptyPanelGroupGUIException, EvaluatorException, ExportException, FeatureNotSupportedWarning, FileNotFoundInListException, FileNotOpenException, FileNotSupportedException, FilePaletteException, FLyrVect.EnvelopeCantBeInitializedException, FmapContentHandlerCreationException, GeometryException, GeometryOperationException, GeometryOperationNotSupportedException, GettingEnvelopeException, GettingMapInfoException, GmlException, GmlFileReadException, GmlInvalidFormatException, GmlNoGeometryException, GmlParserException, GmlWarningMalformed, GmlWarningNoSchema, GmlWarningNotFound, GmlWarningVersionNotSupported, GmlWarningWrongNamespace, GPELayerException, GPEXmlEmptyFileException, GPEXmlToZipFileException, ImplementationNotValidException, InstallPackageServiceException, InstallPackageWizardException, InvalidROIsShpException, InvalidSetViewException, InvalidSourceException, KmlBodyParseException, KmlException, KmlHeaderParseException, KmlImpossibleCreateParser, KmlNotRootTagException, LayerNotFoundInCollectionException, ListBaseException, MakePackageServiceException, MakePluginPackageWizardException, MapContextException, MapControlException, NewLayerException, NotContinueWizardException, NotExtentException, NotMultipleLayerWarning, NotNamespaceParserWarning, NotRegisteredTransformException, NotSupportedElementWarning, NotSupportedExtensionException, NotSupportedFeatureWarning, NotSupportedLayerWarning, NotSupportedOperationException, NotValidSourceException, OperationException, OperationNotSupportedException, PanelBaseException, PanelWithNoPreferredSizeDefinedException, ParserCreationException, ParseURIException, PolygonAutomaticallyClosedWarning, PolygonNotClosedWarning, PortableViewException, ProcessInterruptedException, ProcessInterruptedException, QueryException, RasterException, RasterToolException, RasterToolException, RedoException, ROIMaskMessageException, ServiceException, SLDException, SrsUnknownWarning, StartEditionLayerException, StopEditionLayerException, TableEditingException, TileReadingException, TimeSupportException, TimeSupportSwingException, UndoException, UnsavedDataException, URLFormatException, URLFormatException, VectorEditingException, VersionNotFoundWarning, VisitCanceledException, VisitorException, WarpException, WebMapException, WKBEncodingException, WriterHandlerCreationException, XMLException

public abstract class BaseException
extends java.lang.Exception
implements IBaseException

Esta clase esta pensada para actuar como clase base para las excepciones que se lanzan dentro del proyecto de gvSIG. Aņade la implementacion necesaria para disponer de mensajes de error internacionalizables, a traves del metodo getLocalizedMessage, asi como una serie de metodos que nos permiten obtener los mesanes de error de la cadena de excepciones enlazadas a traves de su "causa", asi como utilidades que permitan recorrer de forma comoda esta cadena de excepciones por medio de un Iterador.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected long	code Unique code of error.
protected java.lang.String	formatString TODO: remove the variable, use the Exception get/setMessage() instead.
protected java.lang.String	messageKey

Constructor Summary

Constructors

Constructor and Description
BaseException() Deprecated.
BaseException(java.lang.String message, java.lang.String key, long code) Constructs a BaseException with a default message format, a key to find a localized message format, and a unique code to identify the exception.
BaseException(java.lang.String message, java.lang.Throwable cause, java.lang.String key, long code) Constructs a BaseException with a default message format, a key to find a localized message format, and a unique code to identify the exception.

Method Summary

Modifier and Type	Method and Description
static boolean	containsCause(java.lang.Throwable ex, java.lang.Class<? extends java.lang.Throwable> searchException)
long	getCode()
java.lang.String	getFormatString()
static java.lang.String	getHTMLMessageStack(java.lang.Throwable th)
java.lang.String	getLocalizedMessage() Returns the translated message that describes the exception.
java.lang.String	getLocalizedMessage(ExceptionTranslator translator, int indent) Returns the translated message that describes the exception with indentation.
java.lang.String	getLocalizedMessageStack() Crosses the exceptions chained through cause to conform the compound message in the corresponding language.
java.lang.String	getLocalizedMessageStack(ExceptionTranslator translator, int indent) Crosses the exceptions chained through cause to conform the compound message in the corresponding language.
java.lang.String	getMessage() Returns the message that describes the exception.
java.lang.String	getMessage(int indent) Returns the message that describes the exception, with indentation.
java.lang.String	getMessageKey()
java.lang.String	getMessageStack() Crosses the exceptions chained through cause to conform the message.
java.lang.String	getMessageStack(int indent) Crosses the exceptions chained through cause to conform the compound message with indentation.
static java.lang.String	getMessageStack(java.lang.Throwable th, int indent)
java.lang.Object	getValue(java.lang.String name)
java.util.Iterator	iterator()
void	setCode(long code) Sets the exception's code.
void	setFormatString(java.lang.String formatString) Sets the format string.
void	setMessageKey(java.lang.String messageKey) Sets the property messageKey.
static void	setTranslator(ExceptionTranslator translator) Sets the property translator.
static void	setTranslator(java.lang.Object translator)
protected void	setValue(java.lang.String name, java.lang.Object value)
protected java.util.Map	values()

Methods inherited from class java.lang.Throwable

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

Field Detail

messageKey

protected java.lang.String messageKey

formatString

protected java.lang.String formatString

TODO: remove the variable, use the Exception get/setMessage() instead.

code

protected long code

Unique code of error.

Constructor Detail

BaseException

public BaseException()

Deprecated.

Empty constructor, don't use it anymore.

BaseException

public BaseException(java.lang.String message,
                     java.lang.String key,
                     long code)

Constructs a BaseException with a default message format, a key to find a localized message format, and a unique code to identify the exception.

Parameters:

message - the default messageFormat to describe the exception

key - the key to use to search a localized messageFormnata

code - the unique code to identify the exception

BaseException

public BaseException(java.lang.String message,
                     java.lang.Throwable cause,
                     java.lang.String key,
                     long code)

Constructs a BaseException with a default message format, a key to find a localized message format, and a unique code to identify the exception.

Parameters:

message - the default messageFormat to describe the exception

cause - the original cause of the exception

key - the key to use to search a localized messageFormnata

code - the unique code to identify the exception

Method Detail

getMessage

public java.lang.String getMessage()

Description copied from interface: IBaseException

Returns the message that describes the exception.

Specified by:

getMessage in interface IBaseException

Overrides:

getMessage in class java.lang.Throwable

Returns:

The message.

getMessage

public java.lang.String getMessage(int indent)

Description copied from interface: IBaseException

Returns the message that describes the exception, with indentation.

Specified by:

getMessage in interface IBaseException

Parameters:

indent - Quantity of blanks to insert at the start of the message.

Returns:

The message with indentation.

getLocalizedMessage

public java.lang.String getLocalizedMessage()

Description copied from interface: IBaseException

Returns the translated message that describes the exception.

Specified by:

getLocalizedMessage in interface IBaseException

Overrides:

getLocalizedMessage in class java.lang.Throwable

Returns:

The translated message with indentation.

getLocalizedMessage

public java.lang.String getLocalizedMessage(ExceptionTranslator translator,
                                            int indent)

Description copied from interface: IBaseException

Returns the translated message that describes the exception with indentation.

Specified by:

getLocalizedMessage in interface IBaseException

Parameters:

translator - Instance of a class that fulfills the IExceptionTranslator interface. His method "getText" takes charge returning the expression, correspondent to the key that delivers him, translated into the configured language.

indent - Quantity of blanks to insert at the start of the message.

Returns:

The translated message with indentation.

getMessageStack

public java.lang.String getMessageStack()

Description copied from interface: IBaseException

Crosses the exceptions chained through cause to conform the message.

Specified by:

getMessageStack in interface IBaseException

Returns:

The compound message with all the messages of the stack of exceptions.

getMessageStack

public java.lang.String getMessageStack(int indent)

Description copied from interface: IBaseException

Crosses the exceptions chained through cause to conform the compound message with indentation.

Specified by:

getMessageStack in interface IBaseException

Parameters:

indent - Quantity of blanks to insert at the start of the messages.

Returns:

The compound message with all the messages of the stack of exceptions.

getHTMLMessageStack

public static java.lang.String getHTMLMessageStack(java.lang.Throwable th)

getMessageStack

public static java.lang.String getMessageStack(java.lang.Throwable th,
                                               int indent)

getLocalizedMessageStack

public java.lang.String getLocalizedMessageStack()

Description copied from interface: IBaseException

Crosses the exceptions chained through cause to conform the compound message in the corresponding language.

Specified by:

getLocalizedMessageStack in interface IBaseException

Returns:

The translated compound message.

getLocalizedMessageStack

public java.lang.String getLocalizedMessageStack(ExceptionTranslator translator,
                                                 int indent)

Description copied from interface: IBaseException

Crosses the exceptions chained through cause to conform the compound message in the corresponding language.

Specified by:

getLocalizedMessageStack in interface IBaseException

Parameters:

translator - Instance of a class that fulfills the IExceptionTranslator interface. His method "getText" takes charge returning the expression, correspondent to the key that delivers him, translated into the configured language.

indent - Quantity of blanks to insert at the start of the messages.

Returns:

The translated message with indentation.

getCode

public long getCode()

Specified by:

getCode in interface IBaseException

Returns:

The exception's code.

setCode

public void setCode(long code)

Sets the exception's code.

Parameters:

code -

getFormatString

public java.lang.String getFormatString()

Specified by:

getFormatString in interface IBaseException

Returns:

The format string.

setFormatString

public void setFormatString(java.lang.String formatString)

Sets the format string.

Parameters:

formatString -

getMessageKey

public java.lang.String getMessageKey()

Specified by:

getMessageKey in interface IBaseException

Returns:

The message key associated to the exception.

setMessageKey

public void setMessageKey(java.lang.String messageKey)

Sets the property messageKey.

Parameters:

messageKey -

iterator

public java.util.Iterator iterator()

Specified by:

iterator in interface IBaseException

Returns:

A iterator for the chained exceptions.

values

protected java.util.Map values()

Returns:

A map that serves to replace in the format string the keys with the corresponding values.

getValue

public java.lang.Object getValue(java.lang.String name)

Specified by:

getValue in interface IBaseException

setValue

protected void setValue(java.lang.String name,
                        java.lang.Object value)

setTranslator

public static void setTranslator(ExceptionTranslator translator)

Sets the property translator.

Parameters:

translator - It(He,She) is used to translate the messages associated with the exceptions.

setTranslator

public static void setTranslator(java.lang.Object translator)

containsCause

public static boolean containsCause(java.lang.Throwable ex,
                                    java.lang.Class<? extends java.lang.Throwable> searchException)