|
Copyright © 2006 BEA Systems, Inc. All Rights Reserved | ||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface PreferencePersistenceManager
Specifies an interface for managing portlet preferences in a persistence store.
The implementation of this EJB uses an SPI for storing and retrieving
preferences. The SPI is is specified by com.bea.portlet.prefs.IPreferenceAppStore
. To
replace the default implementation of this SPI, update the following env-entry properties:
prefs-spi-jndi-name
: This is the JNDI name of the EJB implementing the SPI.
The default value is BEA_netuix.DefaultStore
.prefs-spi-home-class-name
: This is the class name of the home of the EJB
implementing the SPI. The default value is com.bea.portlet.prefs.provider.DefaultStoreHome
.
Field Summary | |
---|---|
static String |
DEFAULT_SPI_HOME_NAME
|
static String |
DEFAULT_SPI_JNDI_NAME
|
Method Summary | |
---|---|
Map |
getEntityPreferences(PortletPreferencesId uniqueId)
Deprecated |
Map |
getPreferences(CustomizationContext customizationContext,
PortletPreferencesId uniqueId)
Returns preferences for a portlet entity with the given uniqueId . |
Map |
getPreferences(PortletPreferencesId uniqueId)
Deprecated |
void |
removePreferences(CustomizationContext customizationContext,
PortletPreferencesId uniqueId)
Clear all preferences for the given unique ID from the underlying persistence store. |
void |
removePreferences(PortletPreferencesId uniqueId)
Deprecated |
PortletPreferencesId |
storePreferences(CustomizationContext customizationContext,
PortletPreferencesId uniqueId,
Map preferences,
boolean checkForSuccessor,
boolean propagate)
Writes the preferences to the underlying persistence. |
PortletPreferencesId |
storePreferences(CustomizationContext customizationContext,
PortletPreferencesId uniqueId,
Map preferences,
boolean checkForSuccessor,
boolean propagate,
boolean forceSuccessorCreate)
Writes the preferences to the underlying persistence. |
Field Detail |
---|
static final String DEFAULT_SPI_JNDI_NAME
static final String DEFAULT_SPI_HOME_NAME
Method Detail |
---|
Map getPreferences(PortletPreferencesId uniqueId) throws RemoteException, IOException
Returns preferences for a portlet entity with the given
uniqueId
.
The returned java.util.Map
contains
com.bea.netuix.application.prefs.Preference
objects keyed against their names.
uniqueId
- unique ID
RemoteException
IOException
Map getEntityPreferences(PortletPreferencesId uniqueId) throws RemoteException, IOException
Returns preferences for a portlet entity with the given
uniqueId
. Do not go up Predecessor hierarchy
The returned java.util.Map
contains
com.bea.netuix.application.prefs.Preference
objects keyed against their names.
uniqueId
- unique ID
RemoteException
IOException
Map getPreferences(CustomizationContext customizationContext, PortletPreferencesId uniqueId) throws RemoteException, IOException
Returns preferences for a portlet entity with the given
uniqueId
.
The returned java.util.Map
contains
com.bea.netuix.application.prefs.Preference
objects keyed against their names.
uniqueId
- unique ID
RemoteException
IOException
PortletPreferencesId storePreferences(CustomizationContext customizationContext, PortletPreferencesId uniqueId, Map preferences, boolean checkForSuccessor, boolean propagate) throws RemoteException, IOException
Writes the preferences to the underlying persistence.
This method should be implemented to be atomic. That is, the implementation should guarantee that either all preference values are persisted or none at all.
The java.util.Map
argument should contain
com.bea.netuix.application.prefs.Preference
objects keyed against their names.
If the boolean argument is true
, this method
propagates preferences to all successors. The successors would
therefore lose their current preferences. So, use this method
with caution.
customizationContext
- uniqueId
- unique IDpreferences
- preferencescheckForSuccessor
- boolean to indicate if a check to find if
a successor should be createdpropagate
- boolean to indicate if preferences should be
propagated to successors
RemoteException
IOException
PortletPreferencesId storePreferences(CustomizationContext customizationContext, PortletPreferencesId uniqueId, Map preferences, boolean checkForSuccessor, boolean propagate, boolean forceSuccessorCreate) throws RemoteException, IOException
Writes the preferences to the underlying persistence.
This method should be implemented to be atomic. That is, the implementation should guarantee that either all preference values are persisted or none at all.
The java.util.Map
argument should contain
com.bea.netuix.application.prefs.Preference
objects keyed against their names.
If the boolean argument is true
, this method
propagates preferences to all successors. The successors would
therefore lose their current preferences. So, use this method
with caution.
customizationContext
- uniqueId
- unique IDpreferences
- preferencescheckForSuccessor
- boolean to indicate if a check to find if
a successor should be createdpropagate
- boolean to indicate if preferences should be
propagated to successorsforceSuccessorCreate
- if true
- forces the
underlying store to create a new successor
RemoteException
IOException
void removePreferences(PortletPreferencesId uniqueId) throws RemoteException, IOException
Clear all preferences for the given unique ID from the underlying persistence store.
This method removes preferences of all successors. The successors would therefore lose their current preferences.
uniqueId
- unique ID
RemoteException
IOException
void removePreferences(CustomizationContext customizationContext, PortletPreferencesId uniqueId) throws RemoteException, IOException
Clear all preferences for the given unique ID from the underlying persistence store.
This method removes preferences of all successors. The successors would therefore lose their current preferences.
uniqueId
- unique ID
RemoteException
IOException
|
Copyright © 2006 BEA Systems, Inc. All Rights Reserved | ||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |