/*
 * Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved.
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
 *
 * This code is free software; you can redistribute it and/or modify it
 * under the terms of the GNU General Public License version 2 only, as
 * published by the Free Software Foundation.  Oracle designates this
 * particular file as subject to the "Classpath" exception as provided
 * by Oracle in the LICENSE file that accompanied this code.
 *
 * This code 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
 * version 2 for more details (a copy is included in the LICENSE file that
 * accompanied this code).
 *
 * You should have received a copy of the GNU General Public License version
 * 2 along with this work; if not, write to the Free Software Foundation,
 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
 *
 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
 * or visit www.oracle.com if you need additional information or have any
 * questions.
 */

package com.sun.xml.internal.ws.encoding;

import com.sun.istack.internal.NotNull;
import com.sun.istack.internal.Nullable;
import com.sun.xml.internal.ws.api.message.Attachment;
import com.sun.xml.internal.ws.api.message.AttachmentEx;
import com.sun.xml.internal.ws.developer.StreamingAttachmentFeature;
import com.sun.xml.internal.ws.developer.StreamingDataHandler;
import com.sun.xml.internal.ws.util.ByteArrayBuffer;
import com.sun.xml.internal.ws.util.ByteArrayDataSource;

import com.sun.xml.internal.org.jvnet.mimepull.Header;
import com.sun.xml.internal.org.jvnet.mimepull.MIMEMessage;
import com.sun.xml.internal.org.jvnet.mimepull.MIMEPart;

import javax.activation.DataHandler;
import javax.xml.soap.SOAPException;
import javax.xml.soap.SOAPMessage;
import javax.xml.transform.Source;
import javax.xml.transform.stream.StreamSource;
import javax.xml.ws.WebServiceException;
import java.io.ByteArrayInputStream;
import java.io.IOException;
import java.io.InputStream;
import java.io.OutputStream;
import java.util.HashMap;
import java.util.Iterator;
import java.util.List;
import java.util.Map;
import java.util.logging.Level;
import java.util.logging.Logger;

Parses Mime multipart message into primary part and attachment parts. It parses the stream lazily as and when required.
Author:Vivek Pandey, Jitendra Kotamraju
/** * Parses Mime multipart message into primary part and attachment parts. It * parses the stream lazily as and when required. * * @author Vivek Pandey * @author Jitendra Kotamraju */
public final class MimeMultipartParser { private final String start; private final MIMEMessage message; private Attachment root; private ContentTypeImpl contentType; // Attachments without root part private final Map<String, Attachment> attachments = new HashMap<String, Attachment>(); private boolean gotAll; public MimeMultipartParser(InputStream in, String cType, StreamingAttachmentFeature feature) { this.contentType = new ContentTypeImpl(cType); // ContentType ct = new ContentType(cType); // String boundary = ct.getParameter("boundary"); String boundary = contentType.getBoundary(); if (boundary == null || boundary.equals("")) { throw new WebServiceException("MIME boundary parameter not found" + contentType); } message = (feature != null) ? new MIMEMessage(in, boundary, feature.getConfig()) : new MIMEMessage(in, boundary); // Strip <...> from root part's Content-ID // String st = ct.getParameter("start"); String st = contentType.getRootId(); if (st != null && st.length() > 2 && st.charAt(0) == '<' && st.charAt(st.length()-1) == '>') { st = st.substring(1, st.length()-1); } start = st; }
Parses the stream and returns the root part. If start parameter is present in Content-Type, it is used to determine the root part, otherwise root part is the first part.
Returns:StreamAttachment for root part null if root part cannot be found
/** * Parses the stream and returns the root part. If start parameter is * present in Content-Type, it is used to determine the root part, otherwise * root part is the first part. * * @return StreamAttachment for root part * null if root part cannot be found * */
public @Nullable Attachment getRootPart() { if (root == null) { root = new PartAttachment((start != null) ? message.getPart(start) : message.getPart(0)); } return root; }
Parses the entire stream and returns all MIME parts except root MIME part.
Returns:Map for all attachment parts
/** * Parses the entire stream and returns all MIME parts except root MIME part. * * @return Map<String, StreamAttachment> for all attachment parts */
public @NotNull Map<String, Attachment> getAttachmentParts() { if (!gotAll) { MIMEPart rootPart = (start != null) ? message.getPart(start) : message.getPart(0); List<MIMEPart> parts = message.getAttachments(); for(MIMEPart part : parts) { if (part != rootPart) { String cid = part.getContentId(); if (!attachments.containsKey(cid)) { PartAttachment attach = new PartAttachment(part); attachments.put(attach.getContentId(), attach); } } } gotAll = true; } return attachments; }
This method can be called to get a matching MIME attachment part for the given contentId. It parses the stream until it finds a matching part.
Returns:StreamAttachment attachment for contentId null if there is no attachment for contentId
/** * This method can be called to get a matching MIME attachment part for the * given contentId. It parses the stream until it finds a matching part. * * @return StreamAttachment attachment for contentId * null if there is no attachment for contentId */
public @Nullable Attachment getAttachmentPart(String contentId) throws IOException { //first see if this attachment is already parsed, if so return it Attachment attach = attachments.get(contentId); if (attach == null) { MIMEPart part = message.getPart(contentId); attach = new PartAttachment(part); attachments.put(contentId, attach); } return attach; } static class PartAttachment implements AttachmentEx { final MIMEPart part; byte[] buf; private StreamingDataHandler streamingDataHandler; PartAttachment(MIMEPart part) { this.part = part; } public @NotNull @Override String getContentId() { return part.getContentId(); } public @NotNull @Override String getContentType() { return part.getContentType(); } @Override public byte[] asByteArray() { if (buf == null) { ByteArrayBuffer baf = new ByteArrayBuffer(); try { baf.write(part.readOnce()); } catch(IOException ioe) { throw new WebServiceException(ioe); } finally { if (baf != null) { try { baf.close(); } catch (IOException ex) { Logger.getLogger(MimeMultipartParser.class.getName()).log(Level.FINE, null, ex); } } } buf = baf.toByteArray(); } return buf; } @Override public DataHandler asDataHandler() { if (streamingDataHandler == null) { streamingDataHandler = (buf != null) ? new DataSourceStreamingDataHandler(new ByteArrayDataSource(buf,getContentType())) : new MIMEPartStreamingDataHandler(part); } return streamingDataHandler; } @Override public Source asSource() { return (buf != null) ? new StreamSource(new ByteArrayInputStream(buf)) : new StreamSource(part.read()); } @Override public InputStream asInputStream() { return (buf != null) ? new ByteArrayInputStream(buf) : part.read(); } @Override public void writeTo(OutputStream os) throws IOException { if (buf != null) { os.write(buf); } else { InputStream in = part.read(); byte[] temp = new byte[8192]; int len; while((len=in.read(temp)) != -1) { os.write(temp, 0, len); } in.close(); } } @Override public void writeTo(SOAPMessage saaj) throws SOAPException { saaj.createAttachmentPart().setDataHandler(asDataHandler()); } // AttachmentEx methods begin here @Override public Iterator<MimeHeader> getMimeHeaders() { final Iterator<? extends Header> ih = part.getAllHeaders() .iterator(); return new Iterator<MimeHeader>() { @Override public boolean hasNext() { return ih.hasNext(); } @Override public MimeHeader next() { final Header hdr = ih.next(); return new AttachmentEx.MimeHeader() { @Override public String getValue() { return hdr.getValue(); } @Override public String getName() { return hdr.getName(); } }; } @Override public void remove() { throw new UnsupportedOperationException(); } }; } } public ContentTypeImpl getContentType() { return contentType; } }