Uploaded image for project: 'CXF'
  1. CXF
  2. CXF-4722

JAX-RS documentation incorrect about phase of interceptors

    XMLWordPrintableJSON

    Details

    • Estimated Complexity:
      Novice

      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.

        Attachments

          Activity

            People

            • Assignee:
              sergey_beryozkin Sergey Beryozkin
              Reporter:
              yinzara Matthew Morrissette
            • Votes:
              0 Vote for this issue
              Watchers:
              2 Start watching this issue

              Dates

              • Created:
                Updated:
                Resolved:

                Time Tracking

                Estimated:
                Original Estimate - 10m
                10m
                Remaining:
                Remaining Estimate - 10m
                10m
                Logged:
                Time Spent - Not Specified
                Not Specified