org.jahia.services.seo.jcr

Class VanityUrlService

java.lang.Object

org.jahia.services.seo.jcr.VanityUrlService

public class VanityUrlService
extends Object

Service to manage vanity urls in Jahia

Author:

Benjamin Papez

Field Summary

Fields

Modifier and Type	Field and Description
static String	CACHE_BY_URL

Constructor Summary

Constructors

Constructor and Description
VanityUrlService()

Method Summary

Modifier and Type	Method and Description
List<VanityUrl>	findExistingVanityUrls(String url, String site, String workspace) Find any mappings for the given vanity URL.
void	flushCacheEntry(String key)
void	flushCaches()
String	getCacheByUrlKey(String url, String site, String workspace)
VanityUrl	getVanityUrlForWorkspaceAndLocale(JCRNodeWrapper contentNode, String workspace, Locale locale, String siteKey) Gets a node's default vanity URL for the given locale and workspace.
VanityUrl	getVanityUrlForWorkspaceAndLocale(String contentNodePath, String workspace, Locale locale, String siteKey) Gets a node's default vanity URL for the given locale and workspace.
List<VanityUrl>	getVanityUrls(JCRNodeWrapper contentNode, String languageCode, JCRSessionWrapper session) Gets all node's vanity URLs for the given locale
List<VanityUrl>	getVanityUrlsForCurrentLocale(JCRNodeWrapper contentNode, JCRSessionWrapper session) Gets all node's vanity URLs for the current locale in the session
boolean	removeVanityUrlMapping(JCRNodeWrapper contentNode, VanityUrl vanityUrl) Completely delete a mapped vanity URL.
boolean	removeVanityUrlMappings(JCRNodeWrapper contentNode, String languageCode) Completely delete all mapped vanity URL for a locale.
boolean	saveVanityUrlMapping(JCRNodeWrapper contentNode, VanityUrl vanityUrl) Add or update a vanity URL mapping belonging to a specific content node and identified either by the vanity URL node UUID or the vanity URL value set in the VanityUrl bean.
boolean	saveVanityUrlMapping(JCRNodeWrapper contentNode, VanityUrl vanityUrl, boolean save) Add or update a vanity URL mapping belonging to a specific content node and identified either by the vanity URL node UUID or the vanity URL value set in the VanityUrl bean.
boolean	saveVanityUrlMappings(JCRNodeWrapper contentNode, List<VanityUrl> vanityUrls, Set<String> updatedLocales) Add, update or delete all vanity URL mappings for a specific content node and the language codes set in the list of VanityUrl beans.
void	setCacheService(CacheService cacheService)
void	setUrlResolverListener(URLResolverListener urlResolverListener)
void	setVanityUrlManager(VanityUrlManager vanityUrlManager) Injects the dependency to VanityUrlManager.

Methods inherited from class java.lang.Object

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

Field Detail

CACHE_BY_URL

public static final String CACHE_BY_URL

See Also:

Constant Field Values

Constructor Detail

VanityUrlService

public VanityUrlService()

Method Detail

getVanityUrlForWorkspaceAndLocale

public VanityUrl getVanityUrlForWorkspaceAndLocale(JCRNodeWrapper contentNode,
                                                   String workspace,
                                                   Locale locale,
                                                   String siteKey)
                                            throws javax.jcr.RepositoryException

Gets a node's default vanity URL for the given locale and workspace. If none is default then take the first mapping for the locale.

Parameters:

contentNode - the content node for which to return a mapping

workspace - the workspace to look for mappings

locale - the locale to which the mapping should apply

siteKey - the key of the current site; if the content node's site does not match the specified one in siteKey, null is returned by this method

Returns:

the VanityUrl bean

Throws:

javax.jcr.RepositoryException - if there was an unexpected exception accessing the repository

getVanityUrlForWorkspaceAndLocale

