mimemediatype.java

jxme的一些相关程序,主要是手机上程序开发以及手机和计算机通信的一些程序资料,程序编译需要Ant支持

/*
 * Copyright (c) 2001 Sun Microsystems, Inc.  All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 *
 * 1. Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 *
 * 2. Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in
 *    the documentation and/or other materials provided with the
 *    distribution.
 *
 * 3. The end-user documentation included with the redistribution,
 *    if any, must include the following acknowledgment:
 *       "This product includes software developed by the
 *       Sun Microsystems, Inc. for Project JXTA."
 *    Alternately, this acknowledgment may appear in the software itself,
 *    if and wherever such third-party acknowledgments normally appear.
 *
 * 4. The names "Sun", "Sun Microsystems, Inc.", "JXTA" and "Project JXTA" must
 *    not be used to endorse or promote products derived from this
 *    software without prior written permission. For written
 *    permission, please contact Project JXTA at http://www.jxta.org.
 *
 * 5. Products derived from this software may not be called "JXTA",
 *    nor may "JXTA" appear in their name, without prior written
 *    permission of Sun.
 *
 * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
 * DISCLAIMED.  IN NO EVENT SHALL SUN MICROSYSTEMS OR
 * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
 * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
 * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
 * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 * SUCH DAMAGE.
 * ====================================================================
 *
 * This software consists of voluntary contributions made by many
 * individuals on behalf of Project JXTA.  For more
 * information on Project JXTA, please see
 * <http://www.jxta.org/>.
 *
 * This license is based on the BSD license adopted by the Apache Foundation.
 *
 * $Id: MimeMediaType.java,v 1.19 2002/06/03 20:41:10 bondolo Exp $
 */

package net.jxta.document;

import java.lang.Cloneable;
import java.lang.String;
import java.util.Enumeration;
import java.util.Vector;

import java.lang.IllegalArgumentException;

/**
 *  Mime Media Types are used to describe the format of data streams. Its format
 *  is defined by
 * {@link <a href=http://www.ietf.org/rfc/rfc2046.txt">IETF RFC 2046 <i>MIME : Media Types</i></a>}.
 *  This class managed parsing of Mime Media Types from strings and piecemeal
 *  construction of Mime Media Type descriptors.
 *
 * @see         net.jxta.document.Document
 * @see         net.jxta.document.StructuredDocument
 * @see         net.jxta.document.StructuredTextDocument
 *
 * @version $Revision: 1.19 $
 * @since JXTA 1.0
 */
public class MimeMediaType extends Object implements Cloneable {
  
  static private class parameter {
    String attribute;
    String value;
    
    parameter( String attr, String val ) {
      attribute = attr;
      value = outputForm( val );
    }
    
    public String toString() {
      return attribute + "=" + value;
    }
    
    static String outputForm( String val ) {
      StringBuffer result = new StringBuffer();
      
      if( -1 == findNextSeperator( val ) )
        result.append( val );
      else {
        // needs quoting
        result.append( '"' );
        for ( int eachChar = 0; eachChar < val.length(); eachChar++ ) {
          char aChar = val.charAt( eachChar );
          
          if( ('\\' == aChar) || ('\"' == aChar) || ('\r' == aChar) ) {
            // needs escaping.
            result.append( '\\' );
          }
          result.append( aChar );
        }
        result.append( '"' );
      }
      
      return result.toString();
    }
    
    public boolean equals( Object obj ) {
      if (this == obj)
        return true;
      
      if( !(obj instanceof parameter) )
        return false;
      
      return ((parameter)obj).attribute.equals( attribute );
    }
  }
  
  /**
   *  The primary media type
   **/
  private String type = null;
  
  /**
   *  The specific media sub-type
   **/
  private String subtype = null;
  
  /**
   *  The parameters for this media type
   **/
  private Vector parameters = new Vector();
  
  private final static String CTL =
  "\u0000\u0001\u0002\u0003\u0004\u0005\u0006\u0007" +
  "\u0008\u0009\n\u000b\u000c\r\u000e\u000f" +
  "\u0010\u0011\u0012\u0013\u0014\u0015\u0016\u0017" +
  "\u0018\u0019\u001a\u001b\u001c\u001d\u001e\u001f" +
  "\u007f";
  
