lumis.portal.page
Interface IPageManager

Package class diagram package IPageManager
All Superinterfaces:
IConfigDeleter, IConfigKeyChecker
All Known Implementing Classes:
PageManager

@StableMinor(version="4.1",
             sinceVersion="4.0")
public interface IPageManager
extends IConfigDeleter, IConfigKeyChecker

Interface to Page Manager

Since:
4.0.6

Method Summary
 String add(SessionConfig sessionConfig, PageConfig pageConfig, ITransaction transaction)
          Add a page.
 void addCssLink(SessionConfig sessionConfig, String pageId, String cssId, int position, ITransaction transaction)
          Add the hyperlink to the page's CSS file.
 void addOrUpdate(SessionConfig sessionConfig, PageConfig pageConfig, ITransaction transaction)
          Add or Update a Page, depending on its previous existence.
 void clearCache(SessionConfig sessionConfig, Collection<String> pageIds, ITransaction transaction)
          Clears the cache for a group of pages.
 void clearCache(SessionConfig sessionConfig, String pageId, ITransaction transaction)
          Clear the page cache.
 void copy(SessionConfig sessionConfig, String sourcePageId, String destinationPageId, ITransaction transaction)
          Copy the layout and properties from the original page to the destination page.
 void delete(SessionConfig sessionConfig, String pageId, ITransaction transaction)
          Delete a page.
 void deleteCssLink(SessionConfig sessionConfig, String pageId, String cssId, ITransaction transaction)
          Delete the hyperlink to the page's CSS file.
 void deleteOrphanInterfaces(SessionConfig sessionConfig, String pageId, ITransaction daoTransaction)
          Remove any interface instance associated to the page that is not being referenced in it's layout.
 String deserialize(SessionConfig sessionConfig, DeserializationConfig deserializationConfig, Node pageNode, boolean firstDeserialization, ITransaction transaction)
           
 String deserialize(SessionConfig sessionConfig, DeserializationConfig deserializationConfig, Node pageNode, ITransaction transaction)
           
 void deserializeCss(SessionConfig sessionConfig, DeserializationConfig deserializationConfig, Node cssLinksNodes, ITransaction transaction)
           
 void disconnectFromTemplate(SessionConfig sessionConfig, String pageId, ITransaction transaction)
          Disconnect the page from its template if one exists
 PageConfig get(SessionConfig sessionConfig, String pageId, ITransaction transaction)
          Get the configuration of the page.
 int getCachePage(SessionConfig sessionConfig, PageConfig pageConfig, ITransaction transaction)
           
 boolean getCenterPage(SessionConfig sessionConfig, PageConfig pageConfig, ITransaction transaction)
           
 List<String> getCssIds(SessionConfig sessionConfig, String pageId, ITransaction transaction)
          Get a list of Css Ids of the page.
 List<String> getCssIdsRecursively(SessionConfig sessionConfig, String pageId, ITransaction transaction)
          Get a list of Css Ids of the page including inherited Css.
 String getFirstIdByChannelId(SessionConfig sessionConfig, String channelId, ITransaction transaction)
           
 List<String> getIdsByParentChannelId(SessionConfig sessionConfig, String channelId, ITransaction transaction)
          Returns all the pages that have the given channel as their parent channel.
 List<String> getIdsByParentChannelIdRecursively(SessionConfig sessionConfig, String channelId, ITransaction transaction)
           
 Collection<String> getIdsByParentTemplateId(SessionConfig sessionConfig, String parentTemplateId, ITransaction transaction)
           
 Collection<String> getIdsByServiceInstanceId(SessionConfig sessionConfig, String serviceInstanceId, ITransaction transaction)
           
 List<String> getMetaTagIdsRecursively(SessionConfig sessionConfig, PageConfig pageConfig, ITransaction transaction)
          Get a list of Meta-Tags Ids of the page including inherited Meta-Tags.
 List<String> getParentPathIds(SessionConfig sessionConfig, String pageId, ITransaction transaction)
          Returns the Ids of parent channels recursively.
 String getPath(SessionConfig sessionConfig, String pageId, ITransaction transaction)
          Returns the complete path beginnig from the root channel to the page.
 String getProtocolScheme(SessionConfig sessionConfig, int protocolType, ITransaction transaction)
          Return the protocol Scheme of the page given a protocol type.
 int getProtocolType(SessionConfig sessionConfig, PageConfig pageConfig, ITransaction transaction)
          Returns the protocolType of the given page.
 void serialize(SessionConfig sessionConfig, String pageId, OutputStream outputStream, ITransaction transaction)
           
 void serializeCss(SessionConfig sessionConfig, String pageId, OutputStream outputStream, ITransaction transaction)
           
 void update(SessionConfig sessionConfig, PageConfig pageConfig, ITransaction transaction)
          Update a page.
 void updateDeserializedPageLayout(SessionConfig sessionConfig, DeserializationConfig deserializationConfig, String pageId, ITransaction transaction)
           
 void updateLayout(SessionConfig sessionConfig, String pageId, String layout, ITransaction transaction)
          Update the page layout.
 void updateSsiProperty(SessionConfig sessionConfig, ServiceInterfaceInstanceConfig serviceInterfaceInstanceConfig, ITransaction transaction)
          Updates the server side include property of the interface's page.
 
