org.apache.jetspeed.components.portletpreferences
Interface PortletPreferencesProvider

All Superinterfaces:
org.apache.pluto.container.PortletPreferencesService

public interface PortletPreferencesProvider
extends org.apache.pluto.container.PortletPreferencesService

Version:
$Id: PortletPreferencesProvider.java 884254 2009-11-25 20:35:29Z taylor $

Method Summary
 java.util.Set<java.lang.String> getPortletWindowIds(PortletDefinition portletdefinition)
          Retrieve entity ids (window) given portlet definitaion
 java.util.Set<java.lang.String> getUserNames(PortletDefinition portletdefinition, java.lang.String windowId)
          Retrieve user names for given entity(window) id and portlet definitaion
 java.util.Map<java.lang.String,org.apache.pluto.container.PortletPreference> getUserPreferences(PortletDefinition portletdefinition, java.lang.String windowId, java.lang.String userName)
          Retrieve entity preference names for given entity(window) id ,portlet definitaion and user name
 void preload()
          Initializes the preferences node by executing configured preloads.
 void preloadApplicationPreferences(java.lang.String portletApplicationName)
          Preload all preferences for the given portlet application name into the preferences cache
 void preloadUserPreferences()
          Preload all user preferences for all users into the preferences cache.
 void removeDefaults(PortletApplication app)
          Remove all default preferences for all portlet definitions in a given portlet application
 void removeDefaults(PortletDefinition pd)
          Remove all default preferences for a given portlet definition
 void removeDefaults(PortletDefinition pd, java.lang.String preferenceName)
          Remove default preferences by preference name for a given portlet definition
 java.util.Map<java.lang.String,org.apache.pluto.container.PortletPreference> retrieveDefaultPreferences(PortletDefinition pd)
          Retrieve the default preferences for a given portlet definition
 java.util.Map<java.lang.String,org.apache.pluto.container.PortletPreference> retrieveEntityPreferences(PortletWindow window)
          Retrieve entity (window) default preferences for a given window
 java.util.Map<java.lang.String,org.apache.pluto.container.PortletPreference> retrieveUserPreferences(PortletWindow window, java.lang.String userName)
          Retrieve the user preferences for the window and user parameters
 void storeDefaults(PortletApplication app)
          Store the default preferences for all portlets in the given portlet application
 void storeDefaults(PortletDefinition pd, Preference preference)
          Store the default preferences by input preference for a given portlet definition
 void storeDefaults(PortletDefinition pd, Preferences prefs)
          Store the default preferences by descriptor preferences for a given portlet definition
 void storeEntityPreferences(java.util.Map<java.lang.String,org.apache.pluto.container.PortletPreference> map, PortletWindow window)
          Store entity preferences contained in the map parameter for a given window
 void storePortletPreference(PortletDefinition portletdefinition, java.lang.String windowId, java.lang.String userName, java.util.Map<java.lang.String,org.apache.pluto.container.PortletPreference> map)
          Store portlet definition entity preferences contained in the map parameter for a given window and username
 void storePortletPreference(java.lang.String appName, java.lang.String portletName, java.lang.String windowId, java.lang.String userName, java.util.Map<java.lang.String,org.apache.pluto.container.PortletPreference> map)
          Store portlet entity preferences contained in the map parameter for a given window and username
 void storeUserPreferences(java.util.Map<java.lang.String,org.apache.pluto.container.PortletPreference> map, PortletWindow window, java.lang.String userName)
          Store user preferences contained in the map parameter for a given user and window
 
Methods inherited from interface org.apache.pluto.container.PortletPreferencesService
getDefaultPreferences, getPreferencesValidator, getStoredPreferences, store
 

Method Detail

preload

void preload()
             throws java.lang.Exception
Initializes the preferences node by executing configured preloads.

Throws:
java.lang.Exception

preloadApplicationPreferences

void preloadApplicationPreferences(java.lang.String portletApplicationName)
Preload all preferences for the given portlet application name into the preferences cache

Parameters:
portletApplicationName -

preloadUserPreferences

void preloadUserPreferences()
Preload all user preferences for all users into the preferences cache. Be careful with this method as it can chew up a lot of memory. Ensure the cache is configured to be large enough to hold all preferences


