Azure · browndav-msft · Mar 23, 2026 · Mar 23, 2026 · Mar 24, 2026 · Mar 24, 2026
@@ -500,6 +500,23 @@ See the License for the specific language governing permissions and limitations
 
 -------------------------------------------------------------------------------------------------
 
+License notice for Apache Arrow
+-------------------------------------------------------------------------------
+
+apache-arrow-java (https://github.com/apache/arrow-java)
+Copyright 2015-2024 The Apache Software Foundation
+
+Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
+in compliance with the License. You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software distributed under the License
+is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and limitations under the License.
+
+-------------------------------------------------------------------------------------------------
+
 License notice for GraalVM
 ------------------------------------------------------------------------------
 org.graalvm.sdk:graal-sdk - https://github.com/graalvm/native-build-tools/blob/master/common/junit-platform-native/LICENSE
@@ -609,4 +626,4 @@ compliance with the License. You may obtain a copy of the License at:
 
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an
 "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific
-language governing permissions and limitations under the License.
+language governing permissions and limitations under the License.
@@ -25,6 +25,7 @@ com.github.spotbugs:spotbugs;4.8.3
 com.github.spotbugs:spotbugs-annotations;4.8.3
 com.github.spotbugs:spotbugs-maven-plugin;4.8.3.1
 com.google.code.gson:gson;2.14.0
+com.google.flatbuffers:flatbuffers-java;24.3.25
 com.google.guava:guava;33.6.0-jre
 com.h2database:h2;2.2.220
 com.h3xstream.findsecbugs:findsecbugs-plugin;1.9.0
@@ -63,6 +64,7 @@ io.vertx:vertx-codegen;4.5.27
 io.vertx:vertx-core;4.5.27
 javax.websocket:javax.websocket-api;1.1
 org.apache.ant:ant;1.10.15
+org.apache.arrow:arrow-format;19.0.0
 org.apache.avro:avro;1.11.4
 org.apache.avro:avro-maven-plugin;1.11.4
 org.apache.commons:commons-lang3;3.18.0

@@ -602,6 +602,10 @@
 
                 <!-- Used by many libraries to bring in annotations used by Reactor -->
                 <include>com.google.code.findbugs:jsr305:[3.0.2]</include> <!-- {x-include-update;com.google.code.findbugs:jsr305;external_dependency} -->
+
+                <!-- Apache Arrow format parsing. flatbuffers-java is the sole (compile-scoped) dependency used by
+                     azure-storage-blob's vendored Arrow FlatBuffer accessors -->
+                <include>com.google.flatbuffers:flatbuffers-java:[24.3.25]</include> <!-- {x-include-update;com.google.flatbuffers:flatbuffers-java;external_dependency} -->
               </includes>
             </bannedDependencies>
 

@@ -2,5 +2,5 @@
   "AssetsRepo": "Azure/azure-sdk-assets",
   "AssetsRepoPrefixPath": "java",
   "TagPrefix": "java/storage/azure-storage-blob",
-  "Tag": "java/storage/azure-storage-blob_494b72fca7"
+  "Tag": "java/storage/azure-storage-blob_13b4ad4e16"
 }
@@ -59,6 +59,10 @@
     </javaModulesSurefireArgLine>
     <parallelizeLiveTests>concurrent</parallelizeLiveTests>
 
+    <!-- Exclude vendored Apache Arrow code from linting checks -->
+    <checkstyle.excludes>**/implementation/util/apachearrow/**/*.java</checkstyle.excludes>
+    <spotbugs.excludes>**/implementation/util/apachearrow/**/*.java</spotbugs.excludes>
+
     <spotbugs.skip>false</spotbugs.skip>
   </properties>
 
@@ -138,6 +142,20 @@
       <version>1.17.7</version> <!-- {x-version-update;testdep_net.bytebuddy:byte-buddy-agent;external_dependency} -->
       <scope>test</scope>
     </dependency>
