Qore TableMapper Module Reference  1.1
TableMapper::InboundTableMapperIterator Class Reference

provides a hash iterator based on a InboundTableMapper object and an iterator input source; for each iteration the iterted row is inserted into the Table target More...

Inheritance diagram for TableMapper::InboundTableMapperIterator:

Public Member Functions

nothing commit ()
 commits the transaction
 
int commitLimit ()
 returns the commit_limit value set in the constructor()
 
 constructor (Qore::AbstractIterator i, SqlUtil::Table target, hash mapv, *hash opts, int commit_limit=0)
 creates the iterator from the arguments passed More...
 
 constructor (Qore::AbstractIterator i, SqlUtil::AbstractTable target, hash mapv, *hash opts, int commit_limit=0)
 creates the iterator from the arguments passed More...
 
 constructor (Qore::AbstractIterator i, TableMapper::InboundTableMapper mapv, int commit_limit=0)
 creates the iterator from the arguments passed More...
 
int getCount ()
 returns the internal record count More...
 
Qore::SQL::AbstractDatasource getDatasource ()
 returns the AbstractDatasource object associated with this object
 
string getTableName ()
 returns the table name
 
hash getValue ()
 returns the current row transformed with the mapper
 
bool next ()
 Moves the current position of the input iterator to the next element; returns False if there are no more elements otherwise inserts the row in the target table and returns True. More...
 
 resetCount ()
 resets the internal record count More...
 
nothing rollback ()
 rolls back the transaction
 

Private Attributes

int cnt = 0
 row count for commit
 
int commit_limit
 row commit limit (<= 0 for no commits)
 
TableMapper::InboundTableMapper mapc
 data mapper
 
hash val
 a copy of the last hash value mapped
 

Detailed Description

provides a hash iterator based on a InboundTableMapper object and an iterator input source; for each iteration the iterted row is inserted into the Table target

Member Function Documentation

TableMapper::InboundTableMapperIterator::constructor ( Qore::AbstractIterator  i,
SqlUtil::Table  target,
hash  mapv,
*hash  opts,
int  commit_limit = 0 
)

creates the iterator from the arguments passed

The target table is also scanned using SqlUtil and column definitions are used to update the target record specification, also if there are any columns with NOT NULL constraints and no default value, mapping, or constant value, then a MAP-ERROR exception is thrown

Example:
1 const DbMapper = (
2  "id": ("sequence": "seq_inventory_example"),
3  "store_code": "StoreCode",
4  "product_code": "ProductCode",
5  "product_desc": "ProductDescription",
6  "ordered": "Ordered",
7  "available": "Available",
8  "in_transit": "InTransit",
9  "status": ("constant": "01"),
10  "total": int sub (any x, hash rec) { return rec.Available.toInt() + rec.Ordered.toInt() + rec.InTransit.toInt(); },
11  );
12 
13 InboundTableMapperIterator i(input, table, DbMapper);
Parameters
iinput iterator; AbstractIterator::getValue() must return a hash
targetthe target table object
mapva hash providing field mappings; each hash key is the name of the output column in lower case in the target table; each value is either True (meaning no translations are done; the data is copied 1:1) or a hash describing the mapping; see Mapper Specification Format for detailed documentation for this option
optsan optional hash of options for the mapper; see Mapper Options for a description of valid mapper options; note that options related to bulk DML are ignored by this object since it works on one row at a time
commit_limitrow count before a commit is made; if <= 0 then no commits are made by this object, otherwise a commit is made for each commit_limit rows processed by this object, commits are made in calls to next()
Note
by default commit_limit is 0 meaning that this object will make no commits; in this case the transaction will have to be commited explicitly externally
TableMapper::InboundTableMapperIterator::constructor ( Qore::AbstractIterator  i,
SqlUtil::AbstractTable  target,
hash  mapv,
*hash  opts,
int  commit_limit = 0 
)

creates the iterator from the arguments passed

The target table is also scanned using SqlUtil and column definitions are used to update the target record specification, also if there are any columns with NOT NULL constraints and no default value, mapping, or constant value, then a MAP-ERROR exception is thrown

Example:
1 const DbMapper = (
2  "id": ("sequence": "seq_inventory_example"),
3  "store_code": "StoreCode",
4  "product_code": "ProductCode",
5  "product_desc": "ProductDescription",
6  "ordered": "Ordered",
7  "available": "Available",
8  "in_transit": "InTransit",
9  "status": ("constant": "01"),
10  "total": int sub (any x, hash rec) { return rec.Available.toInt() + rec.Ordered.toInt() + rec.InTransit.toInt(); },
11  );
12 
13 InboundTableMapperIterator i(input, table, DbMapper);
Parameters
iinput iterator; AbstractIterator::getValue() must return a hash
targetthe target table object
mapva hash providing field mappings; each hash key is the name of the output column in lower case in the target table; each value is either True (meaning no translations are done; the data is copied 1:1) or a hash describing the mapping; see Mapper Specification Format for detailed documentation for this option
optsan optional hash of options for the mapper; see Mapper Options for a description of valid mapper options; note that options related to bulk DML are ignored by this object since it works on one row at a time
commit_limitrow count before a commit is made; if <= 0 then no commits are made by this object, otherwise a commit is made for each commit_limit rows processed by this object, commits are made in calls to next()
Note
by default commit_limit is 0 meaning that this object will make no commits; in this case the transaction will have to be commited explicitly externally
TableMapper::InboundTableMapperIterator::constructor ( Qore::AbstractIterator  i,
TableMapper::InboundTableMapper  mapv,
int  commit_limit = 0 
)

creates the iterator from the arguments passed

The target table is also scanned using SqlUtil and column definitions are used to update the target record specification, also if there are any columns with NOT NULL constraints and no default value, mapping, or constant value, then a MAP-ERROR exception is thrown

Example:
1 const DbMapper = (
2  "id": ("sequence": "seq_inventory_example"),
3  "store_code": "StoreCode",
4  "product_code": "ProductCode",
5  "product_desc": "ProductDescription",
6  "ordered": "Ordered",
7  "available": "Available",
8  "in_transit": "InTransit",
9  "total": int sub (any x, hash rec) { return rec.Available.toInt() + rec.Ordered.toInt() + rec.InTransit.toInt(); },
10  );
11 
12 InboundTableMapper mapper(table, DbMapper);
13 InboundTableMapperIterator i(input, mapper);
Parameters
iinput iterator; AbstractIterator::getValue() must return a hash
mapvthe mapper to transform the data
commit_limitrow count before a commit is made; if <= 0 then no commits are made by this object, otherwise a commit is made for each commit_limit rows processed by this object, commits are made in calls to next()
int TableMapper::InboundTableMapperIterator::getCount ( )

returns the internal record count

See also
resetCount()
bool TableMapper::InboundTableMapperIterator::next ( )
virtual

Moves the current position of the input iterator to the next element; returns False if there are no more elements otherwise inserts the row in the target table and returns True.

if commit_limit is > 0 then TableMapper::InboundTableMapper::commit() is called for every commit_limit rows according to the internal row count

Returns
False if there are no more elements, in this case if there is an uncommitted transaction according to the internal row count, then TableMapper::InboundTableMapper::commit() is called as well

Reimplemented from Mapper::AbstractMapperIterator.

TableMapper::InboundTableMapperIterator::resetCount ( )

resets the internal record count

See also
getCount()