[jax-rs-spec users] [jsr339-experts] Re: PLEASE REVIEW: Updated filtering API proposal

From: Bill Burke <>
Date: Fri, 06 Apr 2012 08:25:58 -0400

Isn't it

git checkout new-filter-api


git checkout -b new-filter-api origin/new-filter-api

There is no -t switch.

On 4/5/12 11:11 AM, Marek Potociar wrote:
> Hello experts,
> Please review the reworked filtering API proposal. To review, please
> checkout the remote branch:
> git clone ssh:///<user_name>/ jaxrs-api
> cd jaxrs-api
> git checkout -t new-filter-api origin/new-filter-api
> The API code is under src/jax-rs-api. Examples are under src/examples.
> The git commit history will help you to better see the actual changes.
> What has changed (quite a lot):
> * filtering API has been split into server (container) and client part.
> o client side: ClientRequestFilter, ClientRequestContext,
> ClientResponseFilter, ClientResponseContext
> o server side: ContainerRequestFilter, ContainerRequestContext,
> ContainerResponseFilter, ContainerResponseContext, ResourceFilter
> o Response remains a common component (went through some
> modifications though - see bellow)
> * Container filters are by default pre-matching
> o There is a new @PostMatching name-binding annotation to support
> global resource (post-matching) filters and interceptors
> o DynamicBinding interface has been refactored into DynamicBinder
> provider interface and javadoc has been clarified.
> * Request changes have been rolled back - removed RequestHeaders,
> RequestBuilder & Request API methods.
> * Some of the removed methods were added to the filter context interfaces
> * ResponseHeaders has been removed, Response API has been updated to
> support common use cases and some of the ResponseHeaders methods
> * Client API has been updated to accommodate the Req/Resp API changes.
> * Examples have been updated to use the new filtering API. (Positive
> fact is that in all cases the use of the new API meant less code in
> the example filter implementation code.)
> Other changes:
> * MessageProcessingException has been moved from core into root package
> * Client-side Target has been renamed to WebTarget to avoid a name
> clash with java.lang.annotation.Target from Java SE.
> Looking forward to your feedback. If possible, we would like to put the
> proposal into the next EDR that is planned for 4/20, so please, make
> sure to send your feedback by Friday next week CoB (4/13).
> Thank you,
> Marek

Bill Burke
JBoss, a division of Red Hat