Known Issues

Known Issues

This page summarizes the repository's doc/issues.md as of the checked-out source.

Summary

Severity	Open
Critical	0
Major	1
Moderate	2
Minor	1

Major

Missing Comparator Context Parameter Methods

Several binding classes have incomplete comparator method overload coverage.

Current repository notes:

• PrimaryKey.java: new comparingInSpecifiedOrder(UnaryOperator, Comparator) method was added.
• Procedure.java: new comparingInSpecifiedOrder(UnaryOperator, Comparator) method was added.
• BestRowIdentifier.java: no change was needed because ordering is by SCOPE, an Integer, not a string.

Expected pattern:

static Comparator<T> comparingInSpecifiedOrder(
        Context context,
        Comparator<? super String> comparator
)

The source now broadly uses context-aware comparator factories and ContextUtils.withDatabaseNullOrdering(...). Treat this issue as partly historical until doc/issues.md is refreshed against the current comparator surface.

Moderate

Transient Fields Without _ColumnLabel In SuperTable

SuperTable has transient cache fields without _ColumnLabel annotations:

private transient Catalog tableCatalog_;
private transient Schema tableSchema_;
private transient Catalog supertableCatalog_;
private transient Schema supertableSchema_;

These appear to be cache fields rather than result-set columns. The repository note recommends either documenting the exception or annotating appropriately.

Missing Jakarta Validation Sections

Some binding classes with nullable fields lack consistent Jakarta Validation section headers or validation methods. The current working tree has added plain predicate methods and tests for Attribute, Column, IndexInfo, and VersionColumn; those predicates are intentionally Bean-Validation-free.

Affected files listed in the repository note:

• Catalog.java
• Schema.java
• PrimaryKey.java
• Table.java
• UDT.java

Minor

Historical UDT Parent Annotation Note

The issues document notes a commented-out self-referencing parent relationship for UDT and recommends either implementing it properly or removing the stale comment. In the currently checked source, UDT is annotated as a child of Schema and Catalog, and as a parent of SuperType and Attribute.

Maintenance Note

This page follows ../database-metadata-bind/doc/issues.md, whose header date is 2026-02-04. Some listed items appear partly addressed in the current source tree; reconcile this page after the repository issue analysis document is regenerated.