com.kapowtech.robosuite.api.java.rest

Class RpaObjectBuilder

java.lang.Object

com.kapowtech.robosuite.api.java.rest.RpaObjectBuilder

Direct Known Subclasses:

OAuthRpaObjectBuilder

public class RpaObjectBuilder
extends java.lang.Object

Used to build RPA Objects, typically for use as input objects to a robot. RpaObject is an immutable class.

Chaining

The setAttribute methods in this class return a reference to the RpaObjectBuilder object itself, and are thus chainable in a way similar to the StringBuffer class.

Example of use

This shows how to build a rather complex set of query parameters, perhaps to search for biographical information.

RpaObject userCredential = new RpaObjectBuilder("UserCredential"). setAttribute("username", "user42"). setAttribute("password", "secret").toRpaObject();

The RpaObjectBuilder is itself mutable, but the RpaObjects it returns are inherently immutable.

See Also:

RpaObject, Attribute

Constructor Summary

Constructors

Constructor and Description
RpaObjectBuilder(RpaObject prototype) Creates a new RpaObjectBuilder that creates an RpaObject from a specified prototype.
RpaObjectBuilder(java.lang.String name) Creates a new RpaObjectBuilder that creates an RpaObject with the given name.

Method Summary

Modifier and Type	Method and Description
void	clearAttributes() Clears all attributes from the object being constructed.
java.lang.String	getName() Returns the name of the object under construction.
protected java.lang.String	getType() The type of RPA object (currently BASIC or OAUTH)
RpaObjectBuilder	setAttribute(Attribute attribute) Adds a new attribute to the RPA Object that is under construction.
RpaObjectBuilder	setAttribute(java.lang.String name, Binary value) Adds a new binary type attribute with the given name and value to the RPA Object that is under construction.
RpaObjectBuilder	setAttribute(java.lang.String name, boolean value) Adds a new boolean type attribute with the given name and value to the RPA Object that is under construction.
RpaObjectBuilder	setAttribute(java.lang.String name, byte[] value) Adds a new binary type attribute with the given name and value to the RPA Object that is under construction.
RpaObjectBuilder	setAttribute(java.lang.String name, char value) Adds a new character type attribute with the given name and value to the RPA Object that is under construction.
RpaObjectBuilder	setAttribute(java.lang.String name, java.util.Date value) Adds a new date type attribute with the given name and value to the RPA Object that is under construction.
RpaObjectBuilder	setAttribute(java.lang.String name, double value) Adds a new number type attribute with the given name and value to the RPA Object that is under construction.
RpaObjectBuilder	setAttribute(java.lang.String name, long value) Adds a new integer type attribute with the given name and value to the RPA Object that is under construction.
RpaObjectBuilder	setAttribute(java.lang.String name, java.lang.Object value) Adds a new attribute with the given name and value to the RPA Object under construction.
RpaObjectBuilder	setAttribute(java.lang.String name, java.lang.String value) Adds a new attribute with the given name and value to the RPA Object that is under construction.
RpaObjectBuilder	setAttributes(java.util.Map<java.lang.String,Attribute> attributes) Sets several attributes, initialized from the names and values of a java.util.Map.
void	setName(java.lang.String name) Sets the name of the object under construction.
org.json.JSONObject	toJSON() Translates this RPA object builder into JSON that can be used for calls to the tasks API on the Management Console.
RpaObject	toRpaObject() Creates a new RpaObject initialized with the values placed in this object.

Methods inherited from class java.lang.Object

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

Constructor Detail

RpaObjectBuilder

public RpaObjectBuilder(java.lang.String name)

Creates a new RpaObjectBuilder that creates an RpaObject with the given name.

Parameters:

name - the name of the new RpaObject to create.

Throws:

java.lang.NullPointerException - if the name parameter was null.

RpaObjectBuilder

public RpaObjectBuilder(RpaObject prototype)

Creates a new RpaObjectBuilder that creates an RpaObject from a specified prototype.

Parameters:

prototype - the prototype for the new RpaObject to create. The object being constructed will initially have the same name and attributes as the prototype. The prototype is not modified as a result of using it in this class, since it is immutable.

Throws:

java.lang.NullPointerException - if the prototype parameter was null.

Method Detail

getName

public java.lang.String getName()

Returns the name of the object under construction.

Returns:

the name of the object.

setName

public void setName(java.lang.String name)

Sets the name of the object under construction.

Parameters:

name - the name of the object.

Throws:

java.lang.NullPointerException - if the name parameter was null.

setAttribute

public RpaObjectBuilder setAttribute(java.lang.String name,
                                     java.lang.Object value)

Adds a new attribute with the given name and value to the RPA Object under construction. If the object under construction already contains an attribute with the given name, it will be overwritten.

Parameters:

name - the name of the attribute

value - the attribute value, which must be a valid type. The attribute types are restricted to the standard Java types: Boolean, Date, Double, Long, Character, java.lang.String; and the RPA type Binary.

Returns:

a reference to this object.

Throws:

java.lang.NullPointerException - if the name of the attribute is null.

InvalidAttributeTypeException - if the value argument is not an accepted type.