+
+    <!-- Arrow dependency -->
+    <!-- The internal ListBlobs Arrow reader decodes the IPC stream using vendored FlatBuffer metadata accessors
+         (com.azure.storage.blob.implementation.util.apachearrow) backed by flatbuffers-java, so flatbuffers-java is the
+         sole dependency needed to parse the Arrow format. The arrow-format artifact is deliberately NOT a dependency:
+         it ships Java 11 bytecode and would break the Java 8 baseline build. The reader's behavior is validated against
+         committed golden base64 fixtures (src/test/resources/arrow) rather than the official arrow-vector writer, so no
+         Apache Arrow test dependency is required. -->
+    <dependency>
+      <groupId>com.google.flatbuffers</groupId>
+      <artifactId>flatbuffers-java</artifactId>
+      <version>24.3.25</version> <!-- {x-version-update;com.google.flatbuffers:flatbuffers-java;external_dependency} -->
+    </dependency>
+
   </dependencies>
 
   <profiles>
@@ -182,5 +200,84 @@
         </plugins>
       </build>
     </profile>
+
+    <!-- This profile is used to generate a sources JAR with arrow-format shaded into com.azure.storage.blob.implementation.util.apachearrow. -->
+    <!-- DO NOT run this profile with release, it is only meant to be run locally when the shaded Apache Arrow code needs to be updated. -->
+    <!-- -->
+    <!-- To update the shaded Apache Arrow code, run Maven build with '-Dshade-apache-arrow-format' included in the command. -->
+    <!-- In the target folder, extract the sources JAR. The path com/azure/storage/blob/implementation/util/apachearrow will contain the relocated Apache Arrow source code. -->
+    <!-- Copy this code into the com.azure.storage.blob.implementation.util.apachearrow package in azure-storage-blob and overwrite the existing files. -->
+    <profile>
+      <id>shade-apache-arrow-format</id>
+      <activation>
+        <property>
+          <name>shade-apache-arrow-format</name>
+        </property>
+      </activation>
+
+      <dependencies>
+        <dependency>
+          <groupId>org.apache.arrow</groupId>
+          <artifactId>arrow-format</artifactId>
+          <version>19.0.0</version> <!-- {x-version-update;org.apache.arrow:arrow-format;external_dependency} -->
+        </dependency>
+      </dependencies>
+
+      <build>
+        <plugins>
+          <plugin>
+            <groupId>org.apache.maven.plugins</groupId>
+            <artifactId>maven-shade-plugin</artifactId>
+            <version>3.6.0</version> <!-- {x-version-update;org.apache.maven.plugins:maven-shade-plugin;external_dependency} -->
+
+            <executions>
+              <execution>
+                <id>shade</id>
+                <phase>package</phase>
+                <goals>
+                  <goal>shade</goal>
+                </goals>
+              </execution>
+            </executions>
+
+            <configuration>
+              <createSourcesJar>true</createSourcesJar>
+              <shadeSourcesContent>true</shadeSourcesContent>
+              <shadedArtifactAttached>true</shadedArtifactAttached>
+              <shadedClassifierName>shade-apache-arrow-format</shadedClassifierName>
+              <createDependencyReducedPom>false</createDependencyReducedPom>
+
+              <artifactSet>
+                <includes>
+                  <include>org.apache.arrow:arrow-format</include> <!-- {x-include-update;org.apache.arrow:arrow-format;external_dependency} -->
+                </includes>
+              </artifactSet>
+
+              <relocations>
+                <relocation>
+                  <pattern>org.apache.arrow.flatbuf</pattern>
+                  <shadedPattern>com.azure.storage.blob.implementation.util.apachearrow</shadedPattern>
+                </relocation>
+              </relocations>
+            </configuration>
+          </plugin>
+
+          <plugin>
+            <groupId>org.apache.maven.plugins</groupId>
+            <artifactId>maven-enforcer-plugin</artifactId>
+            <version>3.6.1</version> <!-- {x-version-update;org.apache.maven.plugins:maven-enforcer-plugin;external_dependency} -->
+            <configuration>
+              <rules>
+                <bannedDependencies>
+                  <includes>
+                    <include>org.apache.arrow:arrow-format:[19.0.0]</include> <!-- {x-include-update;org.apache.arrow:arrow-format;external_dependency} -->
+                  </includes>
+                </bannedDependencies>
+              </rules>
+            </configuration>
+          </plugin>
+        </plugins>
+      </build>
+    </profile>
   </profiles>
 </project>