@ConsumerType public interface Preprocessor extends javax.servlet.Filter
Preprocessorusing a whiteboard pattern are executed for every request before the dispatching is performed.
If there are several services of this type, they are run in order of their service ranking, the one with the highest ranking is used first. In the case of a service ranking tie, the service with the lowest service id is processed first.
The preprocessor is handled in the same way as filters. When a preprocessor
is put into service
called, when it is not used anymore
Filter.destroy() is called. As
these preprocessors are run before dispatching and therefore the targeted
servlet context is not known yet,
FilterConfig.getServletContext() returns the servlet
context of the backing implementation. The same context is returned by the
request object. The context path is the context path of this underlying
servlet context. The passed in chain can be used to invoke the next
preprocessor in the chain, or if the end of that chain is reached to start
dispatching of the request. A preprocessor might decide to terminate the
processing and directly generate a response.
Service properties with the prefix
are passed as init parameters to this service.