1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328
/* * @(#)MimeType.java 1.20 05/11/17 * * Copyright 2006 Sun Microsystems, Inc. All Rights Reserved. * * This software is the proprietary information of Sun Microsystems, Inc. * Use is subject to license terms. * */ package javax.activation; import java.io.ObjectOutput; import java.io.ObjectInput; import java.io.IOException; import java.io.*; /** * A Multipurpose Internet Mail Extension (MIME) type, as defined * in RFC 2045 and 2046. * * @since 1.6 */ public class MimeType implements Externalizable { private String primaryType; private String subType; private MimeTypeParameterList parameters; /** * A string that holds all the special chars. */ private static final String TSPECIALS = "()<>@,;:/[]?=\\\""; /** * Default constructor. */ public MimeType() { primaryType = "application"; subType = "*"; parameters = new MimeTypeParameterList(); } /** * Constructor that builds a MimeType from a String. * * @param rawdata the MIME type string */ public MimeType(String rawdata) throws MimeTypeParseException { parse(rawdata); } /** * Constructor that builds a MimeType with the given primary and sub type * but has an empty parameter list. * * @param primary the primary MIME type * @param sub the MIME sub-type * @exception MimeTypeParseException if the primary type or subtype * is not a valid token */ public MimeType(String primary, String sub) throws MimeTypeParseException { // check to see if primary is valid if (isValidToken(primary)) { primaryType = primary.toLowerCase(); } else { throw new MimeTypeParseException("Primary type is invalid."); } // check to see if sub is valid if (isValidToken(sub)) { subType = sub.toLowerCase(); } else { throw new MimeTypeParseException("Sub type is invalid."); } parameters = new MimeTypeParameterList(); } /** * A routine for parsing the MIME type out of a String. */ private void parse(String rawdata) throws MimeTypeParseException { int slashIndex = rawdata.indexOf('/'); int semIndex = rawdata.indexOf(';'); if ((slashIndex < 0) && (semIndex < 0)) { // neither character is present, so treat it // as an error throw new MimeTypeParseException("Unable to find a sub type."); } else if ((slashIndex < 0) && (semIndex >= 0)) { // we have a ';' (and therefore a parameter list), // but no '/' indicating a sub type is present throw new MimeTypeParseException("Unable to find a sub type."); } else if ((slashIndex >= 0) && (semIndex < 0)) { // we have a primary and sub type but no parameter list primaryType = rawdata.substring(0, slashIndex).trim().toLowerCase(); subType = rawdata.substring(slashIndex + 1).trim().toLowerCase(); parameters = new MimeTypeParameterList(); } else if (slashIndex < semIndex) { // we have all three items in the proper sequence primaryType = rawdata.substring(0, slashIndex).trim().toLowerCase(); subType = rawdata.substring(slashIndex + 1, semIndex).trim().toLowerCase(); parameters = new MimeTypeParameterList(rawdata.substring(semIndex)); } else { // we have a ';' lexically before a '/' which means we // have a primary type and a parameter list but no sub type throw new MimeTypeParseException("Unable to find a sub type."); } // now validate the primary and sub types // check to see if primary is valid if (!isValidToken(primaryType)) throw new MimeTypeParseException("Primary type is invalid."); // check to see if sub is valid if (!isValidToken(subType)) throw new MimeTypeParseException("Sub type is invalid."); } /** * Retrieve the primary type of this object. * * @return the primary MIME type */ public String getPrimaryType() { return primaryType; } /** * Set the primary type for this object to the given String. * * @param primary the primary MIME type * @exception MimeTypeParseException if the primary type * is not a valid token */ public void setPrimaryType(String primary) throws MimeTypeParseException { // check to see if primary is valid if (!isValidToken(primaryType)) throw new MimeTypeParseException("Primary type is invalid."); primaryType = primary.toLowerCase(); } /** * Retrieve the subtype of this object. * * @return the MIME subtype */ public String getSubType() { return subType; } /** * Set the subtype for this object to the given String. * * @param sub the MIME subtype * @exception MimeTypeParseException if the subtype * is not a valid token */ public void setSubType(String sub) throws MimeTypeParseException { // check to see if sub is valid if (!isValidToken(subType)) throw new MimeTypeParseException("Sub type is invalid."); subType = sub.toLowerCase(); } /** * Retrieve this object's parameter list. * * @return a MimeTypeParameterList object representing the parameters */ public MimeTypeParameterList getParameters() { return parameters; } /** * Retrieve the value associated with the given name, or null if there * is no current association. * * @param name the parameter name * @return the paramter's value */ public String getParameter(String name) { return parameters.get(name); } /** * Set the value to be associated with the given name, replacing * any previous association. * * @param name the parameter name * @param value the paramter's value */ public void setParameter(String name, String value) { parameters.set(name, value); } /** * Remove any value associated with the given name. * * @param name the parameter name */ public void removeParameter(String name) { parameters.remove(name); } /** * Return the String representation of this object. */ public String toString() { return getBaseType() + parameters.toString(); } /** * Return a String representation of this object * without the parameter list. * * @return the MIME type and sub-type */ public String getBaseType() { return primaryType + "/" + subType; } /** * Determine if the primary and sub type of this object is * the same as what is in the given type. * * @param type the MimeType object to compare with * @return true if they match */ public boolean match(MimeType type) { return primaryType.equals(type.getPrimaryType()) && (subType.equals("*") || type.getSubType().equals("*") || (subType.equals(type.getSubType()))); } /** * Determine if the primary and sub type of this object is * the same as the content type described in rawdata. * * @param rawdata the MIME type string to compare with * @return true if they match */ public boolean match(String rawdata) throws MimeTypeParseException { return match(new MimeType(rawdata)); } /** * The object implements the writeExternal method to save its contents * by calling the methods of DataOutput for its primitive values or * calling the writeObject method of ObjectOutput for objects, strings * and arrays. * * @param out the ObjectOutput object to write to * @exception IOException Includes any I/O exceptions that may occur */ public void writeExternal(ObjectOutput out) throws IOException { out.writeUTF(toString()); out.flush(); } /** * The object implements the readExternal method to restore its * contents by calling the methods of DataInput for primitive * types and readObject for objects, strings and arrays. The * readExternal method must read the values in the same sequence * and with the same types as were written by writeExternal. * * @param in the ObjectInput object to read from * @exception ClassNotFoundException If the class for an object being * restored cannot be found. */ public void readExternal(ObjectInput in) throws IOException, ClassNotFoundException { try { parse(in.readUTF()); } catch (MimeTypeParseException e) { throw new IOException(e.toString()); } } // below here be scary parsing related things /** * Determine whether or not a given character belongs to a legal token. */ private static boolean isTokenChar(char c) { return ((c > 040) && (c < 0177)) && (TSPECIALS.indexOf(c) < 0); } /** * Determine whether or not a given string is a legal token. */ private boolean isValidToken(String s) { int len = s.length(); if (len > 0) { for (int i = 0; i < len; ++i) { char c = s.charAt(i); if (!isTokenChar(c)) { return false; } } return true; } else { return false; } } /** * A simple parser test, * for debugging... * public static void main(String[] args) throws MimeTypeParseException, IOException { for (int i = 0; i < args.length; ++i) { System.out.println("Original: " + args[i]); MimeType type = new MimeType(args[i]); System.out.println("Short: " + type.getBaseType()); System.out.println("Parsed: " + type.toString()); System.out.println(); } } */ }