Package org.gbif.api.model.common.search

Class FacetedSearchRequest<P extends SearchParameter>

java.lang.Object

org.gbif.api.model.common.paging.PageableBase

org.gbif.api.model.common.search.BaseSearchRequest<P>

org.gbif.api.model.common.search.FacetedSearchRequest<P>

All Implemented Interfaces:

Pageable, SearchRequest<P>

Direct Known Subclasses:

DatasetSearchRequest, EventSearchRequest, LiteratureSearchRequest, NameUsageSearchRequest, OccurrenceSearchRequest

public class FacetedSearchRequest<P extends SearchParameter>
extends BaseSearchRequest<P>

Generic request class for search operations requesting facets. It extends a search request with a list of desired facets and optional settings.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static @interface	FacetedSearchRequest.FacetParameters	Annotation to document the facet query parameters.

Nested classes/interfaces inherited from interface org.gbif.api.model.common.paging.Pageable

Pageable.OffsetLimitParameters

Nested classes/interfaces inherited from interface org.gbif.api.model.common.search.SearchRequest

SearchRequest.QueryField

Constructor Summary

Constructors

Constructor	Description
FacetedSearchRequest()
FacetedSearchRequest(long offset, int limit)
FacetedSearchRequest(Pageable page)
FacetedSearchRequest(BaseSearchRequest<P> searchRequest)

Method Summary

Modifier and Type	Method	Description
void	addFacetPage(P parameter, int facetOffset, int facetLimit)	Sets the paging setting of facet parameter.
void	addFacets(P... facets)
Integer	getFacetLimit()	Page size of the facet request.
Integer	getFacetMinCount()	Min count of facet to return, if the facet count is less than this number the facet won't be included.
Integer	getFacetOffset()	Offset of the facet request.
Pageable	getFacetPage(P parameter)	Gets the paging configuration of a facet parameter.
Map<P,Pageable>	getFacetPages()	Holds the paging configuration for each requested facet.
Set<P>	getFacets()	Gets the list of requested facets by the search operation.
boolean	isFacetMultiSelect()
void	setFacetLimit(Integer facetLimit)
void	setFacetMinCount(Integer facetMinCount)
void	setFacetMultiSelect(boolean facetMultiSelect)
void	setFacetOffset(Integer facetOffset)
void	setFacetPages(Map<P,Pageable> facetPages)
void	setFacets(Set<P> facets)	Sets the list of facets.

Methods inherited from class org.gbif.api.model.common.search.BaseSearchRequest

addParameter, addParameter, addParameter, addParameter, addParameter, addParameter, addParameter, addParameter, addParameter, addParameter, copyPagingValues, getHighlightFields, getParameters, getQ, getQFields, getSpellCheckCount, isHighlight, isMatchCase, isSpellCheck, setHighlight, setHighlightFields, setParameters, setQ, setQFields, setSpellCheck, setSpellCheckCount, toString

Methods inherited from class org.gbif.api.model.common.paging.PageableBase

addOffset, equals, getLimit, getOffset, hashCode, setLimit, setOffset

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.gbif.api.model.common.paging.Pageable

getLimit, getOffset

Constructor Details

FacetedSearchRequest

public FacetedSearchRequest()

FacetedSearchRequest

public FacetedSearchRequest(Pageable page)

FacetedSearchRequest

public FacetedSearchRequest(BaseSearchRequest<P> searchRequest)

FacetedSearchRequest

public FacetedSearchRequest(long offset,
 int limit)

Method Details

getFacetMinCount

public Integer getFacetMinCount()

Min count of facet to return, if the facet count is less than this number the facet won't be included.

setFacetMinCount

public void setFacetMinCount(Integer facetMinCount)

getFacets

public Set<P> getFacets()

Gets the list of requested facets by the search operation. The facets are a list of search parameters.

setFacets

public void setFacets(Set<P> facets)

Sets the list of facets.

isFacetMultiSelect

public boolean isFacetMultiSelect()

Returns:

the facetMultiSelect

setFacetMultiSelect

public void setFacetMultiSelect(boolean facetMultiSelect)

Parameters:

facetMultiSelect - the facetMultiSelect to set

getFacetLimit

public Integer getFacetLimit()

Page size of the facet request.

setFacetLimit

public void setFacetLimit(Integer facetLimit)

getFacetPages

public Map<P,Pageable> getFacetPages()

Holds the paging configuration for each requested facet.

setFacetPages

public void setFacetPages(Map<P,Pageable> facetPages)

addFacetPage

public void addFacetPage(P parameter,
 int facetOffset,
 int facetLimit)

Sets the paging setting of facet parameter.

getFacetPage

public Pageable getFacetPage(P parameter)

Gets the paging configuration of a facet parameter.

getFacetOffset

public Integer getFacetOffset()

Offset of the facet request.

setFacetOffset

public void setFacetOffset(Integer facetOffset)

addFacets

public void addFacets(P... facets)