atg.endeca.assembler.navigation

Class ExtendedNavigationStateBuilder

java.lang.Object

com.endeca.infront.navigation.url.UrlNavigationStateBuilder

atg.endeca.assembler.navigation.ExtendedNavigationStateBuilder

All Implemented Interfaces:

com.endeca.infront.navigation.NavigationStateBuilder

public class ExtendedNavigationStateBuilder
extends com.endeca.infront.navigation.url.UrlNavigationStateBuilder

The main feature added to the UrlNavigationStateBuilder is that our RecordFilterBuilders can be registered on it thus providing additional record filters to be added to the parsed filter state.
This class is NOT thread-safe

Field Summary

Fields

Modifier and Type	Field and Description
protected static java.lang.String	CLASS_VERSION Class version string

Fields inherited from class com.endeca.infront.navigation.url.UrlNavigationStateBuilder

handledParams, logger

Constructor Summary

Constructors

Constructor and Description
ExtendedNavigationStateBuilder()

Method Summary

Modifier and Type	Method and Description
NavigationStateProcessor[]	getNavigationStateProcessors()
RecordFilterBuilder[]	getNonSecurityFilterBuilders()
atg.endeca.assembler.navigation.filter.RangeFilterBuilder[]	getRangeFilterBuilders()
RecordFilterBuilder[]	getRecordFilterBuilders()
RecordFilterBuilder	getSecurityFilterBuilder()
RecordFilterBuilder[]	getSecurityFilterBuilders()
protected com.endeca.infront.navigation.model.FilterState	parseFilterState(com.endeca.soleng.urlformatter.UrlState pUrlState) Allows the security filter to be provided by securityFilterBuilder, thus allowing us to calculate security filter based on user profile, etc.
com.endeca.infront.navigation.NavigationState	parseNavigationState(java.lang.String pQueryString, java.lang.String pPathInfo, java.lang.String pCharacterEncoding) Retrieve the NavigationStateProcessor component and invoke its process method passing in the NavigationState returned from calling super.
protected java.util.List<com.endeca.infront.navigation.model.RangeFilter>	parseRangeFilters(com.endeca.soleng.urlformatter.UrlState urlState) Adds custom range filters provided by the rangeFilterBuilders property to the NavigationState.
protected java.util.List<java.lang.String>	parseRecordFilters(com.endeca.soleng.urlformatter.UrlState pUrlState) Adds custom record filters provided by record filter builders.
com.endeca.infront.navigation.RecordState	parseRecordState(java.lang.String pQueryString, java.lang.String pPathInfo, java.lang.String pCharacterEncoding) This overridden method ensures that the current request's pathInfo parameter has a value.
void	setNavigationStateProcessors(NavigationStateProcessor[] pNavigationStateProcessors)
void	setRangeFilterBuilders(atg.endeca.assembler.navigation.filter.RangeFilterBuilder[] pRangeFilterBuilders)
void	setRecordFilterBuilders(RecordFilterBuilder[] pRecordFilterBuilders)
static java.util.List<java.lang.String>	splitRecordFilters(java.util.List<java.lang.String> pRecordFilters) For each record filter in the list the method checks whether the filter is a union of filters and if so splits it into individual record filters.

Methods inherited from class com.endeca.infront.navigation.url.UrlNavigationStateBuilder

addAutoPhraseEnabled, addEqlFilter, addFeaturedRecords, addGeoFilter, addLanguageId, addNavigationFilters, addParameters, addParameters, addRangeFilters, addRecordFilters, addRecordSpec, addSearchFilters, buildUrlState, buildUrlState, getAggregateRecordSpecParam, getAutophraseParam, getDefaultFilterState, getDefaultMatchMode, getDefaultSearchKey, getEqlParam, getFeaturedRecordsParam, getGeoFilterParam, getLanguageParam, getMdexRequestBroker, getNavigationFiltersParam, getRangeFiltersParam, getRecordDetailsDimensionNames, getRecordFilterParam, getRecordSpecParam, getRemoveAlways, getRemoveOnClearFilterState, getRemoveOnUpdateFilterState, getSearchFiltersKeyParam, getSearchFiltersMatchModeParam, getSearchFiltersParam, getSiteManager, getSiteState, getUrlFormatter, parseApplicationFilterState, parseFeaturedRecords, parseGeoFilter, parseNavigationFilters, parseNavigationState, parseParameters, parseRecordSpec, parseRecordState, parseSearchFilters, setAggregateRecordSpecParam, setAutophraseParam, setDefaultFilterState, setDefaultMatchMode, setDefaultSearchKey, setEqlParam, setFeaturedRecordsParam, setGeoFilterParam, setLanguageParam, setMdexRequestBroker, setNavigationFiltersParam, setRangeFiltersParam, setRecordDetailsDimensionNames, setRecordFilterParam, setRecordSpecParam, setRemoveAlways, setRemoveOnClearFilterState, setRemoveOnUpdateFilterState, setSearchFiltersKeyParam, setSearchFiltersMatchModeParam, setSearchFiltersParam, setSiteManager, setSiteState, setUrlFormatter

Methods inherited from class java.lang.Object

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

Field Detail

CLASS_VERSION

