Reset sources for azure-storage-blob to the release version 12.29.0.

Azure · azure-sdk · Jan 16, 2025 · Jan 16, 2025 · Jan 16, 2025 · Jan 16, 2025
commit 96977662b14129a6a6f47e429cca81e046260dac
@@ -1,15 +1,5 @@
 # Release History
 
-## 12.30.0-beta.1 (Unreleased)
-
-### Features Added
-
-### Breaking Changes
-
-### Bugs Fixed
-
-### Other Changes
-
 ## 12.29.0 (2024-11-13)
 
 ### Features Added

@@ -611,16 +611,16 @@ This project has adopted the [Microsoft Open Source Code of Conduct][coc]. For m
 [source]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/storage/azure-storage-blob/src
 [samples_readme]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/storage/azure-storage-blob/src/samples/README.md
 [docs]: https://azure.github.io/azure-sdk-for-java/
-[rest_docs]: https://learn.microsoft.com/rest/api/storageservices/blob-service-rest-api
-[product_docs]: https://learn.microsoft.com/azure/storage/blobs/storage-blobs-overview
-[sas_token]: https://learn.microsoft.com/azure/storage/common/storage-dotnet-shared-access-signature-part-1
-[jdk]: https://learn.microsoft.com/java/azure/jdk/
+[rest_docs]: https://docs.microsoft.com/rest/api/storageservices/blob-service-rest-api
+[product_docs]: https://docs.microsoft.com/azure/storage/blobs/storage-blobs-overview
+[sas_token]: https://docs.microsoft.com/azure/storage/common/storage-dotnet-shared-access-signature-part-1
+[jdk]: https://docs.microsoft.com/java/azure/jdk/
 [azure_subscription]: https://azure.microsoft.com/free/
-[storage_account]: https://learn.microsoft.com/azure/storage/common/storage-quickstart-create-account?tabs=azure-portal
-[storage_account_create_cli]: https://learn.microsoft.com/azure/storage/common/storage-quickstart-create-account?tabs=azure-cli
-[storage_account_create_portal]: https://learn.microsoft.com/azure/storage/common/storage-quickstart-create-account?tabs=azure-portal
+[storage_account]: https://docs.microsoft.com/azure/storage/common/storage-quickstart-create-account?tabs=azure-portal
+[storage_account_create_cli]: https://docs.microsoft.com/azure/storage/common/storage-quickstart-create-account?tabs=azure-cli
+[storage_account_create_portal]: https://docs.microsoft.com/azure/storage/common/storage-quickstart-create-account?tabs=azure-portal
 [identity]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/identity/azure-identity/README.md
-[error_codes]: https://learn.microsoft.com/rest/api/storageservices/blob-service-error-codes
+[error_codes]: https://docs.microsoft.com/rest/api/storageservices/blob-service-error-codes
 [samples]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/storage/azure-storage-blob/src/samples
 [cla]: https://cla.microsoft.com
 [coc]: https://opensource.microsoft.com/codeofconduct/

@@ -2,5 +2,5 @@
   "AssetsRepo": "Azure/azure-sdk-assets",
   "AssetsRepoPrefixPath": "java",
   "TagPrefix": "java/storage/azure-storage-blob",
-  "Tag": "java/storage/azure-storage-blob_f223d6f99b"
+  "Tag": "java/storage/azure-storage-blob_4863e111dc"
 }
@@ -13,7 +13,7 @@
 
   <groupId>com.azure</groupId>
   <artifactId>azure-storage-blob</artifactId>
-  <version>12.30.0-beta.1</version> <!-- {x-version-update;com.azure:azure-storage-blob;current} -->
+  <version>12.29.0</version> <!-- {x-version-update;com.azure:azure-storage-blob;current} -->
 
   <name>Microsoft Azure client library for Blob Storage</name>
   <description>This module contains client library for Microsoft Azure Blob Storage.</description>
@@ -64,6 +64,7 @@
 
     <spotbugs.skip>false</spotbugs.skip>
     <spotbugs.excludeFilterFile>spotbugs-exclude.xml</spotbugs.excludeFilterFile>
+    <doclintMissingInclusion>-</doclintMissingInclusion>
   </properties>
 
   <dependencies>
@@ -75,22 +76,22 @@
     <dependency>
       <groupId>com.azure</groupId>
       <artifactId>azure-core</artifactId>
