javax.ws.rs.ext
Interface WriterInterceptor

public interface WriterInterceptor

Interface for message body writer interceptors that wrap around calls to MessageBodyWriter.writeTo(T, java.lang.Class, java.lang.reflect.Type, java.lang.annotation.Annotation[], javax.ws.rs.core.MediaType, javax.ws.rs.core.MultivaluedMap, java.io.OutputStream). Message body interceptors implementing this interface must be annotated with @Provider to be discovered by the JAX-RS runtime. Message body interceptor instances may also be discovered and bound dynamically to particular resource methods.

Since:

2.0

Author:

Santiago Pericas-Geertsen, Bill Burke, Marek Potociar (marek.potociar at oracle.com)

See Also:

MessageBodyWriter

Method Summary

void	aroundWriteTo(WriterInterceptorContext context) Interceptor method wrapping calls to MessageBodyWriter.writeTo(T, java.lang.Class, java.lang.reflect.Type, java.lang.annotation.Annotation[], javax.ws.rs.core.MediaType, javax.ws.rs.core.MultivaluedMap, java.io.OutputStream).

Method Detail

aroundWriteTo

void aroundWriteTo(WriterInterceptorContext context)
                   throws java.io.IOException,
                          WebApplicationException

Interceptor method wrapping calls to MessageBodyWriter.writeTo(T, java.lang.Class, java.lang.reflect.Type, java.lang.annotation.Annotation[], javax.ws.rs.core.MediaType, javax.ws.rs.core.MultivaluedMap, java.io.OutputStream). The parameters of the wrapped method called are available from context. Implementations of this method SHOULD explicitly call WriterInterceptorContext.proceed() to invoke the next interceptor in the chain, and ultimately the wrapped method.

Parameters:

context - invocation context.

Throws:

java.io.IOException - if an IO error arises.

WebApplicationException - thrown by wrapped method.