org.ametys.skinfactory.skins

Class SkinDAO

java.lang.Object

org.apache.avalon.framework.logger.AbstractLogEnabled

org.ametys.skinfactory.skins.SkinDAO

All Implemented Interfaces:

Component, LogEnabled, Serviceable

public class SkinDAO
extends AbstractLogEnabled
implements Serviceable, Component

Component to interact with a skin

Field Summary

Fields

Modifier and Type	Field and Description
private static String	__PROD_MODE
private static String	__WORK_MODE
private static DateFormat	_DATE_FORMAT
private ModelDesignsManager	_designsManager
private I18nUtils	_i18nUtils
private LanguagesManager	_languageManager
private SkinLockManager	_lockManager
private SkinModelsManager	_modelsManager
private SiteManager	_siteManager
private SkinFactoryComponent	_skinFactoryManager
private SkinEditionHelper	_skinHelper
private SkinsManager	_skinsManager
private UploadManager	_uploadManager
private UserManager	_userManager
private CurrentUserProvider	_userProvider
static String	SKIN_FACTORY_TOOL_ID Constant for skin editor tool id

Constructor Summary

Constructors

Constructor and Description
SkinDAO()

Method Summary

Modifier and Type	Method and Description
private void	_copyFilesToPreserve(File skinDir)
private String	_getDefaultLanguage(File i18nFile)
private String	_getHash(File skinDir)
private File	_getUploadDir(File tempDir, ImageParameter imgParam)
private List<Object>	_imageFiles2JsonObject(String imageDirPath, String libraryDirPath, File file, String modelName, boolean deep)
private boolean	_isImage(File file)
private void	_preserveFile(File skinDir, File fileToPreserve)
private void	_reapplyModel(File skinDir, File modelDir, String hash)
private Map<String,Object>	_uploadImages2JsonObject(File uploadDir, String skinName, ImageParameter imageParam)
Map<String,Object>	affectDesign(String skinName, String designId) Affect a new design configuration
Map<String,Object>	changeModel(String modelName, String skinName, boolean useDefaults) Change the model of a skin
protected Map<String,Object>	checkLock(File skinDir) Determines the skin directory is locked.
String	checkManualCloseCondition(String skinId) Check the current save state of a skin
Map<String,String>	checkOpenCondition(String siteName) Check the conditions for opening the current skin of a site
Map<String,Object>	getColors(String siteName) Get the colors of a model and its theme for a site.
Map<String,Object>	getCssStyleItems(String siteName) Get the css style items used by a site
Map<String,Object>	getGalleryImages(String skinName, String paramId) Retrieve the list of images for the skin and parameter
List<Object>	getGalleryVariants(String skinName, String paramId) Retrieve the list of gallery variants available for the specified skin and parameter
Map<String,Object>	getLanguages(String siteName) Get the languages available on a site
Map<String,Object>	getParametersValues(String siteName, List<String> paramIds) Get the parameters of the skin of a site
Map<String,Object>	getSkinModelParameters(String modelName) Get the skin model's parameters
List<Object>	getThemeColors(String siteName) Retrieve the list of themes' colors for a site
Map<String,String>	openSkin(String siteName, String mode) Open the skin of a site for edition
Map<String,Object>	restoreDefaults(String skinName) Restore the default parameters for a skin
void	service(ServiceManager manager)
Map<String,Object>	updateColorTheme(String skinName, String themeId) Set the theme used by a skin
Map<String,Object>	updateParameter(String skinName, String lang, String parameterId, String value, boolean uploaded) Update a parameter of the skin
Map<String,Object>	uploadLocalImage(String uploadId, String fileName, String skinName, String parameterId) Upload a local image and set it as value for a image parameter

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

SKIN_FACTORY_TOOL_ID

public static final String SKIN_FACTORY_TOOL_ID

Constant for skin editor tool id

See Also:

Constant Field Values

_DATE_FORMAT

private static final DateFormat _DATE_FORMAT

__WORK_MODE

private static final String __WORK_MODE

See Also:

Constant Field Values

__PROD_MODE

private static final String __PROD_MODE

See Also:

Constant Field Values

_userProvider

private CurrentUserProvider _userProvider

_i18nUtils

private I18nUtils _i18nUtils

_languageManager

private LanguagesManager _languageManager

_designsManager

private ModelDesignsManager _designsManager

_siteManager

private SiteManager _siteManager

_skinHelper

private SkinEditionHelper _skinHelper

_skinFactoryManager

private SkinFactoryComponent _skinFactoryManager

_lockManager

private SkinLockManager _lockManager

_modelsManager

private SkinModelsManager _modelsManager

_skinsManager

private SkinsManager _skinsManager

_userManager

private UserManager _userManager

_uploadManager

private UploadManager _uploadManager

Constructor Detail

SkinDAO

public SkinDAO()

Method Detail

service

public void service(ServiceManager manager)
             throws ServiceException

Specified by:

service in interface Serviceable

Throws:

ServiceException

checkManualCloseCondition

public String checkManualCloseCondition(String skinId)
                                 throws IOException

Check the current save state of a skin

Parameters:

skinId - The skin id

Returns:

The state message.

Throws:

IOException - if an error occurs when manipulating files

checkOpenCondition

public Map<String,String> checkOpenCondition(String siteName)
                                      throws IOException

Check the conditions for opening the current skin of a site

Parameters:

siteName - The name of the site

Returns:

The informations on the state of the site's skin

Throws:

IOException - if an error occurs when manipulating files

checkLock

protected Map<String,Object> checkLock(File skinDir)
                                throws IOException

Determines the skin directory is locked. If no, the lock owner is set in JSON map request attribute

Parameters:

