org.idoox.wasp.interceptor
Interface TransportInterceptor

All Superinterfaces:

Interceptor

All Known Implementing Classes:

IPFilterInterceptor

public interface TransportInterceptor

extends Interceptor

This is the interface of the transport interceptor. A transport interceptor is a stateless class implementing this interface.

Transport interceptors are at the lowest level of message processing. They accept a raw transport message as their input, modify it and return a transport message as an output. This level has no notion of XML or higher level protocols, so it is able to, for example, convert non-XML protocols into XML protocols and vice versa.

In WSO2 SOA Enablement Server, interceptors are used for example in these ways:

• dumping messages into the debug console

• computing message statistics, such as average message length

• performing authentication

• transforming the incoming message via XSLT

Transport interceptors can be configured either via Runtime Publishing API org.systinet.wasp.webservice.Interceptors interface or in the deployment desciptor in the case of persistantly deployed services.

Since:

4.0

Component:

Core

Method Summary

void	intercept(Connection connection, InterceptorChain chain, int position) Intercepts a connection.

Methods inherited from interface org.idoox.wasp.interceptor.Interceptor

destroy, load

Method Detail

intercept

public void intercept(Connection connection,
                      InterceptorChain chain,
                      int position)
               throws StopProcessingException,
                      java.io.IOException

Intercepts a connection. inputMessage and outputMessage in a connection can be null if this interceptor isn't in given interceptor chain direction.

Parameters:

connection - a connection to be intercepted

chain - a chain where the interceptor is

position - a position of the interceptor in the chain

Throws:

StopProcessingException - when connection processing have to be stopped without error

java.io.IOException - when I/O error occurs - connection processing is stopped with error message