  private final static String space = "\u0020";
  private final static String LWSP_char = space + "\u0009";
  private final static String param_sep = LWSP_char + ";";
  private final static String tspecials = "()<>@,;:\\\"/[]?=";
  private final static String terminator = CTL + space + tspecials;
  
  /**
   * Creates a new MimeMediaType
   *
   * @since JXTA 1.0
   *
   * @param someString string representing a mime-type
   */
  public MimeMediaType(String someString) {
    
    if( null == someString )
      throw new IllegalArgumentException( "input cannot be null" );
    
    String cleaned = someString.trim();
    
    if( 0 == cleaned.length() )
      throw new IllegalArgumentException( "input cannot be empty" );
    
    // determine the type
    int typeSepAt = findNextSeperator( cleaned );
    
    if( (-1 == typeSepAt) || (0 == typeSepAt) || ('/' != cleaned.charAt(typeSepAt)) )
      throw new IllegalArgumentException( "expected seperator or seperator in unexpected location" );
    
    setType( cleaned.substring( 0, typeSepAt ) );
    
    // determine the sub-type
    int subtypeSepAt = findNextSeperator( cleaned, typeSepAt + 1 );
    
    String itsParams = "";
    
    if(-1 == subtypeSepAt)
      setSubtype( cleaned.substring( typeSepAt + 1 ) );
    else {
      setSubtype( cleaned.substring( typeSepAt + 1, subtypeSepAt) );
      itsParams = cleaned.substring( subtypeSepAt );
      // include the seperator, its significant
    }
    
    parseParams( itsParams, false );
  }
  
  /**
   * Creates a new type/subtype MimeMediaType
   *
   * @since JXTA 1.0
   *
   * @param type string representing a mime type
   * @param subtype string representing a mime subtype
   **/
  public MimeMediaType(String type, String subtype) {
    this( type, subtype, (String) null );
  }
  
  /**
   * Creates a new type/subtype MimeMediaType
   *
   * @since JXTA 1.0
   *
   * @param type string representing a mime type
   * @param subtype string representing a mime subtype
   * @param parameters parameters to the mime-type constructor
   **/
  public MimeMediaType(String type, String subtype, String parameters) {
    setType( type );
    setSubtype( subtype );
    if( null != parameters )
      parseParams( parameters, false );
  }
  
  /**
   * Creates a new type/subtype MimeMediaType with the specified parameters.
   *  The parameters are copied from the source mime type and additional params
   *  are added. If replace is true, then the provided params will overwrite
   *  the params from the source mime type.
   *
   * @since JXTA 1.0
   *
   * @param type the source mime type
   * @param params parameters to the mime-type constructor
   * @param replace parameters if true then provided params should replace
   * existing params else they are accumulated.
   **/
  public MimeMediaType(MimeMediaType type, String params, boolean replace) {
    setType( type.getType() );
    setSubtype( type.getSubtype() );
    parameters.addAll( type.parameters );
    
    parseParams( params, replace  );
  }
  
  /**
   * Creates a new type/subtype MimeMediaType
   *
   * @since JXTA 1.0
   *
   * @param itsParams parse a string for mime parameters.
   * @param replace parameters if true then provided params should replace
   * existing params else they are accumulated.
   **/
  private void parseParams( String itsParams, boolean replace ) {
    int currentCharIdx = 0;
    String currentAttribute = null;
    boolean inSeperator = true;
    boolean inComment = false;
    boolean inAttribute = false;
    StringBuffer currentValue = null;
    boolean inValue = false;
    boolean inQuoted = false;
    boolean nextEscaped = false;
    
    while( currentCharIdx < itsParams.length() ) {
      char currentChar = itsParams.charAt( currentCharIdx );
      
      if( inSeperator ) {
        if( '(' == currentChar ) {
          inSeperator = false;
          inComment = true;
        } else if( -1 == param_sep.indexOf( currentChar ) ) {
          inSeperator = false;
          inAttribute = true;
          currentCharIdx--; // unget
        }
      }  else if ( inComment ) {
        if( nextEscaped ) {
          nextEscaped = false;
        } else {
          if( '\\' == currentChar ) {
            nextEscaped = true;
          } else if( ')' == currentChar ) {
            inComment = false;
            inSeperator = true;
          } else if( '\r' == currentChar ) {
            throw new IllegalArgumentException( "malformed mime parameter at idx = " + currentCharIdx );
          }
        }