Package 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	Description
private Context	_cocoonContext
private LinkDirectoryColorsComponent	_colorComponent
private Context	_context
private CurrentUserProvider	_currentUserProvider
private DirectoryHelper	_directoryHelper
private DynamicInformationProviderExtensionPoint	_dynamicInfoExtensionPoint
private JSONUtils	_jsonUtils
private ObservationManager	_observationManager
private ProfileAssignmentStorageExtensionPoint	_profileAssignmentStorageEP
private AmetysObjectResolver	_resolver
private RightManager	_rightManager
private SiteManager	_siteManager
private UploadManager	_uploadManager
static String	ROLE	Avalon Role

Constructor Summary

Constructors

Constructor	Description
LinkDAO()

Method Summary

Modifier and Type	Method	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	_setAccess(Link link, UserIdentity user)	Set access to the link
private void	_setLinkValues(Link link, Map<String,Object> values)
private void	_setPicture(Link link, String valueAsStr)
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
String	getLinkColor(DefaultLink link)	Retrieves the color of the 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

_resolver

private AmetysObjectResolver _resolver

_observationManager

private ObservationManager _observationManager

_siteManager

private SiteManager _siteManager

_currentUserProvider

private CurrentUserProvider _currentUserProvider

_uploadManager

private UploadManager _uploadManager

_rightManager

private RightManager _rightManager

_profileAssignmentStorageEP

private ProfileAssignmentStorageExtensionPoint _profileAssignmentStorageEP

_jsonUtils

private JSONUtils _jsonUtils

_directoryHelper

private DirectoryHelper _directoryHelper

_context

private Context _context

_cocoonContext

private Context _cocoonContext

_dynamicInfoExtensionPoint

private DynamicInformationProviderExtensionPoint _dynamicInfoExtensionPoint

_colorComponent

private LinkDirectoryColorsComponent _colorComponent

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)

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

_setAccess

private void _setAccess(Link link,
                        UserIdentity user)

Set access to the link

Parameters:

link - the link

user - the user to set access. Can be null, in this case, we set anonymous right

getLinkColor

public String getLinkColor(DefaultLink link)

Retrieves the color of the link. If there is no color configured on the link, the default site color

Parameters:

link - the link

Returns:

the color of the link