Loading...

XML

Word

Printable

Subcomponent:
java.lang.foreign
Compatibility Kind:

behavioral
Compatibility Risk:
minimal
Compatibility Risk Description:
Most of the changes touched by this change are benign, in the sense that the spec changes remove exceptions that cannot occur. The change to MemoryLayout::equals is more substantial, although that's how the implementation was behaving anyway.
Interface Kind:

Java API
Scope:
SE

Summary

The specification for the memory layout API contains some issues that have accumulated as a result of API changes over the various incubation steps.

More in-depth testing revealed the following issues in the MemoryLayout API javadoc:

the MemoryLayout::equals contract is partially incorrect, as it does not take into account ValueLayout::carrier
SequenceLayout::reshape and SequenceLayout::flatten refer to an erroneous condition that can no longer happen given some simplifications in the API (e.g now all the layouts have a definite size)
ValueLayout::arrayElementVarHandle throws UOE if the alignment constraints are incorrect - but the javadoc text is unclear, and refers to the LayoutPath API which does not matter here.

csr of

JDK-8289558 Need spec clarification of j.l.foreign.*Layout