com.unboundid.ldap.listener.interceptor
Interface InMemoryInterceptedRequest

All Known Subinterfaces:
InMemoryInterceptedAddRequest, InMemoryInterceptedCompareRequest, InMemoryInterceptedDeleteRequest, InMemoryInterceptedExtendedRequest, InMemoryInterceptedModifyDNRequest, InMemoryInterceptedModifyRequest, InMemoryInterceptedSASLBindRequest, InMemoryInterceptedSearchRequest, InMemoryInterceptedSimpleBindRequest

@NotExtensible
@ThreadSafety(level=INTERFACE_NOT_THREADSAFE)
public interface InMemoryInterceptedRequest

This class provides an API that can be used in the course of processing a request via the InMemoryOperationInterceptor API.


Method Summary
 java.lang.String getConnectedAddress()
          Retrieves the server address to which the client is connected, if available.
 int getConnectedPort()
          Retrieves the server port to which the client is connected, if available.
 long getConnectionID()
          Retrieves the connection ID for the associated client connection.
 int getMessageID()
          Retrieves the LDAP message ID for this operation.
 java.lang.Object getProperty(java.lang.String name)
          Retrieves the value for a property that has previously been set for this operation.
 void sendIntermediateResponse(IntermediateResponse intermediateResponse)
          Sends the provided intermediate response message to the client.
 void sendUnsolicitedNotification(ExtendedResult unsolicitedNotification)
          Sends an unsolicited notification message to the client.
 java.lang.Object setProperty(java.lang.String name, java.lang.Object value)
          Sets the value for a property that may be used to help maintain state information across the request and response for an operation.
 

Method Detail

getConnectionID

long getConnectionID()
Retrieves the connection ID for the associated client connection.

Returns:
The connection ID for the associated client connection.

getConnectedAddress

java.lang.String getConnectedAddress()
Retrieves the server address to which the client is connected, if available.

Returns:
The server address to which the client is connected, or null if this is not available for some reason.

getConnectedPort

int getConnectedPort()
Retrieves the server port to which the client is connected, if available.

Returns:
The server port to which the client is connected, or -1 if this is not available for some reason.

getMessageID

int getMessageID()
Retrieves the LDAP message ID for this operation.

Returns:
The LDAP message ID for this operation.

sendIntermediateResponse

void sendIntermediateResponse(IntermediateResponse intermediateResponse)
                              throws LDAPException
Sends the provided intermediate response message to the client. It will be processed by the InMemoryOperationInterceptor.processIntermediateResponse(com.unboundid.ldap.listener.interceptor.InMemoryInterceptedIntermediateResponse) method of all registered operation interceptors.

Parameters:
intermediateResponse - The intermediate response to send to the client. It must not be null.
Throws:
LDAPException - If a problem is encountered while trying to send the intermediate response.

sendUnsolicitedNotification

void sendUnsolicitedNotification(ExtendedResult unsolicitedNotification)
                                 throws LDAPException
Sends an unsolicited notification message to the client.

Parameters:
unsolicitedNotification - The unsolicited notification to send to the client. It must not be null.
Throws:
LDAPException - If a problem is encountered while trying to send the unsolicited notification.

getProperty

java.lang.Object getProperty(java.lang.String name)
Retrieves the value for a property that has previously been set for this operation. This can be used to help maintain state information across the request and response for an operation.

Parameters:
name - The name of the property for which to retrieve the corresponding value. It must not be null.
Returns:
The value for the requested property, or null if there is no value for the specified property.

setProperty

java.lang.Object setProperty(java.lang.String name,
                             java.lang.Object value)
Sets the value for a property that may be used to help maintain state information across the request and response for an operation.

Parameters:
name - The name of the property to set. It must not be null.
value - The value to use for the property. If it is null, then any value previously set will be removed.
Returns:
The value held for the property before this method was invoked, or null if it did not previously have a value.