Qore SalesforceRestDataProvider Module Reference  1.0.1
SalesforceRestDataProvider::SalesforceRestRecordIterator Class Reference

Defines the record iterator class for Table-based iterators. More...

Inherits AbstractDataProviderRecordIterator.

Public Member Methods

 constructor (SalesforceRestClient rest, string name, hash< SalesforceRestRecordInfo > record_info, *hash< auto > where_cond, *hash< auto > search_options)
 creates the iterator More...
 
string getOrClause (list< auto > arglist)
 Returns "or" clauses.
 
*hash< string, AbstractDataField > getRecordType ()
 Returns the record description, if available. More...
 
hash< auto > getValue ()
 Returns a single record if the iterator is valid. More...
 
string makeQuery (*hash< auto > where_cond, *hash< auto > search_options)
 Returns the SQL for a request.
 
auto memberGate (string key)
 Returns the value of the given field in the current row, if the iterator is valid. More...
 
bool next ()
 Increments the row pointer when retrieving rows from a select statement; returns True if there is a row to retrieve, False if not. More...
 
bool valid ()
 Returns True if the iterator is valid. More...
 

Private:Internal Attributes

ListHashIterator i
 record iterator
 
string name
 current object name
 
hash< SalesforceRestRecordInforecord_info
 The record info for this object.
 
SalesforceRestClient rest
 The REST client object for API calls.
 

Detailed Description

Defines the record iterator class for Table-based iterators.

Member Function Documentation

◆ constructor()

SalesforceRestDataProvider::SalesforceRestRecordIterator::constructor ( SalesforceRestClient  rest,
string  name,
hash< SalesforceRestRecordInfo record_info,
*hash< auto >  where_cond,
*hash< auto >  search_options 
)

creates the iterator

Parameters
restthe REST client connection to the server
namethe name of the object
record_infoinfo about the current object
where_condthe search conditions
search_optionssearch options; assumed to have already been processed for validity before this call

◆ getRecordType()

*hash<string, AbstractDataField> SalesforceRestDataProvider::SalesforceRestRecordIterator::getRecordType ( )

Returns the record description, if available.

Returns
the record type of the iterator

◆ getValue()

hash<auto> SalesforceRestDataProvider::SalesforceRestRecordIterator::getValue ( )

Returns a single record if the iterator is valid.

Exceptions
INVALID-ITERATORthe iterator is not pointing at a valid element

◆ memberGate()

auto SalesforceRestDataProvider::SalesforceRestRecordIterator::memberGate ( string  key)

Returns the value of the given field in the current row, if the iterator is valid.

Parameters
keythe name of the field
Returns
the value of the given field in the current row, if the iterator is valid
Exceptions
FIELD-ERRORinvalid or unknown field name

◆ next()

bool SalesforceRestDataProvider::SalesforceRestRecordIterator::next ( )

Increments the row pointer when retrieving rows from a select statement; returns True if there is a row to retrieve, False if not.

Returns
True if there is a row to retrieve, False if not (no more rows to be retrieved)
Note
Exceptions could be thrown by the DBI driver when the statement is executed; see the relevant DBI driver docs for more information

◆ valid()

bool SalesforceRestDataProvider::SalesforceRestRecordIterator::valid ( )

Returns True if the iterator is valid.

Returns
True if the iterator is valid