-      <version>1.54.1</version> <!-- {x-version-update;com.azure:azure-core;dependency} -->
+      <version>1.54.0</version> <!-- {x-version-update;com.azure:azure-core;dependency} -->
     </dependency>
     <dependency>
       <groupId>com.azure</groupId>
       <artifactId>azure-core-http-netty</artifactId>
-      <version>1.15.7</version> <!-- {x-version-update;com.azure:azure-core-http-netty;dependency} -->
+      <version>1.15.6</version> <!-- {x-version-update;com.azure:azure-core-http-netty;dependency} -->
     </dependency>
     <dependency>
       <groupId>com.azure</groupId>
       <artifactId>azure-storage-common</artifactId>
-      <version>12.29.0-beta.1</version> <!-- {x-version-update;com.azure:azure-storage-common;current} -->
+      <version>12.28.0</version> <!-- {x-version-update;com.azure:azure-storage-common;current} -->
     </dependency>
     <dependency>
       <groupId>com.azure</groupId>
       <artifactId>azure-storage-internal-avro</artifactId>
-      <version>12.14.1</version> <!-- {x-version-update;com.azure:azure-storage-internal-avro;current} -->
+      <version>12.14.0</version> <!-- {x-version-update;com.azure:azure-storage-internal-avro;current} -->
     </dependency>
 
     <!-- Added this dependency to include necessary annotations used by reactor core.
@@ -105,21 +106,21 @@
     <dependency>
       <groupId>com.azure</groupId>
       <artifactId>azure-storage-common</artifactId>
-      <version>12.29.0-beta.1</version> <!-- {x-version-update;com.azure:azure-storage-common;current} -->
+      <version>12.28.0</version> <!-- {x-version-update;com.azure:azure-storage-common;current} -->
       <classifier>tests</classifier>
       <type>test-jar</type>
       <scope>test</scope>
     </dependency>
     <dependency>
       <groupId>com.azure</groupId>
       <artifactId>azure-core-test</artifactId>
-      <version>1.27.0-beta.4</version> <!-- {x-version-update;com.azure:azure-core-test;dependency} -->
+      <version>1.27.0-beta.3</version> <!-- {x-version-update;com.azure:azure-core-test;dependency} -->
       <scope>test</scope>
     </dependency>
     <dependency>
       <groupId>com.azure</groupId>
       <artifactId>azure-identity</artifactId>
-      <version>1.15.0</version> <!-- {x-version-update;com.azure:azure-identity;dependency} -->
+      <version>1.14.1</version> <!-- {x-version-update;com.azure:azure-identity;dependency} -->
       <scope>test</scope>
     </dependency>
     <dependency>

