org.ametys.plugins.linkdirectory

Class DirectoryHelper

java.lang.Object

org.ametys.runtime.plugin.component.AbstractLogEnabled

org.ametys.plugins.linkdirectory.DirectoryHelper

All Implemented Interfaces:

LogEnabled, Component, Contextualizable, Serviceable

public final class DirectoryHelper
extends AbstractLogEnabled
implements Component, Serviceable, Contextualizable

Link directory helper.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private class	DirectoryHelper.DefaultLinkSorter Helper class to sort links (DefaultLinkSorter implementation) If both links are in the ordered links list, this order is used If one of them is in it and not the other, the one in it will be before the other If none of them is in the list, the initial order will be used

Field Summary

Fields

Modifier and Type	Field and Description
private static String	__LINKS_NODE_NAME
private static String	__PLUGIN_NODE_NAME
private static String	__THEMES_NODE_NAME
private static String	__USER_LINKS_NODE_NAME
private AmetysObjectResolver	_ametysObjectResolver The Ametys object resolver
private Context	_context The context
private CurrentUserProvider	_currentUserProvider The current user provider
private DynamicInformationProviderExtensionPoint	_dynamicProviderEP
private LinkDAO	_linkDAO The link DAO
private RightManager	_rightManager The right manager
private SiteManager	_siteManager The site manager
private UserPreferencesManager	_userPreferencesManager The user preferences manager
static String	ROLE The component role

Constructor Summary

Constructors

Constructor and Description
DirectoryHelper()

Method Summary

Modifier and Type	Method and Description
private void	_addURLAttribute(DefaultLink link, boolean hasIPRestriction, boolean isIPAuthorized, AttributesImpl attrs) Add the URL attribute to sax
private boolean	_isCurrentUserGrantedAccess(DefaultLink link) Determines if the current user is allowed to see the link or not
private boolean	_isIPAuthorized(Pattern ipRestriction) Checks if the IP is authorized for use link internal URL
private void	_saxThemes(ContentHandler contentHandler, DefaultLink link) Sax the themes
private void	_saxThemesLabel(ContentHandler contentHandler, DefaultLink link) Sax the label of the themes
void	contextualize(Context context)
String	getAllLinksQuery(String siteName, String language) Get all the links
Map<String,String>	getContextVars(Request request) Retrieve the context variables from the front
String	getLanguage(Request request) Get the site's language
List<DefaultLink>	getLinks(List<String> themesIds, UserIdentity user, String siteName, String language) Get the list of links corresponding to the given theme ids
AmetysObjectIterable<DefaultLink>	getLinks(String siteName, String language) Get links of a given site and language
ModifiableTraversableAmetysObject	getLinksForUserNode(Site site, String language, UserIdentity user) Get the links root node for the given user.
String	getLinksForUserNodePath(String siteName, String language, UserIdentity user) Get the links root node path for the given user
ModifiableTraversableAmetysObject	getLinksNode(Site site, String language) Get the links root node.
String	getLinksNodePath(String siteName, String language) Get the links root node path
String	getLinksQuery(String siteName, String language, Expression expression) Get the link query corresponding to the expression passed as a parameter
private ModifiableTraversableAmetysObject	getOrCreateNode(ModifiableTraversableAmetysObject parentNode, String nodeName, String nodeType)
ModifiableTraversableAmetysObject	getPluginNode(Site site) Get the root plugin storage object.
String	getPluginNodePath(String siteName) Get the plugin node path
String	getSiteName(Request request) Get the site's name
String	getThemeExistsQuery(String siteName, String language, String label) Get the query verifying the existence of a theme
String	getThemeIdFromThemeName(Site site, String language, String configuredThemeName) Retrieve theme id from theme name
String	getThemeName(String themeId) Get theme name from jcr id
String	getThemeQuery(String siteName, String language, Expression expression) Get the theme query corresponding to the expression passed as a parameter
List<String>	getThemesIdsFromThemesNames(Site site, String language, List<String> configuredThemesNames) Retrieve theme ids from theme names
Map<String,List<String>>	getThemesMap(List<String> configuredThemesNames, String siteName, String language) Get the actual ids of the themes configured properly, their names if they were not
ModifiableTraversableAmetysObject	getThemesNode(Site site, String language) Get the themes storage node.
String	getThemesNodePath(String siteName, String language) Get the themes node path
String	getUrlExistsForUserQuery(String siteName, String language, String url, UserIdentity user) Get the query verifying the existence of an url for the given user
String	getUrlExistsQuery(String siteName, String language, String url) Get the query verifying the existence of an url
AmetysObjectIterable<DefaultLink>	getUserLinks(String siteName, String language, UserIdentity user) Get links of a given site and language, for the given user
AmetysObjectIterable<DefaultLink>	getUserLinks(String siteName, String language, UserIdentity user, String themeId) Get links of a given site and language, for the given user
String	getUserLinksQuery(String siteName, String language, UserIdentity user, Expression expression) Get the user link query corresponding to the expression passed as a parameter
boolean	hasInternalUrl(String siteName, String language, List<String> themesIds) Checks if the links displayed in a link directory service has internal link
boolean	hasRestrictions(String siteName, String language, List<String> themesIds) Checks if the links displayed in a link directory service has access restrictions
boolean	isAccessRestricted(AmetysObjectIterable<AmetysObject> links) Check if the links' access is restricted or not
String	normalizeString(String s) Normalizes an input string in order to capitalize it, remove accents, and replace whitespaces with underscores
void	saxLink(String siteName, ContentHandler contentHandler, DefaultLink link, boolean saxThemesLabelOnly, boolean selected, boolean saxLinksOnly, boolean hasIPRestriction, boolean isIPAuthorized, boolean userLink, boolean isHidden) Generate a directory link.
void	saxLinks(String siteName, ContentHandler contentHandler, List<DefaultLink> links, List<DefaultLink> userLinks, Map<String,String> contextVars, String storageContext, UserIdentity user, boolean saxThemesLabelOnly, boolean saxLinksOnly) Sax the directory links
void	service(ServiceManager manager)
boolean	themeExists(String themeId) Verify the existence of a theme