protected static final java.lang.String CLASS_VERSION

Class version string

See Also:

Constant Field Values

Constructor Detail

ExtendedNavigationStateBuilder

public ExtendedNavigationStateBuilder()

Method Detail

getRangeFilterBuilders

public atg.endeca.assembler.navigation.filter.RangeFilterBuilder[] getRangeFilterBuilders()

Returns:

An array of RangeFilterBuilders

setRangeFilterBuilders

public void setRangeFilterBuilders(atg.endeca.assembler.navigation.filter.RangeFilterBuilder[] pRangeFilterBuilders)

getRecordFilterBuilders

public RecordFilterBuilder[] getRecordFilterBuilders()

Returns:

the RecordFilterBuilders

setRecordFilterBuilders

public void setRecordFilterBuilders(RecordFilterBuilder[] pRecordFilterBuilders)

Parameters:

pRecordFilterBuilders - the recordFilterBuilders to set

getNonSecurityFilterBuilders

public RecordFilterBuilder[] getNonSecurityFilterBuilders()

Returns:

the non-security filter builders

getSecurityFilterBuilder

public RecordFilterBuilder getSecurityFilterBuilder()

Returns:

the security filter builder

getSecurityFilterBuilders

public RecordFilterBuilder[] getSecurityFilterBuilders()

Returns:

the security filter builders

getNavigationStateProcessors

public NavigationStateProcessor[] getNavigationStateProcessors()

Returns:

the mNavigationStateProcessors. NavigationStateProcessors are used to modify the NavigationState

setNavigationStateProcessors

public void setNavigationStateProcessors(NavigationStateProcessor[] pNavigationStateProcessors)

Parameters:

pNavigationStateProcessors - the NavigationStateProcessors to set

parseRecordFilters

protected java.util.List<java.lang.String> parseRecordFilters(com.endeca.soleng.urlformatter.UrlState pUrlState)
                                                       throws com.endeca.infront.navigation.NavigationException

Adds custom record filters provided by record filter builders. Only unique record filters are returned.

Overrides:

parseRecordFilters in class com.endeca.infront.navigation.url.UrlNavigationStateBuilder

Throws:

com.endeca.infront.navigation.NavigationException

parseRangeFilters

protected java.util.List<com.endeca.infront.navigation.model.RangeFilter> parseRangeFilters(com.endeca.soleng.urlformatter.UrlState urlState)
                                                                                     throws com.endeca.infront.navigation.NavigationException

Adds custom range filters provided by the rangeFilterBuilders property to the NavigationState.

Overrides:

parseRangeFilters in class com.endeca.infront.navigation.url.UrlNavigationStateBuilder

Throws:

com.endeca.infront.navigation.NavigationException

splitRecordFilters

public static java.util.List<java.lang.String> splitRecordFilters(java.util.List<java.lang.String> pRecordFilters)

For each record filter in the list the method checks whether the filter is a union of filters and if so splits it into individual record filters.

Parameters:

pRecordFilters - The initial list of record filters to split

Returns:

The list of split record filters.

parseFilterState

protected com.endeca.infront.navigation.model.FilterState parseFilterState(com.endeca.soleng.urlformatter.UrlState pUrlState)
                                                                    throws com.endeca.infront.navigation.NavigationException

Allows the security filter to be provided by securityFilterBuilder, thus allowing us to calculate security filter based on user profile, etc. The calculated filter is anded with the default security filter. If no securityFilterBuilder is registered or the registered securityFilterBuilder returns null, uses the default security filter provided by the default filter state.

Overrides:

parseFilterState in class com.endeca.infront.navigation.url.UrlNavigationStateBuilder

Throws:

com.endeca.infront.navigation.NavigationException

parseNavigationState

public com.endeca.infront.navigation.NavigationState parseNavigationState(java.lang.String pQueryString,
                                                                          java.lang.String pPathInfo,
                                                                          java.lang.String pCharacterEncoding)
                                                                   throws com.endeca.infront.navigation.NavigationException

Retrieve the NavigationStateProcessor component and invoke its process method passing in the NavigationState returned from calling super.

This method also ensures that the current request's pathInfo parameter has a value. This is necessary because when the Endeca SeoUrlFormatter is being used, it requires the pathInfo to parse the request.

Specified by:

parseNavigationState in interface com.endeca.infront.navigation.NavigationStateBuilder

Overrides:

parseNavigationState in class com.endeca.infront.navigation.url.UrlNavigationStateBuilder

Throws:

com.endeca.infront.navigation.NavigationException

parseRecordState

public com.endeca.infront.navigation.RecordState parseRecordState(java.lang.String pQueryString,
                                                                  java.lang.String pPathInfo,
                                                                  java.lang.String pCharacterEncoding)
                                                           throws com.endeca.infront.navigation.NavigationException

This overridden method ensures that the current request's pathInfo parameter has a value. This is necessary because when the Endeca SeoUrlFormatter is being used, it requires the pathInfo to parse the request.

Specified by:

parseRecordState in interface com.endeca.infront.navigation.NavigationStateBuilder

Overrides:

parseRecordState in class com.endeca.infront.navigation.url.UrlNavigationStateBuilder

Throws:

com.endeca.infront.navigation.NavigationException