xref: /packages/apps/Email/src/org/apache/james/mime4j/field/ContentTypeField.java

/****************************************************************
 * Licensed to the Apache Software Foundation (ASF) under one   *
 * or more contributor license agreements.  See the NOTICE file *
 * distributed with this work for additional information        *
 * regarding copyright ownership.  The ASF licenses this file   *
 * to you under the Apache License, Version 2.0 (the            *
 * "License"); you may not use this file except in compliance   *
 * with the License.  You may obtain a copy of the License at   *
 *                                                              *
 *   http://www.apache.org/licenses/LICENSE-2.0                 *
 *                                                              *
 * Unless required by applicable law or agreed to in writing,   *
 * software distributed under the License is distributed on an  *
 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY       *
 * KIND, either express or implied.  See the License for the    *
 * specific language governing permissions and limitations      *
 * under the License.                                           *
 ****************************************************************/

package org.apache.james.mime4j.field;

import java.io.StringReader;
import java.util.ArrayList;
import java.util.Collections;
import java.util.HashMap;
import java.util.Map;

//BEGIN android-changed: Stubbing out logging
import org.apache.james.mime4j.Log;
import org.apache.james.mime4j.LogFactory;
//END android-changed
import org.apache.james.mime4j.field.contenttype.parser.ContentTypeParser;
import org.apache.james.mime4j.field.contenttype.parser.ParseException;
import org.apache.james.mime4j.field.contenttype.parser.TokenMgrError;

/**
 * Represents a <code>Content-Type</code> field.
 *
 * <p>TODO: Remove dependency on Java 1.4 regexps</p>
 *
 *
 * @version $Id: ContentTypeField.java,v 1.6 2005/01/27 14:16:31 ntherning Exp $
 */
public class ContentTypeField extends Field {

    /**
     * The prefix of all <code>multipart</code> MIME types.
     */
    public static final String TYPE_MULTIPART_PREFIX = "multipart/";
    /**
     * The <code>multipart/digest</code> MIME type.
     */
    public static final String TYPE_MULTIPART_DIGEST = "multipart/digest";
    /**
     * The <code>text/plain</code> MIME type.
     */
    public static final String TYPE_TEXT_PLAIN = "text/plain";
    /**
     * The <code>message/rfc822</code> MIME type.
     */
    public static final String TYPE_MESSAGE_RFC822 = "message/rfc822";
    /**
     * The name of the <code>boundary</code> parameter.
     */
    public static final String PARAM_BOUNDARY = "boundary";
    /**
     * The name of the <code>charset</code> parameter.
     */
    public static final String PARAM_CHARSET = "charset";

    private String mimeType = "";
    private Map<String, String> parameters = null;
    private ParseException parseException;

    protected ContentTypeField(String name, String body, String raw, String mimeType, Map<String, String> parameters, ParseException parseException) {
        super(name, body, raw);
        this.mimeType = mimeType;
        this.parameters = parameters;
        this.parseException = parseException;
    }

    /**
     * Gets the exception that was raised during parsing of
     * the field value, if any; otherwise, null.
     */
    public ParseException getParseException() {
        return parseException;
    }

    /**
     * Gets the MIME type defined in this Content-Type field.
     *
     * @return the MIME type or an empty string if not set.
     */
    public String getMimeType() {
        return mimeType;
    }

    /**
     * Gets the MIME type defined in the child's
     * Content-Type field or derives a MIME type from the parent
     * if child is <code>null</code> or hasn't got a MIME type value set.
     * If child's MIME type is multipart but no boundary
     * has been set the MIME type of child will be derived from
     * the parent.
     *
     * @param child the child.
     * @param parent the parent.
     * @return the MIME type.
     */
    public static String getMimeType(ContentTypeField child,
                                     ContentTypeField parent) {

        if (child == null || child.getMimeType().length() == 0
                || child.isMultipart() && child.getBoundary() == null) {

            if (parent != null && parent.isMimeType(TYPE_MULTIPART_DIGEST)) {
                return TYPE_MESSAGE_RFC822;
            } else {
                return TYPE_TEXT_PLAIN;
            }
        }

        return child.getMimeType();
    }

