com.facebook.buck.support.exceptions.handler

Class ExceptionHandlerRegistry<R>

java.lang.Object

com.facebook.buck.support.exceptions.handler.ExceptionHandlerRegistry<R>

public class ExceptionHandlerRegistry<R>
extends Object

Central registry to manage different kinds of exceptions thrown to Buck Main class level, which will unwrap the exceptions when necessary to make exceptions more friendly and readable to users

Constructor Summary

Constructors

Constructor and Description
ExceptionHandlerRegistry(com.google.common.collect.ImmutableList<ExceptionHandler<? extends Throwable,R>> handlers, ExceptionHandler<Throwable,R> genericHandler)

Method Summary

Modifier and Type	Method and Description
R	handleException(Throwable t)

Methods inherited from class java.lang.Object

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

Constructor Detail

ExceptionHandlerRegistry

public ExceptionHandlerRegistry(com.google.common.collect.ImmutableList<ExceptionHandler<? extends Throwable,R>> handlers,
                                ExceptionHandler<Throwable,R> genericHandler)

Method Detail

handleException

public R handleException(Throwable t)

Parameters:

t - the exception to handle

Returns:

the exit code Buck should return to user

This method tries to find a registered ExceptionHandler that can process the input Exception, and calls that handler to process the exception. If it cannot find one, it will try to unwrap the exception by calling getCause() to get underlying exceptions. If all the underlying causes are exhausted, or any loop is detected in the exception chain before an exception is handled, the top level Throwable will be processed by the genericHandler.