Methods inherited from class org.ametys.runtime.plugin.component.AbstractLogEnabled

getLogger, setLogger

Methods inherited from class java.lang.Object

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

Field Detail

ROLE

public static final String ROLE

The component role

__PLUGIN_NODE_NAME

private static final String __PLUGIN_NODE_NAME

See Also:

Constant Field Values

__LINKS_NODE_NAME

private static final String __LINKS_NODE_NAME

See Also:

Constant Field Values

__THEMES_NODE_NAME

private static final String __THEMES_NODE_NAME

See Also:

Constant Field Values

__USER_LINKS_NODE_NAME

private static final String __USER_LINKS_NODE_NAME

See Also:

Constant Field Values

_ametysObjectResolver

private AmetysObjectResolver _ametysObjectResolver

The Ametys object resolver

_siteManager

private SiteManager _siteManager

The site manager

_userPreferencesManager

private UserPreferencesManager _userPreferencesManager

The user preferences manager

_currentUserProvider

private CurrentUserProvider _currentUserProvider

The current user provider

_rightManager

private RightManager _rightManager

The right manager

_linkDAO

private LinkDAO _linkDAO

The link DAO

_context

private Context _context

The context

_dynamicProviderEP

private DynamicInformationProviderExtensionPoint _dynamicProviderEP

Constructor Detail

DirectoryHelper

public DirectoryHelper()

Method Detail

service

public void service(ServiceManager manager)
             throws ServiceException

Specified by:

service in interface Serviceable

Throws:

ServiceException

contextualize

public void contextualize(Context context)
                   throws ContextException

Specified by:

