See also {@link #consistentWithEquals()}.\n *\n *
By default, if this coder is {@link #consistentWithEquals()}, and the value is not null,\n * returns the provided object. Otherwise, encodes the value into a {@code byte[]}, and returns an\n * object that performs array equality on the encoded bytes.\n */\n public Object structuralValue(T value) {\n if (value != null && consistentWithEquals()) {\n return value;\n } else {\n try {\n ByteArrayOutputStream os = new ByteArrayOutputStream();\n encode(value, os, Context.OUTER);\n return new StructuralByteArray(os.toByteArray());\n } catch (Exception exn) {\n throw new IllegalArgumentException(\n \"Unable to encode element '\" + value + \"' with coder '\" + this + \"'.\", exn);\n }\n }\n }\n\n /**\n * Returns whether {@link #registerByteSizeObserver} cheap enough to call for every element, that\n * is, if this {@code Coder} can calculate the byte size of the element to be coded in roughly\n * constant time (or lazily).\n *\n *
Not intended to be called by user code, but instead by {@link PipelineRunner}\n * implementations.\n *\n *
By default, returns false. The default {@link #registerByteSizeObserver} implementation\n * invokes {@link #getEncodedElementByteSize} which requires re-encoding an element unless it is\n * overridden. This is considered expensive.\n */\n public boolean isRegisterByteSizeObserverCheap(T value) {","sourceCodeStart":250,"sourceCodeEnd":286,"githubUrl":"https://github.com/apache/beam/blob/12126d8942aaf848030c478b4c6a28c6af861c66/sdks/java/core/src/main/java/org/apache/beam/sdk/coders/Coder.java#L250-L286","documentation":"Coder.structuralValue falls back to encoding the value to bytes when the coder does not override structuralValue; if that encode throws, it rethrows IllegalArgumentException naming the value and coder. The real cause is the nested exception, typically a null or unsupported value for the coder.","triggerScenarios":"Calling structuralValue(value) (directly or via keyedValues / side-input helpers) on a value the coder cannot encode — commonly null elements for non-nullable coders like ByteCoder or ByteArrayCoder.","commonSituations":"Null values in GBK keys, side inputs containing nulls, coders that throw on encode for special values, equality/hashing machinery encountering bad elements.","solutions":["Inspect getCause() to find the real encode failure (often CoderException for null)","Filter/normalize null or unsupported elements before they reach keyed or side-input paths","Use a coder that supports the values (e.g. NullableCoder) or override structuralValue in a custom coder","Fix upstream data so all elements are encodable"],"exampleFix":"// before\nKV