Methods inherited from interface lumis.portal.serialization.operation.IConfigDeleter
deleteConfig
 
Methods inherited from interface lumis.portal.serialization.operation.IConfigKeyChecker
keyExists
 

Method Detail

addOrUpdate

void addOrUpdate(SessionConfig sessionConfig,
                 PageConfig pageConfig,
                 ITransaction transaction)
                 throws ManagerException,
                        PortalException
Add or Update a Page, depending on its previous existence.

Parameters:
sessionConfig -
pageConfig -
transaction -
Throws:
ManagerException
PortalException

add

String add(SessionConfig sessionConfig,
           PageConfig pageConfig,
           ITransaction transaction)
           throws ManagerException,
                  PortalException
Add a page. If the page is a page template, and its layout is null, a default layout containing an interface holder is set in the page template.

Parameters:
sessionConfig -
pageConfig -
transaction -
Returns:
a String.
Throws:
ManagerException
PortalException

copy

void copy(SessionConfig sessionConfig,
          String sourcePageId,
          String destinationPageId,
          ITransaction transaction)
          throws ManagerException,
                 PortalException
Copy the layout and properties from the original page to the destination page. Also replace all the destination page's interface instances with new instances of interfaces that exists in the source page.

Parameters:
sessionConfig -
sourcePageId -
destinationPageId -
transaction -
Throws:
ManagerException
PortalException

get

PageConfig get(SessionConfig sessionConfig,
               String pageId,
               ITransaction transaction)
               throws ManagerException,
                      PortalException
Get the configuration of the page.

Parameters:
sessionConfig -
pageId -
transaction -
Returns:
a PageConfig.
Throws:
ManagerException
PortalException

delete

void delete(SessionConfig sessionConfig,
            String pageId,
            ITransaction transaction)
            throws ManagerException,
                   PortalException
Delete a page.

Parameters:
sessionConfig -
pageId -
transaction -
Throws:
ManagerException
PortalException

update

void update(SessionConfig sessionConfig,
            PageConfig pageConfig,
            ITransaction transaction)
            throws ManagerException,
                   PortalException
Update a page.

Parameters:
sessionConfig -
pageConfig -
transaction -
Throws:
ManagerException
PortalException

updateLayout

void updateLayout(SessionConfig sessionConfig,
                  String pageId,
                  String layout,
                  ITransaction transaction)
                  throws ManagerException,
                         PortalException
Update the page layout.

Parameters:
sessionConfig -
pageConfig -
transaction -
Throws:
ManagerException
PortalException

updateSsiProperty

void updateSsiProperty(SessionConfig sessionConfig,
                       ServiceInterfaceInstanceConfig serviceInterfaceInstanceConfig,
                       ITransaction transaction)
                       throws PortalException
Updates the server side include property of the interface's page.

If the server side include is to be calculated automatically, this method checks if any of the interface instances within the page have the ssi property set to true. If so the ssi property of the page is set to true.

Parameters:
sessionConfig -
serviceInterfaceInstanceConfig -
transaction -
Throws:
PortalException
Since:
4.1.0

getPath

String getPath(SessionConfig sessionConfig,
               String pageId,
               ITransaction transaction)
               throws ManagerException,
                      PortalException
Returns the complete path beginnig from the root channel to the page.

Parameters:
sessionConfig -
pageId -
transaction -
Returns:
a String.
Throws:
ManagerException
PortalException

getParentPathIds

List<String> getParentPathIds(SessionConfig sessionConfig,
                              String pageId,
                              ITransaction transaction)
                              throws ManagerException,
                                     PortalException
Returns the Ids of parent channels recursively.

Parameters:
sessionConfig -
pageId -
transaction -
Returns:
an array of Strings.
Throws:
ManagerException
PortalException

getIdsByParentChannelId

List<String> getIdsByParentChannelId(SessionConfig sessionConfig,
                                     String channelId,
                                     ITransaction transaction)
                                     throws ManagerException,
                                            PortalException
Returns all the pages that have the given channel as their parent channel.

