org.ametys.plugins.linkdirectory.link

Class LinkDAO

java.lang.Object

org.apache.avalon.framework.logger.AbstractLogEnabled

org.ametys.plugins.linkdirectory.link.LinkDAO

All Implemented Interfaces:

Component, Contextualizable, LogEnabled, Serviceable

public class LinkDAO
extends AbstractLogEnabled
implements Serviceable, Component, Contextualizable

DAO for manipulating Link

Field Summary

Fields

Modifier and Type	Field and Description
private Context	_cocoonContext
private Context	_context
private CurrentUserProvider	_currentUserProvider
private DirectoryHelper	_directoryHelper
private DynamicInformationProviderExtensionPoint	_dynamicInfoExtensionPoint
private static GroupManager	_groupManager
private JSONUtils	_jsonUtils
private ObservationManager	_observationManager
private AmetysObjectResolver	_resolver
private SiteConfigurationExtensionPoint	_siteConfEP
private SiteManager	_siteManager
private UploadManager	_uploadManager
private UserHelper	_userHelper
private static UserManager	_userManager
static String	ROLE Avalon Role

Constructor Summary

Constructors

Constructor and Description
LinkDAO()

Method Summary

Modifier and Type	Method and Description
protected DefaultLink	_createLink(String name, ModifiableTraversableAmetysObject rootNode) Create the link object.
private void	_moveDown(DefaultLink link) Move link after its following
private void	_moveFirst(DefaultLink link) Move link the first position
private void	_moveLast(DefaultLink link) Move link to the last position.
private void	_moveUp(DefaultLink link) Move link before its preceding
private void	_setLinkValues(Link link, Map<String,Object> values)
private void	_setPicture(Link link, String valueAsStr)
private void	_setRestrictions(Link link, boolean grantAnyUser, String grantedUsersAsString, String grantedGroupsAsString)
private void	_setThemes(Link link, List<String> themes)
private void	_setValues(Link link, Map<String,Object> values)
protected boolean	_urlExists(String url, String internalUrl, String siteName, String language) Test if a link with the specified url or internal url exists in the directory.
protected boolean	_urlExistsForUser(String url, String internalUrl, String siteName, String language, UserIdentity user) Test if a link with the specified url or internal url exists in the directory for the given user.
void	contextualize(Context context)
Map<String,Object>	convertLink2JsonObject(DefaultLink link) Convert a link to JSON object
Map<String,Object>	createLink(Map<String,Object> parameters) Create a new link
Map<String,Object>	createUserLink(Map<String,Object> parameters) Create a new user link
List<String>	deleteLinks(List<String> ids) Delete one or multiples links
List<Map<String,Object>>	getDynamicInformationProviders() Returns the list of providers of dynamic information as json object
Map<String,Object>	getLink(String id) Get the JSON object representing a link
List<Map<String,Object>>	getLinks(List<String> linkIds) Get links infos
boolean	isInternalURLAllowed(String siteName) Determines if the restriction IP parameter is not empty
Map<String,Object>	moveLink(String id, String role) Move a link in the list
void	service(ServiceManager manager)
Map<String,Object>	updateLink(Map<String,Object> parameters) Updates a link

Methods inherited from class org.apache.avalon.framework.logger.AbstractLogEnabled

enableLogging, getLogger, setupLogger, setupLogger, setupLogger

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

Avalon Role

_userManager

private static UserManager _userManager

_groupManager

private static GroupManager _groupManager

_userHelper

private UserHelper _userHelper

_resolver

private AmetysObjectResolver _resolver

_observationManager

private ObservationManager _observationManager

_siteManager

private SiteManager _siteManager

_currentUserProvider

private CurrentUserProvider _currentUserProvider

_uploadManager

private UploadManager _uploadManager

_siteConfEP

private SiteConfigurationExtensionPoint _siteConfEP

_jsonUtils

private JSONUtils _jsonUtils

_directoryHelper

private DirectoryHelper _directoryHelper

_context

private Context _context

_cocoonContext

private Context _cocoonContext

_dynamicInfoExtensionPoint

private DynamicInformationProviderExtensionPoint _dynamicInfoExtensionPoint

Constructor Detail

LinkDAO

public LinkDAO()

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

createLink

public Map<String,Object> createLink(Map<String,Object> parameters)

Create a new link

Parameters:

parameters - a map of the following parameters for the link : siteName, language, url, title, content, url-alternative, picture, picture#type, picture-alternative, themes, grant-any-user, fousers, fogroups

