[CXF-4722] JAX-RS documentation incorrect about phase of interceptors

• Type: Bug
• Status: Closed
• Priority: Minor
• Resolution: Fixed
• Component/s: Documentation
• Labels: documentation interceptors jax-rs' phase
• Estimated Complexity: Novice
• Assignee: Sergey Beryozkin
• Reporter: Matthew Morrissette
• Created: 22/Dec/12 03:21
• Updated: 05/Dec/13 19:09
• Resolved: 27/Dec/12 16:16

Description

On the page:
http://cxf.apache.org/docs/jax-rs-filters.html

In the section:
Difference between JAX-RS filters and CXF interceptors

It notes that the JAXRSInInterceptor is tied to the Phase.PRE_STREAM phase. However this was changed in revision# 775241 in trunk on the 15th of May, 2009 to the Phase.UNMARSHAL phase with the comment:
JAX-RS : moving JAXRSInInterceptor to Phase.UNMARSHAL, support for relative URIs in ResponseBuilder.location

Which means for all version of JAX-RS v 2.2.2 or higher (2.2.2 was released shortly thereafter), it is in the UNMARSHAL phase and for previous versions, it's in the PRE_STREAM phase.

The JAXRSOutInterceptor is correctly listed as MARSHAL phase.

This caused me hours of confusion when writing custom interceptors.