See Also:

Attribute, AttributeType

setAttribute

public RpaObjectBuilder setAttribute(java.lang.String name,
                                     java.lang.String value)

Adds a new attribute with the given name and value to the RPA Object that is under construction. If the object under construction already contains an attribute with the given name, it will be overwritten.

Parameters:

name - the name of the attribute

value - the attribute value.

Returns:

a reference to this object.

Throws:

java.lang.NullPointerException - if the name of the attribute is null.

InvalidAttributeTypeException - if the value argument is not an accepted type.

See Also:

Attribute, AttributeType

setAttribute

public RpaObjectBuilder setAttribute(java.lang.String name,
                                     long value)

Adds a new integer type attribute with the given name and value to the RPA Object that is under construction. If the object under construction already contains an attribute with the given name, it will be overwritten.

Parameters:

name - the name of the attribute

value - a 64 bit signed integer value.

Returns:

a reference to this object.

See Also:

Attribute, AttributeType.INTEGER

setAttribute

public RpaObjectBuilder setAttribute(java.lang.String name,
                                     boolean value)

Adds a new boolean type attribute with the given name and value to the RPA Object that is under construction. If the object under construction already contains an attribute with the given name, it will be overwritten.

Parameters:

name - the name of the attribute

value - a boolean value.

Returns:

a reference to this object.

See Also:

Attribute, AttributeType.BOOLEAN

setAttribute

public RpaObjectBuilder setAttribute(java.lang.String name,
                                     char value)

Adds a new character type attribute with the given name and value to the RPA Object that is under construction. If the object under construction already contains an attribute with the given name, it will be overwritten.

Parameters:

name - the name of the attribute

value - a character value.

Returns:

a reference to this object.

See Also:

Attribute, AttributeType.CHARACTER

setAttribute

public RpaObjectBuilder setAttribute(java.lang.String name,
                                     double value)

Adds a new number type attribute with the given name and value to the RPA Object that is under construction. If the object under construction already contains an attribute with the given name, it will be overwritten.

Parameters:

name - the name of the attribute

value - a floating point value.

Returns:

a reference to this object.

See Also:

Attribute, AttributeType.NUMBER

setAttribute

public RpaObjectBuilder setAttribute(java.lang.String name,
                                     java.util.Date value)

Adds a new date type attribute with the given name and value to the RPA Object that is under construction. If the object under construction already contains an attribute with the given name, it will be overwritten.

Parameters:

name - the name of the attribute

value - a date value.

Returns:

a reference to this object.

See Also:

Attribute, AttributeType.DATE

setAttribute

public RpaObjectBuilder setAttribute(java.lang.String name,
                                     Binary value)

Adds a new binary type attribute with the given name and value to the RPA Object that is under construction. If the object under construction already contains an attribute with the given name, it will be overwritten.

Parameters:

name - the name of the attribute

value - a binary value (a sequence of bytes).

Returns:

a reference to this object.

See Also:

Attribute, AttributeType.BINARY

setAttribute

public RpaObjectBuilder setAttribute(java.lang.String name,
                                     byte[] value)

Adds a new binary type attribute with the given name and value to the RPA Object that is under construction. If the object under construction already contains an attribute with the given name, it will be overwritten.

Parameters:

name - the name of the attribute

value - a binary value (a sequence of bytes). This method constructs a new Binary object from the bytes.

Returns:

a reference to this object.

See Also:

Attribute, AttributeType.BINARY

setAttribute

public RpaObjectBuilder setAttribute(Attribute attribute)

Adds a new attribute to the RPA Object that is under construction. If the object under construction already contains an attribute with the given name, it will be overwritten.

Parameters:

attribute - the attribute to add.

Returns:

a reference to this object.

Throws:

java.lang.NullPointerException - if the attribute parameter was null.

See Also:

Attribute, AttributeType.BINARY

setAttributes

public RpaObjectBuilder setAttributes(java.util.Map<java.lang.String,Attribute> attributes)

Sets several attributes, initialized from the names and values of a java.util.Map.

This convenience method loops over the map entries, adding a new attribute for each. The name of the new attribute will be the entry's key, and the value will be the entry's value.

Parameters:

attributes - to set as a map

Returns:

a reference to this object.

Throws:

java.lang.NullPointerException - if the attributes parameter was null, or any of the keys in the map are null.

InvalidAttributeTypeException - if the value argument is not an accepted type.

See Also:

Map.Entry#getKey, Map.Entry#getValue

clearAttributes

public void clearAttributes()

Clears all attributes from the object being constructed.

getType

protected java.lang.String getType()

The type of RPA object (currently BASIC or OAUTH)

Returns:

the type of object as a string.

toRpaObject

public RpaObject toRpaObject()

Creates a new RpaObject initialized with the values placed in this object. The created object is immutable, and will not be changed, even if this builder is modified.

Returns:

a new RpaObject initialized with the values placed in this object.

toJSON

public org.json.JSONObject toJSON()

Translates this RPA object builder into JSON that can be used for calls to the tasks API on the Management Console.

Returns:

a JSONObject containing the name, type, and attributes of the object.