contextualize in interface Contextualizable

Throws:

ContextException

getPluginNode

public ModifiableTraversableAmetysObject getPluginNode(Site site)
                                                throws AmetysRepositoryException

Get the root plugin storage object.

Parameters:

site - the site.

Returns:

the root plugin storage object.

Throws:

AmetysRepositoryException - if a repository error occurs.

getLinksNode

public ModifiableTraversableAmetysObject getLinksNode(Site site,
                                                      String language)
                                               throws AmetysRepositoryException

Get the links root node.

Parameters:

site - the site

language - the language.

Returns:

the links root node.

Throws:

AmetysRepositoryException - if a repository error occurs.

getLinksForUserNode

public ModifiableTraversableAmetysObject getLinksForUserNode(Site site,
                                                             String language,
                                                             UserIdentity user)
                                                      throws AmetysRepositoryException

Get the links root node for the given user.

Parameters:

site - the site

language - the language.

user - The user identity

Returns:

the links root node for the given user.

Throws:

AmetysRepositoryException - if a repository error occurs.

getThemesNode

public ModifiableTraversableAmetysObject getThemesNode(Site site,
                                                       String language)
                                                throws AmetysRepositoryException

Get the themes storage node.

Parameters:

site - the site

language - the language.

Returns:

the themes storage node.

Throws:

AmetysRepositoryException - if a repository error occurs.

getPluginNodePath

public String getPluginNodePath(String siteName)

Get the plugin node path

Parameters:

siteName - the site name.

Returns:

the plugin node path.

getLinksNodePath

public String getLinksNodePath(String siteName,
                               String language)

Get the links root node path

Parameters:

siteName - the site name.

language - the language

Returns:

the links root node path.

getLinksForUserNodePath

public String getLinksForUserNodePath(String siteName,
                                      String language,
                                      UserIdentity user)

Get the links root node path for the given user

Parameters:

siteName - the site name.

language - the language

user - The user identity

Returns:

the links root node path for the given user.

getThemesNodePath

public String getThemesNodePath(String siteName,
                                String language)

Get the themes node path

Parameters:

siteName - the site name.

language - the language

Returns:

the themes node path.

getAllLinksQuery

public String getAllLinksQuery(String siteName,
                               String language)

Get all the links

Parameters:

siteName - the site name.

language - the language.

Returns:

all the links' nodes

getLinksQuery

public String getLinksQuery(String siteName,
                            String language,
                            Expression expression)

Get the link query corresponding to the expression passed as a parameter

Parameters:

siteName - the site name.

language - the language.

expression - the Expression of the links retrieval query

Returns:

the link corresponding to the expression passed as a parameter

getUserLinksQuery

public String getUserLinksQuery(String siteName,
                                String language,
                                UserIdentity user,
                                Expression expression)

Get the user link query corresponding to the expression passed as a parameter

Parameters:

siteName - the site name.

language - the language.

user - the user

expression - the Expression of the links retrieval query

Returns:

the user link corresponding to the expression passed as a parameter

getThemeQuery

public String getThemeQuery(String siteName,
                            String language,
                            Expression expression)

Get the theme query corresponding to the expression passed as a parameter

Parameters:

siteName - the site name.

language - the language.

expression - the Expression of the theme retrieval query

Returns:

the theme corresponding to the expression passed as a parameter

getUrlExistsQuery

public String getUrlExistsQuery(String siteName,
                                String language,
                                String url)

Get the query verifying the existence of an url

Parameters:

siteName - the site name.

language - the language.

url - the url to test.

Returns:

the query verifying the existence of an url

getUrlExistsForUserQuery

public String getUrlExistsForUserQuery(String siteName,
                                       String language,
                                       String url,
                                       UserIdentity user)

Get the query verifying the existence of an url for the given user

Parameters:

siteName - the site name.

language - the language.

url - the url to test.

user - The user identity

Returns:

the query verifying the existence of an url for the given user

