com.flexive.shared.interfaces

Interface ResultPreferencesEngine

All Known Subinterfaces:

ResultPreferencesEngineLocal

public interface ResultPreferencesEngine

Interface for retrieving and updating the displayed result properties.

Version:

$Rev: 2906 $

Author:

Daniel Lichtenberger (daniel.lichtenberger@flexive.com), UCS - unique computing solutions gmbh (http://www.ucs.at)

Method Summary

Modifier and Type	Method and Description
boolean	isCustomized(long typeId, com.flexive.shared.search.ResultViewType viewType, com.flexive.shared.search.ResultLocation location) Returns true when the user actually stored a configuration for the given parameters.
com.flexive.shared.search.ResultPreferences	load(long typeId, com.flexive.shared.search.ResultViewType viewType, com.flexive.shared.search.ResultLocation location) Loads the result preferences for the given type for the current user.
com.flexive.shared.search.ResultPreferences	loadSystemDefault(long typeId, com.flexive.shared.search.ResultViewType viewType, com.flexive.shared.search.ResultLocation location) Loads the system default result preferences for the given type.
void	remove(long typeId, com.flexive.shared.search.ResultViewType viewType, com.flexive.shared.search.ResultLocation location) Remove the current user's preferences for the given parameters.
void	save(com.flexive.shared.search.ResultPreferences preferences, long typeId, com.flexive.shared.search.ResultViewType viewType, com.flexive.shared.search.ResultLocation location) Save the given result preferences for the current user.
void	saveInSource(com.flexive.shared.search.ResultPreferences preferences, long typeId, com.flexive.shared.search.ResultViewType viewType, com.flexive.shared.search.ResultLocation location) Save the given result preferences for the current user, using the type ID where the existing result preferences are stored.
void	saveSystemDefault(com.flexive.shared.search.ResultPreferences preferences, long typeId, com.flexive.shared.search.ResultViewType viewType, com.flexive.shared.search.ResultLocation... locations) Save the given result preferences as the default settings for the given type, viewtype, and location.

Method Detail

load

com.flexive.shared.search.ResultPreferences load(long typeId,
                                                 com.flexive.shared.search.ResultViewType viewType,
                                                 com.flexive.shared.search.ResultLocation location)
                                          throws com.flexive.shared.exceptions.FxApplicationException

Loads the result preferences for the given type for the current user. When no preferences are defined for the given parameters, the default preferences are returned.

Parameters:

typeId - the content type ID, or -1 for the "overall" properties

viewType - the view type (list, thumbs)

location - the "location" where the results will be displayed (e.g. the main admin result pages)

Returns:

the result preferences for the given type for the current user.

Throws:

com.flexive.shared.exceptions.FxApplicationException - if the result preferences could not be loaded

loadSystemDefault

com.flexive.shared.search.ResultPreferences loadSystemDefault(long typeId,
                                                              com.flexive.shared.search.ResultViewType viewType,
                                                              com.flexive.shared.search.ResultLocation location)
                                                       throws com.flexive.shared.exceptions.FxApplicationException

Loads the system default result preferences for the given type. When no preferences are defined for the given parameters, an empty ResultPreferences object is returned.

Parameters:

typeId - the content type ID, or -1 for the "overall" properties

viewType - the view type (list, thumbs)

location - the "location" where the results will be displayed (e.g. the main admin result pages)

Returns:

the system default result preferences for the given type.

Throws:

com.flexive.shared.exceptions.FxApplicationException - if the result preferences could not be loaded

isCustomized

boolean isCustomized(long typeId,
                     com.flexive.shared.search.ResultViewType viewType,
                     com.flexive.shared.search.ResultLocation location)
              throws com.flexive.shared.exceptions.FxApplicationException

Returns true when the user actually stored a configuration for the given parameters. Used to check if fallbacks were used when loading preferences via load(long, com.flexive.shared.search.ResultViewType, com.flexive.shared.search.ResultLocation).

Parameters:

typeId - the content type ID, or -1 for the "overall" properties

viewType - the view type (list, thumbs)

location - the "location" where the results will be displayed (e.g. the main admin result pages)

Returns:

true when the user actually stored a configuration for the given parameters

Throws:

com.flexive.shared.exceptions.FxApplicationException - on errors

save

void save(com.flexive.shared.search.ResultPreferences preferences,
          long typeId,
          com.flexive.shared.search.ResultViewType viewType,
          com.flexive.shared.search.ResultLocation location)
   throws com.flexive.shared.exceptions.FxApplicationException

Save the given result preferences for the current user.

Parameters:

preferences - the preferences to be saved

typeId - the content type ID

viewType - the view type (list, thumbs)

location - the "location" where the results will be displayed

Throws:

com.flexive.shared.exceptions.FxApplicationException - if the result preferences could not be updated

saveInSource

void saveInSource(com.flexive.shared.search.ResultPreferences preferences,
                  long typeId,
                  com.flexive.shared.search.ResultViewType viewType,
                  com.flexive.shared.search.ResultLocation location)
           throws com.flexive.shared.exceptions.FxApplicationException

Save the given result preferences for the current user, using the type ID where the existing result preferences are stored. If a type does not specify result preferences, the fallback preferences will be updated.

Only when a user has no own result preferences and uses the system default's, a new configuration entry will be created (instead of updating the shared result preferences).

Parameters:

preferences - the preferences to be saved

typeId - the content type ID

viewType - the view type (list, thumbs)

location - the "location" where the results will be displayed

Throws:

com.flexive.shared.exceptions.FxApplicationException - if the result preferences could not be updated

Since:

3.1

saveSystemDefault

void saveSystemDefault(com.flexive.shared.search.ResultPreferences preferences,
                       long typeId,
                       com.flexive.shared.search.ResultViewType viewType,
                       com.flexive.shared.search.ResultLocation... locations)
                throws com.flexive.shared.exceptions.FxApplicationException

Save the given result preferences as the default settings for the given type, viewtype, and location. Only the global supervisor can do this.

Parameters:

preferences - the preferences to be saved

typeId - the content type ID

viewType - the view type (list, thumbs)

locations - the result location(s) where the results will be displayed

Throws:

com.flexive.shared.exceptions.FxApplicationException - if the result preferences could not be updated

remove

void remove(long typeId,
            com.flexive.shared.search.ResultViewType viewType,
            com.flexive.shared.search.ResultLocation location)
     throws com.flexive.shared.exceptions.FxApplicationException

Remove the current user's preferences for the given parameters. If no preferences exist for the given parameters, no action is performed.

Parameters:

typeId - the content type ID, or -1 for the "overall" properties

viewType - the view type (list, thumbs)

location - the "location" where the results will be displayed (e.g. the main admin result pages)

Throws:

com.flexive.shared.exceptions.FxApplicationException - if the user's preferences could not be removed