Class AuthError


  • public final class AuthError
    extends java.lang.Object
    Errors occurred during authentication.

    This class is an open tagged union. Tagged unions instances are always associated to a specific tag. This means only one of the isAbc() methods will return true. You can use tag() to determine the tag associated with this instance.

    Open unions may be extended in the future with additional tags. If a new tag is introduced that this SDK does not recognized, the OTHER value will be used.

    • Field Detail

      • INVALID_ACCESS_TOKEN

        public static final AuthError INVALID_ACCESS_TOKEN
        The access token is invalid.
      • INVALID_SELECT_USER

        public static final AuthError INVALID_SELECT_USER
        The user specified in 'Dropbox-API-Select-User' is no longer on the team.
      • INVALID_SELECT_ADMIN

        public static final AuthError INVALID_SELECT_ADMIN
        The user specified in 'Dropbox-API-Select-Admin' is not a Dropbox Business team admin.
      • USER_SUSPENDED

        public static final AuthError USER_SUSPENDED
        The user has been suspended.
      • EXPIRED_ACCESS_TOKEN

        public static final AuthError EXPIRED_ACCESS_TOKEN
        The access token has expired.
      • ROUTE_ACCESS_DENIED

        public static final AuthError ROUTE_ACCESS_DENIED
        The route is not available to public.
      • OTHER

        public static final AuthError OTHER
        Catch-all used for unknown tag values returned by the Dropbox servers.

        Receiving a catch-all value typically indicates this SDK version is not up to date. Consider updating your SDK version to handle the new tags.

    • Method Detail

      • tag

        public AuthError.Tag tag()
        Returns the tag for this instance.

        This class is a tagged union. Tagged unions instances are always associated to a specific tag. This means only one of the isXyz() methods will return true. Callers are recommended to use the tag value in a switch statement to properly handle the different values for this AuthError.

        If a tag returned by the server is unrecognized by this SDK, the AuthError.Tag.OTHER value will be used.

        Returns:
        the tag for this instance.
      • missingScope

        public static AuthError missingScope​(TokenScopeError value)
        Returns an instance of AuthError that has its tag set to AuthError.Tag.MISSING_SCOPE.

        The access token does not have the required scope to access the route.

        Parameters:
        value - value to assign to this instance.
        Returns:
        Instance of AuthError with its tag set to AuthError.Tag.MISSING_SCOPE.
        Throws:
        java.lang.IllegalArgumentException - if value is null.
      • isOther

        public boolean isOther()
        Returns true if this instance has the tag AuthError.Tag.OTHER, false otherwise.
        Returns:
        true if this instance is tagged as AuthError.Tag.OTHER, false otherwise.
      • hashCode

        public int hashCode()
        Overrides:
        hashCode in class java.lang.Object
      • equals

        public boolean equals​(java.lang.Object obj)
        Overrides:
        equals in class java.lang.Object
      • toString

        public java.lang.String toString()
        Overrides:
        toString in class java.lang.Object
      • toStringMultiline

        public java.lang.String toStringMultiline()
        Returns a String representation of this object formatted for easier readability.

        The returned String may contain newlines.

        Returns:
        Formatted, multiline String representation of this object