Fix javadocs for encoded url (#46213)

* fix javadocs to reflect that `blobName`s should not be URL

This matches up with https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/storage/azure-storage-blob/CHANGELOG.md#breaking-changes-1

* fix javadocs to match nonencoded name for url

Author: browndav-msft

sdk/storage/azure-storage-blob/src/main/java/com/azure/storage/blob/BlobContainerAsyncClient.java

@@ -164,8 +164,7 @@ public final class BlobContainerAsyncClient {
      * </pre>
      * <!-- end com.azure.storage.blob.BlobContainerAsyncClient.getBlobAsyncClient#String -->
      *
-     * @param blobName A {@code String} representing the name of the blob. If the blob name contains special characters,
-     * pass in the url encoded version of the blob name.
+     * @param blobName A {@code String} representing the name of the blob. This should not be encoded.
      * @return A new {@link BlobAsyncClient} object which references the blob with the specified name in this container.
      */
     public BlobAsyncClient getBlobAsyncClient(String blobName) {
@@ -184,8 +183,7 @@ public BlobAsyncClient getBlobAsyncClient(String blobName) {
      * </pre>
      * <!-- end com.azure.storage.blob.BlobContainerAsyncClient.getBlobAsyncClient#String-String -->
      *
-     * @param blobName A {@code String} representing the name of the blob. If the blob name contains special characters,
-     * pass in the url encoded version of the blob name.
+     * @param blobName A {@code String} representing the name of the blob. This should not be encoded.
      * @param snapshot the snapshot identifier for the blob.
      * @return A new {@link BlobAsyncClient} object which references the blob with the specified name in this container.
      */
@@ -198,8 +196,7 @@ public BlobAsyncClient getBlobAsyncClient(String blobName, String snapshot) {
      * Creates a new BlobAsyncClient object by concatenating blobName to the end of ContainerAsyncClient's URL. The new
      * BlobAsyncClient uses the same request policy pipeline as the ContainerAsyncClient.
      *
-     * @param blobName A {@code String} representing the name of the blob. If the blob name contains special characters,
-     * pass in the url encoded version of the blob name.
+     * @param blobName A {@code String} representing the name of the blob. This should not be encoded.
      * @param versionId the version identifier for the blob, pass {@code null} to interact with the latest blob version.
      * @return A new {@link BlobAsyncClient} object which references the blob with the specified name in this container.
      */

sdk/storage/azure-storage-blob/src/main/java/com/azure/storage/blob/BlobContainerClient.java

@@ -150,9 +150,7 @@ public final class BlobContainerClient {
      * Initializes a new BlobClient object by concatenating blobName to the end of ContainerAsyncClient's URL. The new
      * BlobClient uses the same request policy pipeline as the ContainerAsyncClient.
      *
-     * @param blobName A {@code String} representing the name of the blob. If the blob name contains special characters,
-     *  pass in the url encoded version of the blob name.
-     *
+     * @param blobName A {@code String} representing the name of the blob. This should not be encoded.
      * <p><strong>Code Samples</strong></p>
      *
      * <!-- src_embed com.azure.storage.blob.BlobContainerClient.getBlobClient#String -->
@@ -178,8 +176,7 @@ public BlobClient getBlobClient(String blobName) {
      * </pre>
      * <!-- end com.azure.storage.blob.BlobContainerClient.getBlobClient#String-String -->
      *
-     * @param blobName A {@code String} representing the name of the blob. If the blob name contains special characters,
-     * pass in the url encoded version of the blob name.
+     * @param blobName A {@code String} representing the name of the blob. This should not be encoded.
      * @param snapshot the snapshot identifier for the blob.
      * @return A new {@link BlobClient} object which references the blob with the specified name in this container.
      */
@@ -192,8 +189,7 @@ public BlobClient getBlobClient(String blobName, String snapshot) {
      * Initializes a new BlobClient object by concatenating blobName to the end of ContainerAsyncClient's URL. The new
      * BlobClient uses the same request policy pipeline as the ContainerAsyncClient.
      *
-     * @param blobName A {@code String} representing the name of the blob. If the blob name contains special characters,
-     * pass in the url encoded version of the blob name.
+     * @param blobName A {@code String} representing the name of the blob. This should not be encoded.
      * @param versionId the version identifier for the blob, pass {@code null} to interact with the latest blob version.
      * @return A new {@link BlobClient} object which references the blob with the specified name in this container.
      */