com.prosysopc.ua.stack.application

Interface SessionChannel.RequestValidator

Enclosing class:

SessionChannel

public static interface SessionChannel.RequestValidator

An optional listener, that can be set to the channel and allows modifying and rejecting ServiceRequests sent to this channel. Important! This interface and methods for it is only designed to be used by the SDK internally, meaning these and their functionality and existence can change at will.

Method Summary

Modifier and Type	Method and Description
<T extends ServiceResponse> void	validateServiceRequest(SessionChannel channel, ServiceRequest<T> request) If attached to a SessionChannel, this method is called before the request is delegated to underlying secure channel and allows modification of the request or prevention it's delegation (by throwing the ServiceResultException).

Method Detail

validateServiceRequest

<T extends ServiceResponse> void validateServiceRequest(SessionChannel channel,
                                                        ServiceRequest<T> request)
                                                 throws ServiceResultException

If attached to a SessionChannel, this method is called before the request is delegated to underlying secure channel and allows modification of the request or prevention it's delegation (by throwing the ServiceResultException). IMPORTANT! The request given here is as-is before delegating it to the secure channel. This means the ServiceRequest.getRequestHeader() contains the correct authentication token needed. This should not be edited or if the entire request data is edited, the new data should contain the authentication token in the new RequestHeader, if one is made.

Throws:

ServiceResultException - Throw this to prevent the request going to the underlying secure channel, the caller of SessionChannel.serviceRequest(ServiceRequest) will get this as the thrown exception or the caller of SessionChannel.serviceRequestAsync(ServiceRequest) will find it from the returned AsyncResult.