lumis.portal.theme

Class ThemeManager

java.lang.Object

lumis.portal.theme.ThemeManager

All Implemented Interfaces:

IThemeManagerSPI

public class ThemeManager
extends Object
implements IThemeManagerSPI

Implements theme related operations.

Since:

7.0.0

Version:

$Revision: 22901 $ $Date: 2019-07-02 14:51:03 +0000 (Tue, 02 Jul 2019) $

Field Summary

Fields

Modifier and Type	Field and Description
static String	APPLIED_THEME_PROPERTY_BAG_NAME Applied themes property bag name.
static String	BASE_THEME_PREFIX Base theme prefix lum_basetheme/.
static String	CLASSIC_THEME_ID The classic theme identifier.
static String	LUMIS_PORTAL_7_0_THEME_ID The Lumis Portal 7.0 theme identifier.
static String	LUMIS_PORTAL_9_0_THEME_ID The Lumis Portal 9.0 theme identifier.
static String	LUMIS_PORTAL_ADMIN_THEME_ID The Lumis Portal 7.0 theme identifier.
static String	NO_THEME_PREFIX No theme prefix lum_notheme/.
static String	THEME_DEFINITION_FILE The theme definition file name.
static String	THEME_WWW_RESOURCE_PREFIX The WWW resource prefix lumis-theme/.

Constructor Summary

Constructors

Constructor and Description
ThemeManager()

Method Summary

Modifier and Type	Method and Description
void	clearCache(String themeId) Clears the theme cache.
void	copyThemesFilesToWebRoots(Collection<? extends ITheme> themes, Collection<IWebRootPortalBaseFolder> webRoots) Copies the given themes' WWW resources to the given web root folders.
Collection<ITheme>	getAllThemes() Returns all existent themes.
List<String>	getAppliedThemesIds(ChannelConfig channel) Return the applied themes (identifiers) in the given channel.
List<String>	getAppliedThemesIds(PageConfig page) Returns the applied themes (identifiers) in the given page.
ThemeUsageConfig	getLocalThemes(ChannelConfig channel, String runtimeInterfaceId) Returns the theme usage for the given channel.
ThemeUsageConfig	getLocalThemes(PageConfig page, String runtimeInterfaceId) Returns the theme usage for the given page.
IThemeSPI	getTheme(String themeId) Returns the theme with the given identifier.
List<ITheme>	getThemes(List<String> appliedThemeIds) Returns the applied themes from an applied themes identifiers list.
List<ITheme>	getThemes(WebResource webResource) Returns the applied themes in the given web resource.
void	register(String themePath) Registers a theme in the specified classpath relative path.
void	removeThemeFolderFromWebRoots(Collection<? extends ITheme> themes, Collection<IWebRootPortalBaseFolder> webRoots) Removes the given themes' folders from the given web root folders.
void	unregister(String themeId) Unregisters a theme, removing it from the themes registry.
void	unregister(String themeId, boolean verifyUsage) Unregisters a theme, removing it from the themes registry.
void	updateLocalThemeUsage(ChannelConfig channel, ThemeUsageConfig themeUsage) Updates the theme usage for the given channel.
void	updateLocalThemeUsage(PageConfig page, ThemeUsageConfig themeUsage) Updates the theme usage for the given page.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

THEME_DEFINITION_FILE

public static final String THEME_DEFINITION_FILE

The theme definition file name.

Since:

7.0.0

See Also:

Constant Field Values

APPLIED_THEME_PROPERTY_BAG_NAME

public static final String APPLIED_THEME_PROPERTY_BAG_NAME

Applied themes property bag name.

Since:

7.0.0

See Also:

Constant Field Values

BASE_THEME_PREFIX

public static final String BASE_THEME_PREFIX

Base theme prefix lum_basetheme/.

Since:

7.0.0

See Also:

Constant Field Values

NO_THEME_PREFIX

public static final String NO_THEME_PREFIX

No theme prefix lum_notheme/.

Since:

7.0.0

See Also:

Constant Field Values

THEME_WWW_RESOURCE_PREFIX

public static final String THEME_WWW_RESOURCE_PREFIX

The WWW resource prefix lumis-theme/.

Since:

7.0.0

See Also:

Constant Field Values

CLASSIC_THEME_ID

public static final String CLASSIC_THEME_ID

The classic theme identifier.

Since:

7.0.0

See Also:

Constant Field Values

LUMIS_PORTAL_7_0_THEME_ID

public static final String LUMIS_PORTAL_7_0_THEME_ID

The Lumis Portal 7.0 theme identifier.

Since:

7.1.0

See Also:

Constant Field Values

LUMIS_PORTAL_9_0_THEME_ID

public static final String LUMIS_PORTAL_9_0_THEME_ID

The Lumis Portal 9.0 theme identifier.

Since:

10.0.0

See Also:

Constant Field Values

LUMIS_PORTAL_ADMIN_THEME_ID

public static final String LUMIS_PORTAL_ADMIN_THEME_ID

The Lumis Portal 7.0 theme identifier.

Since:

7.1.0

See Also:

Constant Field Values

Constructor Detail

ThemeManager

public ThemeManager()

Method Detail

register

public void register(String themePath)
              throws PortalException

Description copied from interface: IThemeManagerSPI

Registers a theme in the specified classpath relative path.

