src/org/ohmage/query/ISurveyResponseQueries.java
int retrieveSurveyResponses(
			final Campaign campaign,
			final String username,
			final Set<UUID> surveyResponseIds,
			final Collection<String> usernames,
			final DateTime startDate,
			final DateTime endDate,
			final SurveyResponse.PrivacyState privacyState,
			final Collection<String> surveyIds,
			final Collection<String> promptIds,
			final String promptType,
			final Set<String> promptResponseSearchTokens,
			final Collection<ColumnKey> columns, 
			final List<SortParameter> sortOrder,
			final long surveyResponsesToSkip,
			final long surveyResponsesToProcess,
			List<SurveyResponse> result) 
			throws DataAccessException;
/**
	 * Retrieves the information about survey responses that match the given
	 * criteria. The criteria is based on the parameters. All parameters are
	 * optional except the campaign, and a null parameter is the equivalent to
	 * an omitted parameter. If all parameters are null, except the campaign,
	 * then all of the information about all of the survey responses will be
	 * returned for that campaign.
	 * 
	 * @param campaign The campaign to which the survey responses must belong.
	 * 
	 * @param username The username of the user that is making this request.
	 * 				   This is used by the ACLs to limit who sees what.
	 * 
	 * @param surveyResponseIds A set of survey response unique identifiers 
	 * 							limiting the results to only those survey
	 * 							responses whose IDs are in this list.
	 * 
	 * @param usernames Limits the results to only those submitted by any one 
	 * 					of the users in the list.
	 * 
	 * @param startDate Limits the results to only those survey responses that
	 * 					occurred on or after this date.
	 * 
	 * @param endDate Limits the results to only those survey responses that
	 * 				  occurred on or before this date.
	 * 
	 * @param privacyState Limits the results to only those survey responses
	 * 					   with this privacy state.
	 * 
	 * @param surveyIds Limits the results to only those survey responses that 
	 * 					were derived from a survey in this collection.
	 * 
	 * @param promptIds Limits the results to only those survey responses that 
	 * 					were derived from a prompt in this collection.
	 * 
	 * @param promptType Limits the results to only those survey responses that
	 * 					 are of the given prompt type.
	 * 
	 * @param surveyResponseSearchTokens The set of tokens to use against the
	 * 									 prompt response values.
	 * 
	 * @param columns Aggregates the data based on the column keys. If this is
	 * 				  null, no aggregation is performed. If the list is empty,
	 * 				  an empty list is returned.
	 * 
	 * @param sortOrder The order in which to sort the responses.
	 * 
	 * @param surveyResponsesToSkip The number of survey responses to skip once
	 * 								the result has been aggregated from the 
	 * 								server.
	 * 
	 * @param surveyResponsesToProcess The number of survey responses to 
	 * 								   analyze once the survey responses to 
	 * 								   skip have been skipped.
	 * 
	 * @param result A list of SurveyResponse objects, probably empty, to add
	 * 				 the results of this query to.
	 * 
	 * @return The total number of results that matched the given criteria, not
	 * 		   the number that were added to result. In order to get that 
	 * 		   number, simply subtract 'result's length after this to call to
	 * 		   its length before this call.
	 *  
	 * @throws DataAccessException Thrown if there is an error. 
	 */
Retrieves the information about survey responses that match the given
criteria. The criteria is based on the parameters. All parameters are
optional except the campaign, and a null parameter is the equivalent to
an omitted parameter. If all parameters are null, except the campaign,
then all of the information about all of the survey responses will be
returned for that campaign.

@param campaign The campaign to which the survey responses must belong.

@param username The username of the user that is making this request.
This is used by the ACLs to limit who sees what.

@param surveyResponseIds A set of survey response unique identifiers
limiting the results to only those survey
responses whose IDs are in this list.

@param usernames Limits the results to only those submitted by any one
of the users in the list.

@param startDate Limits the results to only those survey responses that
occurred on or after this date.

@param endDate Limits the results to only those survey responses that
occurred on or before this date.

