com.groupbyinc.util

Class AbstractUrlBeautifier<RQ extends AbstractRequest<RQ>,Q extends AbstractQuery<RQ,Q>>

java.lang.Object

com.groupbyinc.util.AbstractUrlBeautifier<RQ,Q>

public abstract class AbstractUrlBeautifier<RQ extends AbstractRequest<RQ>,Q extends AbstractQuery<RQ,Q>>
extends java.lang.Object

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	AbstractUrlBeautifier.UrlBeautificationException

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	PARAM_REPLACEMENT
static java.lang.String	SEARCH_NAVIGATION_NAME

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractUrlBeautifier()

Method Summary

Modifier and Type	Method and Description
void	addRefinementMapping(char pToken, java.lang.String pName) Set up a mapping for a refinement.
void	addReplacementRule(char pTarget, java.lang.Character pReplacement) Adds a new replacement rule that will be applied to the search term and mapped refinements.
void	addReplacementRule(char pTarget, java.lang.Character pReplacement, java.lang.String pRefinementName) Adds a new replacement rule that will only be applied to the specified refinement.
void	clearSavedFields() Clean up all mappings.
protected abstract Q	createQuery()
Q	fromUrl(java.lang.String uri) Convert a URI into a query object.
Q	fromUrl(java.lang.String url, Q defaultQuery) Convert a URI into a query object.
java.lang.String	getAppend() Return the current appended URL segment
java.lang.String	getRefinementsQueryParameterName()
void	setAppend(java.lang.String pAppend) Quite often URLs need to end with specific extensions to map to the correct controller in the backend.
void	setRefinementsQueryParameterName(java.lang.String pRefinementsQueryParameterName) Sets the name of the query parameter with which non-mapped refinements will show up in the query string.
void	setSearchMapping(char pToken) Set the mapping from a search term to a path segment.
java.lang.String	toUrl(java.lang.String searchString, java.lang.String existingRefinements) Convert a search term and a list of refinements into a beautified URL.

Methods inherited from class java.lang.Object

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

Field Detail

PARAM_REPLACEMENT

public static final java.lang.String PARAM_REPLACEMENT

See Also:

Constant Field Values

SEARCH_NAVIGATION_NAME

public static final java.lang.String SEARCH_NAVIGATION_NAME

See Also:

Constant Field Values

Constructor Detail

AbstractUrlBeautifier

protected AbstractUrlBeautifier()

Method Detail

createQuery

protected abstract Q createQuery()

toUrl

public java.lang.String toUrl(java.lang.String searchString,
                              java.lang.String existingRefinements)
                       throws AbstractUrlBeautifier.UrlBeautificationException

Convert a search term and a list of refinements into a beautified URL. Each refinement that has a mapping will be turned into a path segment. If a mapping has been created for search, the search term will also be placed into a URL path segment.

Parameters:

searchString - The current search state.

existingRefinements - The current refinement state

Returns:

Throws:

AbstractUrlBeautifier.UrlBeautificationException

fromUrl

public Q fromUrl(java.lang.String uri)
          throws AbstractUrlBeautifier.UrlBeautificationException

Convert a URI into a query object. Mappings will be converted to the correct search and refinement state.

Parameters:

uri - The URI to parse into a query object

Returns:

Throws:

AbstractUrlBeautifier.UrlBeautificationException

fromUrl

public Q fromUrl(java.lang.String url,
                 Q defaultQuery)
          throws AbstractUrlBeautifier.UrlBeautificationException

Convert a URI into a query object. Mappings will be converted to the correct search and refinement state.

Parameters:

url - The URI to parse into a query object

defaultQuery - The default query to use if this URL does not correctly parse.

Returns:

Throws:

AbstractUrlBeautifier.UrlBeautificationException

setSearchMapping

public void setSearchMapping(char pToken)

Set the mapping from a search term to a path segment. Note: you cannot use vowels for mapping tokens to prevent dictionary word creation. The order in which this method is called determines where in the URL the search term will show up.

Parameters:

pToken - The single letter to represent search in the lookup.

addRefinementMapping

public void addRefinementMapping(char pToken,
                                 java.lang.String pName)

Set up a mapping for a refinement. Note: you cannot use vowels for mapping tokens to prevent dictionary word creation. The order in which this method is called determines where in the URL the refinements will show up.

Parameters:

pToken - The single letter to represent this refinement in the lookup.

pName - The name of the navigation that will be mapped using this token.

clearSavedFields

public void clearSavedFields()

Clean up all mappings.

getAppend

public java.lang.String getAppend()

Return the current appended URL segment

Returns:

setAppend

public void setAppend(java.lang.String pAppend)

Quite often URLs need to end with specific extensions to map to the correct controller in the backend. Here you can set this value. For example: /index.html

Parameters:

pAppend - The value to append to each beautified URL.

getRefinementsQueryParameterName

public java.lang.String getRefinementsQueryParameterName()

Returns:

The name with which non-mapped refinements will be mapped into the URL query string.

setRefinementsQueryParameterName

public void setRefinementsQueryParameterName(java.lang.String pRefinementsQueryParameterName)

Sets the name of the query parameter with which non-mapped refinements will show up in the query string. This includes ranges which are never mapped to beautified URLs.

Parameters:

pRefinementsQueryParameterName - The name of the query parameter to use.

addReplacementRule

public void addReplacementRule(char pTarget,
                               java.lang.Character pReplacement)

Adds a new replacement rule that will be applied to the search term and mapped refinements. The original search term and refinements will be put back into the query object. If pReplacement is null the target character will be removed. Note: Replacements that are chained may still contain the original target character. For example: addReplacementRule('x','y'); addReplacementRule('z','x'); The result of this may contain x's in the final result. www.example.com/xyz will become www.example.com/yyz after the first replacement and www.example.com/yyx after the second replacement.

Parameters:

pTarget - The char values to be replaced

pReplacement - The replacement char value

addReplacementRule

public void addReplacementRule(char pTarget,
                               java.lang.Character pReplacement,
                               java.lang.String pRefinementName)

Adds a new replacement rule that will only be applied to the specified refinement. The original search term and refinements will be put back into the query object. If pReplacement is null the target character will be removed. Note: Replacements that are chained may still contain the original target character. For example: addReplacementRule('x', 'y', "brand"); addReplacementRule('z', 'x', "brand"); The result of this may contain x's in the final result. www.example.com/xyz/b will become www.example.com/yyz/b after the first replacement and www.example.com/yyx/b after the second replacement.

Parameters:

pTarget - The char values to be replaced

pReplacement - The replacement char value

pRefinementName - The name of the refinement that this replacement should be applied to.