/* * 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.Collections; import java.util.HashMap; import java.util.List; import java.util.Locale; import java.util.Map; import javax.faces.application.FacesMessage; import javax.faces.component.UIComponent; import javax.faces.context.FacesContext; import javax.faces.event.ActionEvent; import org.alfresco.model.ApplicationModel; import org.alfresco.model.ContentModel; import org.alfresco.repo.content.MimetypeMap; import org.alfresco.repo.transaction.RetryingTransactionHelper; import org.alfresco.repo.transaction.RetryingTransactionHelper.RetryingTransactionCallback; import org.alfresco.repo.version.common.VersionLabelComparator; import org.alfresco.service.cmr.coci.CheckOutCheckInService; import org.alfresco.service.cmr.lock.LockService; import org.alfresco.service.cmr.ml.ContentFilterLanguagesService; import org.alfresco.service.cmr.ml.EditionService; import org.alfresco.service.cmr.ml.MultilingualContentService; import org.alfresco.service.cmr.repository.ContentData; import org.alfresco.service.cmr.repository.NodeRef; import org.alfresco.service.cmr.repository.TemplateService; 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.ml.MultilingualUtils; 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_CURRENT = "current"; 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 ML_VERSION_PANEL_ID = "ml-versions-panel"; protected LockService lockService; protected VersionService versionService; protected CheckOutCheckInService cociService; protected MultilingualContentService multilingualContentService; protected ContentFilterLanguagesService contentFilterLanguagesService; protected EditionService editionService; private Node translationDocument; // ------------------------------------------------------------------------------ // Construction /** * Default constructor */ public DocumentDetailsBean() { super(); // initial state of some panels that don't use the default panels.put("version-history-panel", false); panels.put("ml-info-panel", false); panels.put("related-translation-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; } /** * 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); } /** * @return true if the current document has the 'inlineeditable' aspect applied */ public boolean isMultilingual() { return getDocument().hasAspect(ContentModel.ASPECT_MULTILINGUAL_DOCUMENT); } /** * Adds the node to the dispatch context so that overridden dialogs can be picked up */ public void setupEditContext(ActionEvent event) { this.navigator.setupDispatchContext(getDocument()); } /** * Save the state of the panel that was expanded/collapsed */ public void expandPanel(ActionEvent event) { super.expandPanel(event); String id = event.getComponent().getId(); if(id.startsWith(ML_VERSION_PANEL_ID)) { this.currentEditionCursorPosition = Integer.parseInt(id.substring("ml-versions-panel".length())) - 1; } } /** * 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()); if(getDocument().hasAspect(ContentModel.ASPECT_MULTILINGUAL_EMPTY_TRANSLATION)) { clientVersion.put("url", null); } else { clientVersion.put("url", DownloadContentServlet.generateBrowserURL(version.getFrozenStateNodeRef(), clientVersion.getName())); } // add the client side version to the list versions.add(clientVersion); } } } return versions; } /** List of client light weight edition histories */ private List editionHistory = null; /** For the client side iteration on the edition hitories list, it represents the index of the list */ private int currentEditionCursorPosition; /** * For the client side iteration on the edition hitories list, returns the number of editions. * * @return the number of edition of the current mlContainer */ public int getEditionSize() { // return the size of the list return editionHistory.size(); } /** * Init the mlContainer histories and returns an empty list to fill a rich list value without content. * * @return an empty list */ public List getEmptyListAndInitEditions() { // this call ensures that the edition of the mlContainer must be // re-initialized. // remove each old mlContainer's translations of the panel list List panelsToRemove = new ArrayList(); for(Map.Entry panel : panels.entrySet()) { if(panel.getKey().startsWith(ML_VERSION_PANEL_ID)) { //panels.remove(panel.getKey()); panelsToRemove.add(panel.getKey()); } } for(String panelId : panelsToRemove) { panels.remove(panelId); } // init the Edition histories initEditionHistory(); currentEditionCursorPosition = -1; return new ArrayList(0); } /** * For the client side iteration on the edition hitories list, * return the next edition history. * * @return a light weight representation of an edition history */ public SingleEditionBean getNextSingleEditionBean() { currentEditionCursorPosition++; return getCurrentSingleEditionBean(); } /** * For the client side iteration on the edition hitories list, * return the current edition history. * * @return a light weight representation of an edition history */ public SingleEditionBean getCurrentSingleEditionBean() { return editionHistory.get(currentEditionCursorPosition); } /** * Constructs a list of objects representing the editions of the * logical document * * @return List of editions */ @SuppressWarnings("unchecked") private List initEditionHistory() { // get the mlContainer NodeRef mlContainer = getDocumentMlContainer().getNodeRef(); // get all editions and sort them ascending according their version label List orderedEditionList = new ArrayList(editionService.getEditions(mlContainer).getAllVersions()); Collections.sort(orderedEditionList, new VersionLabelComparator()); // the list of Single Edition Bean to return editionHistory = new ArrayList(orderedEditionList.size()); boolean firstEdition = true; // for each edition, init a SingleEditionBean for (Version edition : orderedEditionList) { SingleEditionBean editionBean = new SingleEditionBean(); MapNode clientEdition = new MapNode(edition.getFrozenStateNodeRef()); String editionLabel = edition.getVersionLabel(); if (firstEdition) { editionLabel += " (" + Application.getMessage(FacesContext.getCurrentInstance(), MSG_CURRENT) + ")"; } clientEdition.put("editionLabel", editionLabel); clientEdition.put("editionNotes", edition.getDescription()); clientEdition.put("editionAuthor", edition.getCreator()); clientEdition.put("editionDate", edition.getCreatedDate()); // Set the edition of the edition bean editionBean.setEdition(clientEdition); // get translations List translationHistories = null; if (firstEdition) { // Get the translations because the current edition doesn't content link with its // translation in the version store. Map translations = multilingualContentService.getTranslations(mlContainer); translationHistories = new ArrayList(translations.size()); for (NodeRef translation : translations.values()) { translationHistories.add(versionService.getVersionHistory(translation)); } } else { translationHistories = editionService.getVersionedTranslations(edition); } // add each translation in the SingleEditionBean for (VersionHistory versionHistory : translationHistories) { // get the list of versions and sort them ascending according their version label List orderedVersions = new ArrayList(versionHistory.getAllVersions()); Collections.sort(orderedVersions, new VersionLabelComparator()); // the last version is the first version of the list Version lastVersion = orderedVersions.get(0); // get the properties of the lastVersion Map lastVersionProperties = editionService.getVersionedMetadatas(lastVersion); Locale language = (Locale) lastVersionProperties.get(ContentModel.PROP_LOCALE); // create a map node representation of the last version MapNode clientLastVersion = new MapNode(lastVersion.getFrozenStateNodeRef()); clientLastVersion.put("versionName", lastVersionProperties.get(ContentModel.PROP_NAME)); // use the node service for the description to ensure that the returned value is a text and not a MLText clientLastVersion.put("versionDescription", nodeService.getProperty(lastVersion.getFrozenStateNodeRef(), ContentModel.PROP_DESCRIPTION)); clientLastVersion.put("versionAuthor", lastVersionProperties.get(ContentModel.PROP_AUTHOR)); clientLastVersion.put("versionCreatedDate", lastVersionProperties.get(ContentModel.PROP_CREATED)); clientLastVersion.put("versionModifiedDate", lastVersionProperties.get(ContentModel.PROP_MODIFIED)); clientLastVersion.put("versionLanguage", this.contentFilterLanguagesService.convertToNewISOCode(language.getLanguage()).toUpperCase()); if(nodeService.hasAspect(lastVersion.getFrozenStateNodeRef(), ContentModel.ASPECT_MULTILINGUAL_EMPTY_TRANSLATION)) { clientLastVersion.put("versionUrl", null); } else { clientLastVersion.put("versionUrl", DownloadContentServlet.generateBrowserURL(lastVersion.getFrozenStateNodeRef(), clientLastVersion.getName())); } // add a translation of the editionBean editionBean.addTranslations(clientLastVersion); } editionHistory.add(editionBean); firstEdition = false; } return editionHistory; } /** * Returns a list of objects representing the translations of the current document * * @return List of translations */ public List getTranslations() { List translations = new ArrayList(); Node document = getDocument(); boolean canNewEdtion = MultilingualUtils.canStartNewEditon(document, FacesContext.getCurrentInstance()); if (document.hasAspect(ContentModel.ASPECT_MULTILINGUAL_DOCUMENT) || ContentModel.TYPE_MULTILINGUAL_CONTAINER.equals(document.getType())) { Map translationsMap = this.multilingualContentService.getTranslations(getDocument().getNodeRef()); if (translationsMap != null && translationsMap.size() > 0) { for (Map.Entry entry : translationsMap.entrySet()) { NodeRef nodeRef = (NodeRef) entry.getValue(); // create a map node representation of the translation MapNode mapNode = new MapNode(nodeRef); Locale locale = (Locale) nodeService.getProperty(nodeRef, ContentModel.PROP_LOCALE); String lgge = (locale != null) ? // convert the locale into new ISO codes contentFilterLanguagesService.convertToNewISOCode(locale.getLanguage()).toUpperCase() : null; mapNode.put("name", nodeService.getProperty(nodeRef, ContentModel.PROP_NAME)); mapNode.put("language", lgge); mapNode.put("url", DownloadContentServlet.generateBrowserURL(nodeRef, mapNode.getName())); mapNode.put("notEmpty", new Boolean(!nodeService.hasAspect(nodeRef, ContentModel.ASPECT_MULTILINGUAL_EMPTY_TRANSLATION))); mapNode.put("userHasRight", new Boolean(canNewEdtion)); // add the client side version to the list translations.add(mapNode); } } } return translations; } /** * 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; } /** * Applies the classifiable aspect to the current document */ public void applyClassifiable() { try { RetryingTransactionHelper txnHelper = Repository.getRetryingTransactionHelper(FacesContext.getCurrentInstance()); RetryingTransactionCallback callback = new RetryingTransactionCallback() { public Object execute() throws Throwable { // add the general classifiable aspect to the node nodeService.addAspect(getDocument().getNodeRef(), ContentModel.ASPECT_GEN_CLASSIFIABLE, null); return null; } }; txnHelper.doInTransaction(callback); // reset the state of the current document getDocument().reset(); } catch (Throwable e) { 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() { try { FacesContext context = FacesContext.getCurrentInstance(); RetryingTransactionHelper txnHelper = Repository.getRetryingTransactionHelper(context); RetryingTransactionCallback callback = new RetryingTransactionCallback() { public Object execute() throws Throwable { // add the versionable aspect to the node nodeService.addAspect(getDocument().getNodeRef(), ContentModel.ASPECT_VERSIONABLE, null); return null; } }; txnHelper.doInTransaction(callback); // reset the state of the current document getDocument().reset(); // get hold of the main property sheet on the page and remove the children to force a refresh UIComponent comp = context.getViewRoot().findComponent("document-details:document-props"); if (comp != null) { comp.getChildren().clear(); } } catch (Throwable e) { 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(final ActionEvent event) { final FacesContext fc = FacesContext.getCurrentInstance(); try { RetryingTransactionHelper txnHelper = Repository.getRetryingTransactionHelper(FacesContext.getCurrentInstance()); RetryingTransactionCallback callback = new RetryingTransactionCallback() { public Object execute() throws Throwable { 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(); return null; } }; txnHelper.doInTransaction(callback); } catch (Throwable e) { Utils.addErrorMessage(MessageFormat.format(Application.getMessage( fc, Repository.ERROR_GENERIC), e.getMessage()), e); } } /** * Applies the inlineeditable aspect to the current document */ public String applyInlineEditable() { try { RetryingTransactionHelper txnHelper = Repository.getRetryingTransactionHelper(FacesContext.getCurrentInstance()); RetryingTransactionCallback callback = new RetryingTransactionCallback() { public Object execute() throws Throwable { // 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); } } nodeService.addAspect(getDocument().getNodeRef(), ApplicationModel.ASPECT_INLINEEDITABLE, props); return null; } }; txnHelper.doInTransaction(callback); // reset the state of the current document getDocument().reset(); } catch (Throwable e) { 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); model.put("document", getDocument().getNodeRef()); model.put("space", this.navigator.getCurrentNode().getNodeRef()); model.put(TemplateService.KEY_IMAGE_RESOLVER, imageResolver); 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(); } /** * Before opening the ml container details, remeber the translation * from which the action comes. * * @param node */ public void setTranslationDocument(Node node) { this.translationDocument = node; } /** * Restore the translationf from which the ml container * details dialog comes. */ public void resetMLDocument(ActionEvent event) { this.browseBean.setupCommonBindingProperties(this.translationDocument); this.browseBean.setDocument(this.translationDocument); } /** * Returns the ml container of the document this bean is currently representing * * @return The document multilingual container NodeRef */ public Node getDocumentMlContainer() { Node currentNode = getNode(); if(ContentModel.TYPE_MULTILINGUAL_CONTAINER.equals(currentNode.getType())) { return currentNode; } else { NodeRef nodeRef = getNode().getNodeRef(); return new Node(multilingualContentService.getTranslationContainer(nodeRef)); } } /** * 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; } /** * @param multilingualContentService the multilingual ContentService to set */ public void setMultilingualContentService(MultilingualContentService multilingualContentService) { this.multilingualContentService = multilingualContentService; } /** * @param contentFilterLanguagesService The Content Filter Languages Service to set. */ public void setContentFilterLanguagesService(ContentFilterLanguagesService contentFilterLanguagesService) { this.contentFilterLanguagesService = contentFilterLanguagesService; } /** * @param EditionService The Edition Service to set. */ public void setEditionService(EditionService editionService) { this.editionService = editionService; } }