@@ -103,9 +103,6 @@ public BlobServiceClientBuilder() {
     }
 
     /**
-     * Creates a {@link BlobServiceClient} based on options set in the builder. Every time {@code buildClient()} is
-     * called, a new instance of {@link BlobServiceClient} is created.
-     *
      * @return a {@link BlobServiceClient} created from the configurations in this builder.
      * @throws IllegalArgumentException If no credentials are provided.
      * @throws IllegalStateException If multiple credentials have been specified.
@@ -155,9 +152,6 @@ private HttpPipeline constructPipeline() {
     }
 
     /**
-     * Creates a {@link BlobServiceAsyncClient} based on options set in the builder. Every time
-     * {@code buildAsyncClient()} is called, a new instance of {@link BlobServiceAsyncClient} is created.
-     *
      * @return a {@link BlobServiceAsyncClient} created from the configurations in this builder.
      * @throws IllegalArgumentException If no credentials are provided.
      * @throws IllegalStateException If multiple credentials have been specified.

@@ -15,18 +15,12 @@
  */
 public final class HttpGetterInfo {
     private long offset = 0;
+
     private Long count = null;
-    private String eTag = null;
 
-    /**
-     * Creates a new instance of {@link HttpGetterInfo}.
-     */
-    public HttpGetterInfo() {
-    }
+    private String eTag = null;
 
     /**
-     * Gets the start offset that is used when creating the Range header. If unchanged this will default to 0.
-     *
      * @return the start offset used when creating the Range header. Defaults to 0.
      */
     public long getOffset() {
@@ -45,19 +39,16 @@ public HttpGetterInfo setOffset(long offset) {
     }
 
     /**
-     * Gets the count of bytes used to calculate the end offset when creating the Range header. null is the default and
-     * indicates that the entire rest of the blob should be retrieved.
-     *
-     * @return the count of bytes used to calculate the end offset when creating the Range header. null is the default
-     * and indicates that the entire rest of the blob should be retrieved.
+     * @return the count of bytes used to calculate the end offset when creating the Range header. {@code} null is the
+     * default and indicates that the entire rest of the blob should be retrieved.
      */
     public Long getCount() {
         return count;
     }
 
     /**
-     * Sets the count of bytes used to calculate the end offset when creating the Range header. null is the default and
-     * indicates that the entire rest of the blob should be retrieved.
+     * Sets the count of bytes used to calculate the end offset when creating the Range header. {@code} null is the
+     * default and indicates that the entire rest of the blob should be retrieved.
      *
      * @param count Count of bytes
      * @return the updated HttpGetterInfo object
@@ -71,25 +62,18 @@ public HttpGetterInfo setCount(Long count) {
     }
 
     /**
-     * Gets the eTag used when creating If-Match header. eTag is returned with any operation that modifies the resource
-     * and when retrieving
-     * {@link BlobClient#getPropertiesWithResponse(BlobRequestConditions, Duration, Context) properties}. Defaults to
-     * null.
-     *
      * @return the eTag used when creating If-Match header. eTag is returned with any operation that modifies the
-     * resource and when retrieving
-     * {@link BlobClient#getPropertiesWithResponse(BlobRequestConditions, Duration, Context) properties}. Defaults to
-     * null.
+     * resource and when retrieving {@link BlobClient#getPropertiesWithResponse(BlobRequestConditions, Duration,
+     * Context) properties}. Defaults to null.
      */
     public String getETag() {
         return eTag;
     }
 
     /**
      * Sets the eTag used when creating If-Match header. eTag is returned with any operation that modifies the resource
-     * and when retrieving
-     * {@link BlobClient#getPropertiesWithResponse(BlobRequestConditions, Duration, Context) properties}. Defaults to
-     * null.
+     * and when retrieving {@link BlobClient#getPropertiesWithResponse(BlobRequestConditions, Duration, Context)
+     * properties}. Defaults to null.
      *
      * @param eTag Resource's eTag
      * @return the updated HttpGetterInfo object

@@ -17,12 +17,6 @@
 @Deprecated
 public final class ProgressReporter {
 
-    /**
-     * Creates a new instance of {@link ProgressReporter}.
-     */
-    public ProgressReporter() {
-    }
-
     private abstract static class ProgressReporterImpl implements ProgressReceiver {
         long blockProgress;
 

@@ -1,7 +1,6 @@
 // Copyright (c) Microsoft Corporation. All rights reserved.
 // Licensed under the MIT License.
 // Code generated by Microsoft (R) AutoRest Code Generator.
-
 package com.azure.storage.blob.implementation.models;
 
 import com.azure.core.annotation.Fluent;
@@ -20,6 +19,7 @@
  */
 @Fluent
 public final class BlobFlatListSegment implements XmlSerializable<BlobFlatListSegment> {
+
     /*
      * The BlobItems property.
      */
@@ -33,7 +33,7 @@ public BlobFlatListSegment() {
 
     /**
      * Get the blobItems property: The BlobItems property.
-     * 
+     *
      * @return the blobItems value.
      */
     public List<BlobItemInternal> getBlobItems() {
@@ -42,7 +42,7 @@ public List<BlobItemInternal> getBlobItems() {
 
     /**
      * Set the blobItems property: The BlobItems property.
-     * 
+     *
      * @param blobItems the blobItems value to set.
      * @return the BlobFlatListSegment object itself.
      */
@@ -70,7 +70,7 @@ public XmlWriter toXml(XmlWriter xmlWriter, String rootElementName) throws XMLSt
 
     /**
      * Reads an instance of BlobFlatListSegment from the XmlReader.
-     * 
+     *
      * @param xmlReader The XmlReader being read.
      * @return An instance of BlobFlatListSegment if the XmlReader was pointing to an instance of it, or null if it was
      * pointing to XML null.
@@ -82,7 +82,7 @@ public static BlobFlatListSegment fromXml(XmlReader xmlReader) throws XMLStreamE
 
     /**
      * Reads an instance of BlobFlatListSegment from the XmlReader.
-     * 
+     *
      * @param xmlReader The XmlReader being read.
      * @param rootElementName Optional root element name to override the default defined by the model. Used to support
      * cases where the model can deserialize from different root element names.
@@ -96,14 +96,15 @@ public static BlobFlatListSegment fromXml(XmlReader xmlReader, String rootElemen
             BlobFlatListSegment deserializedBlobFlatListSegment = new BlobFlatListSegment();
             while (reader.nextElement() != XmlToken.END_ELEMENT) {
                 QName elementName = reader.getElementName();
-
                 if ("Blob".equals(elementName.getLocalPart())) {
+                    if (deserializedBlobFlatListSegment.blobItems == null) {
+                        deserializedBlobFlatListSegment.blobItems = new ArrayList<>();
+                    }
                     deserializedBlobFlatListSegment.blobItems.add(BlobItemInternal.fromXml(reader, "Blob"));
                 } else {
                     reader.skipElement();
                 }
             }
-
             return deserializedBlobFlatListSegment;
         });
     }

@@ -1,7 +1,6 @@
 // Copyright (c) Microsoft Corporation. All rights reserved.
 // Licensed under the MIT License.
 // Code generated by Microsoft (R) AutoRest Code Generator.
-
 package com.azure.storage.blob.implementation.models;
 
 import com.azure.core.annotation.Fluent;
@@ -20,6 +19,7 @@
  */
 @Fluent
 public final class BlobHierarchyListSegment implements XmlSerializable<BlobHierarchyListSegment> {
+
     /*
      * The BlobPrefixes property.
      */
@@ -38,7 +38,7 @@ public BlobHierarchyListSegment() {
 
     /**
      * Get the blobPrefixes property: The BlobPrefixes property.
-     * 
+     *
      * @return the blobPrefixes value.
      */
     public List<BlobPrefixInternal> getBlobPrefixes() {
@@ -47,7 +47,7 @@ public List<BlobPrefixInternal> getBlobPrefixes() {
 
     /**
      * Set the blobPrefixes property: The BlobPrefixes property.
-     * 
+     *
      * @param blobPrefixes the blobPrefixes value to set.
      * @return the BlobHierarchyListSegment object itself.
      */
@@ -58,7 +58,7 @@ public BlobHierarchyListSegment setBlobPrefixes(List<BlobPrefixInternal> blobPre
 
     /**
      * Get the blobItems property: The BlobItems property.
-     * 
+     *
      * @return the blobItems value.
      */
     public List<BlobItemInternal> getBlobItems() {
@@ -67,7 +67,7 @@ public List<BlobItemInternal> getBlobItems() {
 
     /**
      * Set the blobItems property: The BlobItems property.
-     * 
+     *
      * @param blobItems the blobItems value to set.
      * @return the BlobHierarchyListSegment object itself.
      */
@@ -100,7 +100,7 @@ public XmlWriter toXml(XmlWriter xmlWriter, String rootElementName) throws XMLSt
 
     /**
      * Reads an instance of BlobHierarchyListSegment from the XmlReader.
-     * 
+     *
      * @param xmlReader The XmlReader being read.
      * @return An instance of BlobHierarchyListSegment if the XmlReader was pointing to an instance of it, or null if it
      * was pointing to XML null.
@@ -112,7 +112,7 @@ public static BlobHierarchyListSegment fromXml(XmlReader xmlReader) throws XMLSt
 
     /**
      * Reads an instance of BlobHierarchyListSegment from the XmlReader.
-     * 
+     *
      * @param xmlReader The XmlReader being read.
      * @param rootElementName Optional root element name to override the default defined by the model. Used to support
      * cases where the model can deserialize from different root element names.
@@ -127,17 +127,21 @@ public static BlobHierarchyListSegment fromXml(XmlReader xmlReader, String rootE
             BlobHierarchyListSegment deserializedBlobHierarchyListSegment = new BlobHierarchyListSegment();
             while (reader.nextElement() != XmlToken.END_ELEMENT) {
                 QName elementName = reader.getElementName();
-
                 if ("BlobPrefix".equals(elementName.getLocalPart())) {
+                    if (deserializedBlobHierarchyListSegment.blobPrefixes == null) {
+                        deserializedBlobHierarchyListSegment.blobPrefixes = new ArrayList<>();
+                    }
                     deserializedBlobHierarchyListSegment.blobPrefixes
                         .add(BlobPrefixInternal.fromXml(reader, "BlobPrefix"));
                 } else if ("Blob".equals(elementName.getLocalPart())) {
+                    if (deserializedBlobHierarchyListSegment.blobItems == null) {
+                        deserializedBlobHierarchyListSegment.blobItems = new ArrayList<>();
+                    }
                     deserializedBlobHierarchyListSegment.blobItems.add(BlobItemInternal.fromXml(reader, "Blob"));
                 } else {
                     reader.skipElement();
                 }
             }
-
             return deserializedBlobHierarchyListSegment;
         });
     }