public VanityUrl getVanityUrlForWorkspaceAndLocale(String contentNodePath,
                                                   String workspace,
                                                   Locale locale,
                                                   String siteKey)
                                            throws javax.jcr.RepositoryException

Gets a node's default vanity URL for the given locale and workspace. If none is default then take the first mapping for the locale.

Parameters:

contentNodePath - the content node path for which to return a mapping

workspace - the workspace to look for mappings

locale - the locale to which the mapping should apply

siteKey - the key of the current site; if the content node's site does not match the specified one in siteKey, null is returned by this method

Returns:

the VanityUrl bean

Throws:

javax.jcr.RepositoryException - if there was an unexpected exception accessing the repository

getVanityUrlsForCurrentLocale

public List<VanityUrl> getVanityUrlsForCurrentLocale(JCRNodeWrapper contentNode,
                                                     JCRSessionWrapper session)
                                              throws javax.jcr.RepositoryException

Gets all node's vanity URLs for the current locale in the session

Parameters:

contentNode - the content node for which to return the mappings

session - the JCR session holding the information about the workspace, locale and user

Returns:

the list of VanityUrl beans

Throws:

javax.jcr.RepositoryException - if there was an unexpected exception accessing the repository

getVanityUrls

public List<VanityUrl> getVanityUrls(JCRNodeWrapper contentNode,
                                     String languageCode,
                                     JCRSessionWrapper session)
                              throws javax.jcr.RepositoryException

Gets all node's vanity URLs for the given locale

Parameters:

contentNode - the content node for which to return the mappings

languageCode - the language code for which to return the mappings

session - the JCR session holding the information about the workspace and user

Returns:

the list of VanityUrl beans

Throws:

javax.jcr.RepositoryException - if there was an unexpected exception accessing the repository

removeVanityUrlMapping

public boolean removeVanityUrlMapping(JCRNodeWrapper contentNode,
                                      VanityUrl vanityUrl)
                               throws javax.jcr.RepositoryException

Completely delete a mapped vanity URL. If the deleted vanity URL is the default one for the current locale, then check whether there are other active mappings for the same locale and set the first found one as the new default.

Parameters:

contentNode - the content node for which to remove the given mapping

vanityUrl - the VanityUrl bean representing the URL to be removed

Returns:

true if the vanity URL was removed or false if it was not removed

Throws:

javax.jcr.RepositoryException - if there was an unexpected exception accessing the repository

removeVanityUrlMappings

public boolean removeVanityUrlMappings(JCRNodeWrapper contentNode,
                                       String languageCode)
                                throws javax.jcr.RepositoryException

Completely delete all mapped vanity URL for a locale.

Parameters:

contentNode - the content node for which to remove the mappings

languageCode - the language code for which the mappings should be removed

Returns:

true if the vanity URL was removed or false if it was not removed

Throws:

javax.jcr.RepositoryException - if there was an unexpected exception accessing the repository

saveVanityUrlMapping

public boolean saveVanityUrlMapping(JCRNodeWrapper contentNode,
                                    VanityUrl vanityUrl)
                             throws javax.jcr.RepositoryException

Add or update a vanity URL mapping belonging to a specific content node and identified either by the vanity URL node UUID or the vanity URL value set in the VanityUrl bean.

If the URL mapping has already been saved before, we check whether the default, active, language or vanity URL value in the bean is different from the saved one, so we do an update, otherwise no operation is done.

If the new or updated mapping is now the default one for the language, then we also check if there already is another default URL for this language and set its default flag to false.

We also check whether the same URL is already existing for a different node or language in the current site and throw a ConstraintViolationException if this is the case.

Parameters:

contentNode - the content node for which to add or update the given mapping

vanityUrl - the VanityUrl bean representing the URL to be added or updated

Returns:

true if the vanity URL was added or false if it was not added

Throws:

javax.validation.ConstraintViolationException - if the vanity URL mapping already exists for a different content node or language within the site

javax.jcr.RepositoryException - if there was an unexpected exception accessing the repository

