org.jdesktop.application
Class ResourceConverter

java.lang.Object
  extended by org.jdesktop.application.ResourceConverter

public abstract class ResourceConverter
extends java.lang.Object

A base class for converting arbitrary types to and from Strings, as well as a registry of ResourceConverter implementations.

The supportsType method defines what types a ResourceConverter supports. By default it returns true for classes that are equal to the constructor's type argument. The parseType methods converts a string the ResourceConverter's supported type, and the toString does the inverse, it converts a supported type to a String. Concrete ResourceConverter subclasses must override parseType() and, in most cases, the toString method as well.

This class maintains a registry of ResourceConverters. The forType method returns the first ResourceConverter that supports a particular type, new ResourceConverters can be added with register(). A small set of generic ResourceConverters are registered by default. They support the following types:

The Boolean ResourceConverter returns true for "true", "on", "yes", false otherwise. The other primitive type ResourceConverters rely on the corresponding static parseType method, e.g. Integer.parseInt(). The MessageFormat ResourceConverter just creates MessageFormat object with the string as its constructor argument. The URL/URI converters just apply the corresponding constructor to the resource string.

See Also:
ResourceMap

Nested Class Summary
static class ResourceConverter.ResourceConverterException
           
 
Field Summary
protected  java.lang.Class type
           
 
Constructor Summary
protected ResourceConverter(java.lang.Class type)
           
 
Method Summary
static ResourceConverter forType(java.lang.Class type)
           
abstract  java.lang.Object parseString(java.lang.String s, ResourceMap r)
           
static void register(ResourceConverter resourceConverter)
           
 boolean supportsType(java.lang.Class testType)
           
 java.lang.String toString(java.lang.Object obj)
           
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

type

protected final java.lang.Class type
Constructor Detail

ResourceConverter

protected ResourceConverter(java.lang.Class type)
Method Detail

parseString

public abstract java.lang.Object parseString(java.lang.String s,
                                             ResourceMap r)
                                      throws ResourceConverter.ResourceConverterException
Throws:
ResourceConverter.ResourceConverterException

toString

public java.lang.String toString(java.lang.Object obj)

supportsType

public boolean supportsType(java.lang.Class testType)

register

public static void register(ResourceConverter resourceConverter)

forType

public static ResourceConverter forType(java.lang.Class type)