@param privacyState Limits the results to only those survey responses
with this privacy state.

@param surveyIds Limits the results to only those survey responses that
were derived from a survey in this collection.

@param promptIds Limits the results to only those survey responses that
were derived from a prompt in this collection.

@param promptType Limits the results to only those survey responses that
are of the given prompt type.

@param surveyResponseSearchTokens The set of tokens to use against the
prompt response values.

@param columns Aggregates the data based on the column keys. If this is
null, no aggregation is performed. If the list is empty,
an empty list is returned.

@param sortOrder The order in which to sort the responses.

@param surveyResponsesToSkip The number of survey responses to skip once
the result has been aggregated from the
server.

@param surveyResponsesToProcess The number of survey responses to
analyze once the survey responses to
skip have been skipped.

@param result A list of SurveyResponse objects, probably empty, to add
the results of this query to.

@return The total number of results that matched the given criteria, not
the number that were added to result. In order to get that
number, simply subtract 'result's length after this to call to
its length before this call.

@throws DataAccessException Thrown if there is an error.
Retrieves the information about survey responses that match the given criteria . The criteria is based on the parameters . All parameters are optional except the campaign and a null parameter is the equivalent to an omitted parameter . If all parameters are null except the campaign then all of the information about all of the survey responses will be returned for that campaign . @param campaign The campaign to which the survey responses must belong . @param username The username of the user that is making this request . This is used by the ACLs to limit who sees what . @param surveyResponseIds A set of survey response unique identifiers limiting the results to only those survey responses whose IDs are in this list . @param usernames Limits the results to only those submitted by any one of the users in the list . @param startDate Limits the results to only those survey responses that occurred on or after this date . @param endDate Limits the results to only those survey responses that occurred on or before this date . @param privacyState Limits the results to only those survey responses with this privacy state . @param surveyIds Limits the results to only those survey responses that were derived from a survey in this collection . @param promptIds Limits the results to only those survey responses that were derived from a prompt in this collection . @param promptType Limits the results to only those survey responses that are of the given prompt type . @param surveyResponseSearchTokens The set of tokens to use against the prompt response values . @param columns Aggregates the data based on the column keys . If this is null no aggregation is performed . If the list is empty an empty list is returned . @param sortOrder The order in which to sort the responses . @param surveyResponsesToSkip The number of survey responses to skip once the result has been aggregated from the server . @param surveyResponsesToProcess The number of survey responses to analyze once the survey responses to skip have been skipped . @param result A list of SurveyResponse objects probably empty to add the results of this query to . @return The total number of results that matched the given criteria not the number that were added to result . In order to get that number simply subtract ' result ' s length after this to call to its length before this call . @throws DataAccessException Thrown if there is an error .
int retrieveSurveyResponses(
			final Campaign campaign,
			final String username,
			final Set<UUID> surveyResponseIds,
			final Collection<String> usernames,
			final DateTime startDate,
			final DateTime endDate,
			final SurveyResponse.PrivacyState privacyState,
			final Collection<String> surveyIds,
			final Collection<String> promptIds,
			final String promptType,
			final Set<String> promptResponseSearchTokens,
			final Collection<ColumnKey> columns, 
			final List<SortParameter> sortOrder,
			final long surveyResponsesToSkip,
			final long surveyResponsesToProcess,
			List<SurveyResponse> result) 
			throws DataAccessException;
int retrieveSurveyResponses ( final Campaign campaign , final String username , final Set < UUID > surveyResponseIds , final Collection < String > usernames , final DateTime startDate , final DateTime endDate , final SurveyResponse . PrivacyState privacyState , final Collection < String > surveyIds , final Collection < String > promptIds , final String promptType , final Set < String > promptResponseSearchTokens , final Collection < ColumnKey > columns , final List < SortParameter > sortOrder , final long surveyResponsesToSkip , final long surveyResponsesToProcess , List < SurveyResponse > result ) throws DataAccessException ;
Retrieves the information about survey responses that match the given
 criteria.
Retrieves the information about survey responses that match the given criteria .