Client API. The Codename One framework your app is built on: this runs on the device, not in a backend.

public class DefaultGraphModel

  1. Object
  2. AbstractGraphModel
  3. DefaultGraphModel

ImplementsGraphModel

An editable graph kept in memory.

Edits made by a user are checked by the ConnectionValidator before an edge is made. Ids of edges the model makes itself are "e" followed by a counter, skipping any already taken.

Constructors

public DefaultGraphModel()

Methods

public List<GraphNode> getNodes()Every node, in painting order: later nodes are drawn over earlier ones.
public List<GraphEdge> getEdges()Every edge.
public List<GraphGroup> getGroups()Every group.
public GraphNode getNode(String id)The node with this id, or null.
public GraphEdge getEdge(String id)The edge with this id, or null.
public ConnectionValidator getValidator()The validator connect asks.
public void setValidator(ConnectionValidator validator)Replaces the validator; null restores the default one.
public GraphNode addNode(GraphNode node)Adds a node, replacing one with the same id.
public GraphEdge addEdge(GraphEdge edge)Adds an edge as it is, without asking the validator.
public GraphEdge addEdge(String sourceId, String targetId)Adds an edge between two nodes with a generated id.
public GraphGroup addGroup(GraphGroup group)Adds a group.
public void clear()Removes every node, edge and group.
public List<GraphEdge> getEdges(GraphNode node)The edges that touch a node.
public boolean moveNode(GraphNode node, double x, double y)Moves a node to a world position.
public GraphEdge connect(GraphNode source, GraphPort sourcePort, GraphNode target, GraphPort targetPort)Makes an edge from one node or port to another.
public boolean removeEdge(GraphEdge edge)Removes an edge.
public boolean removeNode(GraphNode node)Removes a node and every edge that touches it.
public boolean renameNode(GraphNode node, String label)Gives a node a new label.
public boolean setCollapsed(GraphGroup group, boolean collapsed)Collapses or expands a group.
public boolean insertNode(GraphNode node, int index)Adds a node the user made, from a palette or by pasting.
public boolean insertEdge(GraphEdge edge, int index)Adds an edge as it is, without the checks connect makes: pasting and undo put back edges that were valid when they were made.
public boolean resizeNode(GraphNode node, double width, double height)Gives a node a new size, in world units.
public boolean setNodeGroup(GraphNode node, String groupId)Moves a node into a group or a lane, or out of every one with null.
public boolean resizeGroup(GraphGroup group, double x, double y, double width, double height)Gives a lane new bounds, in world units.
public boolean setPortValue(GraphPort port, Object value)Sets the value an unconnected input port uses.
public boolean removeGroup(GraphGroup group)Removes a group.

Inherited methods

Constructor details

DefaultGraphModel

public DefaultGraphModel()

Method details

getNodes

public List<GraphNode> getNodes()
Every node, in painting order: later nodes are drawn over earlier ones.

getEdges

public List<GraphEdge> getEdges()
Every edge.

getGroups

public List<GraphGroup> getGroups()
Every group.

getNode

public GraphNode getNode(String id)
The node with this id, or null.

getEdge

public GraphEdge getEdge(String id)
The edge with this id, or null.

getValidator

public ConnectionValidator getValidator()
The validator connect asks. Never null.

setValidator

public void setValidator(ConnectionValidator validator)
Replaces the validator; null restores the default one.

addNode

public GraphNode addNode(GraphNode node)
Adds a node, replacing one with the same id.

Returns

the node

addEdge

public GraphEdge addEdge(GraphEdge edge)
Adds an edge as it is, without asking the validator.

Returns

the edge

addEdge

public GraphEdge addEdge(String sourceId, String targetId)
Adds an edge between two nodes with a generated id.

addGroup

public GraphGroup addGroup(GraphGroup group)
Adds a group.

clear

public void clear()
Removes every node, edge and group.

getEdges

public List<GraphEdge> getEdges(GraphNode node)
The edges that touch a node.

moveNode

public boolean moveNode(GraphNode node, double x, double y)
Moves a node to a world position.

Returns

false when the model refuses the move

connect

public GraphEdge connect(GraphNode source, GraphPort sourcePort, GraphNode target, GraphPort targetPort)
Makes an edge from one node or port to another.

Parameters

source GraphNode
the node the edge leaves
sourcePort GraphPort
its output port, or null
target GraphNode
the node the edge enters
targetPort GraphPort
its input port, or null

Returns

the new edge, or null when the model refuses it

removeEdge

public boolean removeEdge(GraphEdge edge)
Removes an edge.

Returns

false when the model refuses

removeNode

public boolean removeNode(GraphNode node)
Removes a node and every edge that touches it.

Returns

false when the model refuses

renameNode

public boolean renameNode(GraphNode node, String label)
Gives a node a new label.

Returns

false when the model refuses

setCollapsed

public boolean setCollapsed(GraphGroup group, boolean collapsed)
Collapses or expands a group.

Returns

false when the model refuses

insertNode

public boolean insertNode(GraphNode node, int index)
Adds a node the user made, from a palette or by pasting.

Parameters

node GraphNode
the node
index int

where in getNodes it goes, which is its painting order; negative, or past the end, for the end. Undoing a removal puts a node back where it was.

A view’s undo of a delete puts nodes back through this method, so a model that refuses it cannot have its deletes undone.

Returns

false when the model refuses, or already has a node with this id

insertEdge

public boolean insertEdge(GraphEdge edge, int index)
Adds an edge as it is, without the checks connect makes: pasting and undo put back edges that were valid when they were made.

Parameters

edge GraphEdge
the edge
index int
where in getEdges it goes; negative, or past the end, for the end

Returns

false when the model refuses, has an edge with this id, or lacks one of the nodes the edge names

resizeNode

public boolean resizeNode(GraphNode node, double width, double height)
Gives a node a new size, in world units.

Returns

false when the model refuses

setNodeGroup

public boolean setNodeGroup(GraphNode node, String groupId)
Moves a node into a group or a lane, or out of every one with null.

Returns

false when the model refuses

resizeGroup

public boolean resizeGroup(GraphGroup group, double x, double y, double width, double height)
Gives a lane new bounds, in world units.

Returns

false when the model refuses

setPortValue

public boolean setPortValue(GraphPort port, Object value)
Sets the value an unconnected input port uses.

Returns

false when the model refuses

removeGroup

public boolean removeGroup(GraphGroup group)
Removes a group. Its members stay, in no group.

Returns

false when the model has no such group