storeDefaults

void storeDefaults(PortletDefinition pd,
                   Preferences prefs)
Store the default preferences by descriptor preferences for a given portlet definition

Parameters:
pd -

storeDefaults

void storeDefaults(PortletDefinition pd,
                   Preference preference)
Store the default preferences by input preference for a given portlet definition

Parameters:
pd -

storeDefaults

void storeDefaults(PortletApplication app)
Store the default preferences for all portlets in the given portlet application

Parameters:
app -

removeDefaults

void removeDefaults(PortletDefinition pd)
Remove all default preferences for a given portlet definition

Parameters:
pd -

removeDefaults

void removeDefaults(PortletDefinition pd,
                    java.lang.String preferenceName)
Remove default preferences by preference name for a given portlet definition

Parameters:
pd -

removeDefaults

void removeDefaults(PortletApplication app)
Remove all default preferences for all portlet definitions in a given portlet application

Parameters:
app -

retrieveDefaultPreferences

java.util.Map<java.lang.String,org.apache.pluto.container.PortletPreference> retrieveDefaultPreferences(PortletDefinition pd)
Retrieve the default preferences for a given portlet definition

Parameters:
pd -
Returns:
the default preferences map for a given portlet definition

retrieveUserPreferences

java.util.Map<java.lang.String,org.apache.pluto.container.PortletPreference> retrieveUserPreferences(PortletWindow window,
                                                                                                     java.lang.String userName)
Retrieve the user preferences for the window and user parameters

Parameters:
window -
userName -
Returns:

retrieveEntityPreferences

java.util.Map<java.lang.String,org.apache.pluto.container.PortletPreference> retrieveEntityPreferences(PortletWindow window)
Retrieve entity (window) default preferences for a given window

Parameters:
window -
Returns:

storeUserPreferences

void storeUserPreferences(java.util.Map<java.lang.String,org.apache.pluto.container.PortletPreference> map,
                          PortletWindow window,
                          java.lang.String userName)
                          throws PreferencesException
Store user preferences contained in the map parameter for a given user and window

Parameters:
map -
window -
userName -
Throws:
PreferencesException

storeEntityPreferences

void storeEntityPreferences(java.util.Map<java.lang.String,org.apache.pluto.container.PortletPreference> map,
                            PortletWindow window)
                            throws PreferencesException
Store entity preferences contained in the map parameter for a given window

Parameters:
map -
page -
window -
Throws:
PreferencesException

getPortletWindowIds

java.util.Set<java.lang.String> getPortletWindowIds(PortletDefinition portletdefinition)
Retrieve entity ids (window) given portlet definitaion

Parameters:
portletdefinition -

getUserNames

java.util.Set<java.lang.String> getUserNames(PortletDefinition portletdefinition,
                                             java.lang.String windowId)
Retrieve user names for given entity(window) id and portlet definitaion

Parameters:
portletdefinition -
windowId -

getUserPreferences

java.util.Map<java.lang.String,org.apache.pluto.container.PortletPreference> getUserPreferences(PortletDefinition portletdefinition,
                                                                                                java.lang.String windowId,
                                                                                                java.lang.String userName)
Retrieve entity preference names for given entity(window) id ,portlet definitaion and user name

Parameters:
portletdefinition -
windowId -

storePortletPreference

void storePortletPreference(PortletDefinition portletdefinition,
                            java.lang.String windowId,
                            java.lang.String userName,
                            java.util.Map<java.lang.String,org.apache.pluto.container.PortletPreference> map)
Store portlet definition entity preferences contained in the map parameter for a given window and username

Parameters:
portletdefinition -
windowId -
userName -
map -

storePortletPreference

void storePortletPreference(java.lang.String appName,
                            java.lang.String portletName,
                            java.lang.String windowId,
                            java.lang.String userName,
                            java.util.Map<java.lang.String,org.apache.pluto.container.PortletPreference> map)
Store portlet entity preferences contained in the map parameter for a given window and username

Parameters:
appName -
portletName -
windowId -
userName -
map -


Copyright © 1999-2011 The Apache Software Foundation. All Rights Reserved.