JDK-8318838 : Update CatalogFeatures with CatalogResolver.NotFoundAction
  • Type: CSR
  • Component: xml
  • Sub-Component: jaxp
  • Priority: P4
  • Status: Draft
  • Resolution: Unresolved
  • Submitted: 2023-10-25
  • Updated: 2023-10-25
Related Reports
CSR :  
Description
Summary
-------

Update the description of the RESOLVE property in CatalogFeatures to be associated with the action type defined as CatalogResolver.NotFoundAction.

Problem
-------

The RESOLVE property defined in CatalogFeatures has three case-sensitive values: "continue", "ignore", and "strict". With the addition of the action type `CatalogResolver.NotFoundAction` (see specification in JDK-8316997), it is desirable to document the fact that the RESOLVE property is mapped to the action type and its value can be set with the action type's string form.

Solution
--------

Amend the specification for the RESOLVE property with statements to describe the relationship with the action type 'CatalogResolver.NotFoundAction'.

Specification
-------------

In CatalogFeatures, class description

      * <tr>
      * <th rowspan="3" scope="row" style="font-weight:normal" id="RESOLVE">RESOLVE</th>
      * <td rowspan="3">Determines the action if there is no matching entry found after
      * all of the specified catalogs are exhausted. The default is strict.
    + * <p>
    + * This property is mapped to the {@link CatalogResolver.NotFoundAction action}
    + * type. The value equals to the string form returned by the action type's toString()
    + * method.
      * </td>