/* * 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.repo.usage; import java.io.Serializable; import java.util.List; import java.util.Map; import org.alfresco.model.ContentModel; import org.alfresco.repo.node.NodeServicePolicies; import org.alfresco.repo.policy.JavaBehaviour; import org.alfresco.repo.policy.PolicyComponent; import org.alfresco.repo.security.authentication.AuthenticationComponent; import org.alfresco.service.cmr.repository.ChildAssociationRef; import org.alfresco.service.cmr.repository.ContentData; import org.alfresco.service.cmr.repository.NodeRef; import org.alfresco.service.cmr.repository.NodeService; import org.alfresco.service.cmr.security.PersonService; import org.alfresco.service.cmr.usage.ContentQuotaException; import org.alfresco.service.cmr.usage.ContentUsageService; import org.alfresco.service.cmr.usage.UsageService; import org.alfresco.service.namespace.NamespaceService; import org.alfresco.service.namespace.QName; import org.apache.commons.logging.Log; import org.apache.commons.logging.LogFactory; /** * Implements Content Usage service and policies/behaviour. * */ public class ContentUsageImpl implements ContentUsageService, NodeServicePolicies.OnCreateNodePolicy, NodeServicePolicies.OnUpdatePropertiesPolicy, NodeServicePolicies.BeforeDeleteNodePolicy { // Logger private static Log logger = LogFactory.getLog(ContentUsageImpl.class); private NodeService nodeService; private PersonService personService; private PolicyComponent policyComponent; private UsageService usageService; private AuthenticationComponent authenticationComponent; private boolean enabled = true; private List stores; public void setNodeService(NodeService nodeService) { this.nodeService = nodeService; } public void setPersonService(PersonService personService) { this.personService = personService; } public void setUsageService(UsageService usageService) { this.usageService = usageService; } public void setPolicyComponent(PolicyComponent policyComponent) { this.policyComponent = policyComponent; } public void setAuthenticationComponent(AuthenticationComponent authenticationComponent) { this.authenticationComponent = authenticationComponent; } public void setEnabled(boolean enabled) { this.enabled = enabled; } public void setStores(List stores) { this.stores = stores; } public List getStores() { return this.stores; } /** * The initialise method */ public void init() { if (enabled) { // Register interest in the onCreateNode policy policyComponent.bindClassBehaviour( QName.createQName(NamespaceService.ALFRESCO_URI, "onCreateNode"), ContentModel.TYPE_CONTENT, new JavaBehaviour(this, "onCreateNode")); // Register interest in the onUpdateProperties policy policyComponent.bindClassBehaviour( QName.createQName(NamespaceService.ALFRESCO_URI, "onUpdateProperties"), ContentModel.TYPE_CONTENT, new JavaBehaviour(this, "onUpdateProperties")); // Register interest in the beforeDeleteNode policy policyComponent.bindClassBehaviour( QName.createQName(NamespaceService.ALFRESCO_URI, "beforeDeleteNode"), ContentModel.TYPE_CONTENT, new JavaBehaviour(this, "beforeDeleteNode")); } } /** * Called when a new node has been created. * * @param childAssocRef the created child association reference */ public void onCreateNode(ChildAssociationRef childAssocRef) { NodeRef nodeRef = childAssocRef.getChildRef(); if (stores.contains(nodeRef.getStoreRef().toString())) { // Get content size // TODO use data dictionary to get content property ContentData contentData = (ContentData)nodeService.getProperty(nodeRef, ContentModel.PROP_CONTENT); Long contentSize = (contentData == null ? null : contentData.getSize()); // Get owner/creator String owner = (String)nodeService.getProperty(nodeRef, ContentModel.PROP_OWNER); if (owner == null) { owner = (String)nodeService.getProperty(nodeRef, ContentModel.PROP_CREATOR); } if (contentSize != null && contentSize != 0 && owner != null) { // new node with non-empty content size if (logger.isDebugEnabled()) logger.debug("onCreateNode: contentSize="+contentSize+", nodeRef="+nodeRef+", ownerAfter="+owner); incrementUserUsage(owner, contentSize, nodeRef); } } } /** * Called after a node's properties have been changed. * * @param nodeRef reference to the updated node * @param before the node's properties before the change * @param after the node's properties after the change */ public void onUpdateProperties( NodeRef nodeRef, Map before, Map after) { if (stores.contains(nodeRef.getStoreRef().toString())) { // Check for change in content size // TODO use data dictionary to get content property ContentData contentDataBefore = (ContentData)before.get(ContentModel.PROP_CONTENT); Long contentSizeBefore = (contentDataBefore == null ? null : contentDataBefore.getSize()); ContentData contentDataAfter = (ContentData)after.get(ContentModel.PROP_CONTENT); Long contentSizeAfter = (contentDataAfter == null ? null : contentDataAfter.getSize()); // Check for change in owner/creator String ownerBefore = (String)before.get(ContentModel.PROP_OWNER); if (ownerBefore == null) { ownerBefore = (String)before.get(ContentModel.PROP_CREATOR); } String ownerAfter = (String)after.get(ContentModel.PROP_OWNER); if (ownerAfter == null) { ownerAfter = (String)after.get(ContentModel.PROP_CREATOR); } // check change in size (and possibly owner) if (contentSizeBefore == null && contentSizeAfter != null && contentSizeAfter != 0 && ownerAfter != null) { // new size has been added - note: ownerBefore does not matter since the contentSizeBefore is null if (logger.isDebugEnabled()) logger.debug("onUpdateProperties: updateSize (null -> "+contentSizeAfter+"): nodeRef="+nodeRef+", ownerAfter="+ownerAfter); incrementUserUsage(ownerAfter, contentSizeAfter, nodeRef); } else if (contentSizeAfter == null && contentSizeBefore != null && contentSizeBefore != 0 && ownerBefore != null) { // old size has been removed - note: ownerAfter does not matter since contentSizeAfter is null if (logger.isDebugEnabled()) logger.debug("onUpdateProperties: updateSize ("+contentSizeBefore+" -> null): nodeRef="+nodeRef+", ownerBefore="+ownerBefore); decrementUserUsage(ownerBefore, contentSizeBefore, nodeRef); } else if (contentSizeBefore != null && contentSizeAfter != null) { if (contentSizeBefore.equals(contentSizeAfter) == false) { // size has changed (and possibly owner) if (logger.isDebugEnabled()) logger.debug("onUpdateProperties: updateSize ("+contentSizeBefore+" -> "+contentSizeAfter+"): nodeRef="+nodeRef+", ownerBefore="+ownerBefore+", ownerAfter="+ownerAfter); if (contentSizeBefore != 0 && ownerBefore != null) { decrementUserUsage(ownerBefore, contentSizeBefore, nodeRef); } if (contentSizeAfter != 0 && ownerAfter != null) { incrementUserUsage(ownerAfter, contentSizeAfter, nodeRef); } } else { // same size - check change in owner only if (ownerBefore == null && ownerAfter != null && contentSizeAfter != 0 && ownerAfter != null) { // new owner has been added if (logger.isDebugEnabled()) logger.debug("onUpdateProperties: updateOwner (null -> "+ownerAfter+"): nodeRef="+nodeRef+", contentSize="+contentSizeAfter); incrementUserUsage(ownerAfter, contentSizeAfter, nodeRef); } else if (ownerAfter == null && ownerBefore != null && contentSizeBefore != 0) { // old owner has been removed if (logger.isDebugEnabled()) logger.debug("onUpdateProperties: updateOwner ("+ownerBefore+" -> null): nodeRef="+nodeRef+", contentSize="+contentSizeBefore); decrementUserUsage(ownerBefore, contentSizeBefore, nodeRef); } else if (ownerBefore != null && ownerAfter != null && ownerBefore.equals(ownerAfter) == false) { // owner has changed (size has not) if (logger.isDebugEnabled()) logger.debug("onUpdateProperties: updateOwner ("+ownerBefore+" -> "+ownerAfter+"): nodeRef="+nodeRef+", contentSize="+contentSizeBefore); if (contentSizeBefore != 0) { decrementUserUsage(ownerBefore, contentSizeBefore, nodeRef); } if (contentSizeAfter != 0) { incrementUserUsage(ownerAfter, contentSizeAfter, nodeRef); } } } } } } /** * Called before a node is deleted. * * @param nodeRef the node reference */ public void beforeDeleteNode(NodeRef nodeRef) { if (stores.contains(nodeRef.getStoreRef().toString())) { // TODO use data dictionary to get content property ContentData contentData = (ContentData)nodeService.getProperty(nodeRef, ContentModel.PROP_CONTENT); if (contentData != null) { long contentSize = contentData.getSize(); String owner = (String)nodeService.getProperty(nodeRef, ContentModel.PROP_OWNER); if (contentSize != 0 && owner != null) { // decrement usage if node is being deleted if (logger.isDebugEnabled()) logger.debug("beforeDeleteNode: nodeRef="+nodeRef+", owner="+owner+", contentSize="+contentSize); decrementUserUsage(owner, contentSize, nodeRef); } } } } private void incrementUserUsage(String userName, long contentSize, NodeRef contentNodeRef) { if (! userName.equals(authenticationComponent.getSystemUserName())) { // increment usage - add positive delta if (logger.isDebugEnabled()) logger.debug("incrementUserUsage: username="+userName+", contentSize="+contentSize+", contentNodeRef="+contentNodeRef); long currentSize = getUserUsage(userName); long quotaSize = getUserQuota(userName); long newSize = currentSize + contentSize; // check whether user's quota exceeded if ((quotaSize != -1) && (newSize > quotaSize)) { if (logger.isWarnEnabled()) { logger.warn("User (" + userName + ") quota exceeded: content=" + contentSize + ", usage=" + currentSize + ", quota=" + quotaSize); } throw new ContentQuotaException("User quota exceeded"); } NodeRef personNodeRef = personService.getPerson(userName); usageService.insertDelta(personNodeRef, contentSize); } } private void decrementUserUsage(String userName, long contentSize, NodeRef contentNodeRef) { if (! userName.equals(authenticationComponent.getSystemUserName())) { // decrement usage - add negative delta if (logger.isDebugEnabled()) logger.debug("decrementUserUsage: username="+userName+", contentSize="+contentSize+", contentNodeRef="+contentNodeRef); long currentSize = getUserUsage(userName); long newSize = currentSize + contentSize; if (newSize < 0) { if (logger.isDebugEnabled()) { logger.debug("User (" + userName + ") has negative usage (" + newSize + ") - reset to 0"); } } NodeRef personNodeRef = personService.getPerson(userName); usageService.insertDelta(personNodeRef, (-contentSize)); } } /** * Set user's usage. Should only be called by background (collapse) job ! * * @param userName * @param currentUsage */ public void setUserStoredUsage(NodeRef personNodeRef, long currentUsage) { if (personNodeRef != null) { nodeService.setProperty(personNodeRef, ContentModel.PROP_SIZE_CURRENT, new Long(currentUsage)); } } public long getUserStoredUsage(NodeRef personNodeRef) { Long currentUsage = null; if (personNodeRef != null) { currentUsage = (Long)nodeService.getProperty(personNodeRef, ContentModel.PROP_SIZE_CURRENT); } return (currentUsage == null ? -1 : currentUsage); } public long getUserUsage(String userName) { long currentUsage = -1; NodeRef personNodeRef = personService.getPerson(userName); if (personNodeRef != null) { currentUsage = getUserStoredUsage(personNodeRef); } if (currentUsage != -1) { // add any deltas currentUsage = currentUsage + usageService.getTotalDeltaSize(personNodeRef); if (currentUsage < 0) { if (logger.isWarnEnabled()) { logger.warn("User usage ("+ userName+") is negative ("+currentUsage+") overriding to 0"); } currentUsage = 0; } } return currentUsage; } /** * Set user's current quota. * Usually called by Web Client (Admin Console) if admin is changing/setting a user's quota. * * @param userName * @param currentQuota */ public void setUserQuota(String userName, long currentQuota) { NodeRef personNodeRef = personService.getPerson(userName); if (personNodeRef != null) { nodeService.setProperty(personNodeRef, ContentModel.PROP_SIZE_QUOTA, new Long(currentQuota)); } } public long getUserQuota(String userName) { Long currentQuota = null; NodeRef personNodeRef = personService.getPerson(userName); if (personNodeRef != null) { currentQuota = (Long)nodeService.getProperty(personNodeRef, ContentModel.PROP_SIZE_QUOTA); } return (currentQuota == null ? -1 : currentQuota); } public boolean getEnabled() { return enabled; } }