This is an automated email from the ASF dual-hosted git repository.

davsclaus pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/camel.git


The following commit(s) were added to refs/heads/main by this push:
     new d769b4647099 camel-azure-storage-blob: CamelAzureStorageBlobBlobName 
is set by the consumer but documented producer-only (#29978)
d769b4647099 is described below

commit d769b464709945507b372ac73d9f147f080c3832
Author: dhairya05 <[email protected]>
AuthorDate: Sun Nov 15 12:54:00 2026 +0530

    camel-azure-storage-blob: CamelAzureStorageBlobBlobName is set by the 
consumer but documented producer-only (#29978)
    
    The consumer puts the blob name on every exchange it creates:
    
        exchange.getIn().setHeader(BlobConstants.BLOB_NAME, blobName);
    
    at the end of createExchangeFromBlob, and reads it back in
    releaseNotProcessed and in the on-completion paths to clear the blob from
    the in-progress set:
    
        final String name = exchange.getIn().getHeader(BlobConstants.BLOB_NAME, 
String.class);
        if (name != null) {
            inProgress.remove(name);
        }
    
    The header is nevertheless labelled producer, and its description only
    covers that direction - "(Operations related to blob) Override/set the
    blob name on the exchange headers." - so nothing in the consumer's
    header table says which blob an exchange came from, although that is the
    first thing a route polling a container needs.
    
    Label it common, as the component already does for 
CamelAzureStorageBlobLeaseBlob
    and LeaseDurationInSeconds, and describe both directions.
---
 .../org/apache/camel/catalog/components/azure-storage-blob.json    | 2 +-
 .../camel/component/azure/storage/blob/azure-storage-blob.json     | 2 +-
 .../apache/camel/component/azure/storage/blob/BlobConstants.java   | 5 +++--
 .../camel/builder/endpoint/dsl/BlobEndpointBuilderFactory.java     | 7 ++++---
 4 files changed, 9 insertions(+), 7 deletions(-)

diff --git 
a/catalog/camel-catalog/src/generated/resources/org/apache/camel/catalog/components/azure-storage-blob.json
 
b/catalog/camel-catalog/src/generated/resources/org/apache/camel/catalog/components/azure-storage-blob.json
index afb6dfa615b3..71a8af9c80ca 100644
--- 
a/catalog/camel-catalog/src/generated/resources/org/apache/camel/catalog/components/azure-storage-blob.json
+++ 
b/catalog/camel-catalog/src/generated/resources/org/apache/camel/catalog/components/azure-storage-blob.json
@@ -125,7 +125,7 @@
     "CamelAzureStorageBlobPublicAccessType": { "index": 45, "kind": "header", 
"displayName": "", "group": "producer", "label": "producer", "required": false, 
"javaType": "PublicAccessType", "deprecated": false, "autowired": false, 
"secret": false, "description": "(createContainer) Specifies how the data in 
this container is available to the public. Pass null for no public access.", 
"constantName": 
"org.apache.camel.component.azure.storage.blob.BlobConstants#PUBLIC_ACCESS_TYPE"
 },
     "CamelAzureStorageBlobRequestCondition": { "index": 46, "kind": "header", 
"displayName": "", "group": "producer", "label": "producer", "required": false, 
"javaType": "BlobRequestConditions", "deprecated": false, "autowired": false, 
"secret": false, "description": "(Operations related to container and blob) 
This contains values which will restrict the successful operation of a variety 
of requests to the conditions present. These conditions are entirely 
optional.", "constantName": "org [...]
     "CamelAzureStorageBlobBlobContainerName": { "index": 47, "kind": "header", 
"displayName": "", "group": "producer", "label": "producer", "required": false, 
"javaType": "String", "deprecated": false, "autowired": false, "secret": false, 
"description": "(Operations related to container and blob) Override\/set the 
container name on the exchange headers.", "constantName": 
"org.apache.camel.component.azure.storage.blob.BlobConstants#BLOB_CONTAINER_NAME"
 },
-    "CamelAzureStorageBlobBlobName": { "index": 48, "kind": "header", 
"displayName": "", "group": "producer", "label": "producer", "required": false, 
"javaType": "String", "deprecated": false, "autowired": false, "secret": false, 
"description": "(Operations related to blob) Override\/set the blob name on the 
exchange headers.", "constantName": 
"org.apache.camel.component.azure.storage.blob.BlobConstants#BLOB_NAME" },
+    "CamelAzureStorageBlobBlobName": { "index": 48, "kind": "header", 
"displayName": "", "group": "common", "label": "common", "required": false, 
"javaType": "String", "deprecated": false, "autowired": false, "secret": false, 
"description": "(producer) Override\/set the blob name on the exchange headers, 
for the operations related to a blob. (consumer) The name of the blob that was 
consumed.", "constantName": 
"org.apache.camel.component.azure.storage.blob.BlobConstants#BLOB_NAME" },
     "CamelAzureStorageBlobFileDir": { "index": 49, "kind": "header", 
"displayName": "", "group": "producer", "label": "producer", "required": false, 
"javaType": "String", "deprecated": false, "autowired": false, "secret": false, 
"description": "(downloadBlobToFile) The file directory where the downloaded 
blobs will be saved to.", "constantName": 
"org.apache.camel.component.azure.storage.blob.BlobConstants#FILE_DIR" },
     "CamelAzureStorageBlobPageBlobRange": { "index": 50, "kind": "header", 
"displayName": "", "group": "producer", "label": "producer", "required": false, 
"javaType": "PageRange", "deprecated": false, "autowired": false, "secret": 
false, "description": "(Operations related to page blob) A PageRange object. 
Given that pages must be aligned with 512-byte boundaries, the start offset 
must be a modulus of 512 and the end offset must be a modulus of 512 - 1. 
Examples of valid byte ranges are  [...]
     "CamelAzureStorageBlobPageBlobSize": { "index": 51, "kind": "header", 
"displayName": "", "group": "producer", "label": "producer", "required": false, 
"javaType": "Long", "deprecated": false, "autowired": false, "secret": false, 
"description": "(createPageBlob, resizePageBlob) Specifies the maximum size for 
the page blob, up to 8 TB. The page blob size must be aligned to a 512-byte 
boundary.", "constantName": 
"org.apache.camel.component.azure.storage.blob.BlobConstants#PAGE_BLOB_SIZE" },
diff --git 
a/components/camel-azure/camel-azure-storage-blob/src/generated/resources/META-INF/org/apache/camel/component/azure/storage/blob/azure-storage-blob.json
 
b/components/camel-azure/camel-azure-storage-blob/src/generated/resources/META-INF/org/apache/camel/component/azure/storage/blob/azure-storage-blob.json
index afb6dfa615b3..71a8af9c80ca 100644
--- 
a/components/camel-azure/camel-azure-storage-blob/src/generated/resources/META-INF/org/apache/camel/component/azure/storage/blob/azure-storage-blob.json
+++ 
b/components/camel-azure/camel-azure-storage-blob/src/generated/resources/META-INF/org/apache/camel/component/azure/storage/blob/azure-storage-blob.json
@@ -125,7 +125,7 @@
     "CamelAzureStorageBlobPublicAccessType": { "index": 45, "kind": "header", 
"displayName": "", "group": "producer", "label": "producer", "required": false, 
"javaType": "PublicAccessType", "deprecated": false, "autowired": false, 
"secret": false, "description": "(createContainer) Specifies how the data in 
this container is available to the public. Pass null for no public access.", 
"constantName": 
"org.apache.camel.component.azure.storage.blob.BlobConstants#PUBLIC_ACCESS_TYPE"
 },
     "CamelAzureStorageBlobRequestCondition": { "index": 46, "kind": "header", 
"displayName": "", "group": "producer", "label": "producer", "required": false, 
"javaType": "BlobRequestConditions", "deprecated": false, "autowired": false, 
"secret": false, "description": "(Operations related to container and blob) 
This contains values which will restrict the successful operation of a variety 
of requests to the conditions present. These conditions are entirely 
optional.", "constantName": "org [...]
     "CamelAzureStorageBlobBlobContainerName": { "index": 47, "kind": "header", 
"displayName": "", "group": "producer", "label": "producer", "required": false, 
"javaType": "String", "deprecated": false, "autowired": false, "secret": false, 
"description": "(Operations related to container and blob) Override\/set the 
container name on the exchange headers.", "constantName": 
"org.apache.camel.component.azure.storage.blob.BlobConstants#BLOB_CONTAINER_NAME"
 },
-    "CamelAzureStorageBlobBlobName": { "index": 48, "kind": "header", 
"displayName": "", "group": "producer", "label": "producer", "required": false, 
"javaType": "String", "deprecated": false, "autowired": false, "secret": false, 
"description": "(Operations related to blob) Override\/set the blob name on the 
exchange headers.", "constantName": 
"org.apache.camel.component.azure.storage.blob.BlobConstants#BLOB_NAME" },
+    "CamelAzureStorageBlobBlobName": { "index": 48, "kind": "header", 
"displayName": "", "group": "common", "label": "common", "required": false, 
"javaType": "String", "deprecated": false, "autowired": false, "secret": false, 
"description": "(producer) Override\/set the blob name on the exchange headers, 
for the operations related to a blob. (consumer) The name of the blob that was 
consumed.", "constantName": 
"org.apache.camel.component.azure.storage.blob.BlobConstants#BLOB_NAME" },
     "CamelAzureStorageBlobFileDir": { "index": 49, "kind": "header", 
"displayName": "", "group": "producer", "label": "producer", "required": false, 
"javaType": "String", "deprecated": false, "autowired": false, "secret": false, 
"description": "(downloadBlobToFile) The file directory where the downloaded 
blobs will be saved to.", "constantName": 
"org.apache.camel.component.azure.storage.blob.BlobConstants#FILE_DIR" },
     "CamelAzureStorageBlobPageBlobRange": { "index": 50, "kind": "header", 
"displayName": "", "group": "producer", "label": "producer", "required": false, 
"javaType": "PageRange", "deprecated": false, "autowired": false, "secret": 
false, "description": "(Operations related to page blob) A PageRange object. 
Given that pages must be aligned with 512-byte boundaries, the start offset 
must be a modulus of 512 and the end offset must be a modulus of 512 - 1. 
Examples of valid byte ranges are  [...]
     "CamelAzureStorageBlobPageBlobSize": { "index": 51, "kind": "header", 
"displayName": "", "group": "producer", "label": "producer", "required": false, 
"javaType": "Long", "deprecated": false, "autowired": false, "secret": false, 
"description": "(createPageBlob, resizePageBlob) Specifies the maximum size for 
the page blob, up to 8 TB. The page blob size must be aligned to a 512-byte 
boundary.", "constantName": 
"org.apache.camel.component.azure.storage.blob.BlobConstants#PAGE_BLOB_SIZE" },
diff --git 
a/components/camel-azure/camel-azure-storage-blob/src/main/java/org/apache/camel/component/azure/storage/blob/BlobConstants.java
 
b/components/camel-azure/camel-azure-storage-blob/src/main/java/org/apache/camel/component/azure/storage/blob/BlobConstants.java
index a01ed64d25f0..d91e96752015 100644
--- 
a/components/camel-azure/camel-azure-storage-blob/src/main/java/org/apache/camel/component/azure/storage/blob/BlobConstants.java
+++ 
b/components/camel-azure/camel-azure-storage-blob/src/main/java/org/apache/camel/component/azure/storage/blob/BlobConstants.java
@@ -188,8 +188,9 @@ public final class BlobConstants {
               description = "(Operations related to container and blob) 
Override/set the container name on the exchange headers.",
               javaType = "String")
     public static final String BLOB_CONTAINER_NAME = HEADER_PREFIX + 
"BlobContainerName";
-    @Metadata(label = "producer",
-              description = "(Operations related to blob) Override/set the 
blob name on the exchange headers.",
+    @Metadata(label = "common",
+              description = "(producer) Override/set the blob name on the 
exchange headers, for the operations related"
+                            + " to a blob. (consumer) The name of the blob 
that was consumed.",
               javaType = "String")
     public static final String BLOB_NAME = HEADER_PREFIX + "BlobName";
     @Metadata(label = "producer",
diff --git 
a/dsl/camel-endpointdsl/src/generated/java/org/apache/camel/builder/endpoint/dsl/BlobEndpointBuilderFactory.java
 
b/dsl/camel-endpointdsl/src/generated/java/org/apache/camel/builder/endpoint/dsl/BlobEndpointBuilderFactory.java
index 54f46f1399d2..3bdcc1d4e714 100644
--- 
a/dsl/camel-endpointdsl/src/generated/java/org/apache/camel/builder/endpoint/dsl/BlobEndpointBuilderFactory.java
+++ 
b/dsl/camel-endpointdsl/src/generated/java/org/apache/camel/builder/endpoint/dsl/BlobEndpointBuilderFactory.java
@@ -4084,12 +4084,13 @@ public interface BlobEndpointBuilderFactory {
             return "CamelAzureStorageBlobBlobContainerName";
         }
         /**
-         * (Operations related to blob) Override/set the blob name on the
-         * exchange headers.
+         * (producer) Override/set the blob name on the exchange headers, for
+         * the operations related to a blob. (consumer) The name of the blob
+         * that was consumed.
          * 
          * The option is a: {@code String} type.
          * 
-         * Group: producer
+         * Group: common
          * 
          * @return the name of the header {@code AzureStorageBlobBlobName}.
          */

Reply via email to