Imported GNU Classpath 0.20

Imported GNU Classpath 0.20
       * Makefile.am (AM_CPPFLAGS): Add classpath/include.
       * java/nio/charset/spi/CharsetProvider.java: New override file.
       * java/security/Security.java: Likewise.
       * sources.am: Regenerated.
       * Makefile.in: Likewise.

From-SVN: r109831
This commit is contained in:
Mark Wielaard 2006-01-17 18:09:40 +00:00
parent bcb36c3e02
commit 2127637945
444 changed files with 75778 additions and 30731 deletions

View file

@ -38,9 +38,11 @@ exception statement from your version. */
package java.awt.datatransfer;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import java.util.WeakHashMap;
/**
* This class maps between native platform type names and DataFlavors.
@ -54,10 +56,28 @@ import java.util.Map;
public final class SystemFlavorMap implements FlavorMap, FlavorTable
{
/**
* The default (instance) flavor map.
* The map which maps the thread's <code>ClassLoaders</code> to
* <code>SystemFlavorMaps</code>.
*/
private static FlavorMap defaultFlavorMap;
private static final Map systemFlavorMaps = new WeakHashMap();
/**
* Constant which is used to prefix encode Java MIME types.
*/
private static final String GNU_JAVA_MIME_PREFIX = "gnu.java:";
/**
* This map maps native <code>String</code>s to lists of
* <code>DataFlavor</code>s
*/
private HashMap nativeToFlavorMap = new HashMap();
/**
* This map maps <code>DataFlavor</code>s to lists of native
* <code>String</code>s
*/
private HashMap flavorToNativeMap = new HashMap();
/**
* Private constructor.
*/
@ -98,47 +118,118 @@ public final class SystemFlavorMap implements FlavorMap, FlavorTable
}
/**
* Returns the default (instance) (System)FlavorMap.
* Returns the (System)FlavorMap for the current thread's
* ClassLoader.
*/
public static FlavorMap getDefaultFlavorMap ()
{
if (defaultFlavorMap == null)
defaultFlavorMap = new SystemFlavorMap ();
return defaultFlavorMap;
ClassLoader classLoader = Thread.currentThread()
.getContextClassLoader();
//if ContextClassLoader not set, use system default
if (classLoader == null)
{
classLoader = ClassLoader.getSystemClassLoader();
}
synchronized(systemFlavorMaps)
{
FlavorMap map = (FlavorMap)
systemFlavorMaps.get(classLoader);
if (map == null)
{
map = new SystemFlavorMap();
systemFlavorMaps.put(classLoader, map);
}
return map;
}
}
/**
* Returns the native type name for the given java mime type.
* Encodes a MIME type for use as a <code>String</code> native. The format
* of an encoded representation of a MIME type is implementation-dependent.
* The only restrictions are:
* <ul>
* <li>The encoded representation is <code>null</code> if and only if the
* MIME type <code>String</code> is <code>null</code>.</li>
* <li>The encoded representations for two non-<code>null</code> MIME type
* <code>String</code>s are equal if and only if these <code>String</code>s
* are equal according to <code>String.equals(Object)</code>.</li>
* </ul>
* <p>
* The present implementation of this method returns the specified MIME
* type <code>String</code> prefixed with <code>gnu.java:</code>.
*
* @param mime the MIME type to encode
* @return the encoded <code>String</code>, or <code>null</code> if
* mimeType is <code>null</code>
*/
public static String encodeJavaMIMEType (String mime)
{
return null;
if (mime != null)
return GNU_JAVA_MIME_PREFIX + mime;
else
return null;
}
/**
* Returns the native type name for the given data flavor.
* Encodes a <code>DataFlavor</code> for use as a <code>String</code>
* native. The format of an encoded <code>DataFlavor</code> is
* implementation-dependent. The only restrictions are:
* <ul>
* <li>The encoded representation is <code>null</code> if and only if the
* specified <code>DataFlavor</code> is <code>null</code> or its MIME type
* <code>String</code> is <code>null</code>.</li>
* <li>The encoded representations for two non-<code>null</code>
* <code>DataFlavor</code>s with non-<code>null</code> MIME type
* <code>String</code>s are equal if and only if the MIME type
* <code>String</code>s of these <code>DataFlavor</code>s are equal
* according to <code>String.equals(Object)</code>.</li>
* </ul>
* <p>
* The present implementation of this method returns the MIME type
* <code>String</code> of the specified <code>DataFlavor</code> prefixed
* with <code>gnu.java:</code>.
*
* @param df the <code>DataFlavor</code> to encode
* @return the encoded <code>String</code>, or <code>null</code> if
* flav is <code>null</code> or has a <code>null</code> MIME type
*/
public static String encodeDataFlavor (DataFlavor df)
{
return null;
if (df != null)
{
return encodeJavaMIMEType(df.getMimeType());
}
else
return null;
}
/**
* Returns true if the native type name can be represented as
* a java mime type.
* a java mime type. Returns <code>false</code> if parameter is
* <code>null</code>.
*/
public static boolean isJavaMIMEType (String name)
{
return false;
return (name != null && name.startsWith(GNU_JAVA_MIME_PREFIX));
}
/**
* Returns the java mime type for the given the native type name.
* Decodes a <code>String</code> native for use as a Java MIME type.
*
* @param name the <code>String</code> to decode
* @return the decoded Java MIME type, or <code>null</code> if nat
* is not an encoded <code>String</code> native
*/
public static String decodeJavaMIMEType (String name)
{
return null;
if (isJavaMIMEType(name))
{
return name.substring(GNU_JAVA_MIME_PREFIX.length());
}
else
return null;
}
/**
@ -156,6 +247,20 @@ public final class SystemFlavorMap implements FlavorMap, FlavorTable
return null;
}
/**
* Returns a List of <code>DataFlavors</code> to which the specified
* <code>String</code> native can be translated by the data transfer
* subsystem. The <code>List</code> will be sorted from best
* <code>DataFlavor</code> to worst. That is, the first <code>DataFlavor
* </code> will best reflect data in the specified native to a Java
* application.
* <p>
* If the specified native is previously unknown to the data transfer
* subsystem, and that native has been properly encoded, then invoking
* this method will establish a mapping in both directions between the
* specified native and a DataFlavor whose MIME type is a decoded
* version of the native.
*/
public List getFlavorsForNative (String nat)
{
throw new Error ("Not implemented");
@ -165,5 +270,160 @@ public final class SystemFlavorMap implements FlavorMap, FlavorTable
{
throw new Error ("Not implemented");
}
/**
* Adds a mapping from a single <code>String</code> native to a single
* <code>DataFlavor</code>. Unlike <code>getFlavorsForNative</code>, the
* mapping will only be established in one direction, and the native will
* not be encoded. To establish a two-way mapping, call
* <code>addUnencodedNativeForFlavor</code> as well. The new mapping will
* be of lower priority than any existing mapping.
* This method has no effect if a mapping from the specified
* <code>String</code> native to the specified or equal
* <code>DataFlavor</code> already exists.
*
* @param nativeStr the <code>String</code> native key for the mapping
* @param flavor the <code>DataFlavor</code> value for the mapping
* @throws NullPointerException if nat or flav is <code>null</code>
*
* @see #addUnencodedNativeForFlavor
* @since 1.4
*/
public synchronized void addFlavorForUnencodedNative(String nativeStr,
DataFlavor flavor)
{
if ((nativeStr == null) || (flavor == null))
throw new NullPointerException();
List flavors = (List) nativeToFlavorMap.get(nativeStr);
if (flavors == null)
{
flavors = new ArrayList();
nativeToFlavorMap.put(nativeStr, flavors);
}
else
{
if (! flavors.contains(flavor))
flavors.add(flavor);
}
}
/**
* Adds a mapping from the specified <code>DataFlavor</code> (and all
* <code>DataFlavor</code>s equal to the specified <code>DataFlavor</code>)
* to the specified <code>String</code> native.
* Unlike <code>getNativesForFlavor</code>, the mapping will only be
* established in one direction, and the native will not be encoded. To
* establish a two-way mapping, call
* <code>addFlavorForUnencodedNative</code> as well. The new mapping will
* be of lower priority than any existing mapping.
* This method has no effect if a mapping from the specified or equal
* <code>DataFlavor</code> to the specified <code>String</code> native
* already exists.
*
* @param flavor the <code>DataFlavor</code> key for the mapping
* @param nativeStr the <code>String</code> native value for the mapping
* @throws NullPointerException if flav or nat is <code>null</code>
*
* @see #addFlavorForUnencodedNative
* @since 1.4
*/
public synchronized void addUnencodedNativeForFlavor(DataFlavor flavor,
String nativeStr)
{
if ((nativeStr == null) || (flavor == null))
throw new NullPointerException();
List natives = (List) flavorToNativeMap.get(flavor);
if (natives == null)
{
natives = new ArrayList();
flavorToNativeMap.put(flavor, natives);
}
else
{
if (! natives.contains(nativeStr))
natives.add(nativeStr);
}
}
/**
* Discards the current mappings for the specified <code>DataFlavor</code>
* and all <code>DataFlavor</code>s equal to the specified
* <code>DataFlavor</code>, and creates new mappings to the
* specified <code>String</code> natives.
* Unlike <code>getNativesForFlavor</code>, the mappings will only be
* established in one direction, and the natives will not be encoded. To
* establish two-way mappings, call <code>setFlavorsForNative</code>
* as well. The first native in the array will represent the highest
* priority mapping. Subsequent natives will represent mappings of
* decreasing priority.
* <p>
* If the array contains several elements that reference equal
* <code>String</code> natives, this method will establish new mappings
* for the first of those elements and ignore the rest of them.
* <p>
* It is recommended that client code not reset mappings established by the
* data transfer subsystem. This method should only be used for
* application-level mappings.
*
* @param flavor the <code>DataFlavor</code> key for the mappings
* @param natives the <code>String</code> native values for the mappings
* @throws NullPointerException if flav or natives is <code>null</code>
* or if natives contains <code>null</code> elements
*
* @see #setFlavorsForNative
* @since 1.4
*/
public synchronized void setNativesForFlavor(DataFlavor flavor,
String[] natives)
{
if ((natives == null) || (flavor == null))
throw new NullPointerException();
flavorToNativeMap.remove(flavor);
for (int i = 0; i < natives.length; i++)
{
addUnencodedNativeForFlavor(flavor, natives[i]);
}
}
/**
* Discards the current mappings for the specified <code>String</code>
* native, and creates new mappings to the specified
* <code>DataFlavor</code>s. Unlike <code>getFlavorsForNative</code>, the
* mappings will only be established in one direction, and the natives need
* not be encoded. To establish two-way mappings, call
* <code>setNativesForFlavor</code> as well. The first
* <code>DataFlavor</code> in the array will represent the highest priority
* mapping. Subsequent <code>DataFlavor</code>s will represent mappings of
* decreasing priority.
* <p>
* If the array contains several elements that reference equal
* <code>DataFlavor</code>s, this method will establish new mappings
* for the first of those elements and ignore the rest of them.
* <p>
* It is recommended that client code not reset mappings established by the
* data transfer subsystem. This method should only be used for
* application-level mappings.
*
* @param nativeStr the <code>String</code> native key for the mappings
* @param flavors the <code>DataFlavor</code> values for the mappings
* @throws NullPointerException if nat or flavors is <code>null</code>
* or if flavors contains <code>null</code> elements
*
* @see #setNativesForFlavor
* @since 1.4
*/
public synchronized void setFlavorsForNative(String nativeStr,
DataFlavor[] flavors)
{
if ((nativeStr == null) || (flavors == null))
throw new NullPointerException();
nativeToFlavorMap.remove(nativeStr);
for (int i = 0; i < flavors.length; i++)
{
addFlavorForUnencodedNative(nativeStr, flavors[i]);
}
}
} // class SystemFlavorMap