/********************************************************************** * Copyright (C) 2003 swixml.org. * All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions * are met: * * 1. Redistributions of source code must retain the above copyright * notice, this list of conditions, and the following disclaimer. * * 2. Redistributions in binary form must reproduce the above copyright * notice, this list of conditions, and the disclaimer that follows * these conditions in the documentation and/or other materials * provided with the distribution. * * 3. The name "Swixml" must not be used to endorse or promote products * derived from this software without prior written permission. For * written permission, please contact Wolf Paulus * * 4. Products derived from this software may not be called "Swixml", nor * may "Swixml" appear in their name, without prior written permission * from the Swixml Project Management. * * In addition, we request (but do not require) that you include in the * end-user documentation provided with the redistribution and/or in the * software itself an acknowledgement equivalent to the following: * "This product includes software developed by the * Swixml Project (http://www.swixml.org/)." * Alternatively, the acknowledgment may be graphical using the logos * available at http://www.swixml.org/ * * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE * DISCLAIMED. IN NO EVENT SHALL THE SWIX AUTHORS OR THE PROJECT * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF * SUCH DAMAGE. * * ==================================================================== * This software consists of voluntary contributions made by many * individuals on behalf of the Swixml Project and was originally * created by Wolf Paulus . For more information on the * Swixml Project, please see . */ package org.swixml; import org.swixml.converters.*; import javax.swing.*; import javax.swing.border.Border; import java.awt.*; import java.awt.event.ActionListener; import java.util.*; /** *

The ConverterLibrary contains all available Coverters, converting Strings.

*

General purpose data type converters are able to convert Strings into objects that are * usually as parameters when setters are called on javax.swing objects. * 

 * Available Converter include converters able to produce
 * 
    
 * 
  • Primitives
    • 
 * 
  • Dimension
    • 
 * 
  • Color
    • 
 * 
  • Border
    • 
 * 
  • etc.
    • 
 * 

 *
* 
 * Example String inputs could look like this:
 * 
    
 * 
  • MatteBorder(4,4,4,4,red)
    • 
 * 
  • FFCCEE
    • 
 * 
  • BorderLayout.CENTER
    • 
 * 
  • 2,2,2,2
    • 
 * 

 *
* Date: Dec 16, 2002 * * @author Wolf Paulus * @version $Revision: 1.0 $ * * @see org.swixml.Converter */ public class ConverterLibrary { private static ConverterLibrary instance = new ConverterLibrary(); private Map converters = new HashMap(); /** * The only available Ctor is private to make this a Singleton */ private ConverterLibrary() { registerConverters(); } /** * @return ConverterLibrary the single INstacne of the ConverterLibarary. */ public static synchronized ConverterLibrary getInstance() { return instance; } /** * @return Map - all registered converters. * 
Use a class to get to the converters
*/ public Map getConverters() { return converters; } /** * Registers Converters with the ConverterLibrary. */ private void registerConverters() { register( Action.class, new ActionConverter() ); register( Border.class, new BorderConverter() ); register( Color.class, new ColorConverter() ); register( Dimension.class, new DimensionConverter() ); register( Font.class, new FontConverter() ); register( Image.class, new ImageConverter() ); register( Icon.class, new ImageIconConverter() ); register( ImageIcon.class, new ImageIconConverter() ); register( Insets.class, new InsetsConverter() ); register( KeyStroke.class, new KeyStrokeConverter() ); register( LayoutManager.class, new LayoutConverter() ); register( Locale.class, new LocaleConverter() ); register( String.class, new StringConverter() ); // // Register the PrimitiveConverter class for java primitive types // register( boolean.class, new PrimitiveConverter() ); register( int.class, new PrimitiveConverter() ); register( long.class, new PrimitiveConverter() ); register( float.class, new PrimitiveConverter() ); register( double.class, new PrimitiveConverter() ); } /** * Registers a Converter with the ConverterLibrary * @param template Class type of the objects the Converter creates * @param converter Converter Instance of Converter able to vconvert Strings into objects of the given type */ public void register( Class template, Converter converter ) { converters.put( template, converter ); } /** * Indicates if a the ConverterLibary has a Converter producing instances of the given Class. * @param template Class * @return boolean true, if the ConverterLibrary has a Converter to produce an instances of the gioven class. */ public boolean hasConverter( Class template ) { boolean found = converters.keySet().contains( template ); Iterator it = converters.keySet().iterator(); while (!found && it!=null && it.hasNext()) { found= template.isAssignableFrom( ((Converter)converters.get(it.next())).convertsTo()); } return found; } /** * Returns a Converter instance, able to produce obejcts of the given class * @param template Class Class of the object the Converter needs to produce. * @return Converter - instance of the given Converter class. */ public Converter getConverter( Class template ) { return (Converter) converters.get( template ); } }