Qore jni Module
1.0.1
|
Java wrapper for the TableMapper::InboundTableMapper class in Qore. More...
Public Member Methods | |
InboundTableMapper (QoreObject obj) | |
creates the object as a wrapper for the Qore object | |
HashMap< String, Object > | insertRow (Map< String, Object > rec) throws Throwable |
inserts or upserts a row into the target table based on a mapped input record; does not commit the transaction More... | |
HashMap< String, Object > | queueData (Map< String, Object > rec, Map< String, Object > crec) throws Throwable |
inserts/upserts a row (or a set of rows, in case a Map<String, Object> of lists is passed) into the block buffer based on a mapped input record; the block buffer is flushed to the DB if the buffer size reaches the limit defined by the "insert_block" option; does not commit the transaction More... | |
HashMap< String, Object > | queueData (Map< String, Object > rec) throws Throwable |
inserts/upserts a row (or a set of rows, in case a Map<String, Object> of lists is passed) into the block buffer based on a mapped input record; the block buffer is flushed to the DB if the buffer size reaches the limit defined by the "insert_block" option; does not commit the transaction More... | |
HashMap< String, Object > | queueData (Map< String, Object >[] l, Map< String, Object > crec) throws Throwable |
inserts/upserts a set of rows (list of hashes representing input records) into the block buffer based on a mapped input record; the block buffer is flushed to the DB if the buffer size reaches the limit defined by the "insert_block" option; does not commit the transaction More... | |
HashMap< String, Object > | queueData (Map< String, Object >[] l) throws Throwable |
inserts/upserts a set of rows (list of hashes representing input records) into the block buffer based on a mapped input record; the block buffer is flushed to the DB if the buffer size reaches the limit defined by the "insert_block" option; does not commit the transaction More... | |
HashMap< String, Object > | flush () throws Throwable |
flushes any remaining batched data to the database; this method should always be called before committing the transaction or destroying the object More... | |
void | discard () throws Throwable |
discards any buffered batched data; this method should be called after using the batch APIs (queueData()) and an error occurs More... | |
HashMap< String, Object > [] | getReturning () throws Throwable |
returns a list argument for the SqlUtil "returning" option, if applicable | |
void | commit () throws Throwable |
flushes any queued data and commits the transaction | |
void | rollback () throws Throwable |
discards any queued data and rolls back the transaction | |
String | getTableName () throws Throwable |
returns the table name | |
AbstractTable | getTable () throws Throwable |
returns the underlying org.qore.lang.sqlutil.AbstractTable object | |
AbstractDatasource | getDatasource () throws Throwable |
returns the org.qore.lang.AbstractDatasource object associated with this object | |
Public Member Methods inherited from org.qore.lang.mapper.Mapper | |
Mapper (QoreObject obj) | |
creates the object as a wrapper for the Qore object | |
Object | getRuntime (String key) throws Throwable |
get current runtime option value for a key More... | |
String | getFieldName (String fname) throws Throwable |
returns a descriptive name of the given field if possible, otherwise returns the field name itself | |
HashMap< String, Object > | validKeys () throws Throwable |
returns a list of valid field keys for this class (can be overridden in subclasses) More... | |
HashMap< String, Object > | validTypes () throws Throwable |
returns a list of valid field types for this class (can be overridden in subclasses) More... | |
HashMap< String, Object > | optionKeys () throws Throwable |
returns a list of valid constructor options for this class (can be overridden in subclasses) More... | |
HashMap< String, Object > | getInputRecord () throws Throwable |
returns the value of the "input" option More... | |
HashMap< String, Object > | getOutputRecord () throws Throwable |
returns the value of the "output" option More... | |
HashMap< String, Object > [] | mapAll (Map< String, Object >[] recs) throws Throwable |
maps all input records and returns the mapped data as a list of output records More... | |
HashMap< String, Object > [] | mapAll (Map< String, Object > recs) throws Throwable |
maps all input records and returns the mapped data as a list of output records More... | |
HashMap< String, Object > | mapData (Map< String, Object > rec) throws Throwable |
processes the input record and returns a Map<String, Object> of the mapped values where the keys in the Map<String, Object> returned are the target field names; the order of the fields in the Map<String, Object> returned is the same order as the keys in the map hash. More... | |
Public Member Methods inherited from org.qore.jni.QoreObjectWrapper | |
QoreObjectWrapper (QoreObject obj) | |
creates the wrapper object with the Qore object | |
void | release () |
releases the Qore object; do not call any further methods on the object after this call | |
QoreObject | getQoreObject () |
returns the Qore object | |
String | className () |
returns the class name for the Qore object | |
boolean | instanceOf (String class_name) |
returns true if the object is an instance of the given class | |
Additional Inherited Members | |
Private Attributes inherited from org.qore.jni.QoreObjectWrapper | |
QoreObject | obj |
the wrapper Qore object | |
Java wrapper for the TableMapper::InboundTableMapper class in Qore.
|
inline |
discards any buffered batched data; this method should be called after using the batch APIs (queueData()) and an error occurs
|
inline |
flushes any remaining batched data to the database; this method should always be called before committing the transaction or destroying the object
|
inline |
inserts or upserts a row into the target table based on a mapped input record; does not commit the transaction
rec | the input record |
MISSING-INPUT | a field marked mandatory is missing |
STRING-TOO-LONG | a field value exceeds the maximum value and the 'trunc' key is not set |
INVALID-NUMBER | the field is marked as numeric but the input value contains non-numeric data |
|
inline |
inserts/upserts a row (or a set of rows, in case a Map<String, Object> of lists is passed) into the block buffer based on a mapped input record; the block buffer is flushed to the DB if the buffer size reaches the limit defined by the "insert_block"
option; does not commit the transaction
Data is only inserted/upserted if the block buffer size reaches the limit defined by the "insert_block"
option, in which case this method returns all the data inserted/upserted. In case the mapped data is only inserted into the cache, no value is returned.
rec | the input record or record set in case a Map<String, Object> of lists is passed |
crec | an optional simple Map<String, Object> (may be null) of data to be added to each input row before mapping |
"unstable_input"
option is given in the constructor"insert_block"
option is set to 1, then this method simply calls insertRow(); however please note that in this case the return value is a Map<String, Object> of single value lists corresponding to a batch data insertN
rows of a column C
and 'crec = ("C" : "mystring")' then the output will be as if there was 'N' rows with C
= "mystring" on the input.MAPPER-BATCH-ERROR | this exception is thrown if this method is called when the "unstable_input" option was given in the constructor |
MISSING-INPUT | a field marked mandatory is missing |
STRING-TOO-LONG | a field value exceeds the maximum value and the 'trunc' key is not set |
INVALID-NUMBER | the field is marked as numeric but the input value contains non-numeric data |
|
inline |
inserts/upserts a row (or a set of rows, in case a Map<String, Object> of lists is passed) into the block buffer based on a mapped input record; the block buffer is flushed to the DB if the buffer size reaches the limit defined by the "insert_block"
option; does not commit the transaction
Data is only inserted/upserted if the block buffer size reaches the limit defined by the "insert_block"
option, in which case this method returns all the data inserted/upserted. In case the mapped data is only inserted into the cache, no value is returned.
rec | the input record or record set in case a Map<String, Object> of lists is passed |
"unstable_input"
option is given in the constructor"insert_block"
option is set to 1, then this method simply calls insertRow(); however please note that in this case the return value is a Map<String, Object> of single value lists corresponding to a batch data insertN
rows of a column C
and 'crec = ("C" : "mystring")' then the output will be as if there was 'N' rows with C
= "mystring" on the input.MAPPER-BATCH-ERROR | this exception is thrown if this method is called when the "unstable_input" option was given in the constructor |
MISSING-INPUT | a field marked mandatory is missing |
STRING-TOO-LONG | a field value exceeds the maximum value and the 'trunc' key is not set |
INVALID-NUMBER | the field is marked as numeric but the input value contains non-numeric data |
|
inline |
inserts/upserts a set of rows (list of hashes representing input records) into the block buffer based on a mapped input record; the block buffer is flushed to the DB if the buffer size reaches the limit defined by the "insert_block"
option; does not commit the transaction
Data is only inserted/upserted if the block buffer size reaches the limit defined by the "insert_block"
option, in which case this method returns all the data inserted/upserted. In case the mapped data is only inserted into the cache, no value is returned.
l | a list of hashes representing the input records |
crec | an optional simple Map<String, Object> of data to be added to each row |
"unstable_input"
option is given in the constructor"insert_block"
option is set to 1, then this method simply calls insertRow()MAPPER-BATCH-ERROR | this exception is thrown if this method is called when the "unstable_input" option was given in the constructor |
MISSING-INPUT | a field marked mandatory is missing |
STRING-TOO-LONG | a field value exceeds the maximum value and the 'trunc' key is not set |
INVALID-NUMBER | the field is marked as numeric but the input value contains non-numeric data |
|
inline |
inserts/upserts a set of rows (list of hashes representing input records) into the block buffer based on a mapped input record; the block buffer is flushed to the DB if the buffer size reaches the limit defined by the "insert_block"
option; does not commit the transaction
Data is only inserted/upserted if the block buffer size reaches the limit defined by the "insert_block"
option, in which case this method returns all the data inserted/upserted. In case the mapped data is only inserted into the cache, no value is returned.
l | a list of hashes representing the input records |
"unstable_input"
option is given in the constructor"insert_block"
option is set to 1, then this method simply calls insertRow()MAPPER-BATCH-ERROR | this exception is thrown if this method is called when the "unstable_input" option was given in the constructor |
MISSING-INPUT | a field marked mandatory is missing |
STRING-TOO-LONG | a field value exceeds the maximum value and the 'trunc' key is not set |
INVALID-NUMBER | the field is marked as numeric but the input value contains non-numeric data |