JavaDocs: Document replacement methods for MKP methods

### Issue
Crypto Tools marked all MasterKeyProvider methods as deprecated, but did not revise their JavaDocs to state which methods should be used instead.

This is a source of customer confusion, as it is not clear that customers should use the Keyring methods instead.

_As originally posted by @jumarko in https://github.com/aws/aws-encryption-sdk-java/pull/1864#discussion_r1665561054_

Are these deprecations documented anywhere?
The javadoc doesn't say anything about what should be used instead.

### Suggested Fix
Revise the Java Docs for the Master Key Providers so that they details which methods replace the marked as deprecated methods.

Either remove the deprecation notice from the Caching Cryptographic Materials Manager methods or [implement support for the CachingCMM with Keyrings](https://github.com/aws/aws-cryptographic-material-providers-library/issues/480).

#### Related Issues
- https://github.com/aws/aws-encryption-sdk-java/issues/2035
- https://github.com/aws/aws-encryption-sdk-java/issues/2033

Trouvez les JavaDocs des méthodes obsolètes de MasterKeyProvider et des méthodes de Caching Cryptographic Materials Manager. Lisez ensuite les issues associées 2035 et 2033, puis comparez les APIs obsolètes aux méthodes de Keyring auxquelles elles font référence. Le travail est terminé lorsque le remplacement de chaque méthode obsolète est documenté et que la question concernant Caching CMM est résolue ou clairement documentée.

Rédigé par le modèle d'indexation à partir du texte de l'issue.