org.jasig.portal.layout.immutable
Class ImmutableUserLayoutManagerWrapper

java.lang.Object
  org.jasig.portal.layout.immutable.ImmutableUserLayoutManagerWrapper

All Implemented Interfaces:

IUserLayoutManager

public class ImmutableUserLayoutManagerWrapper
extends Object
implements IUserLayoutManager

Wraps IUserLayoutManager interface to prevent access to mutator methods. Prior to uPortal 2.5, this class existed in the package org.jasig.portal.layout. It was moved to its present package to associate it with the ImmutableUserLayoutSAXFilter and to separate it from the general Layout API.

Version:

1.0 $Revision: 19776 $ $Date: 2010-01-14 16:17:21 -0600 (Thu, 14 Jan 2010) $

Author:

Peter Kharchenko pkharchenko@interactivebusiness.com"

Constructor Summary

ImmutableUserLayoutManagerWrapper(IUserLayoutManager manager)

Method Summary

boolean	addLayoutEventListener(LayoutEventListener l) Register a layout event listener
IUserLayoutNodeDescription	addNode(IUserLayoutNodeDescription node, String parentId, String nextSiblingId) Add a new node to a current user layout.
boolean	canAddNode(IUserLayoutNodeDescription node, String parentId, String nextSiblingId) Test if a particular node can be added at a given location.
boolean	canDeleteNode(String nodeId) Tests if a particular node can be deleted.
boolean	canMoveNode(String nodeId, String parentId, String nextSiblingId) Test if a particular node can be moved to a given location.
boolean	canUpdateNode(IUserLayoutNodeDescription nodeId) Test if a certain node can be updated.
IUserLayoutNodeDescription	createNodeDescription(int nodeType) A factory method to create an empty IUserLayoutNodeDescription instance
boolean	deleteNode(String nodeId) Delete a node (folder or a channel) from a user layout.
String	getCacheKey() Return a cache key, uniqly corresponding to the composition and the structure of the user layout.
Enumeration	getChildIds(String nodeId) Returns a list of child node Ids for a given node.
int	getDepth(String nodeId) Returns the depth of a node in the layout tree.
int	getLayoutId() Returns a layout Id associated with this manager/
String	getNextSiblingId(String nodeId) Determine an Id of a next sibling node.
IUserLayoutNodeDescription	getNode(String nodeId) Obtain a description of a node (channel or a folder) in a given user layout.
String	getParentId(String nodeId) Returns an Id of a parent user layout node.
String	getPreviousSiblingId(String nodeId) Determine an Id of a previous sibling node.
String	getRootFolderId() Returns an id of the root folder.
String	getSubscribeId(String fname) Returns a subscription id given a functional name.
IUserLayout	getUserLayout() Gets a user layout (with appropriate markings).
void	getUserLayout(ContentHandler ch) Output user layout (with appropriate markings) into a ContentHandler
void	getUserLayout(String nodeId, ContentHandler ch) Output subtree of a user layout (with appropriate markings) defined by a particular node into a ContentHandler
Document	getUserLayoutDOM()
void	loadUserLayout() Calls IUserLayoutManager.loadUserLayout(boolean) passing false.
void	loadUserLayout(boolean reload) Signal manager to load a user layout.
void	markAddTargets(IUserLayoutNodeDescription node) Ask manager to output markings at the locations where a given node can be added.
void	markMoveTargets(String nodeId) Ask manager to output markings at the locations where a given node can be moved.
boolean	moveNode(String nodeId, String parentId, String nextSiblingId) Move a node (channel or folder) from one location to another.
void	processLayoutParameters(IPerson person, UserPreferences userPrefs, HttpServletRequest req) Ignores this call to prevent changes to the layout.
boolean	removeLayoutEventListener(LayoutEventListener l) Remove a registered layout event listener.
void	saveUserLayout() Signal manager to persist user layout to a database
void	setLayoutStore(IUserLayoutStore ls) Set a user layout store implementation.
void	setUserLayout(IUserLayout userLayout) Sets a user layout (with appropriate markings).
void	setUserLayoutDOM(Document doc)
boolean	updateNode(IUserLayoutNodeDescription node) Update a given node.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ImmutableUserLayoutManagerWrapper

