com.bea.netuix.application.manager
Interface ILookAndFeelDefinitionManager

All Known Subinterfaces:

LookAndFeelDefinitionManager

All Known Implementing Classes:

LookAndFeelDefinitionManagerImpl

public interface ILookAndFeelDefinitionManager

This is the primary interface for performing persistent store operations on LookAndFeelDefinitions. In general this interface provides coarse grain getters and fine grain setters.

It is important to note that all methods on this interface are fully internationalized and entitled. All titles and descriptions on the objects returned by these methods are internationalized to the prefered locale. Also, all methods are entitled, meaning if the caller does not have the required credentials the method may return a subset of the actual list or be unable to perform the specified function.

Method Summary

LookAndFeelDefinition	createLookAndFeelDefinition(CustomizationContext customizationContext, LookAndFeelDefinition lookAndFeelDefinition) Creates a new LookAndFeelView Definition.
void	deleteLookAndFeelDefinition(CustomizationContext customizationContext, LookAndFeelDefinitionId lookAndFeelDefinitionId) Delete a lookAndFeel definition.
void	deleteLookAndFeelDefinitionWithReplacement(CustomizationContext customizationContext, LookAndFeelDefinitionId deleteLookAndFeelDefinitionId, LookAndFeelDefinitionId replacementLookAndFeelDefinitionId) Delete a lookAndFeel definition (and its skins, skeletons and themes) and replace any uses of that lookAndFeel with a replacement lookAndFeel.
LookAndFeelDefinition	getLookAndFeelDefinition(CustomizationContext customizationContext, LookAndFeelDefinitionId lookAndFeelDefinitionId) Getter for returning a single LookAndFeelDefinition object given a supplied lookAndFeel definition identifier.
LookAndFeelDefinition	getLookAndFeelDefinitionFromFile(CustomizationContext customizationContext, String lookAndFeelFile, String webAppName) Getter for returning a single LookAndFeelDefinition object given a supplied lookAndFeel file name.
LookAndFeelDefinitionId	getLookAndFeelDefinitionId(CustomizationContext customizationContext, String markupName, String webAppName) Getter for returning a single LookAndFeelDefinitionId object given a supplied lookAndFeel markup name and webapp.
LookAndFeelDefinition[]	getLookAndFeelDefinitions(CustomizationContext customizationContext, String webapp) Getter for returning a list of all LookAndFeelDefinitions scoped to the supplied webapp.
LookAndFeelView	getLookAndFeelView(CustomizationContext customizationContext, LookAndFeelDefinitionId lookAndFeelDefinitionId) Getter for returning an immutable deep copy of a LookAndFeelView.
void	updateLookAndFeelDefinition(CustomizationContext customizationContext, LookAndFeelDefinition lookAndFeelDefinition) Update the lookAndFeel definition with the new data.

Method Detail

getLookAndFeelView

public LookAndFeelView getLookAndFeelView(CustomizationContext customizationContext,
                                          LookAndFeelDefinitionId lookAndFeelDefinitionId)
                                   throws RemoteException

Getter for returning an immutable deep copy of a LookAndFeelView. The LookAndFeelView object, unlike the LookAndFeelDefinition or the LookAndFeelInstance objects contains a full set of references to all child pages, lookAndFeels and so on. The LookAndFeelView object however is immutable.

Parameters:

customizationContext - customization information such as prefered locales and desktopInstanceId returned.

lookAndFeelDefinitionId - the unique lookAndFeelDefinitionId.

Returns:

an immutable deep copy LookAndFeelView object if one exist, otherwise null.

RemoteException

getLookAndFeelDefinitions

public LookAndFeelDefinition[] getLookAndFeelDefinitions(CustomizationContext customizationContext,
                                                         String webapp)
                                                  throws RemoteException

Getter for returning a list of all LookAndFeelDefinitions scoped to the supplied webapp.

Parameters:

customizationContext - customization information such as prefered locales and desktopInstanceId returned.

webapp - the web application these lookAndFeel definitions are scoped to.

Returns:

an array of LookAndFeelDefinition objects if they exist, otherwise, an empty array.

RemoteException

See Also:

LookAndFeelDefinition

getLookAndFeelDefinition

public LookAndFeelDefinition getLookAndFeelDefinition(CustomizationContext customizationContext,
                                                      LookAndFeelDefinitionId lookAndFeelDefinitionId)
                                               throws RemoteException

Getter for returning a single LookAndFeelDefinition object given a supplied lookAndFeel definition identifier.

Parameters:

customizationContext - customization information such as prefered locales and desktopInstanceId returned.

lookAndFeelDefinitionId - the unique lookAndFeel definition identifier.

Returns:

a LookAndFeelDefinition object fully populated and internationalized, otherwise, null>/code> if the object does not exist.

RemoteException

See Also:

LookAndFeelDefinition

getLookAndFeelDefinitionFromFile

public LookAndFeelDefinition getLookAndFeelDefinitionFromFile(CustomizationContext customizationContext,
                                                              String lookAndFeelFile,
                                                              String webAppName)
                                                       throws RemoteException

Getter for returning a single LookAndFeelDefinition object given a supplied lookAndFeel file name.

