src/share/jaf_classes/javax/activation/FileTypeMap.java

Mon, 08 Aug 2016 13:10:38 -0700

author
asaha
date
Mon, 08 Aug 2016 13:10:38 -0700
changeset 1267
f3d512b73229
parent 494
2fcd3ddb57a6
child 637
9c07ef4934dd
permissions
-rw-r--r--

Merge

ohair@286 1 /*
mkos@494 2 * Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved.
ohair@286 3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
ohair@286 4 *
ohair@286 5 * This code is free software; you can redistribute it and/or modify it
ohair@286 6 * under the terms of the GNU General Public License version 2 only, as
ohair@286 7 * published by the Free Software Foundation. Oracle designates this
ohair@286 8 * particular file as subject to the "Classpath" exception as provided
ohair@286 9 * by Oracle in the LICENSE file that accompanied this code.
ohair@286 10 *
ohair@286 11 * This code is distributed in the hope that it will be useful, but WITHOUT
ohair@286 12 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
ohair@286 13 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
ohair@286 14 * version 2 for more details (a copy is included in the LICENSE file that
ohair@286 15 * accompanied this code).
ohair@286 16 *
ohair@286 17 * You should have received a copy of the GNU General Public License version
ohair@286 18 * 2 along with this work; if not, write to the Free Software Foundation,
ohair@286 19 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
ohair@286 20 *
ohair@286 21 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
ohair@286 22 * or visit www.oracle.com if you need additional information or have any
ohair@286 23 * questions.
ohair@286 24 */
ohair@286 25
ohair@286 26 package javax.activation;
ohair@286 27
ohair@286 28 import java.io.File;
mkos@494 29 import java.util.Map;
mkos@494 30 import java.util.WeakHashMap;
ohair@286 31
ohair@286 32 /**
ohair@286 33 * The FileTypeMap is an abstract class that provides a data typing
ohair@286 34 * interface for files. Implementations of this class will
ohair@286 35 * implement the getContentType methods which will derive a content
ohair@286 36 * type from a file name or a File object. FileTypeMaps could use any
ohair@286 37 * scheme to determine the data type, from examining the file extension
ohair@286 38 * of a file (like the MimetypesFileTypeMap) to opening the file and
ohair@286 39 * trying to derive its type from the contents of the file. The
ohair@286 40 * FileDataSource class uses the default FileTypeMap (a MimetypesFileTypeMap
ohair@286 41 * unless changed) to determine the content type of files.
ohair@286 42 *
ohair@286 43 * @see javax.activation.FileTypeMap
ohair@286 44 * @see javax.activation.FileDataSource
ohair@286 45 * @see javax.activation.MimetypesFileTypeMap
ohair@286 46 *
ohair@286 47 * @since 1.6
ohair@286 48 */
ohair@286 49
ohair@286 50 public abstract class FileTypeMap {
ohair@286 51
ohair@286 52 private static FileTypeMap defaultMap = null;
mkos@494 53 private static Map<ClassLoader,FileTypeMap> map =
mkos@494 54 new WeakHashMap<ClassLoader,FileTypeMap>();
ohair@286 55
ohair@286 56 /**
ohair@286 57 * The default constructor.
ohair@286 58 */
ohair@286 59 public FileTypeMap() {
ohair@286 60 super();
ohair@286 61 }
ohair@286 62
ohair@286 63 /**
ohair@286 64 * Return the type of the file object. This method should
ohair@286 65 * always return a valid MIME type.
ohair@286 66 *
ohair@286 67 * @param file A file to be typed.
ohair@286 68 * @return The content type.
ohair@286 69 */
ohair@286 70 abstract public String getContentType(File file);
ohair@286 71
ohair@286 72 /**
ohair@286 73 * Return the type of the file passed in. This method should
ohair@286 74 * always return a valid MIME type.
ohair@286 75 *
ohair@286 76 * @param filename the pathname of the file.
ohair@286 77 * @return The content type.
ohair@286 78 */
ohair@286 79 abstract public String getContentType(String filename);
ohair@286 80
ohair@286 81 /**
ohair@286 82 * Sets the default FileTypeMap for the system. This instance
ohair@286 83 * will be returned to callers of getDefaultFileTypeMap.
ohair@286 84 *
mkos@494 85 * @param fileTypeMap The FileTypeMap.
ohair@286 86 * @exception SecurityException if the caller doesn't have permission
ohair@286 87 * to change the default
ohair@286 88 */
mkos@494 89 public static synchronized void setDefaultFileTypeMap(FileTypeMap fileTypeMap) {
ohair@286 90 SecurityManager security = System.getSecurityManager();
ohair@286 91 if (security != null) {
ohair@286 92 try {
ohair@286 93 // if it's ok with the SecurityManager, it's ok with me...
ohair@286 94 security.checkSetFactory();
ohair@286 95 } catch (SecurityException ex) {
ohair@286 96 // otherwise, we also allow it if this code and the
mkos@494 97 // factory come from the same (non-system) class loader (e.g.,
ohair@286 98 // the JAF classes were loaded with the applet classes).
mkos@494 99 if (FileTypeMap.class.getClassLoader() == null ||
mkos@494 100 FileTypeMap.class.getClassLoader() !=
mkos@494 101 fileTypeMap.getClass().getClassLoader())
ohair@286 102 throw ex;
ohair@286 103 }
ohair@286 104 }
mkos@494 105 // remove any per-thread-context-class-loader FileTypeMap
mkos@494 106 map.remove(SecuritySupport.getContextClassLoader());
mkos@494 107 defaultMap = fileTypeMap;
ohair@286 108 }
ohair@286 109
ohair@286 110 /**
ohair@286 111 * Return the default FileTypeMap for the system.
ohair@286 112 * If setDefaultFileTypeMap was called, return
ohair@286 113 * that instance, otherwise return an instance of
ohair@286 114 * <code>MimetypesFileTypeMap</code>.
ohair@286 115 *
ohair@286 116 * @return The default FileTypeMap
ohair@286 117 * @see javax.activation.FileTypeMap#setDefaultFileTypeMap
ohair@286 118 */
mkos@494 119 public static synchronized FileTypeMap getDefaultFileTypeMap() {
mkos@494 120 if (defaultMap != null)
mkos@494 121 return defaultMap;
mkos@494 122
mkos@494 123 // fetch per-thread-context-class-loader default
mkos@494 124 ClassLoader tccl = SecuritySupport.getContextClassLoader();
mkos@494 125 FileTypeMap def = map.get(tccl);
mkos@494 126 if (def == null) {
mkos@494 127 def = new MimetypesFileTypeMap();
mkos@494 128 map.put(tccl, def);
mkos@494 129 }
mkos@494 130 return def;
ohair@286 131 }
ohair@286 132 }

mercurial