/* * 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.text.MessageFormat; import java.util.Collection; import java.util.HashMap; import java.util.List; import java.util.Map; 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.service.cmr.repository.NodeRef; import org.alfresco.service.cmr.repository.TemplateService; import org.alfresco.web.app.AlfrescoNavigationHandler; import org.alfresco.web.app.Application; import org.alfresco.web.app.servlet.GuestTemplateContentServlet; 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 provided access to the details of a Space * * @author Kevin Roast */ public class SpaceDetailsBean extends BaseDetailsBean { private static final String MSG_HAS_FOLLOWING_CATEGORIES = "has_following_categories_space"; private static final String MSG_NO_CATEGORIES_APPLIED = "no_categories_applied_space"; private static final String MSG_ERROR_ASPECT_CLASSIFY = "error_aspect_classify_space"; /** RSS Template ID */ private String rssTemplate; // ------------------------------------------------------------------------------ // Construction /** * Default constructor */ public SpaceDetailsBean() { super(); // initial state of some panels that don't use the default panels.put("rules-panel", false); panels.put("dashboard-panel", false); } // ------------------------------------------------------------------------------ // Bean property getters and setters /** * Returns the Node this bean is currently representing * * @return The Node */ public Node getNode() { return this.browseBean.getActionSpace(); } /** * Returns the Space this bean is currently representing * * @return The Space Node */ public Node getSpace() { return getNode(); } /** * Returns the URL to access the browse page for the current node * * @return The bookmark URL */ public String getBrowseUrl() { return Utils.generateURL(FacesContext.getCurrentInstance(), getNode(), URLMode.BROWSE); } /** * 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 space = getSpace(); if (ApplicationModel.TYPE_FOLDERLINK.equals(space.getType())) { NodeRef destRef = (NodeRef)space.getProperties().get(ContentModel.PROP_LINK_DESTINATION); if (nodeService.exists(destRef)) { space = new Node(destRef); } } return space; } /** * Returns a model for use by a template on the Space Details page. * * @return model containing current current space info. */ @SuppressWarnings("unchecked") public Map getTemplateModel() { HashMap model = new HashMap(1, 1.0f); model.put("space", getSpace().getNodeRef()); model.put(TemplateService.KEY_IMAGE_RESOLVER, imageResolver); return model; } /** * @see org.alfresco.web.bean.BaseDetailsBean#getPropertiesPanelId() */ protected String getPropertiesPanelId() { return "space-props"; } // ------------------------------------------------------------------------------ // Action event handlers /** * Navigates to next item in the list of Spaces */ public void nextItem(ActionEvent event) { boolean foundNextItem = false; UIActionLink link = (UIActionLink)event.getComponent(); Map params = link.getParameterMap(); String id = params.get("id"); if (id != null && id.length() != 0) { NodeRef currNodeRef = new NodeRef(Repository.getStoreRef(), id); List nodes = this.browseBean.getParentNodes(currNodeRef); 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) { NodeRef currNodeRef = new NodeRef(Repository.getStoreRef(), id); List nodes = this.browseBean.getParentNodes(currNodeRef); if (nodes.size() > 1) { // see above for (int i=0; i categories = (Collection)this.nodeService.getProperty( getSpace().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() { UserTransaction tx = null; try { tx = Repository.getUserTransaction(FacesContext.getCurrentInstance()); tx.begin(); // add the general classifiable aspect to the node this.nodeService.addAspect(getSpace().getNodeRef(), ContentModel.ASPECT_GEN_CLASSIFIABLE, null); // commit the transaction tx.commit(); // reset the state of the current document getSpace().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); } } /** * Returns whether the current sapce is locked * * @return true if the document is checked out */ public boolean isLocked() { return getSpace().isLocked(); } /** * @return true if the current space has an RSS feed applied */ public boolean isRSSFeed() { return hasRSSFeed(getSpace()); } /** * @return true if the current space has an RSS feed applied */ public static boolean hasRSSFeed(Node space) { return (space.hasAspect(ApplicationModel.ASPECT_FEEDSOURCE) && space.getProperties().get(ApplicationModel.PROP_FEEDTEMPLATE) != null); } /** * @return RSS Feed URL for the current space */ public String getRSSFeedURL() { return buildRSSFeedURL(getSpace()); } /** * Build URL for an RSS space based on the 'feedsource' aspect property. * * @param space Node to build RSS template URL for * * @return URL for the RSS feed for a space */ public static String buildRSSFeedURL(Node space) { // build RSS feed template URL from selected template and the space NodeRef and // add the guest=true URL parameter - this is required for no login access and // add the mimetype=text/xml URL parameter - required to return correct stream type return GuestTemplateContentServlet.generateURL(space.getNodeRef(), (NodeRef)space.getProperties().get(ApplicationModel.PROP_FEEDTEMPLATE)) + "/rss.xml?mimetype=text%2Fxml%3Bcharset=utf-8"; } /** * @return Returns the current RSS Template ID. */ public String getRSSTemplate() { // return current template if it exists NodeRef ref = (NodeRef)getNode().getProperties().get(ApplicationModel.PROP_FEEDTEMPLATE); return ref != null ? ref.getId() : this.rssTemplate; } /** * @param rssTemplate The RSS Template Id to set. */ public void setRSSTemplate(String rssTemplate) { this.rssTemplate = rssTemplate; } /** * Action handler to apply the selected RSS Template and FeedSource aspect to the current Space */ public void applyRSSTemplate(ActionEvent event) { if (this.rssTemplate != null && this.rssTemplate.equals(TemplateSupportBean.NO_SELECTION) == false) { try { // apply the feedsource aspect if required if (getNode().hasAspect(ApplicationModel.ASPECT_FEEDSOURCE) == false) { this.nodeService.addAspect(getNode().getNodeRef(), ApplicationModel.ASPECT_FEEDSOURCE, null); } // get the selected template Id from the Template Picker NodeRef templateRef = new NodeRef(Repository.getStoreRef(), this.rssTemplate); // set the template NodeRef into the templatable aspect property this.nodeService.setProperty(getNode().getNodeRef(), ApplicationModel.PROP_FEEDTEMPLATE, templateRef); // reset node details for next refresh of details page getNode().reset(); } catch (Exception e) { Utils.addErrorMessage(MessageFormat.format(Application.getMessage( FacesContext.getCurrentInstance(), Repository.ERROR_GENERIC), e.getMessage()), e); } } } /** * Action handler to remove a RSS template from the current Space */ public void removeRSSTemplate(ActionEvent event) { try { // clear template property this.nodeService.setProperty(getNode().getNodeRef(), ApplicationModel.PROP_FEEDTEMPLATE, null); this.nodeService.removeAspect(getNode().getNodeRef(), ApplicationModel.ASPECT_FEEDSOURCE); // reset node details for next refresh of details page getNode().reset(); } catch (Exception e) { Utils.addErrorMessage(MessageFormat.format(Application.getMessage( FacesContext.getCurrentInstance(), Repository.ERROR_GENERIC), e.getMessage()), e); } } }