public ImmutableUserLayoutManagerWrapper(IUserLayoutManager manager)
                                  throws PortalException

Throws:

PortalException

Method Detail

getUserLayout

public IUserLayout getUserLayout()
                          throws PortalException

Description copied from interface: IUserLayoutManager

Gets a user layout (with appropriate markings).

Specified by:

getUserLayout in interface IUserLayoutManager

Returns:

the user layout

Throws:

PortalException - if an error occurs

setUserLayout

public void setUserLayout(IUserLayout userLayout)
                   throws PortalException

Description copied from interface: IUserLayoutManager

Sets a user layout (with appropriate markings).

Specified by:

setUserLayout in interface IUserLayoutManager

Parameters:

userLayout - the user layout

Throws:

PortalException - if an error occurs

getUserLayout

public void getUserLayout(ContentHandler ch)
                   throws PortalException

Description copied from interface: IUserLayoutManager

Output user layout (with appropriate markings) into a ContentHandler

Specified by:

getUserLayout in interface IUserLayoutManager

Parameters:

ch - a ContentHandler value

Throws:

PortalException - if an error occurs

getUserLayout

public void getUserLayout(String nodeId,
                          ContentHandler ch)
                   throws PortalException

Description copied from interface: IUserLayoutManager

Output subtree of a user layout (with appropriate markings) defined by a particular node into a ContentHandler

Specified by:

getUserLayout in interface IUserLayoutManager

Parameters:

nodeId - a String a node determining a user layout subtree.

ch - a ContentHandler value

Throws:

PortalException - if an error occurs

setLayoutStore

public void setLayoutStore(IUserLayoutStore ls)

Description copied from interface: IUserLayoutManager

Set a user layout store implementation.

Specified by:

setLayoutStore in interface IUserLayoutManager

Parameters:

ls - an IUserLayoutStore value

loadUserLayout

public void loadUserLayout()
                    throws PortalException

Description copied from interface: IUserLayoutManager

Calls IUserLayoutManager.loadUserLayout(boolean) passing false.

Specified by:

loadUserLayout in interface IUserLayoutManager

Throws:

PortalException

loadUserLayout

public void loadUserLayout(boolean reload)
                    throws PortalException

Description copied from interface: IUserLayoutManager

Signal manager to load a user layout.

Specified by:

loadUserLayout in interface IUserLayoutManager

Parameters:

reload - If true the reload will be forced, purging any cached data.

Throws:

PortalException - PortalException if an error occurs

saveUserLayout

public void saveUserLayout()
                    throws PortalException

Description copied from interface: IUserLayoutManager

Signal manager to persist user layout to a database

Specified by:

saveUserLayout in interface IUserLayoutManager

Throws:

PortalException - if an error occurs

getNode

public IUserLayoutNodeDescription getNode(String nodeId)
                                   throws PortalException

Description copied from interface: IUserLayoutManager

Obtain a description of a node (channel or a folder) in a given user layout.

Specified by:

getNode in interface IUserLayoutManager

Parameters:

nodeId - a String channel subscribe id or folder id.

Returns:

an UserLayoutNodeDescription value

Throws:

PortalException - if an error occurs

addNode

public IUserLayoutNodeDescription addNode(IUserLayoutNodeDescription node,
                                          String parentId,
                                          String nextSiblingId)
                                   throws PortalException

Description copied from interface: IUserLayoutManager

Add a new node to a current user layout.

Specified by:

addNode in interface IUserLayoutManager

Parameters:

