/* * Copyright (C) 2005-2010 Alfresco Software Limited. * * This file is part of Alfresco * * Alfresco is free software: you can redistribute it and/or modify * it under the terms of the GNU Lesser General Public License as published by * the Free Software Foundation, either version 3 of the License, or * (at your option) any later version. * * Alfresco 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 Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public License * along with Alfresco. If not, see . */ package org.alfresco.email.server.handler; import java.io.BufferedInputStream; import java.io.ByteArrayInputStream; import java.io.InputStream; import java.io.Serializable; import java.io.UnsupportedEncodingException; import java.util.HashMap; import java.util.List; import java.util.Map; import org.alfresco.email.server.EmailServiceImpl; import org.alfresco.error.AlfrescoRuntimeException; import org.alfresco.model.ContentModel; import org.alfresco.repo.content.encoding.ContentCharsetFinder; import org.alfresco.service.cmr.dictionary.DictionaryService; import org.alfresco.service.cmr.email.EmailMessage; import org.alfresco.service.cmr.email.EmailMessagePart; import org.alfresco.service.cmr.repository.ChildAssociationRef; import org.alfresco.service.cmr.repository.ContentService; import org.alfresco.service.cmr.repository.ContentWriter; import org.alfresco.service.cmr.repository.MimetypeService; import org.alfresco.service.cmr.repository.NodeRef; import org.alfresco.service.cmr.repository.NodeService; import org.alfresco.service.namespace.NamespaceService; import org.alfresco.service.namespace.QName; import org.apache.commons.io.FilenameUtils; import org.apache.commons.logging.Log; import org.apache.commons.logging.LogFactory; /** * Abstract class implements common logic for processing email messages. * * @author maxim * @since 2.2 */ public abstract class AbstractEmailMessageHandler implements EmailMessageHandler { private static final Log log = LogFactory.getLog(EmailMessageHandler.class); private DictionaryService dictionaryService; private NodeService nodeService; private ContentService contentService; private MimetypeService mimetypeService; private static Log logger = LogFactory.getLog(AbstractEmailMessageHandler.class); /** * @return Alfresco Content Service. */ protected ContentService getContentService() { return contentService; } /** * @param contentService Alfresco Content Service. */ public void setContentService(ContentService contentService) { this.contentService = contentService; } /** * @return the Alfresco dictionary service */ protected DictionaryService getDictionaryService() { return dictionaryService; } /** * @param dictionaryService Alfresco dictionary service */ public void setDictionaryService(DictionaryService dictionaryService) { this.dictionaryService = dictionaryService; } /** * @return Alfresco Node Service. */ protected NodeService getNodeService() { return nodeService; } /** * @param nodeService Alfresco Node Service. */ public void setNodeService(NodeService nodeService) { this.nodeService = nodeService; } /** * @return the service used to determine mimeypte and encoding */ protected MimetypeService getMimetypeService() { return mimetypeService; } /** * @param mimetypeService the the service to determine mimetype and encoding */ public void setMimetypeService(MimetypeService mimetypeService) { this.mimetypeService = mimetypeService; } // /** // * @param to Email address which user part specifies node-dbid // * @return Referance to requested node. // * @throws InvalidArgumentException The exception is thrown if input string has incorrect format or empty. // */ // protected NodeRef getTargetNode(String to) throws InvalidArgumentException // { // if (to == null || to.length() == 0) // { // throw new InvalidArgumentException("Input string has to contain email address."); // } // String[] parts = to.split("@"); // if (parts.length != 2) // { // throw new InvalidArgumentException("Incorrect email address format."); // } // try // { // Long dbId = Long.parseLong(parts[0]); // return nodeService.getNodeRef(dbId); // } // catch (NumberFormatException e) // { // return null; // } // } // /** // * Write the content to the node as MIMETYPE TEXT PLAIN. // * // * @param nodeRef Target node // * @param content Content // */ // protected void writeContent(NodeRef nodeRef, String content) // { // writeContent(nodeRef, content, MimetypeMap.MIMETYPE_TEXT_PLAIN); // } /** * Write the string as content to the node. * * @param nodeRef Target node. * @param content Text for writting. * @param mimetype MIME content type. For exaple you can set this parameter to "text/html" or "text/xml", etc. */ protected void writeContent(NodeRef nodeRef, String content, String mimetype) { try { InputStream inputStream = new ByteArrayInputStream(content.getBytes("UTF-8")); writeContent(nodeRef, inputStream, mimetype, "UTF-8"); } catch (UnsupportedEncodingException e) { throw new AlfrescoRuntimeException("Failed to write content", e); } } /** * Write content to the node from InputStream. * * @param nodeRef Target node. * @param content Content stream. * @param mimetype MIME content type. * @param encoding Encoding. Can be null for text based content, n which case the best guess. */ protected void writeContent(NodeRef nodeRef, InputStream content, String mimetype, String encoding) { InputStream bis = new BufferedInputStream(content, 4092); // Only guess the encoding if it has not been supplied if (encoding == null) { if (mimetypeService.isText(mimetype)) { ContentCharsetFinder charsetFinder = mimetypeService.getContentCharsetFinder(); encoding = charsetFinder.getCharset(bis, mimetype).name(); } else { encoding = "UTF-8"; } } if (log.isDebugEnabled()) { log.debug("Write content (MimeType=\"" + mimetype + "\", Encoding=\"" + encoding + "\""); } ContentService contentService = getContentService(); ContentWriter writer = contentService.getWriter(nodeRef, ContentModel.PROP_CONTENT, true); writer.setMimetype(mimetype); writer.setEncoding(encoding); writer.putContent(bis); } /** * Add emailed aspect to the specified node. * * @param nodeService Alfresco Node Service. * @param nodeRef Target node. * @param mailParser Mail message that will be used for extracting necessary information */ protected void addEmailedAspect(NodeRef nodeRef, EmailMessage message) { /* * TODO - get rid of this and use the RFC822 metadata extractor instead. */ Map emailProps = new HashMap(); emailProps.put(ContentModel.PROP_SENTDATE, message.getSentDate()); emailProps.put(ContentModel.PROP_ORIGINATOR, message.getFrom()); emailProps.put(ContentModel.PROP_ADDRESSEE, message.getTo()); emailProps.put(ContentModel.PROP_ADDRESSEES, (Serializable)message.getCC()); emailProps.put(ContentModel.PROP_SUBJECT, message.getSubject()); nodeService.addAspect(nodeRef, ContentModel.ASPECT_EMAILED, emailProps); /* * MER * Can't add IMAP_CONTENT here since that means the body of the message is a mime message. */ //Map imapProps = new HashMap(); //emailProps.put(ImapModel.PROP_MESSAGE_FROM, message.getFrom()); //emailProps.put(ImapModel.PROP_MESSAGE_TO, message.getTo()); //emailProps.put(ImapModel.PROP_MESSAGE_CC, (Serializable)message.getCC()); //emailProps.put(ImapModel.PROP_MESSAGE_SUBJECT, message.getSubject()); //nodeService.addAspect(nodeRef, ImapModel.ASPECT_IMAP_CONTENT, imapProps); if (log.isDebugEnabled()) { log.debug("Emailed aspect has been added."); } } /** * Add new node into Alfresco repository with specified parameters. Node content isn't added. * * @param nodeService Alfresco Node Service * @param parent Parent node * @param name Name of the new node * @param overwrite if true then overwrite an existing node with the same name. if false the name is changed to make it unique. * @param assocType Association type that should be set between parent node and the new one. * @return Reference to created node */ protected NodeRef addContentNode(NodeService nodeService, NodeRef parent, String name, QName assocType, boolean overwrite) { NodeRef childNodeRef = null; String workingName = name; // Need to work out a new safe name. String baseName = FilenameUtils.getBaseName(name); String extension = FilenameUtils.getExtension(name); if(logger.isDebugEnabled()) { logger.debug("addContentNode name:" + name); } for(int counter = 1; counter < 10000; counter++) { QName safeQName = QName.createQNameWithValidLocalName(NamespaceService.CONTENT_MODEL_1_0_URI, workingName); List childNodeRefs = nodeService.getChildAssocs(parent, ContentModel.ASSOC_CONTAINS, safeQName); if (childNodeRefs.size() > 0) { if(overwrite) { if(logger.isDebugEnabled()) { logger.debug("overwriting existing node :" + name); } childNodeRef=childNodeRefs.get(0).getChildRef(); // Node already exists // The node is present already. Make sure the name case is correct nodeService.setProperty(childNodeRef, ContentModel.PROP_NAME, baseName); return childNodeRef; } // Node already exists and not overwrite String postFix = "(" + counter + ")"; if(baseName.length() + extension.length() + postFix.length() > QName.MAX_LENGTH ) { // Need to truncate base name workingName = baseName.substring(0, QName.MAX_LENGTH - postFix.length() - extension.length() -1) + postFix; } else { workingName = baseName + postFix ; } if(extension.length() > 0) { workingName = workingName + "." + extension; } } else { // Here if child node ref does not already exist if(logger.isDebugEnabled()) { logger.debug("child node ref does not already exist :" + workingName); } Map contentProps = new HashMap(); contentProps.put(ContentModel.PROP_NAME, workingName); ChildAssociationRef associationRef = nodeService.createNode( parent, assocType, safeQName, ContentModel.TYPE_CONTENT, contentProps); childNodeRef = associationRef.getChildRef(); return childNodeRef; } } throw new AlfrescoRuntimeException("Unable to add new file"); } /** * Add new node into Alfresco repository with specified parameters. * Node content isn't added. * * New node will be created with ContentModel.ASSOC_CONTAINS association with parent. * * @param nodeService Alfresco Node Service * @param parent Parent node * @param name Name of the new node * @param overwrite whether a new node should overwrite an existing node with the same name or have its name * mangled to be alongside the existing node. * @return Reference to created node * */ protected NodeRef addContentNode(NodeService nodeService, NodeRef parent, String name, boolean overwrite) { return addContentNode(nodeService, parent, name, ContentModel.ASSOC_CONTAINS, overwrite); } /** * Adds new node into Alfresco repository and mark its as an attachment. * * @param nodeService Alfresco Node Service. * @param folder Space/Folder to add. * @param mainContentNode Main content node. Any mail is added into Alfresco as one main content node and several its attachments. Each attachment related with its main node. * @param fileName File name for the attachment. * @return Reference to created node. */ protected NodeRef addAttachment(NodeService nodeService, NodeRef folder, NodeRef mainContentNode, String fileName) { if (log.isDebugEnabled()) { log.debug("Adding attachment node (name=" + fileName + ")."); } NodeRef attachmentNode = addContentNode(nodeService, folder, fileName, false); // Add attached aspect nodeService.addAspect(mainContentNode, ContentModel.ASPECT_ATTACHABLE, null); // Add the association nodeService.createAssociation(mainContentNode, attachmentNode, ContentModel.ASSOC_ATTACHMENTS); if (log.isDebugEnabled()) { log.debug("Attachment has been added."); } return attachmentNode; } /** * Return unique content name in passed folder based on provided name * * @param parent parent folder * @param name name of node * @param assocType assocType between parent and child * @return Original name or name in format {name}({number}) */ private String getAppropriateNodeName(NodeRef parent, String name, QName assocType) { if (nodeService.getChildByName(parent, assocType, name) != null) { name = name + "(1)"; while (nodeService.getChildByName(parent, assocType, name) != null) { int index = name.lastIndexOf("("); if ((index > 0) && name.charAt(name.length() - 1) == ')') { String posibleNumber = name.substring(index + 1, name.length() - 1); long num = Long.parseLong(posibleNumber) + 1; name = name.substring(0, index) + "(" + num + ")"; } } } return name; } /** * Extracts the attachments from the given message and adds them to the space. All attachments * are linked back to the original node that they are attached to. * * @param spaceNodeRef the space to add the documents into * @param nodeRef the node to which the documents will be attached * @param message the email message */ protected void addAttachments(NodeRef spaceNodeRef, NodeRef nodeRef, EmailMessage message) { // Add attachments EmailMessagePart[] attachments = message.getAttachments(); for (EmailMessagePart attachment : attachments) { String fileName = attachment.getFileName(); InputStream contentIs = attachment.getContent(); MimetypeService mimetypeService = getMimetypeService(); String mimetype = mimetypeService.guessMimetype(fileName); String encoding = attachment.getEncoding(); NodeRef attachmentNode = addAttachment(getNodeService(), spaceNodeRef, nodeRef, fileName); writeContent(attachmentNode, contentIs, mimetype, encoding); } } }