The theme will be added or updated in the themes registry.

Specified by:

register in interface IThemeManagerSPI

Parameters:

themePath - the relative path in the classpath, referencing the folder that contains the themedefintion.xml file.

Throws:

PortalException - if an error occurs during register.

unregister

public void unregister(String themeId)
                throws PortalException

Description copied from interface: IThemeManagerSPI

Unregisters a theme, removing it from the themes registry.

Specified by:

unregister in interface IThemeManagerSPI

Parameters:

themeId - the theme identifier.

Throws:

PortalException - if an error occurs during unregister.

unregister

public void unregister(String themeId,
                       boolean verifyUsage)
                throws PortalException

Unregisters a theme, removing it from the themes registry.

Parameters:

themeId - the theme identifier.

verifyUsage - indicates whether the theme usage must be done.

Throws:

PortalException

Since:

7.0.0

getTheme

public IThemeSPI getTheme(String themeId)
                   throws PortalException

Description copied from interface: IThemeManagerSPI

Returns the theme with the given identifier.

Specified by:

getTheme in interface IThemeManagerSPI

Parameters:

themeId - the theme identifier.

Returns:

the theme.

Throws:

PortalObjectNotFoundException - if no theme exists with the given identifier.

PortalException - if an error occurred while obtaining the theme.

getAppliedThemesIds

public List<String> getAppliedThemesIds(ChannelConfig channel)
                                 throws PortalException

Return the applied themes (identifiers) in the given channel.

Parameters:

channel - the channel.

Returns:

the applied themes in the given channel.

Throws:

PortalException

Since:

7.0.0

getAppliedThemesIds

public List<String> getAppliedThemesIds(PageConfig page)
                                 throws PortalException

Returns the applied themes (identifiers) in the given page.

Parameters:

page - the page.

Returns:

the applied themes in the given page.

Throws:

PortalException

Since:

7.0.0

getThemes

public List<ITheme> getThemes(WebResource webResource)
                       throws PortalException

Returns the applied themes in the given web resource. Ignores the inexistent themes.

Parameters:

webResource - the web resource.

Returns:

the applied themes in the given web resource.

Throws:

PortalException

Since:

11.0.0

getThemes

public List<ITheme> getThemes(List<String> appliedThemeIds)
                       throws PortalException

Returns the applied themes from an applied themes identifiers list. Ignores the inexistent themes.

Parameters:

appliedThemeIds - the applied themes identifiers list.

Returns:

the applied themes from an applied themes identifiers list.

Throws:

PortalException

Since:

7.0.0

getLocalThemes

public ThemeUsageConfig getLocalThemes(PageConfig page,
                                       String runtimeInterfaceId)
                                throws PortalException

Returns the theme usage for the given page.

Parameters:

page - the page.

runtimeInterfaceId - the runtime interface identifier being requested (if any).

Returns:

the theme usage for the given page.

Throws:

PortalException

Since:

7.0.0

getLocalThemes

public ThemeUsageConfig getLocalThemes(ChannelConfig channel,
                                       String runtimeInterfaceId)
                                throws PortalException

Returns the theme usage for the given channel.

Parameters:

channel - the channel.

runtimeInterfaceId - the runtime interface identifier being requested (if any).

Returns:

the theme usage for the given channel.

Throws:

PortalException

Since:

7.0.0

updateLocalThemeUsage

public void updateLocalThemeUsage(PageConfig page,
                                  ThemeUsageConfig themeUsage)
                           throws PortalException

Updates the theme usage for the given page.

Parameters:

page - the page.

themeUsage - the theme usage.

Throws:

PortalException

Since:

7.0.0

updateLocalThemeUsage

public void updateLocalThemeUsage(ChannelConfig channel,
                                  ThemeUsageConfig themeUsage)
                           throws PortalException

Updates the theme usage for the given channel.

Parameters:

channel - the channel.

themeUsage - the theme usage.

Throws:

PortalException

Since:

7.0.0

copyThemesFilesToWebRoots

public void copyThemesFilesToWebRoots(Collection<? extends ITheme> themes,
                                      Collection<IWebRootPortalBaseFolder> webRoots)
                               throws PortalException

Copies the given themes' WWW resources to the given web root folders.

Parameters:

themes - the themes.

webRoots - the web root folders.

Throws:

PortalException

Since:

7.0.0

removeThemeFolderFromWebRoots

public void removeThemeFolderFromWebRoots(Collection<? extends ITheme> themes,
                                          Collection<IWebRootPortalBaseFolder> webRoots)
                                   throws PortalException

Removes the given themes' folders from the given web root folders. If the remaining folder "lumis-theme" is empty after the themes' folders removal it will also be removed.

Parameters:

themes - the themes.

webRoots - the web root folders.

Throws:

PortalException

Since:

7.0.0

getAllThemes

public Collection<ITheme> getAllThemes()
                                throws PortalException

Returns all existent themes. Does not use cache.

Specified by:

getAllThemes in interface IThemeManagerSPI

Returns:

all existent themes.

Throws:

PortalException

Since:

7.0.0

clearCache

public void clearCache(String themeId)
                throws PortalException

Description copied from interface: IThemeManagerSPI

Clears the theme cache.

Specified by:

clearCache in interface IThemeManagerSPI

Parameters:

themeId - the theme identifier

Throws:

PortalException