/* * 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; import java.io.Serializable; import java.text.MessageFormat; import java.util.ArrayList; import java.util.Collection; import java.util.HashMap; import java.util.List; import java.util.Map; import javax.faces.application.FacesMessage; import javax.faces.context.FacesContext; import javax.faces.event.ActionEvent; import javax.transaction.UserTransaction; import org.alfresco.model.ApplicationModel; import org.alfresco.model.ContentModel; import org.alfresco.repo.content.MimetypeMap; import org.alfresco.repo.template.TemplateNode; import org.alfresco.service.cmr.coci.CheckOutCheckInService; import org.alfresco.service.cmr.lock.LockService; import org.alfresco.service.cmr.repository.ContentData; import org.alfresco.service.cmr.repository.NodeRef; import org.alfresco.service.cmr.security.PermissionService; import org.alfresco.service.cmr.version.Version; import org.alfresco.service.cmr.version.VersionHistory; import org.alfresco.service.cmr.version.VersionService; import org.alfresco.service.namespace.QName; import org.alfresco.web.app.Application; import org.alfresco.web.app.servlet.DownloadContentServlet; import org.alfresco.web.bean.repository.MapNode; import org.alfresco.web.bean.repository.Node; import org.alfresco.web.bean.repository.Repository; import org.alfresco.web.ui.common.Utils; import org.alfresco.web.ui.common.Utils.URLMode; import org.alfresco.web.ui.common.component.UIActionLink; /** * Backing bean providing access to the details of a document * * @author gavinc */ public class DocumentDetailsBean extends BaseDetailsBean { private static final String OUTCOME_RETURN = "showDocDetails"; private static final String MSG_HAS_FOLLOWING_CATEGORIES = "has_following_categories"; private static final String MSG_NO_CATEGORIES_APPLIED = "no_categories_applied"; private static final String MSG_SUCCESS_UNLOCK = "success_unlock"; private static final String MSG_ERROR_ASPECT_INLINEEDITABLE = "error_aspect_inlineeditable"; private static final String MSG_ERROR_ASPECT_VERSIONING = "error_aspect_versioning"; private static final String MSG_ERROR_ASPECT_CLASSIFY = "error_aspect_classify"; private static final String MSG_ERROR_UPDATE_CATEGORY = "error_update_category"; protected LockService lockService; protected VersionService versionService; protected CheckOutCheckInService cociService; private NodeRef addedCategory; private List categories; // ------------------------------------------------------------------------------ // Construction /** * Default constructor */ public DocumentDetailsBean() { super(); // initial state of some panels that don't use the default panels.put("version-history-panel", false); } // ------------------------------------------------------------------------------ // Bean property getters and setters /** * Resets any state that may be held by this bean */ public void reset() { // reset the workflow cache this.workflowProperties = null; // reset the category caches this.categories = null; this.addedCategory = null; } /** * Returns the URL to download content for the current document * * @return Content url to download the current document */ public String getUrl() { return (String)getDocument().getProperties().get("url"); } /** * Returns the URL to the content for the current document * * @return Content url to the current document */ public String getBrowserUrl() { Node doc = getLinkResolvedNode(); return Utils.generateURL(FacesContext.getCurrentInstance(), doc, URLMode.HTTP_INLINE); } /** * Returns the download URL to the content for the current document * * @return Download url to the current document */ public String getDownloadUrl() { Node doc = getLinkResolvedNode(); return Utils.generateURL(FacesContext.getCurrentInstance(), doc, URLMode.HTTP_DOWNLOAD); } /** * Resolve the actual document Node from any Link object that may be proxying it * * @return current document Node or document Node resolved from any Link object */ protected Node getLinkResolvedNode() { Node document = getDocument(); if (ApplicationModel.TYPE_FILELINK.equals(document.getType())) { NodeRef destRef = (NodeRef)document.getProperties().get(ContentModel.PROP_LINK_DESTINATION); if (nodeService.exists(destRef)) { document = new Node(destRef); } } return document; } /** * Determines whether the current document is versionable * * @return true if the document has the versionable aspect */ public boolean isVersionable() { return getDocument().hasAspect(ContentModel.ASPECT_VERSIONABLE); } /** * @return true if the current document has the 'inlineeditable' aspect applied */ public boolean isInlineEditable() { return getDocument().hasAspect(ApplicationModel.ASPECT_INLINEEDITABLE); } /** * Returns a list of objects representing the versions of the * current document * * @return List of previous versions */ public List getVersionHistory() { List versions = new ArrayList(); if (getDocument().hasAspect(ContentModel.ASPECT_VERSIONABLE)) { VersionHistory history = this.versionService.getVersionHistory(getDocument().getNodeRef()); if (history != null) { for (Version version : history.getAllVersions()) { // create a map node representation of the version MapNode clientVersion = new MapNode(version.getFrozenStateNodeRef()); clientVersion.put("versionLabel", version.getVersionLabel()); clientVersion.put("notes", version.getDescription()); clientVersion.put("author", version.getCreator()); clientVersion.put("versionDate", version.getCreatedDate()); clientVersion.put("url", DownloadContentServlet.generateBrowserURL(version.getFrozenStateNodeRef(), clientVersion.getName())); // add the client side version to the list versions.add(clientVersion); } } } return versions; } /** * Determines whether the current document has any categories applied * * @return true if the document has categories attached */ public boolean isCategorised() { return getDocument().hasAspect(ContentModel.ASPECT_GEN_CLASSIFIABLE); } /** * Returns a list of objects representing the categories applied to the * current document * * @return List of categories */ public String getCategoriesOverviewHTML() { String html = null; if (isCategorised()) { // we know for now that the general classifiable aspect only will be // applied so we can retrive the categories property direclty Collection categories = (Collection)this.nodeService.getProperty( getDocument().getNodeRef(), ContentModel.PROP_CATEGORIES); if (categories == null || categories.size() == 0) { html = Application.getMessage(FacesContext.getCurrentInstance(), MSG_NO_CATEGORIES_APPLIED); } else { StringBuilder builder = new StringBuilder(Application.getMessage(FacesContext.getCurrentInstance(), MSG_HAS_FOLLOWING_CATEGORIES)); builder.append("
    "); for (NodeRef ref : categories) { if (this.nodeService.exists(ref)) { builder.append("
  • "); builder.append(Repository.getNameForNode(this.nodeService, ref)); builder.append("
  • "); } } builder.append("
"); html = builder.toString(); } } return html; } /** * Event handler called to setup the categories for editing * * @param event The event */ public void setupCategoriesForEdit(ActionEvent event) { this.categories = (List)this.nodeService.getProperty(getDocument().getNodeRef(), ContentModel.PROP_CATEGORIES); } /** * Returns a Map of the initial categories on the node keyed by the NodeRef * * @return Map of initial categories */ public List getCategories() { return this.categories; } /** * Sets the categories Map * * @param categories */ public void setCategories(List categories) { this.categories = categories; } /** * Returns the last category added from the multi value editor * * @return The last category added */ public NodeRef getAddedCategory() { return this.addedCategory; } /** * Sets the category added from the multi value editor * * @param addedCategory The added category */ public void setAddedCategory(NodeRef addedCategory) { this.addedCategory = addedCategory; } /** * Updates the categories for the current document * * @return The outcome */ public String saveCategories() { String outcome = "cancel"; UserTransaction tx = null; try { tx = Repository.getUserTransaction(FacesContext.getCurrentInstance()); tx.begin(); // firstly retrieve all the properties for the current node Map updateProps = this.nodeService.getProperties( getDocument().getNodeRef()); // create a node ref representation of the selected id and set the new properties updateProps.put(ContentModel.PROP_CATEGORIES, (Serializable)this.categories); // set the properties on the node this.nodeService.setProperties(getDocument().getNodeRef(), updateProps); // commit the transaction tx.commit(); // reset the state of the current document so it reflects the changes just made getDocument().reset(); outcome = "finish"; } catch (Throwable e) { try { if (tx != null) {tx.rollback();} } catch (Exception ex) {} Utils.addErrorMessage(MessageFormat.format(Application.getMessage( FacesContext.getCurrentInstance(), MSG_ERROR_UPDATE_CATEGORY), e.getMessage()), e); } return outcome; } /** * Applies the classifiable aspect to the current document */ public void applyClassifiable() { UserTransaction tx = null; try { tx = Repository.getUserTransaction(FacesContext.getCurrentInstance()); tx.begin(); // add the general classifiable aspect to the node this.nodeService.addAspect(getDocument().getNodeRef(), ContentModel.ASPECT_GEN_CLASSIFIABLE, null); // commit the transaction tx.commit(); // reset the state of the current document getDocument().reset(); } catch (Throwable e) { // rollback the transaction try { if (tx != null) {tx.rollback();} } catch (Exception ex) {} Utils.addErrorMessage(MessageFormat.format(Application.getMessage( FacesContext.getCurrentInstance(), MSG_ERROR_ASPECT_CLASSIFY), e.getMessage()), e); } } /** * Applies the versionable aspect to the current document */ public void applyVersionable() { UserTransaction tx = null; try { tx = Repository.getUserTransaction(FacesContext.getCurrentInstance()); tx.begin(); // add the versionable aspect to the node this.nodeService.addAspect(getDocument().getNodeRef(), ContentModel.ASPECT_VERSIONABLE, null); // commit the transaction tx.commit(); // reset the state of the current document getDocument().reset(); } catch (Throwable e) { // rollback the transaction try { if (tx != null) {tx.rollback();} } catch (Exception ex) {} Utils.addErrorMessage(MessageFormat.format(Application.getMessage( FacesContext.getCurrentInstance(), MSG_ERROR_ASPECT_VERSIONING), e.getMessage()), e); } } /** * Action Handler to unlock a locked document */ public void unlock(ActionEvent event) { FacesContext fc = FacesContext.getCurrentInstance(); UserTransaction tx = null; try { tx = Repository.getUserTransaction(fc); tx.begin(); this.lockService.unlock(getNode().getNodeRef()); String msg = Application.getMessage(fc, MSG_SUCCESS_UNLOCK); FacesMessage facesMsg = new FacesMessage(FacesMessage.SEVERITY_INFO, msg, msg); String formId = Utils.getParentForm(fc, event.getComponent()).getClientId(fc); fc.addMessage(formId + ':' + getPropertiesPanelId(), facesMsg); getNode().reset(); // commit the transaction tx.commit(); } catch (Throwable e) { // rollback the transaction try { if (tx != null) {tx.rollback();} } catch (Exception ex) {} Utils.addErrorMessage(MessageFormat.format(Application.getMessage( fc, Repository.ERROR_GENERIC), e.getMessage()), e); } } /** * Applies the inlineeditable aspect to the current document */ public String applyInlineEditable() { UserTransaction tx = null; try { tx = Repository.getUserTransaction(FacesContext.getCurrentInstance()); tx.begin(); // add the inlineeditable aspect to the node Map props = new HashMap(1, 1.0f); String contentType = null; ContentData contentData = (ContentData)getDocument().getProperties().get(ContentModel.PROP_CONTENT); if (contentData != null) { contentType = contentData.getMimetype(); } if (contentType != null) { // set the property to true by default if the filetype is a known content type if (MimetypeMap.MIMETYPE_HTML.equals(contentType) || MimetypeMap.MIMETYPE_TEXT_PLAIN.equals(contentType) || MimetypeMap.MIMETYPE_XML.equals(contentType) || MimetypeMap.MIMETYPE_TEXT_CSS.equals(contentType) || MimetypeMap.MIMETYPE_JAVASCRIPT.equals(contentType)) { props.put(ApplicationModel.PROP_EDITINLINE, true); } } this.nodeService.addAspect(getDocument().getNodeRef(), ApplicationModel.ASPECT_INLINEEDITABLE, props); // commit the transaction tx.commit(); // reset the state of the current document getDocument().reset(); } catch (Throwable e) { // rollback the transaction try { if (tx != null) {tx.rollback();} } catch (Exception ex) {} Utils.addErrorMessage(MessageFormat.format(Application.getMessage( FacesContext.getCurrentInstance(), MSG_ERROR_ASPECT_INLINEEDITABLE), e.getMessage()), e); } // force recreation of the details view - this means the properties sheet component will reinit return OUTCOME_RETURN; } /** * Navigates to next item in the list of content for the current Space */ public void nextItem(ActionEvent event) { UIActionLink link = (UIActionLink)event.getComponent(); Map params = link.getParameterMap(); String id = params.get("id"); if (id != null && id.length() != 0) { List nodes = this.browseBean.getContent(); if (nodes.size() > 1) { // perform a linear search - this is slow but stateless // otherwise we would have to manage state of last selected node // this gets very tricky as this bean is instantiated once and never // reset - it does not know when the document has changed etc. for (int i=0; i params = link.getParameterMap(); String id = params.get("id"); if (id != null && id.length() != 0) { List nodes = this.browseBean.getContent(); if (nodes.size() > 1) { // see above for (int i=0; i model = new HashMap(2, 1.0f); FacesContext fc = FacesContext.getCurrentInstance(); TemplateNode documentNode = new TemplateNode(getDocument().getNodeRef(), Repository.getServiceRegistry(fc), imageResolver); model.put("document", documentNode); TemplateNode spaceNode = new TemplateNode(this.navigator.getCurrentNode().getNodeRef(), Repository.getServiceRegistry(fc), imageResolver); model.put("space", spaceNode); return model; } /** * Returns whether the current document is locked * * @return true if the document is checked out */ public boolean isLocked() { return getDocument().isLocked(); } /** * Returns whether the current document is a working copy * * @return true if the document is a working copy */ public boolean isWorkingCopy() { return getDocument().hasAspect(ContentModel.ASPECT_WORKING_COPY); } /** * @return the working copy document Node for this document if found and the * current has permission or null if not */ public Node getWorkingCopyDocument() { Node workingCopyNode = null; if (isLocked()) { NodeRef workingCopyRef = this.cociService.getWorkingCopy(getDocument().getNodeRef()); if (workingCopyRef != null) { workingCopyNode = new Node(workingCopyRef); // if the current user does not have read permission on // working copy return null if (workingCopyNode.hasPermission(PermissionService.READ) == false) { workingCopyNode = null; } } } return workingCopyNode; } /** * Returns whether the current document is a working copy owned by the current User * * @return true if the document is a working copy owner by the current User */ public boolean isOwner() { return getDocument().isWorkingCopyOwner(); } /** * Returns the Node this bean is currently representing * * @return The Node */ public Node getNode() { return this.browseBean.getDocument(); } /** * Returns the document this bean is currently representing * * @return The document Node */ public Node getDocument() { return this.getNode(); } /** * Sets the lock service instance the bean should use * * @param lockService The LockService */ public void setLockService(LockService lockService) { this.lockService = lockService; } /** * Sets the version service instance the bean should use * * @param versionService The VersionService */ public void setVersionService(VersionService versionService) { this.versionService = versionService; } /** * Sets the checkincheckout service instance the bean should use * * @param cociService The CheckOutCheckInService */ public void setCheckOutCheckInService(CheckOutCheckInService cociService) { this.cociService = cociService; } }