Overview | Package | Class | Tree | Deprecated | Index | Help
| © 2003 BEA Systems, Inc.
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

## 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`

Overview | Package | Class | Tree | Deprecated | Index | Help
| © 2003 BEA Systems, Inc.
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

Copyright © 2003 BEA Systems, Inc. All Rights Reserved