Parameters:

customizationContext - customization information such as prefered locales and desktopInstanceId returned.

lookAndFeelFile - the unique lookAndFeel definition identifier.

Returns:

a LookAndFeelDefinition object fully populated and internationalized, otherwise, null>/code> if the object does not exist.

RemoteException

See Also:

LookAndFeelDefinition

createLookAndFeelDefinition

public LookAndFeelDefinition createLookAndFeelDefinition(CustomizationContext customizationContext,
                                                         LookAndFeelDefinition lookAndFeelDefinition)
                                                  throws RemoteException,
                                                         MissingDataException,
                                                         NotEntitledException

Creates a new LookAndFeelView Definition. While look and feels can be created by this method they should be created via a .laf file. The .laf file may be located anywhere in the webap pdirectory and immediately gets picked up by the system.

Parameters:

customizationContext - customization information such as prefered locales and http request.

lookAndFeelDefinition - the lookAndFeel data and associated placeholders

Returns:

a fully populated LookAndFeelDefinition

Throws:

MissingDataException - the lookAndFeelDefiniiton supplied as an argument is missing some vital data.

NotEntitledException - the caller is not entitled to create a new lookAndFeel.

RemoteException

updateLookAndFeelDefinition

public void updateLookAndFeelDefinition(CustomizationContext customizationContext,
                                        LookAndFeelDefinition lookAndFeelDefinition)
                                 throws RemoteException,
                                        ObjectNotFoundException,
                                        NotEntitledException,
                                        MissingDataException

Update the lookAndFeel definition with the new data.

Parameters:

customizationContext - customization information such as prefered locales and desktopInstanceId returned.

lookAndFeelDefinition - the lookAndFeeldefinition containing the new data

Throws:

ObjectNotFoundException - if the LocalizationIntersectionId in the LocalizationDefnition is bogus.

MissingDataException - if the LookAndFeelDefinition or any of the ThemeDefinitions are missing non nullable data.

RemoteException

NotEntitledException

deleteLookAndFeelDefinition

public void deleteLookAndFeelDefinition(CustomizationContext customizationContext,
                                        LookAndFeelDefinitionId lookAndFeelDefinitionId)
                                 throws RemoteException,
                                        ObjectNotFoundException,
                                        ObjectInUseException,
                                        NotEntitledException

Delete a lookAndFeel definition. Note if the .laf file still exist the look and feel will get recreated. This method is for deleting a look and feel after the .laf file has been deleted.

Parameters:

customizationContext - customization information such as prefered locales and desktopInstanceId returned.

lookAndFeelDefinitionId - the id of the lookAndFeel definition to delete.

Throws:

ObjectNotFoundException - if the lookAndFeelDefinitionId is bogus

ObjectInUseException - if page instances are currently using this lookAndFeel

NotEntitledException - the caller is not entitled to perform this operation.

RemoteException

See Also:

deleteLookAndFeelDefinitionWithReplacement(com.bea.netuix.application.manager.CustomizationContext, com.bea.netuix.application.identifier.LookAndFeelDefinitionId, com.bea.netuix.application.identifier.LookAndFeelDefinitionId)

deleteLookAndFeelDefinitionWithReplacement

public void deleteLookAndFeelDefinitionWithReplacement(CustomizationContext customizationContext,
                                                       LookAndFeelDefinitionId deleteLookAndFeelDefinitionId,
                                                       LookAndFeelDefinitionId replacementLookAndFeelDefinitionId)
                                                throws RemoteException,
                                                       ObjectNotFoundException,
                                                       NotEntitledException

Delete a lookAndFeel definition (and its skins, skeletons and themes) and replace any uses of that lookAndFeel with a replacement lookAndFeel. This method is useful for deleting a lookAndFeel that is in use by desktop instances and not having to delete those dektopinstances instances. Note if the .laf file still exist the look and feel will get recreated. This method is for deleting a look and feel after the .laf file has been deleted.

Parameters:

customizationContext - customization information such as prefered locales and request.

deleteLookAndFeelDefinitionId - the id of the lookAndFeel definition to delete.

replacementLookAndFeelDefinitionId - the id of the replacement lookAndFeel

Throws:

ObjectNotFoundException - if either of the lookAndFeelDefinitionIds are bogus

NotEntitledException - the caller is not entitled to perform this operation.

RemoteException

See Also:

deleteLookAndFeelDefinition(com.bea.netuix.application.manager.CustomizationContext, com.bea.netuix.application.identifier.LookAndFeelDefinitionId)

getLookAndFeelDefinitionId

public LookAndFeelDefinitionId getLookAndFeelDefinitionId(CustomizationContext customizationContext,
                                                          String markupName,
                                                          String webAppName)
                                                   throws RemoteException

Getter for returning a single LookAndFeelDefinitionId object given a supplied lookAndFeel markup name and webapp.

Parameters:

customizationContext - customization information such as prefered locales and desktopInstanceId returned.

markupName - the markup name attribute supplied on the tag in the .laf file

webAppName - as defined in the config.xml

Returns:

LookAndFeelDefinitionId the unique lookAndFeel definition identifier or null is non existent.

RemoteException