This is an automated email from the ASF dual-hosted git repository.
jason810496 pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/airflow.git
The following commit(s) were added to refs/heads/main by this push:
new 884c6577070 Java SDK: Document char is not supported for XCom
parameters (#70239)
884c6577070 is described below
commit 884c65770701b2686b7ad5973efcc074b08f1e5e
Author: PoAn Yang <[email protected]>
AuthorDate: Tue Sep 8 16:24:41 2026 +0900
Java SDK: Document char is not supported for XCom parameters (#70239)
Signed-off-by: PoAn Yang <[email protected]>
---
airflow-core/docs/authoring-and-scheduling/language-sdks/java.rst | 8 ++++++++
1 file changed, 8 insertions(+)
diff --git a/airflow-core/docs/authoring-and-scheduling/language-sdks/java.rst
b/airflow-core/docs/authoring-and-scheduling/language-sdks/java.rst
index 7fd346bf3f4..a7424b4ecd3 100644
--- a/airflow-core/docs/authoring-and-scheduling/language-sdks/java.rst
+++ b/airflow-core/docs/authoring-and-scheduling/language-sdks/java.rst
@@ -447,6 +447,14 @@ represented as Java objects when read back via ``getXCom``.
- object
- ``Map<String, Object>``
+.. note::
+
+ ``char`` and ``Character`` are not supported. JSON has no single-character
type, so a
+ character value is stored as a JSON string (or a number) and is read back
as one of the
+ Java types in the table above. Declaring ``char`` or ``Character`` as an
+ ``@Builder.XCom`` parameter compiles, but reading a pushed value fails at
runtime with a
+ ``ClassCastException``. Use ``String`` instead.
+
.. note::
An ``@Builder.XCom`` parameter that reads a value which was never pushed
resolves to
