Class MSTRWebAPIException

  • All Implemented Interfaces:
    LocalizableException, java.io.Serializable
    Direct Known Subclasses:
    ACMException, MSTRDocumentException, MSTRRestAPIException

    public class MSTRWebAPIException
    extends MSTRCheckedException
    Exception class for all errors thrown from the WebAPI. Field for error code and another exception added to regular exception's implementation. All functions in the Web API throw this object if an error occurs. In that case, the message field(which can be seen via getMessage()) will have the error message in text format, and the error code can be acquired by getErrorCode. The symbolic constants for each error code are in the class WebAPIErrorCodes. Finally, for exceptions where there was another exception thrown, this exception can be acquired by getWrappedException.
    Since:
    MicroStrategy Web 7.3.1 or earlier
    See Also:
    Serialized Form
    • Constructor Detail

      • MSTRWebAPIException

        public MSTRWebAPIException​(LocalizableMessage errorMsg)
        Constructor.
        Parameters:
        errorMsg - error message
        Since:
        MicroStrategy Web 8.0.0
      • MSTRWebAPIException

        public MSTRWebAPIException​(LocalizableMessage errorMsg,
                                   java.lang.Throwable e)
        Constructor.
        Parameters:
        errorMsg - error message
        e - Embedded error
        Since:
        MicroStrategy Web 8.0.0
      • MSTRWebAPIException

        public MSTRWebAPIException​(int code,
                                   java.lang.Object[] params,
                                   java.util.Locale locale)
        Constructor.
        Parameters:
        code - error code
        params - parameters required to generate error message based on error code
        locale - default locale for this exception
        Since:
        MicroStrategy Web 8.0.0
      • MSTRWebAPIException

        public MSTRWebAPIException​(int code,
                                   java.lang.Object[] params,
                                   java.lang.Throwable e,
                                   java.util.Locale locale)
        Constructor.
        Parameters:
        code - error code
        params - parameters required to generate error message based on error code
        locale - default locale for this exception
        e - embedded error
        Since:
        MicroStrategy Web 8.0.0
      • MSTRWebAPIException

        protected MSTRWebAPIException()
      • MSTRWebAPIException

        protected MSTRWebAPIException​(java.lang.String errorMsg)
      • MSTRWebAPIException

        protected MSTRWebAPIException​(java.lang.Throwable e)
      • MSTRWebAPIException

        protected MSTRWebAPIException​(java.lang.String errorMsg,
                                      java.lang.Throwable e)
      • MSTRWebAPIException

        protected MSTRWebAPIException​(int errorCode)
      • MSTRWebAPIException

        protected MSTRWebAPIException​(java.lang.String errorMsg,
                                      int errorCode)
      • MSTRWebAPIException

        protected MSTRWebAPIException​(java.lang.String errorMsg,
                                      int errorCode,
                                      java.lang.Throwable e)
    • Method Detail

      • setNoRetry

        protected void setNoRetry​(boolean value)
        Since:
        MicroStrategy Web 9.0.0
      • canRetry

        protected boolean canRetry()
        Since:
        MicroStrategy Web 9.0.0
      • isRetryable

        protected boolean isRetryable()
        isRetryable returns true if this particular error is a retryable exception.
        Retryable exceptions include:
        • missing session (maybe it timed out)
        • dead IServer (maybe it was shut down or is hanging)
        • missing project (maybe it was just unloaded).
        Returns:
      • setIsRetryable

        protected void setIsRetryable​(boolean iIsRetryable)
        setIsRetyable sets whether or not this particular error is retryable.
        Retryable exceptions include:
        • missing session (maybe it timed out)
        • dead IServer (maybe it was shut down or is hanging)
        • missing project (maybe it was just unloaded).
        Parameters:
        iIsRetryable -