libjava/java/awt/datatransfer/SystemFlavorMap.java

   1 /* SystemFlavorMap.java -- Maps between native flavor names and MIME types.
   2    Copyright (C) 2001 Free Software Foundation, Inc.
   3
   4 This file is part of GNU Classpath.
   5
   6 GNU Classpath is free software; you can redistribute it and/or modify
   7 it under the terms of the GNU General Public License as published by
   8 the Free Software Foundation; either version 2, or (at your option)
   9 any later version.
  10
  11 GNU Classpath is distributed in the hope that it will be useful, but
  12 WITHOUT ANY WARRANTY; without even the implied warranty of
  13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  14 General Public License for more details.
  15
  16 You should have received a copy of the GNU General Public License
  17 along with GNU Classpath; see the file COPYING.  If not, write to the
  18 Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
  19 02111-1307 USA.
  20
  21 Linking this library statically or dynamically with other modules is
  22 making a combined work based on this library.  Thus, the terms and
  23 conditions of the GNU General Public License cover the whole
  24 combination.
  25
  26 As a special exception, the copyright holders of this library give you
  27 permission to link this library with independent modules to produce an
  28 executable, regardless of the license terms of these independent
  29 modules, and to copy and distribute the resulting executable under
  30 terms of your choice, provided that you also meet, for each linked
  31 independent module, the terms and conditions of the license of that
  32 module.  An independent module is a module which is not derived from
  33 or based on this library.  If you modify this library, you may extend
  34 this exception to your version of the library, but you are not
  35 obligated to do so.  If you do not wish to do so, delete this
  36 exception statement from your version. */
  37
  38
  39 package java.awt.datatransfer;
  40
  41 import java.util.HashMap;
  42 import java.util.Map;
  43
  44 /**
  45   * This class maps between native platform type names and DataFlavors.
  46   *
  47   * XXX - The current implementation does no mapping at all.
  48   *
  49   * @author Mark Wielaard (mark@klomp.org)
  50   */
  51 public final class SystemFlavorMap implements FlavorMap
  52 {
  53
  54 /**
  55   * The default (instance) flavor map.
  56   */
  57 private static FlavorMap defaultFlavorMap;
  58
  59 /**
  60   * Private constructor.
  61   */
  62 private SystemFlavorMap()
  63 {
  64 }
  65
  66 /*************************************************************************/
  67
  68 /**
  69   * Maps the specified <code>DataFlavor</code> objects to the native
  70   * data type name.  The returned <code>Map</code> has keys that are
  71   * the data flavors and values that are strings.  The returned map
  72   * may be modified.  This can be useful for implementing nested mappings.
  73   *
  74   * @param flavors An array of data flavors to map
  75   *                or null for all data flavors.
  76   *
  77   * @return A <code>Map</code> of native data types to data flavors.
  78   */
  79 public Map
  80 getNativesForFlavors(DataFlavor[] flavors)
  81 {
  82   return(new HashMap());
  83 }
  84
  85 /*************************************************************************/
  86
  87 /**
  88   * Maps the specified native type names to <code>DataFlavor</code>'s.
  89   * The returned <code>Map</code> has keys that are strings and values
  90   * that are <code>DataFlavor</code>'s.  The returned map may be
  91   * modified.  This can be useful for implementing nested mappings.
  92   *
  93   * @param natives An array of native types to map
  94   *                or null for all native types.
  95   *
  96   * @return A <code>Map</code> of data flavors to native type names.
  97   */
  98 public Map
  99 getFlavorsForNatives(String[] natives)
 100 {
 101   return(new HashMap());
 102 }
 103
 104 /*************************************************************************/
 105
 106 /**
 107   * Returns the default (instance) (System)FlavorMap.
 108   */
 109 public static FlavorMap
 110 getDefaultFlavorMap()
 111 {
 112   if (defaultFlavorMap == null)
 113     defaultFlavorMap = new SystemFlavorMap();
 114
 115   return(defaultFlavorMap);
 116 }
 117
 118 /*************************************************************************/
 119
 120 /**
 121   * Returns the native type name for the given java mime type.
 122   */
 123 public static String
 124 encodeJavaMIMEType(String mime)
 125 {
 126   return null;
 127 }
 128
 129 /*************************************************************************/
 130
 131 /**
 132   * Returns the native type name for the given data flavor.
 133   */
 134 public static String
 135 encodeDataFlavor(DataFlavor df)
 136 {
 137   return null;
 138 }
 139
 140 /*************************************************************************/
 141
 142 /**
 143   * Returns true if the native type name can be represented as
 144   * a java mime type.
 145   */
 146 public static boolean
 147 isJavaMIMEType(String name)
 148 {
 149   return(false);
 150 }
 151
 152 /*************************************************************************/
 153
 154 /**
 155   * Returns the java mime type for the given the native type name.
 156   */
 157 public static String
 158 decodeJavaMIMEType(String name)
 159 {
 160   return null;
 161 }
 162
 163 /*************************************************************************/
 164
 165 /**
 166   * Returns the data flavor given the native type name
 167   * or null when no such data flavor exists.
 168   */
 169 public static DataFlavor
 170 decodeDataFlavor(String name) throws ClassNotFoundException
 171 {
 172   String javaMIMEType = decodeJavaMIMEType(name);
 173   if (javaMIMEType != null)
 174     return(new DataFlavor(javaMIMEType));
 175   else
 176     return(null);
 177 }
 178
 179 } // class SystemFlavorMap
 180