node - an UserLayoutNodeDescription value of a node to be added (Id doesn't have to be set)

parentId - a String id of a folder to which the new node (channel or folder) should be added.

nextSiblingId - a String an id of a sibling node (channel or folder) prior to which the new node should be inserted.

Returns:

an UserLayoutNodeDescription value with a newly determined Id.

Throws:

PortalException - if an error occurs

moveNode

public boolean moveNode(String nodeId,
                        String parentId,
                        String nextSiblingId)
                 throws PortalException

Description copied from interface: IUserLayoutManager

Move a node (channel or folder) from one location to another.

Specified by:

moveNode in interface IUserLayoutManager

Parameters:

nodeId - a String value of a node Id.

parentId - a String id of a folder to which the node should be moved.

nextSiblingId - a String id of a sibling node (folder or channel) prior to which the node should be placed. (null to append at the end)

Returns:

a boolean value noting if the operation was successful

Throws:

PortalException - if an error occurs

deleteNode

public boolean deleteNode(String nodeId)
                   throws PortalException

Description copied from interface: IUserLayoutManager

Delete a node (folder or a channel) from a user layout.

Specified by:

deleteNode in interface IUserLayoutManager

Parameters:

nodeId - a String id (channel subscribe id or folder id)

Returns:

a boolean value noting if the operation was successful

Throws:

PortalException - if an error occurs

updateNode

public boolean updateNode(IUserLayoutNodeDescription node)
                   throws PortalException

Description copied from interface: IUserLayoutManager

Update a given node.

Specified by:

updateNode in interface IUserLayoutManager

Parameters:

node - an UserLayoutNodeDescription value with a valid id.

Returns:

a boolean value noting if the operation was successful

Throws:

PortalException - if an error occurs

canAddNode

public boolean canAddNode(IUserLayoutNodeDescription node,
                          String parentId,
                          String nextSiblingId)
                   throws PortalException

Description copied from interface: IUserLayoutManager

Test if a particular node can be added at a given location.

Specified by:

canAddNode in interface IUserLayoutManager

Parameters:

node - an UserLayoutNodeDescription value describing the node to be added.

parentId - a String id of a parent to which the node to be added.

nextSiblingId - a String id of a sibling prior to which the node to be inserted. (null to append at the end)

Returns:

a boolean value

Throws:

PortalException - if an error occurs

canMoveNode

public boolean canMoveNode(String nodeId,
                           String parentId,
                           String nextSiblingId)
                    throws PortalException

Description copied from interface: IUserLayoutManager

Test if a particular node can be moved to a given location.

Specified by:

canMoveNode in interface IUserLayoutManager

Parameters:

nodeId - a String id of a node to be moved.

parentId - a String id of a parent to which the node to be moved.

nextSiblingId - a String id of a sibling prior to which the node is to be inserted (null to append at the end)

Returns:

a boolean value

Throws:

PortalException - if an error occurs

canDeleteNode

public boolean canDeleteNode(String nodeId)
                      throws PortalException

Description copied from interface: IUserLayoutManager

Tests if a particular node can be deleted.

Specified by:

canDeleteNode in interface IUserLayoutManager

Parameters:

nodeId - a String node id.

Returns:

a boolean value

Throws:

PortalException - if an error occurs

canUpdateNode

public boolean canUpdateNode(IUserLayoutNodeDescription nodeId)
                      throws PortalException

Description copied from interface: IUserLayoutManager

Test if a certain node can be updated.

Specified by:

canUpdateNode in interface IUserLayoutManager

Parameters:

nodeId - a IUserLayoutNodeDescription node id.

Returns:

a boolean value

Throws:

PortalException - if an error occurs

markAddTargets

public void markAddTargets(IUserLayoutNodeDescription node)

Description copied from interface: IUserLayoutManager

Ask manager to output markings at the locations where a given node can be added. The marks will appear next time getUserLayout method is called.

Specified by:

markAddTargets in interface IUserLayoutManager

Parameters:

node - an UserLayoutNodeDescription value or null to stop outputting add markings.

markMoveTargets

public void markMoveTargets(String nodeId)
                     throws PortalException

Description copied from interface: IUserLayoutManager

Ask manager to output markings at the locations where a given node can be moved. The marks will appear next time getUserLayout method is called.

Specified by:

markMoveTargets in interface IUserLayoutManager

Parameters:

nodeId - a String value or null to stop outputting move markings.

Throws:

PortalException - if an error occurs

getParentId

public String getParentId(String nodeId)
                   throws PortalException

Description copied from interface: IUserLayoutManager

Returns an Id of a parent user layout node. The user layout root node always has ID= IUserLayout.ROOT_NODE_NAME

Specified by:

getParentId in interface IUserLayoutManager

Parameters:

nodeId - a String value

Returns:

a String value

Throws:

PortalException - if an error occurs

getChildIds

public Enumeration getChildIds(String nodeId)
                        throws PortalException

Description copied from interface: IUserLayoutManager

Returns a list of child node Ids for a given node.

Specified by:

getChildIds in interface IUserLayoutManager

Parameters:

nodeId - a String value

Returns:

a List of String child node Ids.

Throws:

PortalException - if an error occurs

getNextSiblingId

public String getNextSiblingId(String nodeId)
                        throws PortalException

Description copied from interface: IUserLayoutManager

Determine an Id of a next sibling node.

Specified by:

getNextSiblingId in interface IUserLayoutManager

Parameters:

nodeId - a String value

Returns:

a String Id value of a next sibling node, or null if this is the last sibling.

Throws:

PortalException - if an error occurs

getPreviousSiblingId

public String getPreviousSiblingId(String nodeId)
                            throws PortalException

Description copied from interface: IUserLayoutManager

Determine an Id of a previous sibling node.

Specified by:

getPreviousSiblingId in interface IUserLayoutManager

Parameters:

nodeId - a String value

Returns:

a String Id value of a previous sibling node, or null if this is the first sibling.

Throws:

PortalException - if an error occurs

getCacheKey

public String getCacheKey()
                   throws PortalException

Description copied from interface: IUserLayoutManager

Return a cache key, uniqly corresponding to the composition and the structure of the user layout.

Specified by:

getCacheKey in interface IUserLayoutManager

Returns:

a String value

Throws:

PortalException - if an error occurs

setUserLayoutDOM

public void setUserLayoutDOM(Document doc)

getUserLayoutDOM

public Document getUserLayoutDOM()
                          throws PortalException

Specified by:

getUserLayoutDOM in interface IUserLayoutManager

Throws:

PortalException

getLayoutId

public int getLayoutId()

Description copied from interface: IUserLayoutManager

Returns a layout Id associated with this manager/

Specified by:

getLayoutId in interface IUserLayoutManager

Returns:

an int layout Id value;

getRootFolderId

public String getRootFolderId()

Description copied from interface: IUserLayoutManager

Returns an id of the root folder.

Specified by:

getRootFolderId in interface IUserLayoutManager

Returns:

a String value

getDepth

public int getDepth(String nodeId)
             throws PortalException

Returns the depth of a node in the layout tree.

Specified by:

getDepth in interface IUserLayoutManager

Parameters:

nodeId - a String value

Returns:

a depth value

Throws:

PortalException - if an error occurs

getSubscribeId

public String getSubscribeId(String fname)
                      throws PortalException

Returns a subscription id given a functional name.

Specified by:

getSubscribeId in interface IUserLayoutManager

Parameters:

fname - the functional name to lookup.

Returns:

a String subscription id.

Throws:

PortalException

createNodeDescription

public IUserLayoutNodeDescription createNodeDescription(int nodeType)
                                                 throws PortalException

A factory method to create an empty IUserLayoutNodeDescription instance

Specified by:

createNodeDescription in interface IUserLayoutManager

Parameters:

nodeType - a node type value

Returns:

an IUserLayoutNodeDescription instance

Throws:

PortalException - if the error occurs.

addLayoutEventListener

public boolean addLayoutEventListener(LayoutEventListener l)

Description copied from interface: IUserLayoutManager

Register a layout event listener

Specified by:

addLayoutEventListener in interface IUserLayoutManager

Parameters:

l - a LayoutEventListener object

Returns:

a boolean success status

removeLayoutEventListener

public boolean removeLayoutEventListener(LayoutEventListener l)

Description copied from interface: IUserLayoutManager

Remove a registered layout event listener.

Specified by:

removeLayoutEventListener in interface IUserLayoutManager

Parameters:

l - a LayoutEventListener object

Returns:

a boolean success status

processLayoutParameters

public void processLayoutParameters(IPerson person,
                                    UserPreferences userPrefs,
                                    HttpServletRequest req)
                             throws PortalException

Ignores this call to prevent changes to the layout.

Specified by:

processLayoutParameters in interface IUserLayoutManager

Throws:

PortalException