/*
* @(#)ComponentFactory.java 2.4.0 22 September 2005
*
* Copyright 2005
* College of Computer and Information Science
* Northeastern University
* Boston, MA 02115
*
* The Java Power Tools software may be used for educational
* purposes as long as this copyright notice is retained intact
* at the top of all source files.
*
* To discuss possible commercial use of this software,
* contact Richard Rasala at Northeastern University,
* College of Computer and Information Science,
* 617-373-2462 or rasala@ccs.neu.edu.
*
* The Java Power Tools software has been designed and built
* in collaboration with Viera Proulx and Jeff Raab.
*
* Should this software be modified, the words "Modified from
* Original" must be included as a comment below this notice.
*
* All publication rights are retained. This software or its
* documentation may not be published in any media either
* in whole or in part without explicit permission.
*
* This software was created with support from Northeastern
* University and from NSF grant DUE-9950829.
*/
package edu.neu.ccs.gui;
import java.awt.*;
import javax.swing.*;
import java.awt.geom.*;
/**
*
* ComponentFactory has 3 static methods that create
* gui or graphical objects from more general objects.
*
*
*
* makeComponent that constructs a Component
* from an ObjectmakeIcon that constructs an Icon
* from an ObjectmakePaintable that constructs a Paintable
* from an Object
*
*
* The first two methods both make certain specific attempts to convert a
* general Object into the desired type. If these attempts
* fail then the methods use the makePaintable method to try
* to convert the Object into a Paintable. If
* that attempt succeeds then the Paintable is placed
* into a PaintableComponent. On the other hand, if this
* final attempt fails then null is returned.
*
*
* @author Richard Rasala
* @version 2.4.0
* @since 2.0
*/
public class ComponentFactory {
/**
* Returns a Component associated with the given
* object.
*
*
* The table below shows more about how makeComponent works.
*
*
*
*
* | Argument |
* Return |
*
*
* Component |
* The same Component |
*
*
* String |
* Annotation |
*
*
* Icon |
* Annotation |
*
*
* Action |
* JButton |
*
*
* Paint |
* PaintSwatch |
*
*
*
*
* | converts to |
* Paintable |
*
* |
* PaintableComponent |
*
*
* | otherwise |
* null |
*
*
*
* @param o the object to make into a Component
*/
public static Component makeComponent(Object o) {
if (o == null)
return null;
if (o instanceof Component)
return (Component) o;
if (o instanceof String)
return new Annotation((String) o);
if (o instanceof Icon)
return new Annotation((Icon) o);
if (o instanceof Action)
return new JButton((Action) o);
if (o instanceof Paint)
return new PaintSwatch((Paint) o);
Object p = makePaintable(o);
if (p instanceof Paintable)
return new PaintableComponent((Paintable) p);
return null;
}
/**
* Returns an Icon associated with the given
* object.
*
*
* The table below shows more about how makeIcon works.
*
*
*
*
* | Argument |
* Return |
*
*
* Icon |
* The same Icon |
*
*
* Paint |
* PaintSwatch |
*
*
*
*
* | converts to |
* Paintable |
*
* |
* PaintableComponent |
*
*
* | otherwise |
* null |
*
*
*
* @param o the object to make into an Icon
*/
public static Icon makeIcon(Object o) {
if (o == null)
return null;
if (o instanceof Icon)
return ((Icon) o);
if (o instanceof Paint)
return new PaintSwatch((Paint) o);
Object p = makePaintable(o);
if (p instanceof Paintable)
return new PaintableComponent((Paintable) p);
return null;
}
/**
* Returns a Paintable associated with the given
* object.
*
*
* The table below shows more about how makePaintable works.
*
*
*
*
* | Argument |
* Return |
*
*
* Paintable |
* The same Paintable |
*
*
* Shape |
* ShapePaintable |
*
*
* PathList |
* ShapePaintable |
*
*
* Image |
* ImagePaintable |
*
*
* ImageIcon |
* ImagePaintable |
*
*
* String |
* TextPaintable |
*
*
* Point2D |
* PointPaintable |
*
*
* Object[] |
* PaintableSequence |
*
*
* | otherwise |
* null |
*
*
*
* @param o the object to make into a Paintable
*/
public static Paintable makePaintable(Object o) {
if (o == null)
return null;
if (o instanceof Paintable)
return ((Paintable) o);
if (o instanceof Image)
return new ImagePaintable((Image) o);
if (o instanceof ImageIcon)
return new ImagePaintable((ImageIcon) o);
if (o instanceof PathList)
o = ((PathList) o).makeShape();
if (o instanceof Shape)
return new ShapePaintable((Shape) o);
if (o instanceof String)
return new TextPaintable((String) o);
if (o instanceof Point2D) {
PointPaintable pp = new PointPaintable();
pp.setPoint((Point2D) o);
return pp;
}
if (o instanceof Object[])
return new PaintableSequence((Object[]) o);
return null;
}
}