org.neo4j.ogm.driver

Interface ExceptionTranslator

Functional Interface:

This is a functional interface and can therefore be used as the assignment target for a lambda expression or method reference.

@FunctionalInterface
public interface ExceptionTranslator

This is a helper class modelled roughly after org.springframework.dao.support.PersistenceExceptionTranslator.
There are several situations where exceptions that happen inside a specific driver bubbles up into the core and cannot be caught inside the driver. This is especially true for the bolt driver: The org.neo4j.ogm.drivers.bolt.response.BoltResponse keeps an open result set which might throw a org.neo4j.driver.v1.exceptions.ServiceUnavailableException at a very late stage.
This should be handled gracefully inside the org.neo4j.ogm.session.Neo4jSession. It uses this translator to translate driver specific exceptions into exception declared in the Neo4j-OGM api.
The translator doesn't come as an interface, but as concrete implementation so that it can be used "as is" by our drivers.

Since:

3.2

Author:

Michael J. Simons

Method Summary

Modifier and Type	Method and Description
RuntimeException	translateExceptionIfPossible(Throwable e) Deprecated.

Method Detail

translateExceptionIfPossible

@Deprecated
RuntimeException translateExceptionIfPossible(Throwable e)

Deprecated.

Translates exceptions thrown by any of the drivers into exceptions defined in the Neo4j-OGM api.
Currently it deals with generic exceptions and throwables. This is due to the fact that

1. Neo4jSession is build that way
2. We don't have yet a clear defined exception hierarchy

The later is bound to change in 4.0. Until than, that we introduce this method as deprecated, so that it's short lifetime is clear.

Parameters:

e - Exception to translate

Returns:

The translated exception or e if a translation is not possible.