com.bea.netuix.application.manager
Interface IShellDefinitionManager

All Known Subinterfaces:

ShellDefinitionManager

All Known Implementing Classes:

ShellDefinitionManagerImpl

public interface IShellDefinitionManager

This is the primary interface for performing persistent store operations on ShellDefinitions. 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

ShellDefinition	createShellDefinition(CustomizationContext customizationContext, ShellDefinition shellDefinition) Creates a new ShellView Definition with its placeholders.
void	deleteShellDefinition(CustomizationContext customizationContext, ShellDefinitionId shellDefinitionId) Delete a shell definition.
void	deleteShellDefinitionWithReplacement(CustomizationContext customizationContext, ShellDefinitionId deleteShellDefinitionId, ShellDefinitionId replacementShellDefinitionId) Delete a shell definition and replace any uses of that shell with a replacement shell.
ShellDefinition	getShellDefinition(CustomizationContext customizationContext, ShellDefinitionId shellDefinitionId) Getter for returning a single ShellDefinition object given a supplied shell definition identifier.
ShellDefinition	getShellDefinitionFromFile(CustomizationContext customizationContext, String shellFile, String webAppName) Return a shel definition with the shellFile equal to the supplied filePath.
ShellDefinitionId	getShellDefinitionId(CustomizationContext customizationContext, String markupName, String webAppName) Getter for returning a single ShellDefinitionId object given a supplied shell markup name.
ShellDefinition[]	getShellDefinitions(CustomizationContext customizationContext, String webapp) Getter for returning a list of all ShellDefinitions scoped to the supplied webapp.
ShellView	getShellView(CustomizationContext customizationContext, ShellDefinitionId shellDefinitionId) Getter for returning an immutable deep copy of a ShellView.
void	updateShellDefinition(CustomizationContext customizationContext, ShellDefinition shellDefinition) Update the shell definition with the new data.

Method Detail

getShellView

public ShellView getShellView(CustomizationContext customizationContext,
                              ShellDefinitionId shellDefinitionId)
                       throws RemoteException

Getter for returning an immutable deep copy of a ShellView. The ShellView object, unlike the ShellDefinition or the ShellInstance objects contains a full set of references to all child pages, shells and so on. The ShellView object however is immutable.

Parameters:

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

shellDefinitionId - the unique shellDefinitionId.

Returns:

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

RemoteException

getShellDefinitions

public ShellDefinition[] getShellDefinitions(CustomizationContext customizationContext,
                                             String webapp)
                                      throws RemoteException

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

Parameters:

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

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

Returns:

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

RemoteException

See Also:

ShellDefinition

getShellDefinition

public ShellDefinition getShellDefinition(CustomizationContext customizationContext,
                                          ShellDefinitionId shellDefinitionId)
                                   throws RemoteException

Getter for returning a single ShellDefinition object given a supplied shell definition identifier.

Parameters:

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

shellDefinitionId - the unique shell definition identifier.

Returns:

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

RemoteException

See Also:

ShellDefinition

createShellDefinition

public ShellDefinition createShellDefinition(CustomizationContext customizationContext,
                                             ShellDefinition shellDefinition)
                                      throws MissingDataException,
                                             NotEntitledException,
                                             RemoteException

Creates a new ShellView Definition with its placeholders.

Parameters:

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

shellDefinition - the shell data and associated placeholders

Returns:

a fully populated ShellDefinition

Throws:

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

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

RemoteException

updateShellDefinition

public void updateShellDefinition(CustomizationContext customizationContext,
                                  ShellDefinition shellDefinition)
                           throws ObjectNotFoundException,
                                  NotEntitledException,
                                  RemoteException

Update the shell definition with the new data.

Parameters:

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

shellDefinition - the shell definition containing the new data

Throws:

ObjectNotFoundException - if the LocalizationIntersectionId in the LocalizationResource is bogus.

NotEntitledException

RemoteException

deleteShellDefinition

public void deleteShellDefinition(CustomizationContext customizationContext,
                                  ShellDefinitionId shellDefinitionId)
                           throws ObjectNotFoundException,
                                  ObjectInUseException,
                                  NotEntitledException,
                                  RemoteException

Delete a shell definition.

Parameters:

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

shellDefinitionId - the id of the shell definition to delete.

Throws:

ObjectNotFoundException - if the shellDefinitionId is bogus

ObjectInUseException - if page instances are currently using this shell

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

RemoteException

See Also:

deleteShellDefinitionWithReplacement(com.bea.netuix.application.manager.CustomizationContext, com.bea.netuix.application.identifier.ShellDefinitionId, com.bea.netuix.application.identifier.ShellDefinitionId)

deleteShellDefinitionWithReplacement

public void deleteShellDefinitionWithReplacement(CustomizationContext customizationContext,
                                                 ShellDefinitionId deleteShellDefinitionId,
                                                 ShellDefinitionId replacementShellDefinitionId)
                                          throws ObjectNotFoundException,
                                                 NotEntitledException,
                                                 RemoteException

Delete a shell definition and replace any uses of that shell with a replacement shell. This method is useful for deleting a shell that is in use by book instances and not having to delete those book instances.

Parameters:

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

deleteShellDefinitionId - the id of the shell definition to delete.

replacementShellDefinitionId - the id of the replacement shell

Throws:

ObjectNotFoundException - if either of the shellDefinitionIds are bogus

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

RemoteException

See Also:

deleteShellDefinition(com.bea.netuix.application.manager.CustomizationContext, com.bea.netuix.application.identifier.ShellDefinitionId)

getShellDefinitionId

public ShellDefinitionId getShellDefinitionId(CustomizationContext customizationContext,
                                              String markupName,
                                              String webAppName)
                                       throws RemoteException

Getter for returning a single ShellDefinitionId object given a supplied shell markup name.

Parameters:

customizationContext - customization information such as prefered locales and desktopInstanceId.

markupName - the markup name attribute supplied on the tag,

webAppName - as defined in the config.xml

Returns:

shellDefinitionId the unique shell definition identifier or null if none exist.

RemoteException

getShellDefinitionFromFile

public ShellDefinition getShellDefinitionFromFile(CustomizationContext customizationContext,
                                                  String shellFile,
                                                  String webAppName)
                                           throws RemoteException

Return a shel definition with the shellFile equal to the supplied filePath. The webAppName name is the deployed name of the module, and is often the name of the WAR file or directory, although this is not always the case. This name is that name given in config.xml as the Name of the WebAppComponent element (and thus WebAppComponentMBean's Name attribute). Note that this name is not the name of the URL context root.

Parameters:

customizationContext -

shellFile - the relative path to the shell file from the webapp directory example "/framework/makrup/headfooter.shell"

webAppName - as defined in the config.xml

RemoteException