ECMAScript data-model via Google's V8.

#include <V8DataModel.h>

Inheritance diagram for uscxml::V8DataModel:
[legend]
Collaboration diagram for uscxml::V8DataModel:
[legend]

Public Member Functions

virtual void addExtension (DataModelExtension *ext)
 Register an extension to get data into and out of the data-model. More...
 
virtual void assign (const std::string &location, const Data &data, const std::map< std::string, std::string > &attr=std::map< std::string, std::string >())
 Assign a data object to a location in the data-model. More...
 
virtual std::shared_ptr< DataModelImplcreate (DataModelCallbacks *callbacks)
 The Factory wants to instantiate a new instance. More...
 
virtual bool evalAsBool (const std::string &expr)
 Evaluate a given expression as a boolean. More...
 
virtual Data evalAsData (const std::string &expr)
 Return a string as an evaluated Data object. More...
 
virtual Data getAsData (const std::string &content)
 Return a string as an unevaluated Data object. More...
 
virtual uint32_t getLength (const std::string &expr)
 Evaluate the given expression as something iterable and return its length. More...
 
virtual std::list< std::string > getNames ()
 Return a list of names to be matched by the datamodel attribute in SCXML.
 
virtual void init (const std::string &location, const Data &data, const std::map< std::string, std::string > &attr=std::map< std::string, std::string >())
 Initialize a variable / location in the data-model with a given data object. More...
 
virtual bool isDeclared (const std::string &expr)
 Determine whether a given variable / location is declared. More...
 
virtual bool isValidSyntax (const std::string &expr)
 Determine whether a given string constitutes valid syntax in the data-model's language. More...
 
virtual void setEvent (const Event &event)
 Set the given event as _event in the data-model's global scope. More...
 
virtual void setForeach (const std::string &item, const std::string &array, const std::string &index, uint32_t iteration)
 Set a given item to the object at a given index for one iteration. More...
 
- Public Member Functions inherited from uscxml::DataModelImpl
size_t replaceExpressions (std::string &content)
 Experimental extension to have dynamic content in string literals. More...
 

Protected Member Functions

v8::Local< v8::Value > evalAsValue (const std::string &expr, bool dontThrow=false)
 
v8::Local< v8::Value > getDataAsValue (const Data &data)
 
v8::Local< v8::Value > getNodeAsValue (const XERCESC_NS::DOMNode *node)
 
Data getValueAsData (const v8::Local< v8::Value > &value)
 
void throwExceptionEvent (const v8::TryCatch &tryCatch)
 

Static Protected Member Functions

static void getAttribute (v8::Local< v8::String > property, const v8::PropertyCallbackInfo< v8::Value > &info)
 
static void getInvokers (v8::Local< v8::String > property, const v8::PropertyCallbackInfo< v8::Value > &info)
 
static void getIOProcessors (v8::Local< v8::String > property, const v8::PropertyCallbackInfo< v8::Value > &info)
 
static void jsExtension (const v8::FunctionCallbackInfo< v8::Value > &info)
 
static void jsIn (const v8::FunctionCallbackInfo< v8::Value > &info)
 
static void jsPrint (const v8::FunctionCallbackInfo< v8::Value > &info)
 
static void setWithException (v8::Local< v8::String > property, v8::Local< v8::Value > value, const v8::PropertyCallbackInfo< void > &info)
 

Protected Attributes

v8::Persistent< v8::Context > _context
 
std::set< DataModelExtension * > _extensions
 
v8::Persistent< v8::Object > _invokers
 
v8::Persistent< v8::Object > _ioProcessors
 
- Protected Attributes inherited from uscxml::DataModelImpl
DataModelCallbacks_callbacks
 

Static Protected Attributes

static v8::Isolate * _isolate = NULL
 

Member Function Documentation

void uscxml::V8DataModel::addExtension ( DataModelExtension ext)
virtual
Todo:
This is currently unsupported

Reimplemented from uscxml::DataModelImpl.

void uscxml::V8DataModel::assign ( const std::string &  location,
const Data data,
const std::map< std::string, std::string > &  attr = std::map< std::string, std::string >() 
)
virtual

There are different occurences in the SCXML IRP tests, e.g.

test147:
<data id="Var1" expr="0"/>

test150:
<data id="Var3">
[1,2,3]
</data>

test277:
<data id="Var1" expr="return"/>
Parameters
locationA variable or locatio to assign to.
dataThe Data object with the respective data.
attrAdditional attributes of the XML assign element.

Implements uscxml::DataModelImpl.

std::shared_ptr< DataModelImpl > uscxml::V8DataModel::create ( DataModelCallbacks callbacks)
virtual

This function will have to initialize the object. The actual constructor is called from within here. The only one who calls the constructor directly is the Factory for the prototype object.

Parameters
callbacksThe callbacks available to the datamodel
Returns
A shared pointer with an initialized instance

Implements uscxml::DataModelImpl.

bool uscxml::V8DataModel::evalAsBool ( const std::string &  expr)
virtual

This function is a subset of evalAsData() but saves on creating and copying a Data object.

Parameters
exprAn expression in the data-model's language.
Returns
Whether the expression evaluates as true

Implements uscxml::DataModelImpl.

Data uscxml::V8DataModel::evalAsData ( const std::string &  content)
virtual
Parameters
contentA string with a literal, eppression or compound data-structure in the data-model's language.
Returns
An evaluated structure representing the given compound or literal.

Implements uscxml::DataModelImpl.

Data uscxml::V8DataModel::getAsData ( const std::string &  content)
virtual
Parameters
contentA string with a literal, eppression or compound data-structure in the data-model's language.
Returns
An unevaluated structure representing the given compound or literal.

Implements uscxml::DataModelImpl.

uint32_t uscxml::V8DataModel::getLength ( const std::string &  expr)
virtual
Parameters
exprAnything that possibly evaluates to an enumerable object.
Returns
The number of items in the enumerable object.

Implements uscxml::DataModelImpl.

void uscxml::V8DataModel::init ( const std::string &  location,
const Data data,
const std::map< std::string, std::string > &  attr = std::map< std::string, std::string >() 
)
virtual

This is, semantically, very close to assign() but does not assume the location to be declared first.

Parameters
locationA variable or locatio to assign to.
dataThe Data object with the respective data.
attrAdditional attributes of the XML data element.

Implements uscxml::DataModelImpl.

bool uscxml::V8DataModel::isDeclared ( const std::string &  expr)
virtual
Parameters
exprThe variable / location to check.
Todo:
Is this still used?

Undeclared variables can be checked by trying to access them and catching a reference error.

Implements uscxml::DataModelImpl.

bool uscxml::V8DataModel::isValidSyntax ( const std::string &  expr)
virtual
Parameters
exprA string, supposedly containing an expression of the data-model.
Returns
Whether expr is in L(DM).

Reimplemented from uscxml::DataModelImpl.

void uscxml::V8DataModel::setEvent ( const Event event)
virtual
Parameters
eventThe event as it was dequeued from either the internal or external queue.

Implements uscxml::DataModelImpl.

void uscxml::V8DataModel::setForeach ( const std::string &  item,
const std::string &  array,
const std::string &  index,
uint32_t  iteration 
)
virtual
Parameters
itemA variable or location to assign the current object to.
arrayAn expression evalating to an enumerable object.
indexA variable or location to set the current index at.
iterationThe current iteration index.

Implements uscxml::DataModelImpl.


The documentation for this class was generated from the following files: