org.jgraph.graph

Class AttributeMap

public class AttributeMap extends Hashtable implements Cloneable

A map specifically for the storage of attributes of graph cells. The main advantage of the AttributeMap is that it allows to override cell view behaviour for scaling, translation, diffing, and cloning on a per instance basis without having to change the GraphConstants class
Nested Class Summary
static classAttributeMap.SerializablePoint2D
static classAttributeMap.SerializableRectangle2D
Field Summary
static AttributeMapemptyAttributeMap
Shared empty attribute map to return instead of null in applyMap.
Constructor Summary
AttributeMap()
Creates a new attribute map with an initial capacity of 8.
AttributeMap(int initialCapacity)
Creates a new attribute map with the specified initial capacity
AttributeMap(int initialCapacity, float loadCapacity)
Constructs a new, empty hashtable with the specified initial capacity and the specified load factor.
AttributeMap(Map map)
Constructs a new AttributeMap with the same mappings as the given Map.
Method Summary
AttributeMapapplyMap(Map change)
Apply the change to this views attributes.
ObjectapplyValue(Object key, Object value)
Apply the key to value
Objectclone()
Returns a clone of map, from keys to values.
AttributeMapcloneEntries(AttributeMap newMap)
Clones special object entried in the given map.
Point2D[]clonePoints(Point2D[] points)
Returns a list where all instances of PortView are replaced by their correspnding Point instance.
ListclonePoints(List points)
Returns a list where all instances of PortView are replaced by their correspnding Point instance.
ListclonePoints(Object[] points, boolean convertPortViews)
Returns a list where all instances of PortView are replaced by their correspnding Point instance.
Point2DcreatePoint()
Creates a point of suitable type for this attribute map
Point2DcreatePoint(Point2D p)
Creates a point of suitable type for this attribute map with the same values as the point passed in
Point2DcreatePoint(double x, double y)
Creates a point of suitable type for this attribute map with the same values as those passed in
Rectangle2DcreateRect()
Creates a rectangle of suitable type for this attribute map
Rectangle2DcreateRect(double x, double y, double w, double h)
Creates a rectangle of suitable type for this attribute map with the same values as those passed in
Rectangle2DcreateRect(Point2D pt)
Creates a rectangle of suitable type for this attribute map at the position of the point passed in
Rectangle2DcreateRect(Point2D pt, double size)
Creates a rectangle of suitable type for this attribute map at the position of the point passed in with lengths size
Rectangle2DcreateRect(Rectangle2D rect)
Clones the rectangle passed in
Rectangle2DcreateRect(double x, double y, double w, double h, double grow1, double grow2)
Creates a rectangle of suitable type for this attribute map
Rectangle2DcreateRect(Rectangle2D rect, double grow1, double grow2)
Creates a clone of the rectangle passed in and manipulates it by grow1 and grow2
Mapdiff(Map newState)
Returns a new map that contains all (key, value)-pairs of newState where either key is not used or value is different for key in oldState.
voidscale(double sx, double sy, Point2D origin)
Scales map by the given amount.
static voidtranslate(Collection c, double dx, double dy)
Translates the maps in c using translate(Map, int, int).
voidtranslate(double dx, double dy)
Translates map by the given amount.

Field Detail

emptyAttributeMap

public static transient AttributeMap emptyAttributeMap
Shared empty attribute map to return instead of null in applyMap.

Constructor Detail

AttributeMap

public AttributeMap()
Creates a new attribute map with an initial capacity of 8.

AttributeMap

public AttributeMap(int initialCapacity)
Creates a new attribute map with the specified initial capacity

Parameters: initialCapacity the initial capacity of the new map

AttributeMap

public AttributeMap(int initialCapacity, float loadCapacity)
Constructs a new, empty hashtable with the specified initial capacity and the specified load factor.

Parameters: initialCapacity the initial capacity of the hashtable. loadCapacity the load factor of the hashtable.

AttributeMap

public AttributeMap(Map map)
Constructs a new AttributeMap with the same mappings as the given Map.

Parameters: map the input map to copy

Method Detail

applyMap

public AttributeMap applyMap(Map change)
Apply the change to this views attributes. change must be a Map previously obtained from this object.

Parameters: change the change to apply

Returns: a map that may be used to undo the change to target.

applyValue

public Object applyValue(Object key, Object value)
Apply the key to value

Parameters: key the map key whose value is to be altered value the new value to be applied to the specified key

Returns: the old value.

clone

public Object clone()
Returns a clone of map, from keys to values. If the map contains bounds or points, these are cloned as well. References to PortViews are replaces by points.
Note: Extend this method to clone custom user objects.

cloneEntries

public AttributeMap cloneEntries(AttributeMap newMap)
Clones special object entried in the given map.

clonePoints

public Point2D[] clonePoints(Point2D[] points)
Returns a list where all instances of PortView are replaced by their correspnding Point instance.

Parameters: points the points to be cloned

Returns: the cloned points

clonePoints

public List clonePoints(List points)
Returns a list where all instances of PortView are replaced by their correspnding Point instance.

Parameters: points the points to be cloned

Returns: the cloned points

clonePoints

public List clonePoints(Object[] points, boolean convertPortViews)
Returns a list where all instances of PortView are replaced by their correspnding Point instance.

createPoint

public Point2D createPoint()
Creates a point of suitable type for this attribute map

Returns: a new point

createPoint

public Point2D createPoint(Point2D p)
Creates a point of suitable type for this attribute map with the same values as the point passed in

Parameters: p the point whose values the new point are to be based on

Returns: a new copy of the point passed in

createPoint

public Point2D createPoint(double x, double y)
Creates a point of suitable type for this attribute map with the same values as those passed in

Parameters: x the x-coordinate position of the new point y the y-coordinate position of the new point

Returns: a new point at the coordinates passed in

createRect

public Rectangle2D createRect()
Creates a rectangle of suitable type for this attribute map

Returns: a new rectangle

createRect

public Rectangle2D createRect(double x, double y, double w, double h)
Creates a rectangle of suitable type for this attribute map with the same values as those passed in

Parameters: x the x-coordinate position of the new rectangle y the y-coordinate position of the new rectangle w the width of the new rectangle h the height of the new rectangle

Returns: a new rectangle at the coordinates and of the dimensions passed in

createRect

public Rectangle2D createRect(Point2D pt)
Creates a rectangle of suitable type for this attribute map at the position of the point passed in

Parameters: pt the position of the new rectangle

Returns: a new rectangle the specified coordinates of zero size

createRect

public Rectangle2D createRect(Point2D pt, double size)
Creates a rectangle of suitable type for this attribute map at the position of the point passed in with lengths size

Parameters: pt the position of the new rectangle size the length of both sides of the rectangle

Returns: a new rectangle the specified position and dimensions

createRect

public Rectangle2D createRect(Rectangle2D rect)
Clones the rectangle passed in

Parameters: rect the rectangle to clone

Returns: a copy of the rectangle passed in

createRect

public Rectangle2D createRect(double x, double y, double w, double h, double grow1, double grow2)
Creates a rectangle of suitable type for this attribute map

Parameters: x the x-coordinate position of the new rectangle y the y-coordinate position of the new rectangle w the width of the new rectangle h the height of the new rectangle grow1 the amount both dimensions are to be increased by and the position coorindates of the rectangle are to be decreased by grow2 the additional amount by which both dimensions are to be increased by

Returns: a new rectangle at the coordinates and of the dimensions passed in

createRect

public Rectangle2D createRect(Rectangle2D rect, double grow1, double grow2)
Creates a clone of the rectangle passed in and manipulates it by grow1 and grow2

Parameters: grow1 the amount both dimensions are to be increased by and the position coorindates of the rectangle are to be decreased by grow2 the additional amount by which both dimensions are to be increased by

Returns: a new rectangle at the coordinates and of the dimensions passed in

diff

public Map diff(Map newState)
Returns a new map that contains all (key, value)-pairs of newState where either key is not used or value is different for key in oldState. In other words, this method removes the common entries from oldState and newState, and returns the "difference" between the two. This method never returns null.

scale

public void scale(double sx, double sy, Point2D origin)
Scales map by the given amount.

translate

public static void translate(Collection c, double dx, double dy)
Translates the maps in c using translate(Map, int, int).

translate

public void translate(double dx, double dy)
Translates map by the given amount.
Copyright (C) 2001-2009 JGraph Ltd. All rights reserved.