[CXF-8112] Default WebApplicationExceptionMapper is preferred over custom one but Documentation states opposite

• Type: Bug
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 3.3.3
• Component/s: Documentation
• Estimated Complexity: Unknown
• Assignee: Freeman Yue Fang
• Reporter: Daniel H. Peger
• Created: 11/Sep/19 08:51
• Updated: 18/Sep/23 18:50
• Resolved: 13/Sep/19 15:19

Description

The documentation on customizing the exception mapping in JAX-RS mentions that custom mappers will be preferred over the default WebApplicationExceptionMapper:

Note that the custom WebApplicationException mapper, if registered, will be preferred to the default one.

See https://cxf.apache.org/docs/jax-rs-basics.html#JAX-RSBasics-CustomizingdefaultWebApplicationExceptionmapper

Lately I noticed that after upgrading CXF this is not true anymore for exception mappers that handle all kind of exceptions like ExceptionMapper<Throwable>.

In CXF-6568 it is mentioned that a new property (actual property name seems to be default.wae.mapper.least.specific) was introduced to restore the previous behavior. I think this property should be mentioned on the JAX-RS basics page, as I didn't find any other resource pointing to this possibility.