| com.nabhinc.ws.server.Interceptor
All known Subclasses: com.nabhinc.ws.interceptor.security.UnloggedUserRedirector, com.nabhinc.ws.interceptor.security.SecureConnectionChecker, com.nabhinc.ws.interceptor.security.HTTPBasicAuthenticator, com.nabhinc.ws.interceptor.logging.FileLogger, com.nabhinc.ws.soap.SOAPMethodInvoker, com.nabhinc.ws.interceptor.security.PreconditionAccessController, com.nabhinc.ws.soap.SOAPMonitor,
| Interceptor | | public interface Interceptor extends ServerObject(Code) | | A component that intercepts a Web service request. Stringbeans
Web service framework allows the deployer to attach interceptors
globally, or on selective methods of specified Web services.
author:
Padmanabh Dabke
author:
(c) 2005 Nabh Information Systems, Inc. All Rights Reserved. |
| Method Summary | |
| void | intercept(RequestInfo reqInfo, InterceptorChain chain)
Invoked when the container receives a Web service method
invocation request that this interceptor is attached to.
The interceptor has access to service info, method, and
request arguments and can choose to modify that information.
After it's processing it done, the interceptor has three options:
-
Process
rest of the chain via
doIntercept method on
InterceptorChain supplied as an argument. |
| intercept | | void intercept(RequestInfo reqInfo, InterceptorChain chain) throws WebServiceException, InterceptorUnavailableException, IOException(Code) | | Invoked when the container receives a Web service method
invocation request that this interceptor is attached to.
The interceptor has access to service info, method, and
request arguments and can choose to modify that information.
After it's processing it done, the interceptor has three options:
-
Process
rest of the chain via
doIntercept method on
InterceptorChain supplied as an argument. In some
rare cases, an interceptor can also re-position the interceptor
invocation by invoking setCurrentPosition method
on InterceptorChain.
-
Set up the result and return without invoking the
rest of the chain
-
Set the
redirect attribute on RequestInfo
object and return, resulting in the request being redirected.
-
Throw
WebServiceException or
WebServiceSecurityException if the request cannot
be passed on to the next interceptor based on application logic
(for example, the use is not authenticated).
- Throw
InterceptorUnavailableException if there
is an internal error that prevents the interceptor from executing
its business logic. If this happens, the interceptor will be
unloaded. If it is marked critical, the current request will fail.
Otherwise the next interceptor will be called (or service method
is invoked if this was the last interceptor).
Parameters:
reqInfo - Object providing information about current request
Parameters:
chain - Interceptor chain
throws:
WebServiceException -
throws:
InterceptorUnavailableException - Thrown if the interceptorencounters an internal exception.
throws:
IOException - |
|
|