/*
* Copyright (C) 2005-2007 Alfresco Software Limited.
*
* This program is free software; you can redistribute it and/or
* modify it under the terms of the GNU General Public License
* as published by the Free Software Foundation; either version 2
* of the License, or (at your option) any later version.
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
* You should have received a copy of the GNU General Public License
* along with this program; if not, write to the Free Software
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
* As a special exception to the terms and conditions of version 2.0 of
* the GPL, you may redistribute this Program in connection with Free/Libre
* and Open Source Software ("FLOSS") applications as described in Alfresco's
* FLOSS exception. You should have recieved a copy of the text describing
* the FLOSS exception, and it is also available here:
* http://www.alfresco.com/legal/licensing"
*/
package org.alfresco.web.bean.clipboard;
import java.io.Serializable;
import java.text.MessageFormat;
import java.util.ArrayList;
import java.util.List;
import java.util.Map;
import javax.faces.application.FacesMessage;
import javax.faces.context.FacesContext;
import javax.faces.event.ActionEvent;
import org.alfresco.service.cmr.repository.NodeRef;
import org.alfresco.service.cmr.repository.NodeService;
import org.alfresco.service.cmr.repository.StoreRef;
import org.alfresco.web.app.Application;
import org.alfresco.web.app.context.UIContextService;
import org.alfresco.web.bean.repository.Repository;
import org.alfresco.web.ui.common.Utils;
import org.alfresco.web.ui.common.component.UIActionLink;
import org.alfresco.web.ui.repo.component.shelf.UIClipboardShelfItem;
import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
/**
* Bean backing the Clipboard shelf functionality.
*
* The clipboard bean is responsible for processing Cut/Copy requests to the clipboard
* and for executing the various Paste calls available to the user.
*
* @author Kevin Roast
*/
public class ClipboardBean implements Serializable
{
private static final long serialVersionUID = -6299320341615099651L;
private static Log logger = LogFactory.getLog(ClipboardBean.class);
/** I18N messages */
private static final String MSG_ERROR_PASTE = "error_paste";
/** Current state of the clipboard items */
private List items = new ArrayList(4);
transient private NodeService nodeService;
// ------------------------------------------------------------------------------
// Bean property getters and setters
/**
* @return Returns a list representing the items on the user clipboard.
*/
public List getItems()
{
return this.items;
}
/**
* @param items List representing the items on the user clipboard.
*/
public void setItems(List items)
{
this.items = items;
}
public void setNodeService(NodeService nodeService)
{
this.nodeService = nodeService;
}
private NodeService getNodeService()
{
if (nodeService == null)
{
nodeService = Repository.getServiceRegistry(FacesContext.getCurrentInstance()).getNodeService();
}
return nodeService;
}
// ------------------------------------------------------------------------------
// Navigation action event handlers
/**
* Action handler called to add a node to the clipboard for a Copy operation
*/
public void copyNode(ActionEvent event)
{
UIActionLink link = (UIActionLink)event.getComponent();
Map params = link.getParameterMap();
String ref = params.get("ref");
if (ref != null && ref.length() != 0)
{
addClipboardNode(new NodeRef(ref), ClipboardStatus.COPY);
}
}
/**
* Action handler called to add a node to the clipboard for a Cut operation
*/
public void cutNode(ActionEvent event)
{
UIActionLink link = (UIActionLink)event.getComponent();
Map params = link.getParameterMap();
String ref = params.get("ref");
if (ref != null && ref.length() != 0)
{
addClipboardNode(new NodeRef(ref), ClipboardStatus.CUT);
}
}
/**
* Action handler call from the browse screen to Paste All clipboard items into the current Space
*/
public void pasteAll(ActionEvent event)
{
performPasteItems(-1, UIClipboardShelfItem.ACTION_PASTE_ALL);
}
/**
* Action handler called to paste one or all items from the clipboard
*/
public void pasteItem(ActionEvent event)
{
UIClipboardShelfItem.ClipboardEvent clipEvent = (UIClipboardShelfItem.ClipboardEvent)event;
int index = clipEvent.Index;
if (index >= this.items.size())
{
throw new IllegalStateException("Clipboard attempting paste a non existent item index: " + index);
}
performPasteItems(index, clipEvent.Action);
}
/**
* Perform a paste for the specified clipboard item(s)
*
* @param index of clipboard item to paste or -1 for all
* @param action the clipboard action to perform (see UIClipboardShelfItem)
*/
private void performPasteItems(int index, int action)
{
FacesContext context = FacesContext.getCurrentInstance();
try
{
if (index == -1)
{
// paste all
List toRemove = new ArrayList();
for (ClipboardItem item : this.items)
{
if (!getNodeService().exists(item.getNodeRef()))
{
toRemove.add(item);
continue;
}
if (performClipboardOperation(item, action) == true)
{
// if cut operation then remove item from the clipboard
if (item.getMode() == ClipboardStatus.CUT)
{
// remember which items to remove.
toRemove.add(item);
}
}
}
// if configured to do so clear the clipboard after a paste all
if (Application.getClientConfig(context).isPasteAllAndClearEnabled())
{
this.items.clear();
}
else if (toRemove.size() > 0)
{
// remove the items that were cut above
for (ClipboardItem item : toRemove)
{
this.items.remove(item);
}
}
}
else
{
// single paste operation
ClipboardItem item = this.items.get(index);
if (performClipboardOperation(item, action) == true)
{
// if cut operation then remove item from the clipboard
if (item.getMode() == ClipboardStatus.CUT)
{
this.items.remove(index);
}
}
}
// refresh UI on success
UIContextService.getInstance(context).notifyBeans();
}
catch (Throwable err)
{
Utils.addErrorMessage(Application.getMessage(context, MSG_ERROR_PASTE) + err.getMessage(), err);
}
}
/**
* Perform the operation for the specified clipboard item
*
* @param item the ClipboardItem
* @param action the clipboard action to perform (see UIClipboardShelfItem)
*
* @return true on successful operation
*/
private boolean performClipboardOperation(ClipboardItem item, int action)
throws Throwable
{
boolean success = false;
FacesContext fc = FacesContext.getCurrentInstance();
// test the current JSF view to see if the clipboard item can paste to it
if (logger.isDebugEnabled())
logger.debug("Clipboard destination View Id: " + fc.getViewRoot().getViewId());
if (item.getMode() == ClipboardStatus.CUT)
{
if (item.canMoveToViewId(fc.getViewRoot().getViewId()) == true)
{
success = item.paste(fc, fc.getViewRoot().getViewId(), action);
}
else
{
// we cannot support this view as a Move paste location
if (logger.isDebugEnabled())
logger.debug("Clipboard Item: " + item.getNodeRef() + " not suitable for Move paste to current View Id.");
}
}
else if (item.getMode() == ClipboardStatus.COPY)
{
if (item.canCopyToViewId(fc.getViewRoot().getViewId()) == true)
{
success = item.paste(fc, fc.getViewRoot().getViewId(), action);
}
else
{
// we cannot support this view as a Copy paste location
if (logger.isDebugEnabled())
logger.debug("Clipboard Item: " + item.getNodeRef() + " not suitable for Copy paste to current View Id.");
}
}
return success;
}
/**
* Add a clipboard node to the clipboard ready for a cut/copy operation
*
* @param ref NodeRef of the item for the operation
* @param mode ClipboardStatus for the operation
*/
private void addClipboardNode(NodeRef ref, ClipboardStatus mode)
{
// construct item based on store protocol
ClipboardItem item = null;
if (StoreRef.PROTOCOL_WORKSPACE.equals(ref.getStoreRef().getProtocol()))
{
item = new WorkspaceClipboardItem(ref, mode);
}
else if (StoreRef.PROTOCOL_AVM.equals(ref.getStoreRef().getProtocol()))
{
item = new AVMClipboardItem(ref, mode);
}
else
{
logger.warn("Unable to add item to clipboard - unknown store protocol: " + ref.getStoreRef().getProtocol());
}
if (item != null)
{
// check for duplicates first
boolean foundDuplicate = false;
for (int i=0; i