Package org.opencms.jsp.search.config

Class CmsSearchConfigurationFacet

java.lang.Object

org.opencms.jsp.search.config.CmsSearchConfigurationFacet

All Implemented Interfaces:

I_CmsSearchConfigurationFacet

Direct Known Subclasses:

CmsSearchConfigurationFacetField, CmsSearchConfigurationFacetQuery, CmsSearchConfigurationFacetRange

public class CmsSearchConfigurationFacet
extends Object
implements I_CmsSearchConfigurationFacet

Configuration that is common for all facets. Used as base class for special facet configurations, e.g. for the field facet configuration.

Nested Class Summary

Nested classes/interfaces inherited from interface org.opencms.jsp.search.config.I_CmsSearchConfigurationFacet

I_CmsSearchConfigurationFacet.SortOrder

Field Summary

Fields

Modifier and Type	Field	Description
protected Set<String>	m_explicitExcludeTags	Tags of filter-queries that should not be applied to the facet, explicitly configured.
protected boolean	m_ignoreFacetFilters	A flag, indicating if checked entries from other facets should influence the facet or not.
protected Set<String>	m_ignoreTags	Tags of filter-queries that should not be applied to the facet.
protected boolean	m_isAndFacet	A flag, indicating if facet filter queries should be concatenated by AND.
protected String	m_label	A label that can be displayed in the form, e.g., at top of the facet.
protected Integer	m_minCount	The minimal number of hits required to add an entry to a facet.
protected String	m_name	A name used to identify the facet when showing it in the search form.
protected List<String>	m_preselection	The sorting of facet entries.

Constructor Summary

Constructors

Constructor	Description
CmsSearchConfigurationFacet(Integer minCount, String label, String name, Boolean isAndFacet, List<String> preselection, Boolean ignoreFiltersFromFacets, Collection<String> excludeTags)	The constructor setting all configuration options.

Method Summary

Modifier and Type	Method	Description
boolean	getIgnoreAllFacetFilters()	Returns true if the filters of all facets are not applied when calculating the facet items.
String	getIgnoreMaxParamKey()	Returns the facet specific request parameter used to send the information if the maximum number of facet entries should be ignored.
String	getIgnoreTags()	Returns the tags of other facets, for which the filters from this facet should be ignored.
boolean	getIsAndFacet()	Returns true if the facet filters, such that only documents with all checked facet entries appear, otherwise false.
String	getLabel()	Returns the label that is intended to be displayed over the facet's entries.
Integer	getMinCount()	Returns the minimal number of hits necessary to show a facet entry.
String	getName()	Returns the name used to identify the facet.
String	getParamKey()	Returns the facet specific request parameter used to send the checked facet entries.
List<String>	getPreSelection()	A list of facet-entries that should be preselected, if the search form is rendered the first time.
void	propagateAllFacetNames(Collection<String> names)	Propagate the names of the other facets that are configured.

Methods inherited from class java.lang.Object

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

Field Details

m_minCount

protected Integer m_minCount

The minimal number of hits required to add an entry to a facet.

m_name

protected String m_name

A name used to identify the facet when showing it in the search form.

m_label

protected String m_label

A label that can be displayed in the form, e.g., at top of the facet.

m_preselection

protected List<String> m_preselection

The sorting of facet entries.

m_isAndFacet

protected boolean m_isAndFacet

A flag, indicating if facet filter queries should be concatenated by AND.

m_ignoreFacetFilters

protected boolean m_ignoreFacetFilters

A flag, indicating if checked entries from other facets should influence the facet or not.

m_ignoreTags

protected Set<String> m_ignoreTags

Tags of filter-queries that should not be applied to the facet.

m_explicitExcludeTags

protected Set<String> m_explicitExcludeTags

Tags of filter-queries that should not be applied to the facet, explicitly configured.

Constructor Details

CmsSearchConfigurationFacet

public CmsSearchConfigurationFacet(Integer minCount,
 String label,
 String name,
 Boolean isAndFacet,
 List<String> preselection,
 Boolean ignoreFiltersFromFacets,
 Collection<String> excludeTags)

The constructor setting all configuration options.

Parameters:

minCount - The minimal number of hits required to add an entry to a facet.

label - A label that can be displayed in the form, e.g., at top of the facet.

name - An optional name for the facet

isAndFacet - If set to true, the facets filters for results containing all checked entries. Otherwise it filters for results containing at least one checked entry.

preselection - A list with entries that should be preselected in the facet, when the search page is called the first time.

