Open
Description
Such annotations can help immensely when programming with the API, as it tells the API user what to expect.
Two examples from DbxClient
:
.startGetFile()
can have null as its second argument; it will also never return null; therefore:
@Nonnull
DbxClient.Downloader startGetFile(String path, @Nullable String rev)
.getMetadata()
can return null:
@Nullable
DbxEntry getMetadata(String path)