org.kuali.rice.kim.api.identity.principal

Class PrincipalQueryResults

java.lang.Object

org.kuali.rice.core.api.mo.AbstractDataTransferObject

org.kuali.rice.kim.api.identity.principal.PrincipalQueryResults

All Implemented Interfaces:

Serializable, QueryResults<Principal>, ModelObjectBasic, ModelObjectComplete

public class PrincipalQueryResults
extends AbstractDataTransferObject
implements QueryResults<Principal>

Author:

Kuali Rice Team (rice.collab@kuali.org)

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	PrincipalQueryResults.Builder
static class	PrincipalQueryResults.Constants Defines some internal constants used on this class.
static class	PrincipalQueryResults.Elements A private class which exposes constants which define the XML element names to use when this object is marshaled to XML.

Method Summary

Methods

Modifier and Type	Method and Description
List<Principal>	getResults() Return the list of results that are contained within.
Integer	getTotalRowCount() Gets the total number of records that match the executed query.
boolean	isMoreResultsAvailable() Indicates if there are more results available for the query immediately following the last result that was returned.

Methods inherited from class org.kuali.rice.core.api.mo.AbstractDataTransferObject

afterUnmarshal, beforeUnmarshal, equals, equalsExcludeFields, getDefaultHashCodeEqualsExcludeFields, hashCode, hashCodeExcludeFields, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Method Detail

getResults

public List<Principal> getResults()

Description copied from interface: QueryResults

Return the list of results that are contained within. This list can be empty but it should never be null.

Specified by:

getResults in interface QueryResults<Principal>

Returns:

the list of results

getTotalRowCount

public Integer getTotalRowCount()

Description copied from interface: QueryResults

Gets the total number of records that match the executed query. Note that this number will not necessarily match the number of results returned by QueryResults.getResults() as the query may cut off the number of records returned by the actual query request. In these cases, the total row count represents the total number of results which would be returned by the query if there was no cap on the results returned (i.e. the equivalent of the result of a "count" query in SQL).

The total row count is optional depending on whether or not the client requested the total row count when invoking the query. The client requests this information by setting the CountFlag.INCLUDE or CountFlag.ONLY on the QueryByCriteria. It's also possible that the query is unable to produce a total row count depending on the back-end implementation, in which cases this value will also not be available.

Will never be less than 0.

Specified by:

getTotalRowCount in interface QueryResults<Principal>

Returns:

the total number of rows, or null if the total row count was not requested by the query or could not be determined

isMoreResultsAvailable

public boolean isMoreResultsAvailable()

Description copied from interface: QueryResults

Indicates if there are more results available for the query immediately following the last result that was returned. In this case, the records returned in QueryResults.getResults() will not include the complete result set for the query. This could be because the query only requested a certain number of rows, or that the query couldn't return the number of rows that were requested.

It is intended that this value be used to facilitate paging or reporting in the client in cases where that is desired.

This information will only be available if the client sets a limit on the results returned. This limit is set with the maxResults field on the QueryByCriteria.

Specified by:

isMoreResultsAvailable in interface QueryResults<Principal>

Returns:

true if there are more results available for the query, false otherwise