Package com.isode.dsapi

Class NativeLibraryException

  • All Implemented Interfaces:
    java.io.Serializable
    public class NativeLibraryException
extends java.lang.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:
    Serialized Form

    • Method Summary

      • Methods inherited from class java.lang.Throwable

        addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

      • Methods inherited from class java.lang.Object

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

    • Constructor Detail

      • NativeLibraryException

        public NativeLibraryException​(java.lang.String message,
                              int nativeErrorCode)

      • NativeLibraryException

        public NativeLibraryException​(java.lang.String message)