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 and 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 and Description
protected	ExceptionHandler(T value, Exception exception) Private class constructor.

Method Summary

Modifier and Type	Method and Description
T	get() Returns the contained object.
ExceptionHandler<T>	handleOMEROException(String message) Throws: AccessException if DSAccessException was caught ServiceException if DSOutOfServiceException was caught The appropriate exception if ServerError was caught (see handleOMEROException(java.lang.Throwable, java.lang.String))
static void	handleOMEROException(Throwable throwable, String message) Checks the cause of an exception on OMERO and throws: ServiceException if the cause was: SessionException AuthenticationException ResourceError AccessException if the cause was: SecurityViolation Anything else See Facility.handleException(java.lang.Object, java.lang.Throwable, java.lang.String)
ExceptionHandler<T>	handleServerAndService(String message) Checks if a ServerError or a DSOutOfService was thrown and handles the exception according to the cause.
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

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.

handleOMEROException

public static void handleOMEROException(Throwable throwable,
                                        String message)
                                 throws ServiceException,
                                        AccessException

Checks the cause of an exception on OMERO and throws:

• ServiceException if the cause was:
  • SessionException
  • AuthenticationException
  • ResourceError
• AccessException if the cause was:
  • SecurityViolation
  • Anything else

See Facility.handleException(java.lang.Object, java.lang.Throwable, java.lang.String)

Parameters:

throwable - The exception.

message - Error message.

Throws:

ServiceException - Cannot connect to OMERO.

AccessException - Cannot access data.

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

handleServerAndService

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

Checks if a ServerError or a DSOutOfService was thrown and handles the exception according to the cause.

See handleOMEROException(Throwable, String).

Parameters:

message - Error message.

Returns:

The same ExceptionHandler.

Throws:

ServiceException - Cannot connect to OMERO.

AccessException - Cannot access data.

handleOMEROException

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

Throws:

• AccessException if DSAccessException was caught
• ServiceException if DSOutOfServiceException was caught
• The appropriate exception if ServerError was caught (see handleOMEROException(java.lang.Throwable, java.lang.String))

Parameters:

message - Error message.

Returns:

The same ExceptionHandler.

Throws:

AccessException - Cannot access data.

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