Java: How do handle 404 and 50x errors?

Question

I'm migrating from V1 to V2.

In the past I an error code was an integer that I could look at. Now it's part of a string I presume (i.e. getMessage()).

There are no examples of how the errors would look like if these are 40x errors or 50x errors. How do I handle these? What should I expect, say, if the storage has run out on the server? Previously we used to get a 507 error (as in integer), what should I now expect?

Greg-DB · Accepted Answer

Hi Fahad, if you're using the Dropbox API v2 Java SDK, the SDK will translate these 4xx or 5xx error responses into exceptions for you, so you don't have to parse them yourself.

For instance, in the upload_file example here, there's some basic exception handling for some of the different kinds of exceptions that may get thrown.

The uploadAndFinish method throws a few different types of exceptions. For example, DbxApiException covers some 4xx issues, and DbxException covers some other more general errors.

That way, you don't need to know the specific error codes. You can check the type of the error for more granular error handling. For example, UploadErrorException is a subtype of DbxApiException, and covers some errors specific to uploading. (This would be a 409 from that endpoint.) Likewise, ServerException is a subtype of DbxException, and would indicate a server error. (That would be a 500.)

You can continue checking nested errors for more and more specific information, such as via WriteError.isInsufficientSpace.

Hope this helps!