fr.ifremer.adagio.core.dao

Class Search

Object

Search

All Implemented Interfaces:

Serializable

public class Search
extends Object
implements Serializable

Stores the information necessary to perform a property search.

See Also:

PropertySearch, Serialized Form

Constructor Summary

Constructors

Constructor and Description
Search() Constructs the search object with no parameters.
Search(SearchParameter[] parametersIn) Constructs the search object.
Search(SearchParameter[] parametersIn, boolean eagerFetchingIn) Constructs the search object.
Search(SearchParameter[] parametersIn, int pageNumberIn, int pageSizeIn) Constructs the search object.
Search(SearchParameter[] parametersIn, int pageNumberIn, int pageSizeIn, boolean eagerFetchingIn) Constructs the search object.

Method Summary

Methods

Modifier and Type	Method and Description
Search	addOrderBy(String propertyName) Adds an "order by" clause for the search with default ascending order.
Search	addOrderBy(String propertyName, boolean descending) Adds an "order by" clause for the search.
Search	addOrderBy(String propertyName, int order) Adds an "order by" clause for the search.
Search	addSearchParameter(SearchParameter searchParameter) Adds a search parameter to the search.
int	getPageNumber() Gets the page number (if paging the results).
int	getPageSize() Gets the size of the page (if paging the results).
SearchParameter[]	getParameters() Gets the search parameters for this search object..
boolean	isEagerFetching() Whether or not eager fetching is enabled (if it is enabled, all associations queried will be fetched eagerly).
boolean	isUseSqlLimiting() Whether or not to use sql limiting (if paging is being used).
Search	setEagerFetching(boolean eagerFetchingIn) Sets whether or not eager fetching is enabled (if it is enabled, all associations queried will be fetched eagerly).
Search	setPageNumber(int pageNumberIn) Sets the page number (if paging the results).
Search	setPageSize(int pageSizeIn) Sets the size of the page (if paging the results).
Search	setParameters(SearchParameter[] parametersIn) Sets the search parameters for this search object.
Search	setUseSqlLimiting(boolean useSqlPaging) Sets whether or not to use sql limiting (if paging is being used).

Methods inherited from class Object

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

Constructor Detail

Search

public Search(SearchParameter[] parametersIn,
      int pageNumberIn,
      int pageSizeIn,
      boolean eagerFetchingIn)

Constructs the search object.

Parameters:

parametersIn - the parameters to use.

pageNumberIn - the page number (if paging results).

pageSizeIn - the page size (if paging results).

eagerFetchingIn - whether or not the search will eagerly fetch the associations included in the search.

Search

public Search(SearchParameter[] parametersIn,
      int pageNumberIn,
      int pageSizeIn)

Constructs the search object.

Parameters:

parametersIn - the parameters to use.

pageNumberIn - the page number (if paging results).

pageSizeIn - the page size (if paging results).

Search

public Search(SearchParameter[] parametersIn)

Constructs the search object.

Parameters:

parametersIn - the parameters to use.

Search

public Search(SearchParameter[] parametersIn,
      boolean eagerFetchingIn)

Constructs the search object.

Parameters:

parametersIn - the parameters to use.

eagerFetchingIn - whether or not the search will eagerly fetch the associations included in the search.

Search

public Search()

Constructs the search object with no parameters.

Method Detail

getPageNumber

public int getPageNumber()

Gets the page number (if paging the results).

Returns:

the page number.

setPageNumber

public Search setPageNumber(int pageNumberIn)

Sets the page number (if paging the results).

Parameters:

pageNumberIn - the page number (if paging results).

Returns:

the current search instance.

getPageSize

public int getPageSize()

Gets the size of the page (if paging the results).

Returns:

the page size.

setPageSize

public Search setPageSize(int pageSizeIn)

Sets the size of the page (if paging the results).

Parameters:

pageSizeIn - the page size.

Returns:

the current search instance.

getParameters

public SearchParameter[] getParameters()

Gets the search parameters for this search object..

Returns:

parameters.toArray(new SearchParameter[this.parameters.size()])

setParameters

public Search setParameters(SearchParameter[] parametersIn)

Sets the search parameters for this search object.

Parameters:

parametersIn -

Returns:

the current search instance (this).

addSearchParameter

public Search addSearchParameter(SearchParameter searchParameter)

Adds a search parameter to the search.

Parameters:

searchParameter - the search parameter to add.

Returns:

the current search instance.

isEagerFetching

public boolean isEagerFetching()

Whether or not eager fetching is enabled (if it is enabled, all associations queried will be fetched eagerly).

Returns:

true/false

setEagerFetching

public Search setEagerFetching(boolean eagerFetchingIn)

Sets whether or not eager fetching is enabled (if it is enabled, all associations queried will be fetched eagerly).

Parameters:

eagerFetchingIn - whether or not to eager fetch the results.

Returns:

the current search instance (this).

addOrderBy

public Search addOrderBy(String propertyName)

Adds an "order by" clause for the search with default ascending order.

Parameters:

propertyName - the property name to order by.

Returns:

the current search instance.

addOrderBy

public Search addOrderBy(String propertyName,
                int order)

Adds an "order by" clause for the search.

Parameters:

propertyName - the property name to order by.

order - the order. Use: SearchParameter.ORDER_ASC, SearchParameter.ORDER_DESC, or SearchParameter.ORDER_UNSET.

Returns:

the current search instance.

addOrderBy

public Search addOrderBy(String propertyName,
                boolean descending)

Adds an "order by" clause for the search.

Parameters:

propertyName - the property name to order by.

descending - true/false; true for descending ordering, false for ascending ordering.

Returns:

the current search instance.

isUseSqlLimiting

public boolean isUseSqlLimiting()

Whether or not to use sql limiting (if paging is being used). If this is set to false, then paging will be based on the actual entities returned instead of using SQL to limit the results.

Returns:

true/false

setUseSqlLimiting

public Search setUseSqlLimiting(boolean useSqlPaging)

Sets whether or not to use sql limiting (if paging is being used). If this is set to false, then paging will be based on the actual entities returned instead of using SQL to limit the results.

Parameters:

useSqlPaging - whether or not to use SQL paging (default is false).

Returns:

the current search instance.