saveVanityUrlMapping

public boolean saveVanityUrlMapping(JCRNodeWrapper contentNode,
                                    VanityUrl vanityUrl,
                                    boolean save)
                             throws javax.jcr.RepositoryException

Add or update a vanity URL mapping belonging to a specific content node and identified either by the vanity URL node UUID or the vanity URL value set in the VanityUrl bean.

If the URL mapping has already been saved before, we check whether the default, active, language or vanity URL value in the bean is different from the saved one, so we do an update, otherwise no operation is done.

If the new or updated mapping is now the default one for the language, then we also check if there already is another default URL for this language and set its default flag to false.

We also check whether the same URL is already existing for a different node or language in the current site and throw a ConstraintViolationException if this is the case.

Parameters:

contentNode - the content node for which to add or update the given mapping

vanityUrl - the VanityUrl bean representing the URL to be added or updated

save - should the session be saved at the end

Returns:

true if the vanity URL was added or false if it was not added

Throws:

javax.validation.ConstraintViolationException - if the vanity URL mapping already exists for a different content node or language within the site

javax.jcr.RepositoryException - if there was an unexpected exception accessing the repository

saveVanityUrlMappings

public boolean saveVanityUrlMappings(JCRNodeWrapper contentNode,
                                     List<VanityUrl> vanityUrls,
                                     Set<String> updatedLocales)
                              throws javax.jcr.RepositoryException

Add, update or delete all vanity URL mappings for a specific content node and the language codes set in the list of VanityUrl beans. First we load all existing mappings for all the languages set in the updatedLocales collection. Then we compare the existing with the list of URL mappings given in the vanityUrls collection to know which nodes need to be added, updated or deleted. If the default mapping for a language is set for a new or updated mapping, then we check if there already is another default URL for this language and set its default flag to false. We also check whether the same added URL is already existing for a different node or language in the current site (and which is not being deleted in the same operation) and throw a ConstraintViolationException if this is the case. We also throw a ConstraintViolationException if two URL mappings for the same language in the given vanityUrls collection have the default flag set to true.

Parameters:

contentNode - the content node for which to add the given mapping

vanityUrls - the list of VanityUrls bean representing the URLs to be added or updated

updatedLocales - a set with all locales, which have been edited (e.g. if all mappings for a language need to be deleted, add the language to this set, while in the vanityUrls list there will be no mappings for that language)

Returns:

true if any vanity URL was added, updated or deleted or false if no change was done

Throws:

javax.validation.ConstraintViolationException - if the vanity URL mapping already exists for a different content node or language in the site

javax.jcr.RepositoryException - if there was an unexpected exception accessing the repository

findExistingVanityUrls

public List<VanityUrl> findExistingVanityUrls(String url,
                                              String site,
                                              String workspace)
                                       throws javax.jcr.RepositoryException

Find any mappings for the given vanity URL. If a site is specified the query will be done only for the specified site, otherwise all sites in the workspace will be searched through and a list of VanityURL beans will be returned. The method searches mappings in any language.

Parameters:

url - URL path to check whether there is a content mapping for it (URL must start with /)

site - key of the site to search for the mapping or all sites if the string is null or empty

workspace - the workspace to look for mappings

Returns:

the list of VanityUrl beans

Throws:

javax.jcr.RepositoryException - if there was an unexpected exception accessing the repository

setVanityUrlManager

public void setVanityUrlManager(VanityUrlManager vanityUrlManager)

Injects the dependency to VanityUrlManager.

Parameters:

vanityUrlManager - the dependency to VanityUrlManager

setCacheService

public void setCacheService(CacheService cacheService)

getCacheByUrlKey

public String getCacheByUrlKey(String url,
                               String site,
                               String workspace)

setUrlResolverListener

public void setUrlResolverListener(URLResolverListener urlResolverListener)

flushCaches

public void flushCaches()

flushCacheEntry

public void flushCacheEntry(String key)