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
private static String	__LICENCE
private Context	_context
private I18nUtils	_i18nUtils
protected ServiceManager	_manager	The service manager instance
private SkinModelsManager	_modelsManager
private SiteManager	_siteManager
private SkinParameterTypeExtensionPoint	_skinParameterTypeEP
private SkinsManager	_skinsManager
static String	ROLE	The avalon role

Constructor Summary

Constructors

Constructor	Description
SkinDAO()

Method Summary

Modifier and Type	Method	Description
private void	_createConfigFile(SkinParametersModel model, Path skinDir, Map<String,Object> values)
private Map<String,DefinitionAndValue>	_getDefinitionAndValues(Map<String,Object> values, Collection<ElementDefinition> skinParameterDefinitions)
private static Predicate<Path>	_getModelFilter(Path skinDir)	This filter accepts all Files excepted CVS and SVN directories and root directory named "model"
private Map<String,Object>	_skin2JsonObject(String id, List<Site> skinSites)
private List<Object>	_skins2JsonObject(boolean includeAbstract)
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 Detail

ROLE

public static final String ROLE

The avalon role

__LICENCE

private static final String __LICENCE

See Also:

Constant Field Values

_manager

protected ServiceManager _manager

The service manager instance

_context

private Context _context

_skinsManager

private SkinsManager _skinsManager

_modelsManager

private SkinModelsManager _modelsManager

_siteManager

private SiteManager _siteManager

_i18nUtils

private I18nUtils _i18nUtils

_skinParameterTypeEP

private SkinParameterTypeExtensionPoint _skinParameterTypeEP

Constructor Detail

SkinDAO

public SkinDAO()

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

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

_skins2JsonObject

private List<Object> _skins2JsonObject(boolean includeAbstract)

_skin2JsonObject

private Map<String,Object> _skin2JsonObject(String id,
                                                  List<Site> skinSites)

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

_getDefinitionAndValues

private Map<String,DefinitionAndValue> _getDefinitionAndValues(Map<String,Object> values,
                                                                     Collection<ElementDefinition> skinParameterDefinitions)

_createConfigFile

private void _createConfigFile(SkinParametersModel model,
                               Path skinDir,
                               Map<String,Object> values)
                        throws IOException,
                               SAXException,
                               TransformerConfigurationException

Throws:

IOException

SAXException

TransformerConfigurationException

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

_getModelFilter

private static final Predicate<Path> _getModelFilter(Path skinDir)

This filter accepts all Files excepted CVS and SVN directories and root directory named "model"

Parameters:

skinDir - The model root directory

Returns:

the filter

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