    /**
     * Gets the value of a parameter. Parameter names are case-insensitive.
     *
     * @param name the name of the parameter to get.
     * @return the parameter value or <code>null</code> if not set.
     */
    public String getParameter(String name) {
        return parameters != null
                    ? parameters.get(name.toLowerCase())
                    : null;
    }

    /**
     * Gets all parameters.
     *
     * @return the parameters.
     */
    public Map<String, String> getParameters() {
        if (parameters != null) {
            return Collections.unmodifiableMap(parameters);
        }
        return Collections.emptyMap();
    }

    /**
     * Gets the value of the <code>boundary</code> parameter if set.
     *
     * @return the <code>boundary</code> parameter value or <code>null</code>
     *             if not set.
     */
    public String getBoundary() {
        return getParameter(PARAM_BOUNDARY);
    }

    /**
     * Gets the value of the <code>charset</code> parameter if set.
     *
     * @return the <code>charset</code> parameter value or <code>null</code>
     *         if not set.
     */
    public String getCharset() {
        return getParameter(PARAM_CHARSET);
    }

    /**
     * Gets the value of the <code>charset</code> parameter if set for the
     * given field. Returns the default <code>us-ascii</code> if not set or if
     * <code>f</code> is <code>null</code>.
     *
     * @return the <code>charset</code> parameter value.
     */
    public static String getCharset(ContentTypeField f) {
        if (f != null) {
            if (f.getCharset() != null && f.getCharset().length() > 0) {
                return f.getCharset();
            }
        }
        return "us-ascii";
    }

    /**
     * Determines if the MIME type of this field matches the given one.
     *
     * @param mimeType the MIME type to match against.
     * @return <code>true</code> if the MIME type of this field matches,
     *         <code>false</code> otherwise.
     */
    public boolean isMimeType(String mimeType) {
        return this.mimeType.equalsIgnoreCase(mimeType);
    }

    /**
     * Determines if the MIME type of this field is <code>multipart/*</code>.
     *
     * @return <code>true</code> if this field is has a <code>multipart/*</code>
     *         MIME type, <code>false</code> otherwise.
     */
    public boolean isMultipart() {
        return mimeType.startsWith(TYPE_MULTIPART_PREFIX);
    }

    public static class Parser implements FieldParser {
        private static Log log = LogFactory.getLog(Parser.class);

        public Field parse(final String name, final String body, final String raw) {
            ParseException parseException = null;
            String mimeType = "";
            Map<String, String> parameters = null;

            ContentTypeParser parser = new ContentTypeParser(new StringReader(body));
            try {
                parser.parseAll();
            }
            catch (ParseException e) {
                if (log.isDebugEnabled()) {
                    log.debug("Parsing value '" + body + "': "+ e.getMessage());
                }
                parseException = e;
            }
            catch (TokenMgrError e) {
                if (log.isDebugEnabled()) {
                    log.debug("Parsing value '" + body + "': "+ e.getMessage());
                }
                parseException = new ParseException(e.getMessage());
            }

            try {
                final String type = parser.getType();
                final String subType = parser.getSubType();

                if (type != null && subType != null) {
                    mimeType = (type + "/" + parser.getSubType()).toLowerCase();

                    ArrayList<String> paramNames = parser.getParamNames();
                    ArrayList<String> paramValues = parser.getParamValues();

                    if (paramNames != null && paramValues != null) {
                        for (int i = 0; i < paramNames.size() && i < paramValues.size(); i++) {
                            if (parameters == null)
                                parameters = new HashMap<String, String>((int)(paramNames.size() * 1.3 + 1));
                            String paramName = paramNames.get(i).toLowerCase();
                            String paramValue = paramValues.get(i);
                            parameters.put(paramName, paramValue);
                        }
                    }
                }
            }
            catch (NullPointerException npe) {
            }
            return new ContentTypeField(name, body, raw, mimeType, parameters, parseException);
        }
    }
}