Package com.isode.dsapi

Class NativeLibraryException

java.lang.Object
java.lang.Throwable
java.lang.Exception
java.lang.RuntimeException
com.isode.dsapi.NativeLibraryException
All Implemented Interfaces:
Serializable
public class NativeLibraryException extends RuntimeException
This exception will be thrown when an unrecoverable error has been detected inside the native DSAPI library. Most of the public Java DSAPI methods are able to throw this exception, which indicates that the library has detected an unrecoverable situation such as memory exhaustion or corrupted data structures.

This exception should be treated as a fatal condition, if not for the whole program then at least so far as Java DSAPI is concerned: once this exception has been thrown, the caller should not rely on being able to make any further use of the Java DSAPI classes.

NativeLibraryException is a subclass of RuntimeException, and so no explicit catch clause is required for it, and typically it will result in the program terminating.

NativeLibraryExceptions contain a message which should provide information about the failure: in cases where it is not clear what has caused the problem (such as memory exhaustion, or incorrectly installed software), you should submit a problem report to Isode.

See Also:

  • Constructor Details

    • NativeLibraryException

      public NativeLibraryException(String message, int nativeErrorCode)

    • NativeLibraryException

      public NativeLibraryException(String message)