com.vaadin.server.ErrorEvent Maven / Gradle / Ivy
/*
* Copyright (C) 2000-2024 Vaadin Ltd
*
* This program is available under Vaadin Commercial License and Service Terms.
*
* See for the full
* license.
*/
package com.vaadin.server;
import java.io.Serializable;
import com.vaadin.shared.Connector;
import com.vaadin.ui.UI;
/**
* An error thrown by the framework and handled by an {@link ErrorHandler}.
* Typically handled by {@link VaadinSession#getErrorHandler()} but can also be
* handled by a {@link Connector} specific handler, set using
* {@link ClientConnector#setErrorHandler(ErrorHandler)}.
*
*/
public class ErrorEvent implements Serializable {
private Throwable throwable;
public ErrorEvent(Throwable t) {
setThrowable(t);
}
/**
* Gets the contained throwable, the cause of the error.
*
* @return
*/
public Throwable getThrowable() {
return throwable;
}
public void setThrowable(Throwable throwable) {
this.throwable = throwable;
}
/**
* Method for finding the error handler for the given connector. Uses
* connector hierarchy to find a connector with an error handler. Falls back
* to the VaadinSession error handler if no connector has specified an error
* handler.
*
* Returns a {@link DefaultErrorHandler} if no error handler was found
*
*
* @param connector
* The target connector
* @return An ErrorHandler for the connector
*/
public static ErrorHandler findErrorHandler(ClientConnector connector) {
if (connector != null) {
ErrorHandler errorHandler = connector.getErrorHandler();
if (errorHandler != null) {
return errorHandler;
}
ClientConnector parent = connector.getParent();
if (parent != null) {
return findErrorHandler(parent);
}
/*
* Reached UI and found no error handler. Try session which
* typically has one.
*/
UI ui = connector.getUI();
if (ui != null) {
errorHandler = findErrorHandler(ui.getSession());
if (errorHandler != null) {
return errorHandler;
}
}
}
/*
* No connector known or the connector is not attached to a session. Try
* the current session
*/
if (VaadinSession.getCurrent() != null) {
ErrorHandler errorHandler = VaadinSession.getCurrent()
.getErrorHandler();
if (errorHandler != null) {
return errorHandler;
}
}
/*
* We should never really get here as at least the session should have
* an error handler. If for some reason it does not we use the default
* error handler.
*/
return new DefaultErrorHandler();
}
/**
* Method for finding the error handler for the given session.
*
* @param session
* The target session
*
* @return An ErrorHandler for the session or null if none was found
*/
public static ErrorHandler findErrorHandler(VaadinSession session) {
if (session == null) {
return null;
}
return session.getErrorHandler();
}
}