javadocs refactor

Author: saxenapranav

hadoop-tools/hadoop-azure/src/main/java/org/apache/hadoop/fs/azurebfs/security/EncryptionAdapter.java

@@ -54,7 +54,8 @@ public class EncryptionAdapter {
    * @param path Path for which encryptionContext and encryptionKeys to be stored
    * in the object
    * @param encryptionContext encryptionContext for the path stored in the backend
-   * @throws IOException
+   * @throws IOException throws back the exception it receives from the
+   * {@link EncryptionAdapter#computeKeys()} method call.
    * */
   public EncryptionAdapter(EncryptionContextProvider provider, String path,
       byte[] encryptionContext) throws IOException {
@@ -75,7 +76,8 @@ public EncryptionAdapter(EncryptionContextProvider provider, String path,
    * @param provider developer's implementation of {@link EncryptionContextProvider}
    * @param path file path for which encryptionContext and encryptionKeys to be
    * created and stored
-   * @throws IOException
+   * @throws IOException throws back the exception it receives from the method call
+   * to {@link EncryptionContextProvider} object.
    * */
   public EncryptionAdapter(EncryptionContextProvider provider, String path)
       throws IOException {

hadoop-tools/hadoop-azure/src/main/java/org/apache/hadoop/fs/azurebfs/services/AbfsClient.java

@@ -424,7 +424,8 @@ public AbfsRestOperation deleteFilesystem(TracingContext tracingContext) throws
    * @return object of {@link AbfsRestOperation} which contain all the information
    * about the communication with the server. The information is in
    * {@link AbfsRestOperation#getResult()}
-   * @throws IOException
+   * @throws IOException throws back the exception it receives from the
+   * {@link AbfsRestOperation#execute(TracingContext)} method call.
    * */
   public AbfsRestOperation createPath(final String path, final boolean isFile,
       final boolean overwrite, final Permissions permissions,

hadoop-tools/hadoop-azure/src/main/java/org/apache/hadoop/fs/azurebfs/utils/NamespaceUtil.java

@@ -59,7 +59,10 @@ private NamespaceUtil() {
    * @param tracingContext object to correlate Store requests.
    * @return if the account corresponding to the given client is namespace-enabled
    * or not.
-   * @throws AzureBlobFileSystemException
+   * @throws AzureBlobFileSystemException throws back the exception the method receives
+   * from the {@link AbfsClient#getAclStatus(String, TracingContext)}. In case it gets
+   * {@link AbfsRestOperationException}, it checks if the exception statusCode is
+   * BAD_REQUEST or not. If not, then it will pass the exception to the calling method.
    * */
   public static Boolean isNamespaceEnabled(final AbfsClient abfsClient,
       final TracingContext tracingContext)