Package com.chilkatsoft.chilkat2

Class ChilkatException

java.lang.Object
java.lang.Throwable
java.lang.Exception
java.lang.RuntimeException
com.chilkatsoft.chilkat2.ChilkatException
All Implemented Interfaces:
Serializable
public final class ChilkatException extends RuntimeException
Thrown when a Chilkat method fails: a status method that returned false, or a string- or object-returning method that returned nothing (except the methods documented as returning null when not found, which do not throw).

The exception is self-contained: getLastErrorText() is a copy of the object's LastErrorText taken at the moment of failure (the object's own copy is overwritten by its next call), and Throwable.getMessage() is a one-line summary built from it.

Unchecked (RuntimeException): the calls are I/O and cryptographic operations whose failure a caller handles at the boundary it chooses.

See Also:
Serialized Form

  • Method Details

    • getClassName

      public String getClassName()
      The Chilkat class of the object whose method failed, such as Http.
      Returns:
      the class name

    • getMethodName

      public String getMethodName()
      The Java name of the method that failed, such as quickGetStr.
      Returns:
      the method name

    • getLastErrorText

      public String getLastErrorText()
      The full LastErrorText of the failed call, captured when it failed: what the library did and why it stopped.
      Returns:
      the text log of the failed call

    • getReason

      public String getReason()
      The one-line reason used in Throwable.getMessage(): the last line of LastErrorText that is a sentence rather than a structural line (--X, ChilkatLog:, name: value).
      Returns:
      the reason line, or a pointer to getLastErrorText() when none is found