skinDir - The skin directory

Returns:

information about the lock, or null if not locked

Throws:

IOException - if an error occurs when manipulating files

affectDesign

public Map<String,Object> affectDesign(String skinName,
                                       String designId)
                                throws IOException

Affect a new design configuration

Parameters:

skinName - The skin name

designId - The design id

Returns:

the information on the design, or the error.

Throws:

IOException - if an error occurs when manipulating files

changeModel

public Map<String,Object> changeModel(String modelName,
                                      String skinName,
                                      boolean useDefaults)
                               throws IOException,
                                      TransformerConfigurationException,
                                      SAXException

Change the model of a skin

Parameters:

modelName - The model name

skinName - The skin name

useDefaults - true to use default model parameters

Returns:

The skin parameters, or the error informations.

Throws:

IOException - if an error occurs when manipulating files

TransformerConfigurationException - if something goes wrong when generating the model file

SAXException - if an error occurs while saxing

getLanguages

public Map<String,Object> getLanguages(String siteName)

Get the languages available on a site

Parameters:

siteName - The site name

Returns:

The languages informations

_getDefaultLanguage

private String _getDefaultLanguage(File i18nFile)

getColors

public Map<String,Object> getColors(String siteName)

Get the colors of a model and its theme for a site.

Parameters:

siteName - The site name

Returns:

The colors and theme informations.

getCssStyleItems

public Map<String,Object> getCssStyleItems(String siteName)

Get the css style items used by a site

Parameters:

siteName - The site name

Returns:

The css style items.

getParametersValues

public Map<String,Object> getParametersValues(String siteName,
                                              List<String> paramIds)

Get the parameters of the skin of a site

Parameters:

siteName - The site name

paramIds - If not null, specify the ids of the parameters to retrieve

Returns:

The parameters

openSkin

public Map<String,String> openSkin(String siteName,
                                   String mode)
                            throws IOException

Open the skin of a site for edition

Parameters:

siteName - The site name

mode - The open mode

Returns:

The skin id, or an error message.

Throws:

IOException - if an error occurs when manipulating files

_reapplyModel

private void _reapplyModel(File skinDir,
                           File modelDir,
                           String hash)
                    throws IOException

Throws:

IOException

_preserveFile

private void _preserveFile(File skinDir,
                           File fileToPreserve)
                    throws IOException

Throws:

IOException

_copyFilesToPreserve

private void _copyFilesToPreserve(File skinDir)
                           throws IOException

Throws:

IOException

_getHash

private String _getHash(File skinDir)

restoreDefaults

public Map<String,Object> restoreDefaults(String skinName)
                                   throws IOException,
                                          TransformerConfigurationException,
                                          SAXException

Restore the default parameters for a skin

Parameters:

skinName - The skin name

Returns:

The skin informations, or an error code.

Throws:

IOException - if an error occurs when manipulating files

TransformerConfigurationException - if something goes wrong when generating the model file

SAXException - if an error occurs while saxing

updateColorTheme

public Map<String,Object> updateColorTheme(String skinName,
                                           String themeId)
                                    throws IOException

Set the theme used by a skin

Parameters:

skinName - The skin name

themeId - The theme id

Returns:

The theme informations, or an error code.

Throws:

IOException - if an error occurs when manipulating files

updateParameter

public Map<String,Object> updateParameter(String skinName,
                                          String lang,
                                          String parameterId,
                                          String value,
                                          boolean uploaded)
                                   throws IOException

Update a parameter of the skin

Parameters:

skinName - The skin name

lang - The current language

parameterId - The parameter id to update

value - The new value for the parameter

uploaded - true if the file was uploaded

Returns:

The skin parameters updated, or an error code.

Throws:

IOException - if an error occurs when manipulating files

uploadLocalImage

public Map<String,Object> uploadLocalImage(String uploadId,
                                           String fileName,
                                           String skinName,
                                           String parameterId)
                                    throws IOException

Upload a local image and set it as value for a image parameter

Parameters:

uploadId - The upload identifier

fileName - The name of uploaded file

skinName - The skin name

parameterId - The parameter id to update

Returns:

The skin parameters updated, or an error code.

Throws:

IOException - if an error occurs when manipulating files

getGalleryImages

public Map<String,Object> getGalleryImages(String skinName,
                                           String paramId)
                                    throws IOException

Retrieve the list of images for the skin and parameter

Parameters:

skinName - The skin name

paramId - The parameter id

Returns:

The map of images informations

Throws:

IOException - if an error occurs when manipulating files

_uploadImages2JsonObject

private Map<String,Object> _uploadImages2JsonObject(File uploadDir,
                                                    String skinName,
                                                    ImageParameter imageParam)

_imageFiles2JsonObject

private List<Object> _imageFiles2JsonObject(String imageDirPath,
                                            String libraryDirPath,
                                            File file,
                                            String modelName,
                                            boolean deep)

_getUploadDir

private File _getUploadDir(File tempDir,
                           ImageParameter imgParam)

_isImage

private boolean _isImage(File file)

getGalleryVariants

public List<Object> getGalleryVariants(String skinName,
                                       String paramId)
                                throws IOException

Retrieve the list of gallery variants available for the specified skin and parameter

Parameters:

skinName - The skin name

paramId - The parameter id

Returns:

The list of gallery variants

Throws:

IOException - if an error occurs when manipulating files

getSkinModelParameters

public Map<String,Object> getSkinModelParameters(String modelName)

Get the skin model's parameters

Parameters:

modelName - The model name

Returns:

The parameters

getThemeColors

public List<Object> getThemeColors(String siteName)

Retrieve the list of themes' colors for a site

Parameters:

siteName - The site name

Returns:

The model's themes colors