Returns:

The new link id

createUserLink

public Map<String,Object> createUserLink(Map<String,Object> parameters)

Create a new user link

Parameters:

parameters - a map of the following parameters for the link : siteName, language, url, title, content, url-alternative, picture, picture#type, picture-alternative

Returns:

The new link id

updateLink

public Map<String,Object> updateLink(Map<String,Object> parameters)

Updates a link

Parameters:

parameters - a map of the following parameters for the link : siteName, language, id, url, title, content, url-alternative, picture, picture#type, picture-alternative, themes, grant-any-user, fousers, fogroups

Returns:

the update link

_setValues

private void _setValues(Link link,
                        Map<String,Object> values)

_setLinkValues

private void _setLinkValues(Link link,
                            Map<String,Object> values)

_setThemes

private void _setThemes(Link link,
                        List<String> themes)

_setPicture

private void _setPicture(Link link,
                         String valueAsStr)

_setRestrictions

private void _setRestrictions(Link link,
                              boolean grantAnyUser,
                              String grantedUsersAsString,
                              String grantedGroupsAsString)

deleteLinks

public List<String> deleteLinks(List<String> ids)

Delete one or multiples links

Parameters:

ids - a list of links' ids

Returns:

true if all the links were deleted, false if at least one link could not be delete.

moveLink

public Map<String,Object> moveLink(String id,
                                   String role)
                            throws RepositoryException

Move a link in the list

Parameters:

id - the link id

role - the move action

Returns:

the moved link in JSON

Throws:

RepositoryException - if a repository error occurs.

getLink

public Map<String,Object> getLink(String id)

Get the JSON object representing a link

Parameters:

id - the id of link

Returns:

the link as JSON object

isInternalURLAllowed

public boolean isInternalURLAllowed(String siteName)

Determines if the restriction IP parameter is not empty

Parameters:

siteName - the site name

Returns:

true if the restriction IP parameter is not empty

getDynamicInformationProviders

public List<Map<String,Object>> getDynamicInformationProviders()

Returns the list of providers of dynamic information as json object

Returns:

the providers of dynamic information

convertLink2JsonObject

public Map<String,Object> convertLink2JsonObject(DefaultLink link)

Convert a link to JSON object

Parameters:

link - the link

Returns:

the link as JSON object

getLinks

public List<Map<String,Object>> getLinks(List<String> linkIds)

Get links infos

Parameters:

linkIds - the link id

Returns:

the link infos

_urlExists

protected boolean _urlExists(String url,
                             String internalUrl,
                             String siteName,
                             String language)
                      throws AmetysRepositoryException

Test if a link with the specified url or internal url exists in the directory.

Parameters:

url - the url to test.

internalUrl - the internal url to test

siteName - the site name.

language - the language.

Returns:

true if the link exists.

Throws:

AmetysRepositoryException - if a repository error occurs.

_urlExistsForUser

protected boolean _urlExistsForUser(String url,
                                    String internalUrl,
                                    String siteName,
                                    String language,
                                    UserIdentity user)
                             throws AmetysRepositoryException

Test if a link with the specified url or internal url exists in the directory for the given user.

Parameters:

url - the url to test.

internalUrl - the internal url to test

siteName - the site name.

language - the language.

user - The user identity

Returns:

true if the link exists for the given user.

Throws:

AmetysRepositoryException - if a repository error occurs.

_createLink

protected DefaultLink _createLink(String name,
                                  ModifiableTraversableAmetysObject rootNode)

Create the link object.

Parameters:

name - the desired link name.

rootNode - the links root node.

Returns:

the created Link.

_moveFirst

private void _moveFirst(DefaultLink link)
                 throws RepositoryException

Move link the first position

Parameters:

link - the link to move

Throws:

RepositoryException - if an error occurs while exploring the repository

_moveDown

private void _moveDown(DefaultLink link)
                throws RepositoryException

Move link after its following

Parameters:

link - the link to move down

Throws:

RepositoryException - if an error occurs while exploring the repository

_moveUp

private void _moveUp(DefaultLink link)
              throws RepositoryException

Move link before its preceding

Parameters:

link - the link to move up

Throws:

RepositoryException - if an error occurs while exploring the repository

_moveLast

private void _moveLast(DefaultLink link)
                throws RepositoryException

Move link to the last position.

Parameters:

link - the link to move up

Throws:

RepositoryException - if an error occurs while exploring the repository