ignoreFiltersFromFacets - A flag, indicating if filters from other facets should be ignored or not.

excludeTags - The tags (keys) of (filter) queries to be not taken into account for the facet. If "ignoreFiltersFromFacets" is true, the according tags for facets and queries will be added.

Method Details

getIgnoreAllFacetFilters

public boolean getIgnoreAllFacetFilters()

Description copied from interface: I_CmsSearchConfigurationFacet

Returns true if the filters of all facets are not applied when calculating the facet items. Otherwise returns false.

Specified by:

getIgnoreAllFacetFilters in interface I_CmsSearchConfigurationFacet

Returns:

A flag, indicating if the filters of facet's should be ignored or not.

See Also:

• I_CmsSearchConfigurationFacet.getIgnoreAllFacetFilters()

getIgnoreMaxParamKey

public String getIgnoreMaxParamKey()

Description copied from interface: I_CmsSearchConfigurationFacet

Returns the facet specific request parameter used to send the information if the maximum number of facet entries should be ignored.

Specified by:

getIgnoreMaxParamKey in interface I_CmsSearchConfigurationFacet

Returns:

The facet specific request parameter used to send the information if the maximum number of facet entries should be ignored.

See Also:

• I_CmsSearchConfigurationFacet.getIgnoreMaxParamKey()

getIgnoreTags

public String getIgnoreTags()

Description copied from interface: I_CmsSearchConfigurationFacet

Returns the tags of other facets, for which the filters from this facet should be ignored.

Specified by:

getIgnoreTags in interface I_CmsSearchConfigurationFacet

Returns:

the tags of other facets, for which the filters from this facet should be ignored.

See Also:

• I_CmsSearchConfigurationFacet.getIgnoreTags()

getIsAndFacet

public boolean getIsAndFacet()

Description copied from interface: I_CmsSearchConfigurationFacet

Returns true if the facet filters, such that only documents with all checked facet entries appear, otherwise false.

Specified by:

getIsAndFacet in interface I_CmsSearchConfigurationFacet

Returns:

A flag, indicating if the facet's filters are concatenated by AND (or OR).

See Also:

• I_CmsSearchConfigurationFacet.getIsAndFacet()

getLabel

public String getLabel()

Description copied from interface: I_CmsSearchConfigurationFacet

Returns the label that is intended to be displayed over the facet's entries.

Specified by:

getLabel in interface I_CmsSearchConfigurationFacet

Returns:

The label that is intended to be displayed over the facet's entries.

See Also:

• I_CmsSearchConfigurationFacet.getLabel()

getMinCount

public Integer getMinCount()

Description copied from interface: I_CmsSearchConfigurationFacet

Returns the minimal number of hits necessary to show a facet entry.

Specified by:

getMinCount in interface I_CmsSearchConfigurationFacet

Returns:

The minimal number of hits necessary to show a facet entry. (Solr: facet.mincount)

See Also:

• I_CmsSearchConfigurationFacet.getMinCount()

getName

public String getName()

Description copied from interface: I_CmsSearchConfigurationFacet

Returns the name used to identify the facet.

Specified by:

getName in interface I_CmsSearchConfigurationFacet

Returns:

The name used to identify the facet.

See Also:

• I_CmsSearchConfigurationFacet.getName()

getParamKey

public String getParamKey()

Description copied from interface: I_CmsSearchConfigurationFacet

Returns the facet specific request parameter used to send the checked facet entries.

Specified by:

getParamKey in interface I_CmsSearchConfigurationFacet

Returns:

The facet specific request parameter used to send the checked facet entries.

See Also:

• I_CmsSearchConfigurationFacet.getParamKey()

getPreSelection

public List<String> getPreSelection()

Description copied from interface: I_CmsSearchConfigurationFacet

A list of facet-entries that should be preselected, if the search form is rendered the first time.

Specified by:

getPreSelection in interface I_CmsSearchConfigurationFacet

Returns:

The list of facet-entries that should be preselected, if the search form is rendered the first time.

See Also:

• I_CmsSearchConfigurationFacet.getPreSelection()

propagateAllFacetNames

public void propagateAllFacetNames(Collection<String> names)

Description copied from interface: I_CmsSearchConfigurationFacet

Propagate the names of the other facets that are configured.

Specified by:

propagateAllFacetNames in interface I_CmsSearchConfigurationFacet

Parameters:

names - the names of the other facets

See Also:

• I_CmsSearchConfigurationFacet.propagateAllFacetNames(java.util.Collection)