Parameters:
sessionConfig - The user session id must have rights to read the page list
channelId - Id of the channel
transaction - A transaction that should be used for acessing information from the database
Returns:
an arrays of Strings.
Throws:
ManagerException
PortalException

getFirstIdByChannelId

String getFirstIdByChannelId(SessionConfig sessionConfig,
                             String channelId,
                             ITransaction transaction)
                             throws ManagerException,
                                    PortalException
Parameters:
sessionConfig -
channelId -
transaction -
Returns:
Throws:
ManagerException
PortalException

getIdsByParentChannelIdRecursively

List<String> getIdsByParentChannelIdRecursively(SessionConfig sessionConfig,
                                                String channelId,
                                                ITransaction transaction)
                                                throws ManagerException,
                                                       PortalException
Parameters:
sessionConfig -
channelId -
transaction -
Returns:
a array of strings.
Throws:
ManagerException
PortalException

addCssLink

void addCssLink(SessionConfig sessionConfig,
                String pageId,
                String cssId,
                int position,
                ITransaction transaction)
                throws ManagerException,
                       PortalException
Add the hyperlink to the page's CSS file. To access this method, the user needs the PERMISSION_TYPE_PAGES_LAYOUT permission.

Parameters:
sessionConfig -
pageId -
cssId -
position -
transaction -
Throws:
ManagerException
PortalException

deleteCssLink

void deleteCssLink(SessionConfig sessionConfig,
                   String pageId,
                   String cssId,
                   ITransaction transaction)
                   throws ManagerException,
                          PortalException
Delete the hyperlink to the page's CSS file. To access this method, the user needs the PERMISSION_TYPE_PAGES_LAYOUT permission.

Parameters:
sessionConfig -
pageId -
cssId -
transaction -
Throws:
ManagerException
PortalException

getCssIds

List<String> getCssIds(SessionConfig sessionConfig,
                       String pageId,
                       ITransaction transaction)
                       throws ManagerException,
                              PortalException
Get a list of Css Ids of the page.

Parameters:
sessionConfig -
pageId -
transaction -
Returns:
an arrays of Strings.
Throws:
ManagerException
PortalException

getCssIdsRecursively

List<String> getCssIdsRecursively(SessionConfig sessionConfig,
                                  String pageId,
                                  ITransaction transaction)
                                  throws ManagerException,
                                         PortalException
Get a list of Css Ids of the page including inherited Css.

Parameters:
sessionConfig -
pageId -
transaction -
Returns:
an arrays of Strings.
Throws:
ManagerException
PortalException

getMetaTagIdsRecursively

List<String> getMetaTagIdsRecursively(SessionConfig sessionConfig,
                                      PageConfig pageConfig,
                                      ITransaction transaction)
                                      throws ManagerException,
                                             PortalException
Get a list of Meta-Tags Ids of the page including inherited Meta-Tags.

Parameters:
sessionConfig -
pageConfig -
transaction -
Returns:
Throws:
ManagerException
PortalException

disconnectFromTemplate

void disconnectFromTemplate(SessionConfig sessionConfig,
                            String pageId,
                            ITransaction transaction)
                            throws ManagerException,
                                   PortalException
Disconnect the page from its template if one exists

Parameters:
sessionConfig -
pageId -
transaction -
Throws:
ManagerException
PortalException

getCenterPage

boolean getCenterPage(SessionConfig sessionConfig,
                      PageConfig pageConfig,
                      ITransaction transaction)
                      throws ManagerException,
                             PortalException
Parameters:
sessionConfig -
pageConfig -
transaction -
Returns:
true if the ... and false otherwise.
Throws:
ManagerException
PortalException

getCachePage

int getCachePage(SessionConfig sessionConfig,
                 PageConfig pageConfig,
                 ITransaction transaction)
                 throws ManagerException,
                        PortalException
Parameters:
sessionConfig -
pageConfig -
transaction -
Returns:
an interger.
Throws:
ManagerException
PortalException

serialize

void serialize(SessionConfig sessionConfig,
               String pageId,
               OutputStream outputStream,
               ITransaction transaction)
               throws ManagerException,
                      PortalException
Parameters:
sessionConfig -
pageId -
outputStream -
transaction -
Throws:
ManagerException
PortalException

deserialize

String deserialize(SessionConfig sessionConfig,
                   DeserializationConfig deserializationConfig,
                   Node pageNode,
                   ITransaction transaction)
                   throws ManagerException,
                          PortalException
Parameters:
sessionConfig -
deserializationConfig -
pageNode -
transaction -
Returns:
a String.
Throws:
ManagerException
PortalException

deserialize

String deserialize(SessionConfig sessionConfig,
                   DeserializationConfig deserializationConfig,
                   Node pageNode,
                   boolean firstDeserialization,
                   ITransaction transaction)
                   throws ManagerException,
                          PortalException
