Add JavaDoc Snippets for BlobClient and BlobAsyncClient (#4544)

* Storage SAS implementation (#4404)

* SAS implementation

* Fixed some minor formatting issues

* Fixed checkstyle problems and test issue

* Remove RawClients from Blobs (#4375)

Removes RawClients from Storage Blobs

* Add deleteContainer to StorageClient and getBlobClient with Snapshot to ContainerClient (#4376)

* Removed raw clients

* Added deleteContainer to StorageClient

* Added getAppendBlob with snapshot to ContainerClient

* Storage queue linting, builder refactor, tests (#4383)

* Initial check in for storage queue

* Beginning of code snippets for BlobAsyncClient

* JavaDoc snippets for BlobAsyncClient and BlobClient

* Added links to REST API docs for BlobAsyncClient and BlobClient, fixed JavaDoc issues, fix unit test issues

* Removed invalid import

Author: alzimmermsft

storage/client/blob/src/main/java/com/azure/storage/blob/BlobAsyncClient.java

@@ -18,7 +18,7 @@
 
 /**
  * {@code DownloadAsyncResponse} wraps the protocol-layer response from {@link BlobAsyncClient#download(BlobRange,
- * BlobAccessConditions, boolean, ReliableDownloadOptions)} to automatically retry failed reads from the body as
+ * ReliableDownloadOptions, BlobAccessConditions, boolean)} to automatically retry failed reads from the body as
  * appropriate. If the download is interrupted, the {@code DownloadAsyncResponse} will make a request to resume the download
  * from where it left off, allowing the user to consume the data as one continuous stream, for any interruptions are
  * hidden. The retry behavior is defined by the options passed to the {@link #body(ReliableDownloadOptions)}. The

storage/client/blob/src/main/java/com/azure/storage/blob/BlobClient.java

@@ -1,9 +1,9 @@
 // Copyright (c) Microsoft Corporation. All rights reserved.
 // Licensed under the MIT License.
 
+package com.azure.storage.blob;
+
 import com.azure.identity.credential.DefaultAzureCredential;
-import com.azure.storage.blob.BlobServiceClient;
-import com.azure.storage.blob.BlobServiceClientBuilder;
 
 import java.util.Locale;
 

storage/client/blob/src/main/java/com/azure/storage/blob/DownloadAsyncResponse.java

@@ -1,10 +1,8 @@
 // Copyright (c) Microsoft Corporation. All rights reserved.
 // Licensed under the MIT License.
 
-import com.azure.storage.blob.BlockBlobClient;
-import com.azure.storage.blob.ContainerClient;
-import com.azure.storage.blob.BlobServiceClient;
-import com.azure.storage.blob.BlobServiceClientBuilder;
+package com.azure.storage.blob;
+
 import com.azure.storage.common.credentials.SharedKeyCredential;
 
 import java.io.ByteArrayInputStream;

storage/client/blob/src/samples/java/AzureIdentityExample.java renamed to storage/client/blob/src/samples/java/com/azure/storage/blob/AzureIdentityExample.java

@@ -1,10 +1,8 @@
 // Copyright (c) Microsoft Corporation. All rights reserved.
 // Licensed under the MIT License.
 
-import com.azure.storage.blob.BlockBlobClient;
-import com.azure.storage.blob.ContainerClient;
-import com.azure.storage.blob.BlobServiceClient;
-import com.azure.storage.blob.BlobServiceClientBuilder;
+package com.azure.storage.blob;
+
 import com.azure.storage.common.credentials.SharedKeyCredential;
 
 import java.io.File;

storage/client/blob/src/samples/java/BasicExample.java renamed to storage/client/blob/src/samples/java/com/azure/storage/blob/BasicExample.java

@@ -0,0 +1,29 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+
+package com.azure.storage.blob;
+
+import java.net.MalformedURLException;
+import java.net.URL;
+
+final class JavaDocCodeSnippetsHelpers {
+    static ContainerAsyncClient getContainerAsyncClient() {
+        return new ContainerClientBuilder().buildAsyncClient();
+    }
+
+    static BlobAsyncClient getBlobAsyncClient(String blobName) {
+        return getContainerAsyncClient().getBlobAsyncClient(blobName);
+    }
+
+    static BlobClient getBlobClient(String blobName) {
+        return new BlobClient(getBlobAsyncClient(blobName));
+    }
+
+    static URL generateURL(String urlString) {
+        try {
+            return new URL(urlString);
+        } catch (MalformedURLException ex) {
+            throw new RuntimeException(ex);
+        }
+    }
+}

storage/client/blob/src/samples/java/com/azure/storage/blob/BlobAsyncClientJavaDocCodeSnippets.java

@@ -1,8 +1,8 @@
 // Copyright (c) Microsoft Corporation. All rights reserved.
 // Licensed under the MIT License.
 
-import com.azure.storage.blob.BlobServiceClient;
-import com.azure.storage.blob.BlobServiceClientBuilder;
+package com.azure.storage.blob;
+
 import com.azure.storage.common.credentials.SharedKeyCredential;
 
 import java.util.Locale;