/* * 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