org.jboss.windup.config

Class Variables

java.lang.Object

org.jboss.windup.config.Variables

@Vetoed
public class Variables
extends Object

A variables stack - keeps few layers of "key"->[vertices] maps, one per rule execution level, Iteration and RuleSubset.

Author:

Lincoln Baxter, III

Field Summary

Fields

Modifier and Type	Field and Description
static int	SEARCH_ALL_LAYERS

Method Summary

Modifier and Type	Method and Description
<FRAMETYPE extends WindupVertexFrame> FRAMETYPE	findSingletonVariable(Class<FRAMETYPE> type, String name) Type-safe wrapper around findVariable(String) returns a unique WindupVertexFrame.
<T extends WindupVertexFrame> T	findSingletonVariable(String name) Wrapper around findVariable(String) which gives only one framed vertex, and checks if there is 0 or 1; throws otherwise.
Iterable<? extends WindupVertexFrame>	findVariable(String name) Searches the variables layers, top to bottom, for given name, and returns if found; null otherwise.
Iterable<? extends WindupVertexFrame>	findVariable(String name, int maxDepth) Searches the variables layers, top to bottom, for given name, and returns if found; null otherwise.
<T extends WindupVertexFrame> Iterable<T>	findVariableOfType(Class<T> type) Searches the variables layers, top to bottom, for the iterable having all of it's items of the given type.
static Variables	instance(GraphRewrite event) Get an instance of the Variables stack from the given GraphRewrite event context.
Map<String,Iterable<? extends WindupVertexFrame>>	peek() Get the top Variables layer from the stack.
Map<String,Iterable<? extends WindupVertexFrame>>	pop() Remove the top Variables layer from the the stack.
void	push() Add new Variables layer on top of the stack.
void	push(Map<String,Iterable<? extends WindupVertexFrame>> frame) Push the given Variables layer on top of the stack.
void	removeVariable(String name) Remove a variable in the top variables layer.
void	setSingletonVariable(String name, WindupVertexFrame frame) Type-safe wrapper around setVariable which sets only one framed vertex.
void	setVariable(String name, Iterable<? extends WindupVertexFrame> frames) Set a variable in the top variables layer to given "collection" of the vertex frames.
String	toString()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

SEARCH_ALL_LAYERS

public static int SEARCH_ALL_LAYERS

Method Detail

instance

public static Variables instance(GraphRewrite event)

Get an instance of the Variables stack from the given GraphRewrite event context.

push

public void push()

Add new Variables layer on top of the stack.

push

public void push(Map<String,Iterable<? extends WindupVertexFrame>> frame)

Push the given Variables layer on top of the stack.

pop

public Map<String,Iterable<? extends WindupVertexFrame>> pop()

Remove the top Variables layer from the the stack.

peek

public Map<String,Iterable<? extends WindupVertexFrame>> peek()

Get the top Variables layer from the stack.

setSingletonVariable

public void setSingletonVariable(String name,
                                 WindupVertexFrame frame)

Type-safe wrapper around setVariable which sets only one framed vertex.

setVariable

public void setVariable(String name,
                        Iterable<? extends WindupVertexFrame> frames)

Set a variable in the top variables layer to given "collection" of the vertex frames. Can't be reassigned - throws on attempt to reassign.

removeVariable

public void removeVariable(String name)

Remove a variable in the top variables layer.

findSingletonVariable

public <T extends WindupVertexFrame> T findSingletonVariable(String name)

Wrapper around findVariable(String) which gives only one framed vertex, and checks if there is 0 or 1; throws otherwise.

findSingletonVariable

public <FRAMETYPE extends WindupVertexFrame> FRAMETYPE findSingletonVariable(Class<FRAMETYPE> type,
                                                                             String name)

Type-safe wrapper around findVariable(String) returns a unique WindupVertexFrame.

Throws:

IllegalStateException - If more than one frame was found.

findVariable

public Iterable<? extends WindupVertexFrame> findVariable(String name)

Searches the variables layers, top to bottom, for given name, and returns if found; null otherwise.

findVariable

public Iterable<? extends WindupVertexFrame> findVariable(String name,
                                                          int maxDepth)

Searches the variables layers, top to bottom, for given name, and returns if found; null otherwise. If maxDepth is set to SEARCH_ALL_LAYERS, then search all layers.

findVariableOfType

public <T extends WindupVertexFrame> Iterable<T> findVariableOfType(Class<T> type)

Searches the variables layers, top to bottom, for the iterable having all of it's items of the given type. Return null if not found.

toString

public String toString()

Overrides:

toString in class Object