Package org.ametys.web.skin

Class SkinDAO

java.lang.Object

org.apache.avalon.framework.logger.AbstractLogEnabled

org.ametys.web.skin.SkinDAO

All Implemented Interfaces:

Component, Contextualizable, LogEnabled, Serviceable

public class SkinDAO
extends AbstractLogEnabled
implements Serviceable, Component, Contextualizable

DAO for manipulating skins

Field Summary

Fields

Modifier and Type	Field	Description
protected ServiceManager	_manager	The service manager instance
static final String	ROLE	The avalon role

Constructor Summary

Constructors

Constructor	Description
SkinDAO()

Method Summary

Modifier and Type	Method	Description
Map<String,Object>	configureSkin(String skinName, Map<String,Object> values)	Configure a skin
void	contextualize(Context context)
String	copySkin(String skinId, String originalSkinId)	Duplicate an existing skin
String	deleteSkin(String skinId)	Delete a skin
Map<String,Object>	getSkin(String skinId)	Retrieve informations on a skin
Map<String,Object>	getSkins(boolean includeAbstract)	Retrieve the list of available skins
Map<String,Object>	importSkin(String skinName, String tmpDirPath, Map<String,Object> values)	This action receive a form with the "importfile" zip file as an exported skin.
boolean	isInUse(String skinId)	Determines if a skin is currently used by one or more sites
Collection<DefinitionAndValue>	readValues(Path skinDir, Collection<ElementDefinition> skinParameterDefinitions)	Parse the values file and make a liaison with the definitions, to return a collection of DefinitionAndValue
void	service(ServiceManager manager)
boolean	skinExists(String skinId)	Determines if a skin exists

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 Details

ROLE

public static final String ROLE

The avalon role

_manager

protected ServiceManager _manager

The service manager instance

Constructor Details

SkinDAO

public SkinDAO()

Method Details

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

getSkin

public Map<String,Object> getSkin(String skinId)

Retrieve informations on a skin

Parameters:

skinId - The skin id

Returns:

the informations of a skin

skinExists

public boolean skinExists(String skinId)
                   throws ProcessingException

Determines if a skin exists

Parameters:

skinId - The skin id

Returns:

true if skin exists.

Throws:

ProcessingException - if an error occurs

isInUse

public boolean isInUse(String skinId)

Determines if a skin is currently used by one or more sites

Parameters:

skinId - The skin id

Returns:

true if skin is currently in use

getSkins

public Map<String,Object> getSkins(boolean includeAbstract)

Retrieve the list of available skins

Parameters:

includeAbstract - Should include abstract skins

Returns:

a map of skins

importSkin

public Map<String,Object> importSkin(String skinName,
 String tmpDirPath,
 Map<String,Object> values)
                              throws TransformerConfigurationException,
IOException,
SAXException,
ProcessingException

This action receive a form with the "importfile" zip file as an exported skin. Replace existing skin

Parameters:

skinName - The skin name

tmpDirPath - The directory where the zip was uploaded

values - the configuration's values. Can be empty.

Returns:

The skin name

Throws:

SAXException - if an error occurs during configuration file creation

IOException - if an error occurs while manipulating files

TransformerConfigurationException - if an error occurs during configuration file creation

ProcessingException - error while parsing model

configureSkin

public Map<String,Object> configureSkin(String skinName,
 Map<String,Object> values)
                                 throws TransformerConfigurationException,
IOException,
SAXException,
ProcessingException

Configure a skin

Parameters:

skinName - the skin name

values - the configuration's values

Returns:

A map with "errors" key that is a map <errorName> <errorMessage>

Throws:

SAXException - if an error occurs during configuration file creation

IOException - if an error occurs during configuration file creation

TransformerConfigurationException - if an error occurs during configuration file creation

ProcessingException - error while parsing model

copySkin

public String copySkin(String skinId,
 String originalSkinId)
                throws IOException

Duplicate an existing skin

Parameters:

skinId - The new skin id

originalSkinId - The original skin id

Returns:

An error message, or null if successful

Throws:

IOException - if an I/O exception occurs during copy

deleteSkin

public String deleteSkin(String skinId)
                  throws IOException

Delete a skin

Parameters:

skinId - The skin id

Returns:

the skin id

Throws:

IOException - if an I/O exception occurs during deletion

readValues

public Collection<DefinitionAndValue> readValues(Path skinDir,
 Collection<ElementDefinition> skinParameterDefinitions)
                                          throws Exception

Parse the values file and make a liaison with the definitions, to return a collection of DefinitionAndValue

Parameters:

skinDir - folder of the skin

skinParameterDefinitions - the skin parameter definitions

Returns:

a Collection of DefinitionAndValue using flatDefinitions and the values found in skinDir

Throws:

Exception - Impossible to read the file