getThemeExistsQuery

public String getThemeExistsQuery(String siteName,
                                  String language,
                                  String label)

Get the query verifying the existence of a theme

Parameters:

siteName - the site name.

language - the language.

label - the label of the theme to test.

Returns:

the query verifying the existence of a theme

normalizeString

public String normalizeString(String s)

Normalizes an input string in order to capitalize it, remove accents, and replace whitespaces with underscores

Parameters:

s - the string to normalize

Returns:

the normalized string

getLinks

public AmetysObjectIterable<DefaultLink> getLinks(String siteName,
                                                  String language)

Get links of a given site and language

Parameters:

siteName - the site name

language - the language

Returns:

the links

getLinks

public List<DefaultLink> getLinks(List<String> themesIds,
                                  UserIdentity user,
                                  String siteName,
                                  String language)

Get the list of links corresponding to the given theme ids

Parameters:

themesIds - the ids of the configured themes

user - the current user

siteName - the site's name

language - the site's language

Returns:

the list of default links corresponding to the given themes

getUserLinks

public AmetysObjectIterable<DefaultLink> getUserLinks(String siteName,
                                                      String language,
                                                      UserIdentity user)

Get links of a given site and language, for the given user

Parameters:

siteName - the site name

language - the language

user - The user identity

Returns:

the links for the given user

getUserLinks

public AmetysObjectIterable<DefaultLink> getUserLinks(String siteName,
                                                      String language,
                                                      UserIdentity user,
                                                      String themeId)

Get links of a given site and language, for the given user

Parameters:

siteName - the site name

language - the language

user - The user identity

themeId - the theme id to filter user links. If null, return all user links

Returns:

the links for the given user

hasRestrictions

public boolean hasRestrictions(String siteName,
                               String language,
                               List<String> themesIds)

Checks if the links displayed in a link directory service has access restrictions

Parameters:

siteName - the name of the site

language - the language

themesIds - the list of selected theme ids

Returns:

true if the links of the service have access restrictions, false otherwise

hasInternalUrl

public boolean hasInternalUrl(String siteName,
                              String language,
                              List<String> themesIds)

Checks if the links displayed in a link directory service has internal link

Parameters:

siteName - the name of the site

language - the language

themesIds - the list of selected theme ids

Returns:

true if the links of the service has internal link, false otherwise

isAccessRestricted

public boolean isAccessRestricted(AmetysObjectIterable<AmetysObject> links)

Check if the links' access is restricted or not

Parameters:

links - the links to be tested

Returns:

true if the link has a restricted access, false otherwise

getOrCreateNode

private ModifiableTraversableAmetysObject getOrCreateNode(ModifiableTraversableAmetysObject parentNode,
                                                          String nodeName,
                                                          String nodeType)
                                                   throws AmetysRepositoryException

Throws:

AmetysRepositoryException

saxLinks

public void saxLinks(String siteName,
                     ContentHandler contentHandler,
                     List<DefaultLink> links,
                     List<DefaultLink> userLinks,
                     Map<String,String> contextVars,
                     String storageContext,
                     UserIdentity user,
                     boolean saxThemesLabelOnly,
                     boolean saxLinksOnly)
              throws SAXException,
                     UserPreferencesException

Sax the directory links

Parameters:

siteName - the site name

contentHandler - the content handler

