com.haulmont.cuba.desktop.exception

Class ExceptionHandlers

java.lang.Object

com.haulmont.cuba.desktop.exception.ExceptionHandlers

@Component(value="cuba_ExceptionHandlers")
public class ExceptionHandlers
extends java.lang.Object

Class that holds the collection of exception handlers and delegates unhandled exception processing to them. Handlers form the chain of responsibility.

A set of exception handlers is configured by defining ExceptionHandlersConfiguration beans in spring.xml. If a project needs specific handlers, it should define a bean of such type with its own id, e.g. refapp_ExceptionHandlersConfiguration

Constructor Summary

Constructors

Constructor and Description
ExceptionHandlers()

Method Summary

Modifier and Type	Method and Description
void	addHandler(ExceptionHandler handler) Adds new Web-level handler if it is not yet registered.
void	createByConfiguration() Create all handlers defined by ExceptionHandlersConfiguration beans in spring.xml and GUI handlers defined as Spring-beans.
void	createMinimalSet() Create a minimal set of handlers for disconnected client.
ExceptionHandler	getDefaultHandler()
void	handle(java.lang.Thread thread, java.lang.Throwable exception, com.haulmont.cuba.desktop.sys.DesktopWindowManager windowManager) Delegates exception handling to registered handlers.
void	removeAll() Remove all handlers.
void	setDefaultHandler(ExceptionHandler defaultHandler) Set the default handler instead of initialized in constructor.

Methods inherited from class java.lang.Object

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

Constructor Detail

ExceptionHandlers

public ExceptionHandlers()

Method Detail

getDefaultHandler

public ExceptionHandler getDefaultHandler()

Returns:

default exception handler which is used when none of registered handlers have handled an exception

setDefaultHandler

public void setDefaultHandler(ExceptionHandler defaultHandler)

Set the default handler instead of initialized in constructor.

Parameters:

defaultHandler - default handler instance

addHandler

public void addHandler(ExceptionHandler handler)

Adds new Web-level handler if it is not yet registered.

Parameters:

handler - handler instance

handle

public void handle(java.lang.Thread thread,
                   java.lang.Throwable exception,
                   com.haulmont.cuba.desktop.sys.DesktopWindowManager windowManager)

Delegates exception handling to registered handlers.

Parameters:

thread - current thread

exception - exception instance

windowManager -

createByConfiguration

public void createByConfiguration()

Create all handlers defined by ExceptionHandlersConfiguration beans in spring.xml and GUI handlers defined as Spring-beans.

createMinimalSet

public void createMinimalSet()

Create a minimal set of handlers for disconnected client.

removeAll

public void removeAll()

Remove all handlers.