org.jasig.portal.layout
Class TransientUserLayoutManagerWrapper

java.lang.Object
  org.jasig.portal.layout.TransientUserLayoutManagerWrapper

All Implemented Interfaces:

IUserLayoutManager

public class TransientUserLayoutManagerWrapper
extends Object
implements IUserLayoutManager

Wraps IUserLayoutManager interface to provide ability to incorporate channels into a user layout that are not part of their layout structure (persistent). The channels are incorporated upon request (functional name) and remain part of the layout structure only as long as they are the target channel.

Version:

$Revision: 19776 $

Author:

Keith Stacks

Field Summary

static String	SUBSCRIBE_PREFIX
static String	TRANSIENT_FOLDER_ID

Constructor Summary

TransientUserLayoutManagerWrapper(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 node) 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.
protected IChannelDefinition	getChannelDefinition(String subId) Given a subscribe Id, return a ChannelDefinition.
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.
String	getFname(String subId) Given a subscribe Id, return its functional name.
String	getFocusedId() Get the current focused layout subscribe id.
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.
IUserLayoutManager	getOriginalLayoutManager()
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) Given an functional name, return its subscribe id.
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) Delegates to the wrapped layout manager's implementation.
boolean	removeLayoutEventListener(LayoutEventListener l) Remove a registered layout event listener.
void	saveUserLayout() Signal manager to persist user layout to a database
void	setFocusedId(String subscribeId) Set the current focused layout subscribe id.
void	setLayoutStore(IUserLayoutStore ls) Set a user layout store implementation.
void	setOriginalLayoutManager(IUserLayoutManager man)
void	setUserLayout(IUserLayout userLayout) Sets a user layout (with appropriate markings).
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

Field Detail

TRANSIENT_FOLDER_ID

public static final String TRANSIENT_FOLDER_ID

See Also:

Constant Field Values

SUBSCRIBE_PREFIX

public static final String SUBSCRIBE_PREFIX

See Also:

Constant Field Values

Constructor Detail

TransientUserLayoutManagerWrapper

public TransientUserLayoutManagerWrapper(IUserLayoutManager manager)
                                  throws PortalException

Throws:

PortalException

Method Detail

getOriginalLayoutManager

public IUserLayoutManager getOriginalLayoutManager()
                                            throws PortalException

Throws:

PortalException

setOriginalLayoutManager

public void setOriginalLayoutManager(IUserLayoutManager man)
                              throws PortalException

Throws:

PortalException

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

getUserLayoutDOM

public Document getUserLayoutDOM()
                          throws PortalException

Specified by:

getUserLayoutDOM in interface IUserLayoutManager

Throws:

PortalException

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 node)
                      throws PortalException

Description copied from interface: IUserLayoutManager

Test if a certain node can be updated.

Specified by:

canUpdateNode in interface IUserLayoutManager

Parameters:

node - a IUserLayoutNodeDescription node id.

Returns:

a boolean value

Throws:

PortalException - if an error occurs

markAddTargets

public void markAddTargets(IUserLayoutNodeDescription node)
                    throws PortalException

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.

Throws:

PortalException - if an error occurs

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

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

createNodeDescription

public IUserLayoutNodeDescription createNodeDescription(int nodeType)
                                                 throws PortalException

Description copied from interface: IUserLayoutManager

A factory method to create an empty IUserLayoutNodeDescription instance

Specified by:

createNodeDescription in interface IUserLayoutManager

Parameters:

nodeType - a node type constant from IUserLayoutNodeDescription interface

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

getChannelDefinition

protected IChannelDefinition getChannelDefinition(String subId)
                                           throws PortalException

Given a subscribe Id, return a ChannelDefinition.

Parameters:

subId - the subscribe id for the ChannelDefinition.

Returns:

a ChannelDefinition

Throws:

PortalException

getFname

public String getFname(String subId)

Given a subscribe Id, return its functional name.

Parameters:

subId - the subscribe id to lookup

Returns:

the subscribe id's functional name

getSubscribeId

public String getSubscribeId(String fname)
                      throws PortalException

Given an functional name, return its subscribe id.

Specified by:

getSubscribeId in interface IUserLayoutManager

Parameters:

fname - the functional name to lookup

Returns:

the fname's subscribe id.

Throws:

PortalException

getFocusedId

public String getFocusedId()

Get the current focused layout subscribe id.

setFocusedId

public void setFocusedId(String subscribeId)

Set the current focused layout subscribe id.

Parameters:

subscribeId - Id to be set as focused.

processLayoutParameters

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

Delegates to the wrapped layout manager's implementation.

Specified by:

processLayoutParameters in interface IUserLayoutManager

Throws:

PortalException