Throws:
ManagerException
PortalException

updateDeserializedPageLayout

void updateDeserializedPageLayout(SessionConfig sessionConfig,
                                  DeserializationConfig deserializationConfig,
                                  String pageId,
                                  ITransaction transaction)
                                  throws ManagerException,
                                         PortalException
Parameters:
sessionConfig -
deserializationConfig -
pageId -
transaction -
Throws:
ManagerException
PortalException

getIdsByServiceInstanceId

Collection<String> getIdsByServiceInstanceId(SessionConfig sessionConfig,
                                             String serviceInstanceId,
                                             ITransaction transaction)
                                             throws PortalException
Parameters:
sessionConfig - identifier for the session.
serviceInstanceId - the id of the service instance.
transaction - the transaction for persistence access.
Returns:
the ids of the pages that contain an interface of the given service instance id.
Throws:
PortalException

serializeCss

void serializeCss(SessionConfig sessionConfig,
                  String pageId,
                  OutputStream outputStream,
                  ITransaction transaction)
                  throws ManagerException,
                         PortalException
Parameters:
sessionConfig -
pageId -
outputStream -
transaction -
Throws:
ManagerException
PortalException

deserializeCss

void deserializeCss(SessionConfig sessionConfig,
                    DeserializationConfig deserializationConfig,
                    Node cssLinksNodes,
                    ITransaction transaction)
                    throws ManagerException,
                           PortalException
Parameters:
sessionConfig -
deserializationConfig -
cssLinksNodes -
transaction -
Throws:
ManagerException
PortalException

getIdsByParentTemplateId

Collection<String> getIdsByParentTemplateId(SessionConfig sessionConfig,
                                            String parentTemplateId,
                                            ITransaction transaction)
                                            throws ManagerException,
                                                   PortalException
Parameters:
sessionConfig -
parentTemplateId -
transaction -
Returns:
Throws:
ManagerException
PortalException

clearCache

void clearCache(SessionConfig sessionConfig,
                String pageId,
                ITransaction transaction)
                throws ManagerException,
                       PortalException
Clear the page cache.

This method clears the following caches

Parameters:
sessionConfig -
pageId -
transaction -
Throws:
ManagerException
PortalException
Since:
4.0.4
See Also:
clearCache(SessionConfig, Collection, ITransaction)

clearCache

void clearCache(SessionConfig sessionConfig,
                Collection<String> pageIds,
                ITransaction transaction)
                throws PortalException
Clears the cache for a group of pages. The following caches are cleared: This method is most suited for bulk cache clearing. For small cache clearing, consider using clearCache(SessionConfig, String, ITransaction).

Parameters:
sessionConfig - the user session information.
pageIds - the page identifiers.
transaction - the transaction for persistence access.
Throws:
PortalException
Since:
4.1.0
See Also:
clearCache(SessionConfig, String, ITransaction)

deleteOrphanInterfaces

void deleteOrphanInterfaces(SessionConfig sessionConfig,
                            String pageId,
                            ITransaction daoTransaction)
                            throws ManagerException,
                                   PortalException
Remove any interface instance associated to the page that is not being referenced in it's layout.

Parameters:
sessionConfig -
pageId -
daoTransaction -
Throws:
ManagerException
PortalException
Since:
4.0.6

getProtocolType

int getProtocolType(SessionConfig sessionConfig,
                    PageConfig pageConfig,
                    ITransaction transaction)
                    throws ManagerException,
                           PortalException
Returns the protocolType of the given page.

This method checks recursively up the page´s ancestors until it finds a protocolType that is not PageConfig.PAGE_PROTOCOL_INHERIT.

Possible protocol types are:

Parameters:
sessionConfig -
pageConfig -
transaction -
Returns:
Throws:
ManagerException
PortalException

getProtocolScheme

String getProtocolScheme(SessionConfig sessionConfig,
                         int protocolType,
                         ITransaction transaction)
                         throws ManagerException,
                                PortalException
Return the protocol Scheme of the page given a protocol type.

This method returns a string representation of the protocol type.

Parameters:
sessionConfig -
protocolType -
transaction -
Returns:
If the protocol type is PageConfig.PAGE_PROTOCOL_HTTP, PageConfig.PAGE_PROTOCOL_HTTP_NAME is returned.
If the protocol type is PageConfig.PAGE_PROTOCOL_HTTPS, PageConfig.PAGE_PROTOCOL_HTTPS_NAME is returned.
In all other cases null is returned.
Throws:
ManagerException
PortalException


Lumisportal  4.1.0.071221 - Copyright © 2001-2007, Lumis. All Rights Reserved.