links - the list of links to sax (can be null

userLinks - the user links to sax (can be null)

storageContext - the storage context, null if there is no connected user

contextVars - the context variables

user - the user

saxThemesLabelOnly - true to sax themes label only

saxLinksOnly - true if the only the links need to be saxed, false otherwise

Throws:

SAXException - If an error occurs while generating the SAX events

UserPreferencesException - if an exception occurs while getting the user preferences

saxLink

public void saxLink(String siteName,
                    ContentHandler contentHandler,
                    DefaultLink link,
                    boolean saxThemesLabelOnly,
                    boolean selected,
                    boolean saxLinksOnly,
                    boolean hasIPRestriction,
                    boolean isIPAuthorized,
                    boolean userLink,
                    boolean isHidden)
             throws SAXException

Generate a directory link.

Parameters:

siteName - the site name

contentHandler - the content handler

link - the link to generate.

saxThemesLabelOnly - true to sax themes label only

selected - true if a front end user has checked this link as a user preference, false otherwise (deprecated, only used for old views, isHidden should be used now)

saxLinksOnly - true if we want to sax a link for an input data

hasIPRestriction - true if we have IP restriction

isIPAuthorized - true if the IP is authorized

userLink - true if it is a user link

isHidden - true if the link is hidden

Throws:

SAXException - If an error occurs while generating the SAX events

_addURLAttribute

private void _addURLAttribute(DefaultLink link,
                              boolean hasIPRestriction,
                              boolean isIPAuthorized,
                              AttributesImpl attrs)

Add the URL attribute to sax

Parameters:

link - the link

hasIPRestriction - true if we have IP restriction

isIPAuthorized - true if the IP is authorized

attrs - the attribute

getThemesMap

public Map<String,List<String>> getThemesMap(List<String> configuredThemesNames,
                                             String siteName,
                                             String language)

Get the actual ids of the themes configured properly, their names if they were not

Parameters:

configuredThemesNames - the normalized ids of the configured themes

siteName - the site's name

language - the site's language

Returns:

the actual ids of the configured themes

getThemesIdsFromThemesNames

public List<String> getThemesIdsFromThemesNames(Site site,
                                                String language,
                                                List<String> configuredThemesNames)

Retrieve theme ids from theme names

Parameters:

site - the site

language - the language

configuredThemesNames - the names of the configured themes

Returns:

the themes ids matching the given theme names

getThemeIdFromThemeName

public String getThemeIdFromThemeName(Site site,
                                      String language,
                                      String configuredThemeName)

Retrieve theme id from theme name

Parameters:

site - the site

language - the language

configuredThemeName - the name of the configured theme

Returns:

the themes id matching the given theme name

themeExists

public boolean themeExists(String themeId)

Verify the existence of a theme

Parameters:

themeId - the id of the theme to verify

Returns:

true if the theme exists, false otherwise

getThemeName

public String getThemeName(String themeId)

Get theme name from jcr id

Parameters:

themeId - the jcr theme id

Returns:

the name of the theme. Null if the theme doesn't exist

getSiteName

public String getSiteName(Request request)

Get the site's name

Parameters:

request - the request

Returns:

the site's name

getLanguage

public String getLanguage(Request request)

Get the site's language

Parameters:

request - the request

Returns:

the site's language

getContextVars

public Map<String,String> getContextVars(Request request)

Retrieve the context variables from the front

Parameters:

request - the request

Returns:

the map of context variables

_saxThemes

private void _saxThemes(ContentHandler contentHandler,
                        DefaultLink link)
                 throws SAXException

Sax the themes

Parameters:

contentHandler - the content handler

link - the link

Throws:

SAXException - If an error occurs while generating the SAX events

_saxThemesLabel

private void _saxThemesLabel(ContentHandler contentHandler,
                             DefaultLink link)
                      throws SAXException

Sax the label of the themes

Parameters:

contentHandler - the content handler

link - the link

Throws:

SAXException - if an error occurs while saxing

_isCurrentUserGrantedAccess

private boolean _isCurrentUserGrantedAccess(DefaultLink link)

Determines if the current user is allowed to see the link or not

Parameters:

link - the link

Returns:

true if the current user is allowed to see the link, false otherwise

_isIPAuthorized

private boolean _isIPAuthorized(Pattern ipRestriction)

Checks if the IP is authorized for use link internal URL

Parameters:

ipRestriction - The ip restriction pattern

Returns:

true the IP is authorized for use link internal URL, false otherwise