Package fr.igred.omero.exception

Class ExceptionHandler<T>

java.lang.Object

fr.igred.omero.exception.ExceptionHandler<T>

public class ExceptionHandler<T>
extends Object

Class to handle and convert OMERO exceptions.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	ExceptionHandler.ExceptionWrapper<T,E extends Throwable>
static interface	ExceptionHandler.ThrowingConsumer<T,E extends Throwable>
static interface	ExceptionHandler.ThrowingFunction<T,R,E extends Throwable>

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	ExceptionHandler(T value, Exception exception)	Private class constructor.

Method Summary

Modifier and Type	Method	Description
T	get()	Returns the contained object.
ExceptionHandler<T>	handleException(String message)	Throws: AccessException if DSAccessException was caught ServiceException if DSOutOfServiceException was caught OMEROServerError if ServerError was caught
static void	handleException(Throwable t, String message)	Deprecated. Helper method to convert an exception from: DSAccessException to AccessException DSOutOfServiceException to ServiceException ServerError to OMEROServerError
ExceptionHandler<T>	handleServiceOrAccess(String message)	Throws: ServiceException if DSOutOfServiceException was caught AccessException if DSAccessException was caught
static void	handleServiceOrAccess(Throwable t, String message)	Deprecated. Helper method to convert an exception from: DSOutOfServiceException to ServiceException DSAccessException to AccessException
ExceptionHandler<T>	handleServiceOrServer(String message)	Throws: ServiceException if DSOutOfServiceException was caught OMEROServerError if ServerError was caught
static void	handleServiceOrServer(Throwable t, String message)	Deprecated. Helper method to convert an exception from: DSOutOfServiceException to ServiceException ServerError to OMEROServerError
static <I,R> ExceptionHandler<R>	of(I input, ExceptionHandler.ThrowingFunction<? super I,? extends R,? extends Exception> mapper)	Creates an ExceptionHandler from an object and a function.
static <I> ExceptionHandler<I>	ofConsumer(I input, ExceptionHandler.ThrowingConsumer<? super I,? extends Exception> consumer)	Creates an ExceptionHandler from an object and a function with no return value.
void	rethrow()	Rethrows exception if one was caught (to not swallow it).
<E extends Throwable> ExceptionHandler<T>	rethrow(Class<E> type)	Throws an exception from the specified type, if one was caught.
<E extends Throwable,F extends Throwable> ExceptionHandler<T>	rethrow(Class<E> type, ExceptionHandler.ExceptionWrapper<? super E,? extends F> mapper, String message)	Throws an exception converted from the specified type, if one was caught.
String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

ExceptionHandler

protected ExceptionHandler(T value,
                           Exception exception)

Private class constructor.

Parameters:

value - Object to process.

exception - Caught exception.

Method Detail

handleServiceOrServer

@Deprecated
public static void handleServiceOrServer(Throwable t,
                                         String message)
                                  throws ServiceException,
                                         OMEROServerError

Deprecated.

Helper method to convert an exception from:

• DSOutOfServiceException to ServiceException
• ServerError to OMEROServerError

Parameters:

t - The Exception

message - Short explanation of the problem.

Throws:

ServiceException - Cannot connect to OMERO.

OMEROServerError - Server error.

handleServiceOrAccess

@Deprecated
public static void handleServiceOrAccess(Throwable t,
                                         String message)
                                  throws ServiceException,
                                         AccessException

Deprecated.

Helper method to convert an exception from:

• DSOutOfServiceException to ServiceException
• DSAccessException to AccessException

Parameters:

t - The Exception

message - Short explanation of the problem.

Throws:

ServiceException - Cannot connect to OMERO.

AccessException - Cannot access data.

handleException

@Deprecated
public static void handleException(Throwable t,
                                   String message)
                            throws ServiceException,
                                   AccessException,
                                   OMEROServerError

Deprecated.

Helper method to convert an exception from:

• DSAccessException to AccessException
• DSOutOfServiceException to ServiceException
• ServerError to OMEROServerError

Parameters:

t - The Exception

message - Short explanation of the problem.

Throws:

AccessException - Cannot access data.

OMEROServerError - Server error.

ServiceException - Cannot connect to OMERO.

of

public static <I,R> ExceptionHandler<R> of(I input,
                                                 ExceptionHandler.ThrowingFunction<? super I,? extends R,? extends Exception> mapper)

Creates an ExceptionHandler from an object and a function.

Type Parameters:

I - Input argument type.

R - Returned object type.

Parameters:

input - Object to process.

mapper - Lambda to apply on object.

Returns:

ExceptionHandler wrapping the returned object.

ofConsumer

public static <I> ExceptionHandler<I> ofConsumer(I input,
                                                 ExceptionHandler.ThrowingConsumer<? super I,? extends Exception> consumer)

Creates an ExceptionHandler from an object and a function with no return value.

Type Parameters:

I - Input argument type.

Parameters:

input - Object to process.

consumer - Lambda to apply on object.

Returns:

ExceptionHandler wrapping the object to process.

rethrow

public <E extends Throwable> ExceptionHandler<T> rethrow(Class<E> type)
                                                  throws E extends Throwable

Throws an exception from the specified type, if one was caught.

Type Parameters:

E - The type of the exception.

Parameters:

type - The exception class.

Returns:

The same ExceptionHandler.

Throws:

E - An exception from the specified type.

E extends Throwable

rethrow

public <E extends Throwable,F extends Throwable> ExceptionHandler<T> rethrow(Class<E> type,
                                                                                   ExceptionHandler.ExceptionWrapper<? super E,? extends F> mapper,
                                                                                   String message)
                                                                            throws F extends Throwable

Throws an exception converted from the specified type, if one was caught.

Type Parameters:

E - The type of the exception.

F - The type of the exception thrown.

Parameters:

type - The exception class.

mapper - Lambda to convert the caught exception.

message - Error message.

Returns:

The same ExceptionHandler.

Throws:

F - A converted Exception.

F extends Throwable

handleServiceOrServer

public ExceptionHandler<T> handleServiceOrServer(String message)
                                          throws ServiceException,
                                                 OMEROServerError

Throws:

• ServiceException if DSOutOfServiceException was caught
• OMEROServerError if ServerError was caught

Parameters:

message - Error message.

Returns:

The same ExceptionHandler.

Throws:

ServiceException - Cannot connect to OMERO.

OMEROServerError - Server error.

handleServiceOrAccess

public ExceptionHandler<T> handleServiceOrAccess(String message)
                                          throws ServiceException,
                                                 AccessException

Throws:

• ServiceException if DSOutOfServiceException was caught
• AccessException if DSAccessException was caught

Parameters:

message - Error message.

Returns:

The same ExceptionHandler.

Throws:

ServiceException - Cannot connect to OMERO.

AccessException - Cannot access data.

handleException

public ExceptionHandler<T> handleException(String message)
                                    throws ServiceException,
                                           AccessException,
                                           OMEROServerError

Throws:

• AccessException if DSAccessException was caught
• ServiceException if DSOutOfServiceException was caught
• OMEROServerError if ServerError was caught

Parameters:

message - Error message.

Returns:

The same ExceptionHandler.

Throws:

AccessException - Cannot access data.

OMEROServerError - Server error.

ServiceException - Cannot connect to OMERO.

rethrow

public void rethrow()

Rethrows exception if one was caught (to not swallow it).

get

public T get()

Returns the contained object.

Returns:

See above.

toString

public String toString()

Overrides:

toString in class Object