Package org.apache.cayenne.util

Class ListResponse

java.lang.Object
org.apache.cayenne.util.ListResponse
All Implemented Interfaces:
Serializable, QueryResponse
Direct Known Subclasses:
IncrementalListResponse
public class ListResponse extends Object implements QueryResponse, Serializable
A QueryResponse optimized to hold a single object or data row list.
Since:
1.2
See Also:

  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    protected int
    currentIndex
     
    protected List
    objectList
     

  • Constructor Summary

    Constructors
    Constructor
    Description
    ListResponse()
    Creates an empty response.
    ListResponse(Object object)
     
    ListResponse(List objectList)
     

  • Method Summary

    Modifier and Type
    Method
    Description
    List
    currentList()
    Returns a List under the current iterator position.
    int[]
    currentUpdateCount()
    Returns an update count under the current iterator position.
    List
    firstList()
    A utility method for quickly retrieving the first list in the response.
    int[]
    firstUpdateCount()
    A utility method for quickly retrieving the first update count from the response.
    boolean
    isList()
    Returns whether current iteration result is a list or an update count.
    boolean
    next()
    Rewinds response iterator to the next result, returning true if it is available.
    void
    reset()
    Restarts response iterator.
    int
    size()
    Returns a number of results in the response.

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

  • Field Details

    • objectList

      protected List objectList

    • currentIndex

      protected transient int currentIndex

  • Constructor Details

    • ListResponse

      public ListResponse()
      Creates an empty response.

    • ListResponse

      public ListResponse(Object object)

    • ListResponse

      public ListResponse(List objectList)

  • Method Details

    • size

      public int size()
      Description copied from interface: QueryResponse
      Returns a number of results in the response.
      Specified by:
      size in interface QueryResponse

    • isList

      public boolean isList()
      Description copied from interface: QueryResponse
      Returns whether current iteration result is a list or an update count.
      Specified by:
      isList in interface QueryResponse

    • currentList

      public List currentList()
      Description copied from interface: QueryResponse
      Returns a List under the current iterator position. Use QueryResponse.isList() to check the result type before calling this method.
      Specified by:
      currentList in interface QueryResponse

    • currentUpdateCount

      public int[] currentUpdateCount()
      Description copied from interface: QueryResponse
      Returns an update count under the current iterator position. Returned value is an int[] to accommodate batch queries. For a regular update result, the value will be an int[1]. Use QueryResponse.isList() to check the result type before calling this method.
      Specified by:
      currentUpdateCount in interface QueryResponse

    • next

      public boolean next()
      Description copied from interface: QueryResponse
      Rewinds response iterator to the next result, returning true if it is available.
      Specified by:
      next in interface QueryResponse

    • reset

      public void reset()
      Description copied from interface: QueryResponse
      Restarts response iterator.
      Specified by:
      reset in interface QueryResponse

    • firstList

      public List firstList()
      Description copied from interface: QueryResponse
      A utility method for quickly retrieving the first list in the response. Returns null if the query has no lists. Note that this method resets current iterator to an undefined state.
      Specified by:
      firstList in interface QueryResponse

    • firstUpdateCount

      public int[] firstUpdateCount()
      Description copied from interface: QueryResponse
      A utility method for quickly retrieving the first update count from the response. Note that this method resets current iterator to an undefined state.
      Specified by:
      firstUpdateCount in interface QueryResponse