updated java docs

Author: ahmarsuhail

hadoop-tools/hadoop-aws/src/main/java/org/apache/hadoop/fs/s3a/audit/impl/LoggingAuditor.java

@@ -271,7 +271,13 @@ private class LoggingAuditSpan extends AbstractAuditSpanImpl {
 
     private HttpReferrerAuditHeader referrer;
 
+    /**
+     * Builder for the referrer header. Requests that execute outside S3A, such as in AAL, will initially have SpanId
+     * of  the outside-span operation. For such requests, the spanId and operation name in this builder is overwritten
+     * in the modifyHttpRequest execution interceptor.
+     */
     private final HttpReferrerAuditHeader.Builder headerBuilder;
+
     /**
      * Attach Range of data for GetObject Request.
      * @param request the sdk request to be modified
@@ -414,7 +420,6 @@ public SdkHttpRequest modifyHttpRequest(Context.ModifyHttpRequest context,
       // for delete op, attach the number of files to delete
       attachDeleteKeySizeAttribute(sdkRequest);
 
-
       // build the referrer header
       final String header = referrer.buildHttpReferrer();
       // update the outer class's field.

hadoop-tools/hadoop-aws/src/test/java/org/apache/hadoop/fs/s3a/ITestS3AAnalyticsAcceleratorStreamReading.java

@@ -182,6 +182,8 @@ public void testMultiRowGroupParquet() throws Throwable {
     }
 
     verifyStatisticCounterValue(ioStats, STREAM_READ_ANALYTICS_OPENED, 1);
+
+    verifyStatisticCounterValue(getFileSystem().getIOStatistics(), AUDIT_REQUEST_EXECUTION, 4);
   }
 
   @Test