Class VirtualListViewResponseControl

java.lang.Object
org.ldaptive.control.AbstractControl
org.ldaptive.control.VirtualListViewResponseControl
All Implemented Interfaces:
Control, ResponseControl

public class VirtualListViewResponseControl extends AbstractControl implements ResponseControl
Response control for virtual list view. See http://tools.ietf.org/html/draft-ietf-ldapext-ldapv3-vlv-09. Control is defined as:
   VirtualListViewResponse ::= SEQUENCE {
      targetPosition    INTEGER (0 .. maxInt),
      contentCount      INTEGER (0 .. maxInt),
      virtualListViewResult ENUMERATED {
         success (0),
         operationsError (1),
         protocolError (2),
         unwillingToPerform (53),
         insufficientAccessRights (50),
         timeLimitExceeded (3),
         adminLimitExceeded (11),
         innapropriateMatching (18),
         sortControlMissing (60),
         offsetRangeError (61),
         other(80),
         ... },
      contextID         OCTET STRING OPTIONAL }
 
  • Field Details

    • OID

      public static final String OID
      OID of this control.
      See Also:
    • HASH_CODE_SEED

      private static final int HASH_CODE_SEED
      hash code seed.
      See Also:
    • targetPosition

      private int targetPosition
      list offset for the target entry.
    • contentCount

      private int contentCount
      server's estimate of the current number of entries in the ordered search result set.
    • viewResult

      private ResultCode viewResult
      Result of the vlv operation.
    • contextID

      private byte[] contextID
      value that clients should send back to the server to indicate that the server is willing to return contiguous data from a subsequent search request which uses the same search criteria.
  • Constructor Details

    • VirtualListViewResponseControl

      public VirtualListViewResponseControl()
      Default constructor.
    • VirtualListViewResponseControl

      public VirtualListViewResponseControl(boolean critical)
      Creates a new virtual list view response control.
      Parameters:
      critical - whether this control is critical
    • VirtualListViewResponseControl

      public VirtualListViewResponseControl(int position, int count, ResultCode code, byte[] context)
      Creates a new virtual list view response control.
      Parameters:
      position - offset for the target entry
      count - server estimate of the number of entries
      code - operation result code
      context - server context id
    • VirtualListViewResponseControl

      public VirtualListViewResponseControl(int position, int count, ResultCode code, byte[] context, boolean critical)
      Creates a new virtual list view response control.
      Parameters:
      position - offset for the target entry
      count - server estimate of the number of entries
      code - operation result code
      context - server context id
      critical - whether this control is critical
  • Method Details

    • getTargetPosition

      public int getTargetPosition()
      Returns the target position. This indicates the list offset for the target entry.
      Returns:
      target position
    • setTargetPosition

      public void setTargetPosition(int position)
      Sets the target position.
      Parameters:
      position - target position
    • getContentCount

      public int getContentCount()
      Returns the content count. From the RFC:

      contentCount gives the server's estimate of the current number of entries in the list. Together these give sufficient information for the client to update a list box slider position to match the newly retrieved entries and identify the target entry. The contentCount value returned SHOULD be used in a subsequent VirtualListViewRequest control.

      Returns:
      content count
    • setContentCount

      public void setContentCount(int count)
      Sets the content count.
      Parameters:
      count - content count
    • getViewResult

      public ResultCode getViewResult()
      Returns the result code of the virtual list view.
      Returns:
      result code
    • setViewResult

      public void setViewResult(ResultCode code)
      Sets the result code of the virtual list view.
      Parameters:
      code - result code
    • getContextID

      public byte[] getContextID()
      Returns the context id. From the RFC:

      The contextID is a server-defined octet string. If present, the contents of the contextID field SHOULD be returned to the server by a client in a subsequent virtual list request. The presence of a contextID here indicates that the server is willing to return contiguous data from a subsequent search request which uses the same search criteria, accompanied by a VirtualListViewRequest which indicates that the client wishes to receive an adjoining page of data.

      Returns:
      context id
    • setContextID

      public void setContextID(byte[] id)
      Sets the context id.
      Parameters:
      id - context id
    • equals

      public boolean equals(Object o)
      Overrides:
      equals in class AbstractControl
    • hashCode

      public int hashCode()
      Description copied from class: AbstractControl
      Returns the hash code for this object.
      Specified by:
      hashCode in class AbstractControl
      Returns:
      hash code
    • toString

      public String toString()
      Overrides:
      toString in class AbstractControl
    • decode

      public void decode(DERBuffer encoded)
      Description copied from interface: ResponseControl
      Initializes this response control with the supplied BER encoded data.
      Specified by:
      decode in interface ResponseControl
      Parameters:
      encoded - BER encoded response control