public interface Buffer extends ADMData, Available, BufferHandle, CallbackProcedure, DatabaseInfo, DataSourceModifiable, DataSetChangeable, Dereferenceable, DynamicResource, EmptyTempTable, Errorable, ErrorString, Fillable, IndexInformation, InstantiatingProcedure, IterableResource, JsonData, Keyable, Nameable, NamedSerializable, NamespaceURI, QueryAssociable, Rejectable, TempTableDuplicator, UniqueID, WrappedResource, XmlData
Each DMO interface should contain a public, inner interface which extends both this class and the enclosing DMO interface. This enables DMO proxies used by business logic to invoke DMO-specific methods, as well as methods which provide standard buffer services, without requiring a cast.
Modifier and Type | Field and Description |
---|---|
static java.lang.String |
__AFTER_ROWID__
The legacy name of the hidden after-rowid field in BEFORE-TEMP-TABLEs.
|
static java.lang.String |
__DATA_SOURCE_ROWID__
The legacy name of the hidden DATASOURCE field in BEFORE-TEMP-TABLEs.
|
static java.lang.String |
__ERROR_FLAG__
The legacy name of the hidden error flag field in BEFORE-TEMP-TABLEs.
|
static java.lang.String |
__ERROR_STRING__
The legacy name of the hidden error string field in BEFORE-TEMP-TABLEs.
|
static java.lang.String |
__ORIGIN_ROWID__
The legacy name of the origin rowid field in BEFORE-TEMP-TABLEs.
|
static java.lang.String |
__ROW_STATE__
The legacy name of the hidden row-state field in BEFORE-TEMP-TABLEs.
|
static java.lang.String |
AFTER_FILL_EVENT
The
AFTER-FILL event string constant in upper case. |
static java.lang.String |
AFTER_ROW_FILL_EVENT
The
AFTER-ROW-FILL event string constant in upper case. |
static java.lang.String |
AFTER_ROWID_FIELD
The java (dmo/converted) name of the hidden after-rowid field in BEFORE-TEMP-TABLEs.
|
static java.lang.String |
BEFORE_FILL_EVENT
The
BEFORE-FILL event string constant in upper case. |
static java.lang.String |
BEFORE_ROW_FILL_EVENT
The
BEFORE-ROW-FILL event string constant in upper case. |
static java.lang.String |
DATA_SOURCE_ROWID_FIELD
The java (dmo/converted) name of the hidden DATASOURCE field in BEFORE-TEMP-TABLEs.
|
static int |
ERROR_ERROR
A bitwise flag which marks a system error.
|
static java.lang.String |
ERROR_FLAG_FIELD
The java (dmo/converted) name of the hidden error flag field in BEFORE-TEMP-TABLEs.
|
static int |
ERROR_REJECTED
A bitwise flag which marks a user error.
|
static java.lang.String |
ERROR_STRING_FIELD
The java (dmo/converted) name of the hidden error string field in BEFORE-TEMP-TABLEs.
|
static java.lang.String |
FIND_FAILED_EVENT
The
FIND-FAILED event string constant in upper case. |
static java.lang.String |
ORIGIN_ROWID_FIELD
The java (dmo/converted) name of the origin rowid field in BEFORE-TEMP-TABLEs.
|
static java.lang.String |
ROW_CREATE_EVENT
The
ROW-CREATE event string constant in upper case. |
static int |
ROW_CREATED
ROW-STATE constant value: the row was created.
|
static java.lang.String |
ROW_DELETE_EVENT
The
ROW-DELETE event string constant in upper case. |
static int |
ROW_DELETED
ROW-STATE constant value: the row was deleted.
|
static int |
ROW_MODIFIED
ROW-STATE constant value: the row was modified.
|
static java.lang.String |
ROW_STATE_FIELD
The java (dmo/converted) name of the hidden row-state field in BEFORE-TEMP-TABLEs.
|
static java.lang.String |
ROW_STATE_IDX
The legacy name of the index in BEFORE-TEMP-TABLEs .
|
static int |
ROW_UNMODIFIED
ROW-STATE constant value: the row was not modified.
|
static java.lang.String |
ROW_UPDATE_EVENT
The
ROW-UPDATE event string constant in upper case. |
static java.lang.String |
SYNCHRONIZE_EVENT
The
SYNCHRONIZE event string constant in upper case. |
Modifier and Type | Method and Description |
---|---|
boolean |
_ambiguous()
Indicate whether the last record retrieval attempt failed because the
query criteria was ambiguous.
|
boolean |
_available()
Indicate whether a backing data record currently is available.
|
boolean |
_currentChanged()
Checks if the record in the buffer has changed in database since the
last
FIND CURRENT or GET CURRENT . |
boolean |
_locked()
Indicate whether the last record retrieval attempt was denied because
the target record was locked.
|
boolean |
_newlyCreated()
Indicate whether the buffer associated currently contains a record, and
whether that record is transient.
|
logical |
acceptRowChanges()
Accepts changes to the data in one row of this
DataSet temp-table. |
handle |
afterBuffer()
Obtain the handle to the default buffer of the after-image table that corresponds to
the buffer of the before-image table currently associated with this buffer handle.
|
rowid |
afterRowid()
Gets the
ROWID of the row in the after-image table that is the current version of
the row in the before-image table currently associated with this buffer. |
logical |
ambiguous()
Indicate whether the last record retrieval attempt failed because the
query criteria was ambiguous.
|
logical |
attachDataSource(handle ds)
Attaches a
DataSource object to this temp-table Buffer in a DataSet
object. |
logical |
attachDataSource(handle ds,
character pairList)
Attaches a
DataSource object to this temp-table Buffer in a DataSet
object. |
logical |
attachDataSource(handle ds,
character pairList,
character exceptFields)
Attaches a
DataSource object to this temp-table Buffer in a DataSet
object. |
logical |
attachDataSource(handle ds,
character pairList,
character exceptFields,
character includeFields)
Attaches a
DataSource object to this temp-table Buffer in a DataSet
object. |
character |
attachedPairlist()
Obtain a comma-separated list of field name pairs for fields in a
DataSet
temp-table buffer that are mapped to corresponding fields in an attached DataSource
object. |
logical |
autoDelete()
Get the BUFFER:AUTO-DELETE attribute.
|
void |
autoDelete(boolean autoDelete)
Set the BUFFER:AUTO-DELETE attribute.
|
void |
autoDelete(logical autoDelete)
Set the BUFFER:AUTO-DELETE attribute.
|
void |
average(java.lang.String column,
NumberType num)
Aggregate method which averages the values of a single column across rows in the table
backing this buffer.
|
void |
average(java.lang.String column,
NumberType num,
java.lang.String where)
Aggregate method which averages the values of a single column across rows in the table
backing this buffer.
|
void |
average(java.lang.String column,
NumberType num,
java.lang.String where,
java.lang.Object... args)
Aggregate method which averages the values of a single column across rows in the table
backing this buffer.
|
integer |
batchSize()
Gets the maximum number of
DataSet temp-table rows to retrieve in each FILL
operation. |
void |
batchSize(long size)
Sets the maximum number of
DataSet temp-table rows to retrieve in each FILL
operation. |
void |
batchSize(NumberType size)
Sets the maximum number of
DataSet temp-table rows to retrieve in each FILL
operation. |
handle |
beforeBuffer()
Obtain the handle to the default buffer of the before-image table that corresponds to
the buffer of the after-image table currently associated with this buffer handle.
|
rowid |
beforeRowid()
Gets the
ROWID of the row in the before-image table that is the current version of
the row in the before-image table currently associated with this buffer. |
logical |
bufferCompare(Buffer buffer)
Conversion of BUFFER-COMPARE() method (KW_BUF_COMP).
|
logical |
bufferCompare(Buffer buffer,
character mode)
Conversion of BUFFER-COMPARE() method (KW_BUF_COMP).
|
logical |
bufferCompare(Buffer buffer,
character mode,
character except)
Conversion of BUFFER-COMPARE() method (KW_BUF_COMP).
|
logical |
bufferCompare(Buffer buffer,
character mode,
character except,
character pairs)
Conversion of BUFFER-COMPARE() method (KW_BUF_COMP).
|
logical |
bufferCompare(Buffer buffer,
character mode,
character except,
character pairs,
logical noLobs)
Conversion of BUFFER-COMPARE() method (KW_BUF_COMP).
|
logical |
bufferCompare(handle bufHandle)
Conversion of BUFFER-COMPARE() method (KW_BUF_COMP).
|
logical |
bufferCompare(handle bufHandle,
character mode)
Conversion of BUFFER-COMPARE() method (KW_BUF_COMP).
|
logical |
bufferCompare(handle bufHandle,
character mode,
character except)
Conversion of BUFFER-COMPARE() method (KW_BUF_COMP).
|
logical |
bufferCompare(handle bufHandle,
character mode,
character except,
character pairs)
Conversion of BUFFER-COMPARE() method (KW_BUF_COMP).
|
logical |
bufferCompare(handle bufHandle,
character mode,
character except,
character pairs,
logical noLobs)
Conversion of BUFFER-COMPARE() method (KW_BUF_COMP).
|
logical |
bufferCopy(Buffer buffer)
Conversion of BUFFER-COPY() method (KW_BUF_COPY).
|
logical |
bufferCopy(Buffer buffer,
character except)
Conversion of BUFFER-COPY() method (KW_BUF_COPY).
|
logical |
bufferCopy(Buffer buffer,
character except,
character pairs)
Conversion of BUFFER-COPY() method (KW_BUF_COPY).
|
logical |
bufferCopy(Buffer buffer,
character except,
character pairs,
logical noLobs)
Conversion of BUFFER-COPY() method (KW_BUF_COPY).
|
logical |
bufferCopy(handle bufHandle)
Conversion of BUFFER-COPY() method (KW_BUF_COPY).
|
logical |
bufferCopy(handle bufHandle,
character except)
Conversion of BUFFER-COPY() method (KW_BUF_COPY).
|
logical |
bufferCopy(handle bufHandle,
character except,
character pairs)
Conversion of BUFFER-COPY() method (KW_BUF_COPY).
|
logical |
bufferCopy(handle bufHandle,
character except,
character pairs,
logical noLobs)
Conversion of BUFFER-COPY() method (KW_BUF_COPY).
|
logical |
bufferCreate()
Conversion of BUFFER-CREATE() method (KW_BUF_CREA).
|
handle |
bufferField(BaseDataType fieldName)
Conversion of BUFFER-FIELD() method (KW_BUF_FLD).
|
handle |
bufferField(character fieldName)
Conversion of BUFFER-FIELD() method (KW_BUF_FLD).
|
handle |
bufferField(int fieldNumber)
Conversion of BUFFER-FIELD() method (KW_BUF_FLD).
|
handle |
bufferField(NumberType fieldNumber)
Conversion of BUFFER-FIELD() method (KW_BUF_FLD).
|
handle |
bufferField(java.lang.String fieldName)
Conversion of BUFFER-FIELD() method (KW_BUF_FLD).
|
logical |
bufferRelease()
Conversion of BUFFER-RELEASE() method (KW_BUF_REL).
|
logical |
bufferValidate()
Definition of the BUFFER-VALIDATE method.
|
handle |
childRelation(int64 index)
Obtain the handle to a
DataRelation object for which the buffer is the parent. |
handle |
childRelation(long index)
Obtain the handle to a
DataRelation object for which the buffer is the parent. |
void |
count(java.lang.String column,
NumberType num)
Aggregate method which counts the rows in the table backing this buffer.
|
void |
count(java.lang.String column,
NumberType num,
java.lang.String where)
Aggregate method which counts the rows in the table backing this buffer.
|
void |
count(java.lang.String column,
NumberType num,
java.lang.String where,
java.lang.Object... args)
Aggregate method which counts the rows in the table backing this buffer.
|
void |
create()
Create a new record in the buffer.
|
logical |
currentChanged()
Checks if the record in the buffer has changed in database since the
last
FIND CURRENT or GET CURRENT . |
handle |
dataSet()
Get the handle for the
DataSet object of which the buffer is a member. |
handle |
dataSource()
Get the handle to the
DataSource object currently attached to the DataSet
object buffer. |
character |
dataSourceCompleteMap()
The list of field name pairs for all fields (in comm-delimited format) in a
DataSet
temp-table buffer that are mapped to corresponding fields in an attached data-source object. |
rowid |
dataSourceRowid()
Obtains the
DataSource row corresponding to this buffer object. |
rowid |
dataSourceRowid(character buffName)
Obtains the
DataSource row corresponding to this buffer object. |
void |
dataSourceRowid(character buffName,
rowid val)
Configures the
DataSource row corresponding to this buffer object. |
rowid |
dataSourceRowid(int64 joinLevel)
Obtains the
DataSource row corresponding to this buffer object. |
void |
dataSourceRowid(int64 joinLevel,
rowid val)
Configures the
DataSource row corresponding to this buffer object. |
void |
dataSourceRowid(rowid val)
Configures the
DataSource row corresponding to this buffer object. |
void |
delete(DataModelObject[] suppDMOs,
java.lang.String where,
java.lang.Object... args)
Delete all records associated with this buffer, which match the criteria
specified by the given where clause.
|
void |
delete(java.lang.String where,
java.lang.Object... args)
Delete all records associated with this buffer, which match the criteria
specified by the given where clause.
|
logical |
deleteRecord()
Delete the record currently in the buffer, if any.
|
logical |
deleteRecord(java.util.function.Supplier<logical> valexp,
java.lang.String valmsg)
Delete the record currently in the buffer, IF and ONLY IF the given validation expression
evaluates
true . |
logical |
deleteRecord(java.util.function.Supplier<logical> valexp,
java.util.function.Supplier<character> valmsg)
Delete the record currently in the buffer, IF and ONLY IF the given validation expression
evaluates
true . |
logical |
detachDataSource()
Detaches the
DataSource from the temp-table buffer in a DataSet object. |
void |
disableDumpTriggers()
Disable the triggers associated with the FIND event for the buffer's table.
|
void |
disableLoadTriggers(boolean allowReplication)
Disable the triggers associated with the CREATE, WRITE, DELETE and ASSIGN events for the
buffer's table.
|
logical |
findByRowID(rowid id)
Conversion of FIND-BY-ROWID() method (KW_FIND_BR).
|
logical |
findByRowID(rowid id,
LockType lockType)
Conversion of FIND-BY-ROWID() method (KW_FIND_BR).
|
logical |
findByRowID(rowid id,
long lock)
Conversion of FIND-BY-ROWID() method (KW_FIND_BR).
|
logical |
findByRowID(rowid id,
long lock,
long nowait)
Conversion of FIND-BY-ROWID() method (KW_FIND_BR).
|
logical |
findByRowID(rowid id,
long lock,
NumberType nowait)
Conversion of FIND-BY-ROWID() method (KW_FIND_BR).
|
logical |
findByRowID(rowid id,
NumberType lock)
Conversion of FIND-BY-ROWID() method (KW_FIND_BR).
|
logical |
findByRowID(rowid id,
NumberType lock,
long nowait)
Conversion of FIND-BY-ROWID() method (KW_FIND_BR).
|
logical |
findByRowID(rowid id,
NumberType lock,
NumberType nowait)
Conversion of FIND-BY-ROWID() method (KW_FIND_BR).
|
logical |
findCurrent()
Conversion of the FIND-CURRENT() method.
|
logical |
findCurrent(LockType lockType)
Conversion of the FIND-CURRENT() method.
|
logical |
findCurrent(LockType lockType,
long noWait)
Conversion of the FIND-CURRENT() method.
|
logical |
findCurrent(LockType lockType,
NumberType noWait)
Conversion of the FIND-CURRENT() method.
|
logical |
findCurrent(long lock)
Conversion of the FIND-CURRENT() method.
|
logical |
findCurrent(long lock,
long noWait)
Conversion of the FIND-CURRENT() method.
|
logical |
findCurrent(long lock,
NumberType noWait)
Conversion of the FIND-CURRENT() method.
|
logical |
findCurrent(NumberType lock)
Conversion of the FIND-CURRENT() method.
|
logical |
findCurrent(NumberType lock,
long noWait)
Conversion of the FIND-CURRENT() method.
|
logical |
findCurrent(NumberType lock,
NumberType noWait)
Conversion of the FIND-CURRENT() method.
|
logical |
findFirst()
Conversion of FIND-FIRST() method (KW_FIND_1ST).
|
logical |
findFirst(character whereClause)
Conversion of FIND-FIRST() method (KW_FIND_1ST).
|
logical |
findFirst(character whereClause,
LockType lockType)
Conversion of FIND-FIRST() method (KW_FIND_1ST).
|
logical |
findFirst(character whereClause,
long lock)
Conversion of FIND-FIRST() method (KW_FIND_1ST).
|
logical |
findFirst(character whereClause,
long lock,
long nowait)
Conversion of FIND-FIRST() method (KW_FIND_1ST).
|
logical |
findFirst(character whereClause,
long lock,
NumberType nowait)
Conversion of FIND-FIRST() method (KW_FIND_1ST).
|
logical |
findFirst(character whereClause,
NumberType lock)
Conversion of FIND-FIRST() method (KW_FIND_1ST).
|
logical |
findFirst(character whereClause,
NumberType lock,
long nowait)
Conversion of FIND-FIRST() method (KW_FIND_1ST).
|
logical |
findFirst(character whereClause,
NumberType lock,
NumberType nowait)
Conversion of FIND-FIRST() method (KW_FIND_1ST).
|
logical |
findLast()
Conversion of FIND-LAST() method (KW_FIND_LST).
|
logical |
findLast(character whereClause)
Conversion of FIND-LAST() method (KW_FIND_LST).
|
logical |
findLast(character whereClause,
LockType lockType)
Conversion of FIND-LAST() method (KW_FIND_LST).
|
logical |
findLast(character whereClause,
long lock)
Conversion of FIND-LAST() method (KW_FIND_LST).
|
logical |
findLast(character whereClause,
long lock,
long nowait)
Conversion of FIND-LAST() method (KW_FIND_LST).
|
logical |
findLast(character whereClause,
long lock,
NumberType nowait)
Conversion of FIND-LAST() method (KW_FIND_LST).
|
logical |
findLast(character whereClause,
NumberType lock)
Conversion of FIND-LAST() method (KW_FIND_LST).
|
logical |
findLast(character whereClause,
NumberType lock,
long nowait)
Conversion of FIND-LAST() method (KW_FIND_LST).
|
logical |
findLast(character whereClause,
NumberType lock,
NumberType nowait)
Conversion of FIND-LAST() method (KW_FIND_LST).
|
logical |
findUnique()
Conversion of FIND-UNIQUE() method (KW_FIND_UNI).
|
logical |
findUnique(character whereClause)
Conversion of FIND-UNIQUE() method (KW_FIND_UNI).
|
logical |
findUnique(character whereClause,
LockType lockType)
Conversion of FIND-UNIQUE() method (KW_FIND_UNI).
|
logical |
findUnique(character whereClause,
long lock)
Conversion of FIND-UNIQUE() method (KW_FIND_UNI).
|
logical |
findUnique(character whereClause,
long lock,
long nowait)
Conversion of FIND-UNIQUE() method (KW_FIND_UNI).
|
logical |
findUnique(character whereClause,
long lock,
NumberType nowait)
Conversion of FIND-UNIQUE() method (KW_FIND_UNI).
|
logical |
findUnique(character whereClause,
NumberType lock)
Conversion of FIND-UNIQUE() method (KW_FIND_UNI).
|
logical |
findUnique(character whereClause,
NumberType lock,
long nowait)
Conversion of FIND-UNIQUE() method (KW_FIND_UNI).
|
logical |
findUnique(character whereClause,
NumberType lock,
NumberType nowait)
Conversion of FIND-UNIQUE() method (KW_FIND_UNI).
|
logical |
isMultiTenant()
Getter for the IS-MULTI-TENANT attribute.
|
logical |
lastBatch()
Get the BUFFER:LAST-BATCH attribute.
|
void |
lastBatch(boolean lastBatch)
Set the BUFFER:LAST-BATCH attribute.
|
void |
lastBatch(logical lastBatch)
Set the BUFFER:LAST-BATCH attribute.
|
logical |
locked()
Indicate whether the last record retrieval attempt was denied because
the target record was locked.
|
logical |
markNew()
Creates a blank before-table record for each buffer record, with a
ROW-STATE of
ROW-CREATED for a table with only new data. |
logical |
markRowState(int64 newState)
Manually set the
ROW-STATE attribute for the current record/row. |
logical |
markRowState(int64 newState,
handle before)
Manually set the
ROW-STATE attribute for the current record/row. |
logical |
markRowState(long newState)
Manually set the
ROW-STATE attribute for the current record/row. |
logical |
markRowState(long newState,
handle before)
Manually set the
ROW-STATE attribute for the current record/row. |
void |
maximum(java.lang.String column,
NumberType num)
Aggregate method which finds the maximum value of a single column across rows in the table
backing this buffer.
|
void |
maximum(java.lang.String column,
NumberType num,
java.lang.String where)
Aggregate method which finds the maximum value of a single column across rows in the table
backing this buffer.
|
void |
maximum(java.lang.String column,
NumberType num,
java.lang.String where,
java.lang.Object... args)
Aggregate method which finds the maximum value of a single column across rows in the table
backing this buffer.
|
logical |
mergeRowChanges()
Merges single changed row of a single temp-table in a source
DataSet object loaded
with the GET-CHANGES() method into the corresponding rows of a single temp-table
into the original (target) DataSet buffer. |
logical |
mergeRowChanges(handle original)
Merges single changed row of a single temp-table in a source
DataSet object loaded
with the GET-CHANGES() method into the corresponding rows of a single temp-table
into the original (target) DataSet buffer. |
logical |
mergeRowChanges(handle original,
boolean allCopyMode)
Merges single changed row of a single temp-table in a source
DataSet object loaded
with the GET-CHANGES() method into the corresponding rows of a single temp-table
into the original (target) DataSet buffer. |
logical |
mergeRowChanges(handle original,
logical allCopyMode)
Merges single changed row of a single temp-table in a source
DataSet object loaded
with the GET-CHANGES() method into the corresponding rows of a single temp-table
into the original (target) DataSet buffer. |
void |
minimum(java.lang.String column,
NumberType num)
Aggregate method which finds the minimum value of a single column across rows in the table
backing this buffer.
|
void |
minimum(java.lang.String column,
NumberType num,
java.lang.String where)
Aggregate method which finds the minimum value of a single column across rows in the table
backing this buffer.
|
void |
minimum(java.lang.String column,
NumberType num,
java.lang.String where,
java.lang.Object... args)
Aggregate method which finds the minimum value of a single column across rows in the table
backing this buffer.
|
logical |
newlyCreated()
Indicate whether the buffer associated currently contains a record, and
whether that record is transient.
|
integer |
numChildRelations()
Counts the relations for which the buffer is the parent.
|
integer |
numFields()
Conversion of NUM-FIELDS attribute (KW_NUM_FLD).
|
rowid |
originRowid()
Obtain the
rowid of the row in the original before-image table that corresponds to
the row in the change table currently associated with this buffer handle. |
handle |
parentRelation()
Obtain the handle to the parent data-relation object for the parent of this buffer.
|
logical |
querySynchronize()
Definition of the SYNCHRONIZE method.
|
void |
rawCopyFrom(FieldReference field)
Perform a RAW-TRANSFER operation from the given raw field into this buffer.
|
boolean |
rawCopyFrom(raw field)
Perform a RAW-TRANSFER operation from the given raw field into this buffer.
|
boolean |
rawCopyTo(Buffer buffer)
Perform a RAW-TRANSFER operation from this buffer to the given buffer.
|
void |
rawCopyTo(FieldReference field)
Perform a RAW-TRANSFER operation from this buffer to the given field, which should be of
type
raw . |
void |
rawCopyTo(raw field)
Perform a RAW-TRANSFER operation from this buffer to the given raw variable.
|
logical |
rawTransfer(boolean toMode,
handle h)
RAW-TRANSFER() method implementation that maps its processing to the same methods used
for implementation of the RAW-TRANSFER statement.
|
logical |
rawTransfer(logical toMode,
handle h)
RAW-TRANSFER() method implementation that maps its processing to the same methods used
for implementation of the RAW-TRANSFER statement.
|
recid |
recordID()
Get the record ID of the current buffer's current record, if any.
|
integer |
recordLength()
Conversion of the RECORD-LENGTH built-in function.
|
logical |
rejectRowChanges()
Rejects changes to the data in one row of this
DataSet temp-table. |
void |
release()
Validate and release the record currently in the buffer, if any.
|
rowid |
rowID()
Get the row ID of the current buffer's current record, if any.
|
integer |
rowState()
Obtain the current change state of the
DataSet temp-table row associated with this
buffer object. |
logical |
saveRowChanges()
Saves changes from one row of the
DataSet temp-table to the associated data
source. |
logical |
saveRowChanges(NumberType buffIndex)
Saves changes from one row of the
DataSet temp-table to the associated data source. |
logical |
saveRowChanges(NumberType buffIndex,
Text skipList)
Saves changes from one row of the
DataSet temp-table to the associated data source. |
logical |
saveRowChanges(NumberType buffIndex,
Text skipList,
logical noLobs)
Saves changes from one row of the
DataSet temp-table to the associated data source. |
logical |
saveRowChanges(Text buffName)
Saves changes from one row of the
DataSet temp-table to the associated data source. |
logical |
saveRowChanges(Text buffName,
Text skipList)
Saves changes from one row of the
DataSet temp-table to the associated data source. |
logical |
saveRowChanges(Text buffName,
Text skipList,
logical noLobs)
Saves changes from one row of the
DataSet temp-table to the associated data source. |
logical |
saveRowChanges(unknown buffInfo,
Text skipList)
Saves changes from one row of the
DataSet temp-table to the associated data source. |
logical |
saveRowChanges(unknown buffInfo,
Text skipList,
logical noLobs)
Saves changes from one row of the
DataSet temp-table to the associated data source. |
logical |
serializeRow(character targetFormat,
TargetData target)
Definition of the SERIALIZE-ROW method.
|
logical |
serializeRow(character targetFormat,
TargetData target,
logical formatted)
Definition of the SERIALIZE-ROW method.
|
logical |
serializeRow(character targetFormat,
TargetData target,
logical formatted,
character encoding)
Definition of the SERIALIZE-ROW method.
|
logical |
serializeRow(character targetFormat,
TargetData target,
logical formatted,
character encoding,
logical omitInitialValues)
Definition of the SERIALIZE-ROW method.
|
logical |
serializeRow(character targetFormat,
TargetData target,
logical formatted,
character encoding,
logical omitInitialValues,
logical omitOuterObject)
Definition of the SERIALIZE-ROW method.
|
void |
setMultiTenant(boolean l)
Setter for the IS-MULTI-TENANT attribute.
|
void |
setMultiTenant(logical l)
Setter for the IS-MULTI-TENANT attribute.
|
void |
sum(java.lang.String column,
NumberType num)
Aggregate method which sums the values of a single column across rows in the table
backing this buffer.
|
void |
sum(java.lang.String column,
NumberType num,
java.lang.String where)
Aggregate method which sums the values of a single column across rows in the table
backing this buffer.
|
void |
sum(java.lang.String column,
NumberType num,
java.lang.String where,
java.lang.Object... args)
Aggregate method which sums the values of a single column across rows in the table
backing this buffer.
|
handle |
tableHandle()
Conversion of TABLE-HANDLE attribute (KW_TAB_HAND).
|
void |
validate()
Validate the record currently in the buffer, if any.
|
getADMData, setADMData, setADMData
defaultBufferHandle
applyCallback, applyCallback, getCallbackProcContext, getCallbackProcContext, getCallbackProcName, getCallbackProcName, setCallback, setCallback, setCallback, setCallback, setCallback, setCallback, setCallback, setCallbackProcedure, setCallbackProcedure, setCallbackProcedure, setCallbackProcedure, setCallbackProcedure, setCallbackProcedure, setCallbackProcedure, setCallbackProcedure
getDbName, getTable
isDataSourceModified, isDataSourceModified, setDataSourceModified, setDataSourceModified
acceptChanges, getChanges, getChanges, getChanges, mergeChanges, mergeChanges, mergeChanges, rejectChanges
dereference, dereference, dereference, dereference, dereference, dereference, dereference
_dynamic, dynamic
deleteAll
changeErrorString, errorString
fill, fillMode, fillMode, fillMode
indexInformation, indexInformation, indexInformation
instantiatingProcedure
currentIteration, setCurrentIteration
readJson, readJson, writeJson, writeJson, writeJson, writeJson, writeJson, writeJson
getSerializeName, setSerializeName, setSerializeName
namespacePrefix, namespacePrefix, namespacePrefix, namespaceURI, namespaceURI, namespaceURI
getQueryAsHandle, setQueryAsHandle, setQueryAsHandle
rejected, rejected, rejected
copyTempTable, copyTempTable, copyTempTable, copyTempTable, copyTempTable, copyTempTable, copyTempTable, copyTempTable, copyTempTable
getUniqueID
id, id, unknown, valid
readXml, readXml, readXml, readXmlSchema, readXmlSchema, readXmlSchema, writeXml, writeXml, writeXml, writeXml, writeXml, writeXml, writeXml, writeXml, writeXmlSchema, writeXmlSchema, writeXmlSchema, writeXmlSchema, writeXmlSchema
static final java.lang.String __ERROR_FLAG__
static final java.lang.String ERROR_FLAG_FIELD
static final java.lang.String __DATA_SOURCE_ROWID__
static final java.lang.String DATA_SOURCE_ROWID_FIELD
static final java.lang.String __ORIGIN_ROWID__
static final java.lang.String ORIGIN_ROWID_FIELD
static final java.lang.String __ERROR_STRING__
static final java.lang.String ERROR_STRING_FIELD
static final java.lang.String __AFTER_ROWID__
static final java.lang.String AFTER_ROWID_FIELD
static final java.lang.String __ROW_STATE__
static final java.lang.String ROW_STATE_FIELD
static final java.lang.String ROW_STATE_IDX
static final int ROW_UNMODIFIED
static final int ROW_DELETED
static final int ROW_MODIFIED
static final int ROW_CREATED
static final int ERROR_ERROR
__ERROR_FLAG__
attribute.static final int ERROR_REJECTED
__ERROR_FLAG__
attribute.static final java.lang.String BEFORE_FILL_EVENT
BEFORE-FILL
event string constant in upper case.static final java.lang.String AFTER_FILL_EVENT
AFTER-FILL
event string constant in upper case.static final java.lang.String BEFORE_ROW_FILL_EVENT
BEFORE-ROW-FILL
event string constant in upper case.static final java.lang.String AFTER_ROW_FILL_EVENT
AFTER-ROW-FILL
event string constant in upper case.static final java.lang.String ROW_CREATE_EVENT
ROW-CREATE
event string constant in upper case.static final java.lang.String ROW_DELETE_EVENT
ROW-DELETE
event string constant in upper case.static final java.lang.String ROW_UPDATE_EVENT
ROW-UPDATE
event string constant in upper case.static final java.lang.String FIND_FAILED_EVENT
FIND-FAILED
event string constant in upper case.static final java.lang.String SYNCHRONIZE_EVENT
SYNCHRONIZE
event string constant in upper case.logical lastBatch()
void lastBatch(boolean lastBatch)
lastBatch
- The flag state.void lastBatch(logical lastBatch)
lastBatch
- The flag state.recid recordID()
This method will return a 32-bit recid which represents the internal row ID of the given record. If the actual row ID (which is implemented as a wider integer) cannot fit due to overflow, an error condition will be raised.
dmo
, a recid
initialized as unknown value is returned.ErrorConditionException
- if the actual record ID is too wide to fit within a 32-bit
integer.rowid rowID()
dmo
, a
rowid
initialized as unknown value is returned.boolean _available()
true
if data is available, false
if
no record backs this buffer.logical currentChanged()
FIND CURRENT
or GET CURRENT
.
P2J implementation of 4GL method and function CURRENT-CHANGED
.true
if the database record differs from the
value in memory buffer that was queried with the last
FIND
and false
otherwiseboolean _currentChanged()
FIND CURRENT
or GET CURRENT
.
P2J implementation of 4GL function CURRENT-CHANGED
.true
if the database record differs from the
value in memory buffer that was queried with the last
FIND
and false
otherwiselogical newlyCreated()
true
if a record exists and is new, else
false
.boolean _newlyCreated()
true
if a record exists and is new, else
false
.logical locked()
true
if the record was locked; false
if the attempt succeeded, or if this query has not yet
attempted to retrieve a record.boolean _locked()
true
if the record was locked; false
if the attempt succeeded, or if this query has not yet
attempted to retrieve a record.logical ambiguous()
true
if the query was ambiguous;
false
if the attempt succeeded, or if no attempt
has yet been made.boolean _ambiguous()
true
if the query was ambiguous;
false
if the attempt succeeded, or if no attempt
has yet been made.void rawCopyTo(raw field)
field
- A raw
field to which to copy the record in this buffer.void rawCopyTo(FieldReference field)
raw
. Serializes the record currently in the buffer into the specified
field.field
- A raw
field to which to copy the record in this buffer.boolean rawCopyTo(Buffer buffer)
buffer
- A buffer into which to copy the record in this buffer.true
if successfulvoid rawCopyFrom(FieldReference field)
field
- A raw
field from which to copy the record into this buffer.boolean rawCopyFrom(raw field)
field
- A raw
field from which to copy the record into this buffer.true
if successfullogical rawTransfer(boolean toMode, handle h)
toMode
- true
if the copy direction is into the handle's resource and false
if the data is being copied into the buffer.h
- A buffer or raw buffer field.true
if RAW-TRANSFER() succeeds, else false
.logical rawTransfer(logical toMode, handle h)
toMode
- true
if the copy direction is into the handle's resource and false
if the data is being copied into the buffer.h
- A buffer or raw buffer field.true
if RAW-TRANSFER() succeeds, else false
.void create()
ErrorConditionException
- if there is an error retrieving the next available primary key
from the database or locking the record.logical deleteRecord()
true
if the delete was possible.ErrorConditionException
- if no record currently is loaded in the buffer, or if there is
an error deleting the current record from the database.logical deleteRecord(java.util.function.Supplier<logical> valexp, java.lang.String valmsg)
true
.valexp
- The validation expression to evaluate.valmsg
- The error message to display when validation fails.true
if validation succeeds, false
if it fails and no
exception is raised.ErrorConditionException
- If no record currently is loaded in the buffer, or if there is an error deleting
the current record from the database or if the validation expression fails.logical deleteRecord(java.util.function.Supplier<logical> valexp, java.util.function.Supplier<character> valmsg)
true
.valexp
- The validation expression to evaluate.valmsg
- The error message to display when validation fails.true
if validation succeeds, false
if it fails and no
exception is raised.ErrorConditionException
- If no record currently is loaded in the buffer, or if there is an error deleting
the current record from the database or if the validation expression fails.void delete(java.lang.String where, java.lang.Object... args)
NOTE: the current implementation must not be invoked for a DMO which is backed by a permanent table; only temp-table bulk delete is supported at this time.
where
- An HQL where clause snippet which defines the restriction
criteria to apply to the delete. All references to properties
in a DMO must be unqualified.args
- Query substitution parameters required by the where clause.ErrorConditionException
- if there is an error deleting the records.java.lang.UnsupportedOperationException
- if invoked on a buffer associated with a permanent table.void delete(DataModelObject[] suppDMOs, java.lang.String where, java.lang.Object... args)
NOTE: the current implementation must not be invoked for a DMO which is backed by a permanent table; only temp-table bulk delete is supported at this time.
suppDMOs
- The DMOs for the external (additional) buffers that are accessed in inner
subselect, or null
in case of a simple where
predicate.where
- An HQL where clause snippet which defines the restriction
criteria to apply to the delete. All references to properties
in a DMO must be unqualified.args
- Query substitution parameters required by the where clause.ErrorConditionException
- if there is an error deleting the records.java.lang.UnsupportedOperationException
- if invoked on a buffer associated with a permanent table.void average(java.lang.String column, NumberType num)
column
- An expression indicating the name of the column to aggregate.num
- Variable into which to store the aggregate result.ErrorConditionException
- if an error occurs performing the aggregate operation.void average(java.lang.String column, NumberType num, java.lang.String where)
column
- An expression indicating the name of the column to aggregate.num
- Variable into which to store the aggregate result.where
- HQL where clause used to filter the records.ErrorConditionException
- if an error occurs performing the aggregate operation.void average(java.lang.String column, NumberType num, java.lang.String where, java.lang.Object... args)
column
- An expression indicating the name of the column to aggregate.num
- Variable into which to store the aggregate result.where
- HQL where clause used to filter the records.args
- Query substitution arguments.ErrorConditionException
- if an error occurs performing the aggregate operation.void count(java.lang.String column, NumberType num)
column
- An expression indicating the name of the column to aggregate. May be the wildcard
character ("*").num
- Variable into which to store the aggregate result.ErrorConditionException
- if an error occurs performing the aggregate operation.void count(java.lang.String column, NumberType num, java.lang.String where)
column
- An expression indicating the name of the column to aggregate. May be the wildcard
character ("*").num
- Variable into which to store the aggregate result.where
- HQL where clause used to filter the records.ErrorConditionException
- if an error occurs performing the aggregate operation.void count(java.lang.String column, NumberType num, java.lang.String where, java.lang.Object... args)
column
- An expression indicating the name of the column to aggregate. May be the wildcard
character ("*").num
- Variable into which to store the aggregate result.where
- HQL where clause used to filter the records.args
- Query substitution arguments.ErrorConditionException
- if an error occurs performing the aggregate operation.void minimum(java.lang.String column, NumberType num)
column
- An expression indicating the name of the column to aggregate.num
- Variable into which to store the aggregate result.ErrorConditionException
- if an error occurs performing the aggregate operation.void minimum(java.lang.String column, NumberType num, java.lang.String where)
column
- An expression indicating the name of the column to aggregate.num
- Variable into which to store the aggregate result.where
- HQL where clause used to filter the records.ErrorConditionException
- if an error occurs performing the aggregate operation.void minimum(java.lang.String column, NumberType num, java.lang.String where, java.lang.Object... args)
column
- An expression indicating the name of the column to aggregate.num
- Variable into which to store the aggregate result.where
- HQL where clause used to filter the records.args
- Query substitution arguments.ErrorConditionException
- if an error occurs performing the aggregate operation.void maximum(java.lang.String column, NumberType num)
column
- An expression indicating the name of the column to aggregate.num
- Variable into which to store the aggregate result.ErrorConditionException
- if an error occurs performing the aggregate operation.void maximum(java.lang.String column, NumberType num, java.lang.String where)
column
- An expression indicating the name of the column to aggregate.num
- Variable into which to store the aggregate result.where
- HQL where clause used to filter the records.ErrorConditionException
- if an error occurs performing the aggregate operation.void maximum(java.lang.String column, NumberType num, java.lang.String where, java.lang.Object... args)
column
- An expression indicating the name of the column to aggregate.num
- Variable into which to store the aggregate result.where
- HQL where clause used to filter the records.args
- Query substitution arguments.ErrorConditionException
- if an error occurs performing the aggregate operation.void sum(java.lang.String column, NumberType num)
column
- An expression indicating the name of the column to aggregate.num
- Variable into which to store the aggregate result.ErrorConditionException
- if an error occurs performing the aggregate operation.void sum(java.lang.String column, NumberType num, java.lang.String where)
column
- An expression indicating the name of the column to aggregate.num
- Variable into which to store the aggregate result.where
- HQL where clause used to filter the records.ErrorConditionException
- if an error occurs performing the aggregate operation.void sum(java.lang.String column, NumberType num, java.lang.String where, java.lang.Object... args)
column
- An expression indicating the name of the column to aggregate.num
- Variable into which to store the aggregate result.where
- HQL where clause used to filter the records.args
- Query substitution arguments.ErrorConditionException
- if an error occurs performing the aggregate operation.void release()
ErrorConditionException
- if the buffer fails validation.void validate()
ErrorConditionException
- if the buffer fails validation.logical bufferValidate()
true
if the validation passes.integer recordLength()
handle bufferField(int fieldNumber)
fieldNumber
- An INTEGER expression representing the sequence number of the field in the buffer.handle bufferField(NumberType fieldNumber)
fieldNumber
- An INTEGER expression representing the sequence number of the field in the buffer.handle bufferField(java.lang.String fieldName)
fieldName
- A string expression representing the name of the field in the buffer.handle bufferField(character fieldName)
fieldName
- A CHARACTER string expression representing the name of the field in the buffer.handle bufferField(BaseDataType fieldName)
fieldName
- A CHARACTER string expression representing the name of the field in the buffer.logical bufferCopy(Buffer buffer)
buffer
- The source buffer to copy from.true
if BUFFER-COPY() succeeds, else false
.logical bufferCopy(Buffer buffer, character except)
buffer
- The source buffer to copy from.except
- A comma-separated list of fields that will be ignored in the copy process.true
if BUFFER-COPY() succeeds, else false
.logical bufferCopy(Buffer buffer, character except, character pairs)
buffer
- The source buffer to copy from.except
- A comma-separated list of fields that will be ignored in the copy process.pairs
- A comma-separated list of field-name pairs to be copied. Each pair must contain
one field name from the source and one field name from the target.true
if BUFFER-COPY() succeeds, else false
.logical bufferCopy(Buffer buffer, character except, character pairs, logical noLobs)
buffer
- The source buffer to copy from.except
- A comma-separated list of fields that will be ignored in the copy process.pairs
- A comma-separated list of field-name pairs to be copied. Each pair must contain
one field name from the source and one field name from the target.noLobs
- If TRUE
, BLOB and CLOB fields are ignored during the copy.true
if BUFFER-COPY() succeeds, else false
.logical bufferCopy(handle bufHandle)
bufHandle
- The handle of the source buffer to copy from.true
if BUFFER-COPY() succeeds, else false
.logical bufferCopy(handle bufHandle, character except)
bufHandle
- The handle of the source buffer to copy from.except
- A comma-separated list of fields that will be ignored in the copy process.true
if BUFFER-COPY() succeeds, else false
.logical bufferCopy(handle bufHandle, character except, character pairs)
bufHandle
- The handle of the source buffer to copy from.except
- A comma-separated list of fields that will be ignored in the copy process.pairs
- A comma-separated list of field-name pairs to be copied. Each pair must contain
one field name from the source and one field name from the target.true
if BUFFER-COPY() succeeds, else false
.logical bufferCopy(handle bufHandle, character except, character pairs, logical noLobs)
bufHandle
- The handle of the source buffer to copy from.except
- A comma-separated list of fields that will be ignored in the copy process.pairs
- A comma-separated list of field-name pairs to be copied. Each pair must contain
one field name from the source and one field name from the target.noLobs
- If TRUE
, BLOB and CLOB fields are ignored during the copy.true
if BUFFER-COPY() succeeds, else false
.logical bufferCompare(Buffer buffer)
buffer
- Buffer with which to compare.true
if BUFFER-COMPARE() succeeds,
else false
.logical bufferCompare(Buffer buffer, character mode)
buffer
- Buffer with which to compare.mode
- The text "binary" or "case-sensitive", to provide that type of comparison.true
if BUFFER-COMPARE() succeeds,
else false
.logical bufferCompare(Buffer buffer, character mode, character except)
buffer
- Buffer with which to compare.mode
- The text "binary" or "case-sensitive", to provide that type of comparison.except
- A comma-separated list of fields that will be ignored in the compare process.true
if BUFFER-COMPARE() succeeds,
else false
.logical bufferCompare(Buffer buffer, character mode, character except, character pairs)
buffer
- Buffer with which to compare.mode
- The text "binary" or "case-sensitive", to provide that type of comparison.except
- A comma-separated list of fields that will be ignored in the compare process.pairs
- A comma-separated list of field-name pairs to be compared. Each pair must contain
one field name from the source and one field name from the target.true
if BUFFER-COMPARE() succeeds,
else false
.logical bufferCompare(Buffer buffer, character mode, character except, character pairs, logical noLobs)
buffer
- Buffer with which to compare.mode
- The text "binary" or "case-sensitive", to provide that type of comparison.except
- A comma-separated list of fields that will be ignored in the compare process.pairs
- A comma-separated list of field-name pairs to be compared. Each pair must contain
one field name from the source and one field name from the target.noLobs
- If TRUE
, BLOB and CLOB fields are ignored during the copy.true
if BUFFER-COMPARE() succeeds,
else false
.logical bufferCompare(handle bufHandle)
bufHandle
- Handle of buffer with which to compare.true
if BUFFER-COMPARE() succeeds,
else false
.logical bufferCompare(handle bufHandle, character mode)
bufHandle
- Handle of buffer with which to compare.mode
- The text "binary" or "case-sensitive", to provide that type of comparison.true
if BUFFER-COMPARE() succeeds,
else false
.logical bufferCompare(handle bufHandle, character mode, character except)
bufHandle
- Handle of buffer with which to compare.mode
- The text "binary" or "case-sensitive", to provide that type of comparison.except
- A comma-separated list of fields that will be ignored in the compare process.true
if BUFFER-COMPARE() succeeds,
else false
.logical bufferCompare(handle bufHandle, character mode, character except, character pairs)
bufHandle
- Handle of buffer with which to compare.mode
- The text "binary" or "case-sensitive", to provide that type of comparison.except
- A comma-separated list of fields that will be ignored in the compare process.pairs
- A comma-separated list of field-name pairs to be compared. Each pair must contain
one field name from the source and one field name from the target.true
if BUFFER-COMPARE() succeeds,
else false
.logical bufferCompare(handle bufHandle, character mode, character except, character pairs, logical noLobs)
bufHandle
- Handle of buffer with which to compare.mode
- The text "binary" or "case-sensitive", to provide that type of comparison.except
- A comma-separated list of fields that will be ignored in the compare process.pairs
- A comma-separated list of field-name pairs to be compared. Each pair must contain
one field name from the source and one field name from the target.noLobs
- If TRUE
, BLOB and CLOB fields are ignored during the copy.true
if BUFFER-COMPARE() succeeds,
else false
.logical bufferCreate()
true
if successfullogical findFirst()
true
if FIND-FIRST() succeeds,
else false
.logical findFirst(character whereClause)
whereClause
- where clause, predicate-expression.true
if FIND-FIRST() succeeds,
else false
.logical findFirst(character whereClause, LockType lockType)
whereClause
- where clause, predicate-expression.lockType
- Lock typetrue
if FIND-FIRST() succeeds,
else false
.logical findFirst(character whereClause, long lock)
whereClause
- where clause, predicate-expression.lock
- SHARE-LOCK|EXCLUSIVE-LOCK|NO-LOCKtrue
if FIND-FIRST() succeeds,
else false
.logical findFirst(character whereClause, NumberType lock)
whereClause
- where clause, predicate-expression.lock
- SHARE-LOCK|EXCLUSIVE-LOCK|NO-LOCKtrue
if FIND-FIRST() succeeds,
else false
.logical findFirst(character whereClause, long lock, long nowait)
whereClause
- where clause, predicate-expression.lock
- SHARE-LOCK|EXCLUSIVE-LOCK|NO-LOCKnowait
- NO-WAITtrue
if FIND-FIRST() succeeds,
else false
.logical findFirst(character whereClause, NumberType lock, long nowait)
whereClause
- where clause, predicate-expression.lock
- SHARE-LOCK|EXCLUSIVE-LOCK|NO-LOCKnowait
- NO-WAITtrue
if FIND-FIRST() succeeds,
else false
.logical findFirst(character whereClause, long lock, NumberType nowait)
whereClause
- where clause, predicate-expression.lock
- SHARE-LOCK|EXCLUSIVE-LOCK|NO-LOCKnowait
- NO-WAITtrue
if FIND-FIRST() succeeds,
else false
.logical findFirst(character whereClause, NumberType lock, NumberType nowait)
whereClause
- where clause, predicate-expression.lock
- SHARE-LOCK|EXCLUSIVE-LOCK|NO-LOCKnowait
- NO-WAITtrue
if FIND-FIRST() succeeds,
else false
.logical findLast()
true
if FIND-LAST() succeeds,
else false
.logical findLast(character whereClause)
whereClause
- where clause, predicate-expression.true
if FIND-LAST() succeeds,
else false
.logical findLast(character whereClause, LockType lockType)
whereClause
- where clause, predicate-expression.lockType
- Lock typetrue
if FIND-LAST() succeeds,
else false
.logical findLast(character whereClause, long lock)
whereClause
- where clause, predicate-expression.lock
- SHARE-LOCK|EXCLUSIVE-LOCK|NO-LOCKtrue
if FIND-LAST() succeeds,
else false
.logical findLast(character whereClause, NumberType lock)
whereClause
- where clause, predicate-expression.lock
- SHARE-LOCK|EXCLUSIVE-LOCK|NO-LOCKtrue
if FIND-LAST() succeeds,
else false
.logical findLast(character whereClause, long lock, long nowait)
whereClause
- where clause, predicate-expression.lock
- SHARE-LOCK|EXCLUSIVE-LOCK|NO-LOCKnowait
- NO-WAITtrue
if FIND-LAST() succeeds,
else false
.logical findLast(character whereClause, NumberType lock, long nowait)
whereClause
- where clause, predicate-expression.lock
- SHARE-LOCK|EXCLUSIVE-LOCK|NO-LOCKnowait
- NO-WAITtrue
if FIND-LAST() succeeds,
else false
.logical findLast(character whereClause, long lock, NumberType nowait)
whereClause
- where clause, predicate-expression.lock
- SHARE-LOCK|EXCLUSIVE-LOCK|NO-LOCKnowait
- NO-WAITtrue
if FIND-LAST() succeeds,
else false
.logical findLast(character whereClause, NumberType lock, NumberType nowait)
whereClause
- where clause, predicate-expression.lock
- SHARE-LOCK|EXCLUSIVE-LOCK|NO-LOCKnowait
- NO-WAITtrue
if FIND-LAST() succeeds,
else false
.logical findUnique()
true
if FIND-UNIQUE() succeeds,
else false
.logical findUnique(character whereClause)
whereClause
- where clause, predicate-expression.true
if FIND-UNIQUE() succeeds,
else false
.logical findUnique(character whereClause, LockType lockType)
whereClause
- where clause, predicate-expression.lockType
- Lock typetrue
if FIND-UNIQUE() succeeds,
else false
.logical findUnique(character whereClause, long lock)
whereClause
- where clause, predicate-expression.lock
- SHARE-LOCK|EXCLUSIVE-LOCK|NO-LOCKtrue
if FIND-UNIQUE() succeeds,
else false
.logical findUnique(character whereClause, NumberType lock)
whereClause
- where clause, predicate-expression.lock
- SHARE-LOCK|EXCLUSIVE-LOCK|NO-LOCKtrue
if FIND-UNIQUE() succeeds,
else false
.logical findUnique(character whereClause, long lock, long nowait)
whereClause
- where clause, predicate-expression.lock
- SHARE-LOCK|EXCLUSIVE-LOCK|NO-LOCKnowait
- NO-WAITtrue
if FIND-UNIQUE() succeeds,
else false
.logical findUnique(character whereClause, NumberType lock, long nowait)
whereClause
- where clause, predicate-expression.lock
- SHARE-LOCK|EXCLUSIVE-LOCK|NO-LOCKnowait
- NO-WAITtrue
if FIND-UNIQUE() succeeds,
else false
.logical findUnique(character whereClause, long lock, NumberType nowait)
whereClause
- where clause, predicate-expression.lock
- SHARE-LOCK|EXCLUSIVE-LOCK|NO-LOCKnowait
- NO-WAITtrue
if FIND-UNIQUE() succeeds,
else false
.logical findUnique(character whereClause, NumberType lock, NumberType nowait)
whereClause
- where clause, predicate-expression.lock
- SHARE-LOCK|EXCLUSIVE-LOCK|NO-LOCKnowait
- NO-WAITtrue
if FIND-UNIQUE() succeeds,
else false
.logical findCurrent()
true
if FIND-CURRENT() succeeds (the lock type is changed), else false
.logical findCurrent(LockType lockType)
lockType
- Lock type.true
if FIND-CURRENT() succeeds (the lock type is changed), else false
.logical findCurrent(NumberType lock)
lock
- Lock type.true
if FIND-CURRENT() succeeds (the lock type is changed), else false
.logical findCurrent(long lock)
lock
- Lock type.true
if FIND-CURRENT() succeeds (the lock type is changed), else false
.logical findCurrent(LockType lockType, long noWait)
lockType
- Lock type.noWait
- Zero to lock without waiting; non-zero to wait to acquire the lock.true
if FIND-CURRENT() succeeds (the lock type is changed), else false
.logical findCurrent(NumberType lock, long noWait)
lock
- Lock type.noWait
- Zero to lock without waiting; non-zero to wait to acquire the lock.true
if FIND-CURRENT() succeeds (the lock type is changed), else false
.logical findCurrent(long lock, long noWait)
lock
- Lock type.noWait
- Zero to lock without waiting; non-zero to wait to acquire the lock.true
if FIND-CURRENT() succeeds (the lock type is changed), else false
.logical findCurrent(LockType lockType, NumberType noWait)
lockType
- Lock type.noWait
- Zero or unknown value to lock without waiting; non-zero to wait to acquire the
lock.true
if FIND-CURRENT() succeeds (the lock type is changed), else false
.logical findCurrent(NumberType lock, NumberType noWait)
lock
- Lock type.noWait
- Zero or unknown value to lock without waiting; non-zero to wait to acquire the
lock.true
if FIND-CURRENT() succeeds (the lock type is changed), else false
.logical findCurrent(long lock, NumberType noWait)
lock
- Lock type.noWait
- Zero or unknown value to lock without waiting; non-zero to wait to acquire the
lock.true
if FIND-CURRENT() succeeds (the lock type is changed), else false
.logical bufferRelease()
true
if BUFFER-RELEASE() succeeds,
else false
.logical findByRowID(rowid id)
id
- An expression of type ROWID that represents the rowid of the
desired record.true
if it finds the record, else
false
.logical findByRowID(rowid id, LockType lockType)
id
- An expression of type ROWID that represents the rowid of the
desired record.lockType
- Lock typetrue
if it finds the record, else
false
.logical findByRowID(rowid id, long lock)
id
- An expression of type ROWID that represents the rowid of the
desired record.lock
- SHARE-LOCK|EXCLUSIVE-LOCK|NO-LOCKtrue
if it finds the record, else
false
.logical findByRowID(rowid id, NumberType lock)
id
- An expression of type ROWID that represents the rowid of the
desired record.lock
- SHARE-LOCK|EXCLUSIVE-LOCK|NO-LOCKtrue
if it finds the record, else
false
.logical findByRowID(rowid id, long lock, long nowait)
id
- An expression of type ROWID that represents the rowid of the
desired record.lock
- SHARE-LOCK|EXCLUSIVE-LOCK|NO-LOCKnowait
- NO-WAITtrue
if it finds the record, else
false
.logical findByRowID(rowid id, NumberType lock, long nowait)
id
- An expression of type ROWID that represents the rowid of the
desired record.lock
- SHARE-LOCK|EXCLUSIVE-LOCK|NO-LOCKnowait
- NO-WAITtrue
if it finds the record, else
false
.logical findByRowID(rowid id, long lock, NumberType nowait)
id
- An expression of type ROWID that represents the rowid of the
desired record.lock
- SHARE-LOCK|EXCLUSIVE-LOCK|NO-LOCKnowait
- NO-WAITtrue
if it finds the record, else
false
.logical findByRowID(rowid id, NumberType lock, NumberType nowait)
id
- An expression of type ROWID that represents the rowid of the
desired record.lock
- SHARE-LOCK|EXCLUSIVE-LOCK|NO-LOCKnowait
- NO-WAITtrue
if it finds the record, else
false
.integer numFields()
void disableDumpTriggers()
void disableLoadTriggers(boolean allowReplication)
allowReplication
- If true
then only CREATE, DELETE, ASSIGN and WRITE triggers are
disabled, and not REPLICATION-CREATE, REPLICATION-DELETE and REPLICATION-WRITE
triggers.handle tableHandle()
integer batchSize()
DataSet
temp-table rows to retrieve in each FILL
operation. The default value is zero (which retrieves all rows that satisfy the associated
query).FILL
operation.void batchSize(long size)
DataSet
temp-table rows to retrieve in each FILL
operation.size
- The new value for the BATCH-SIZE
attribute.void batchSize(NumberType size)
DataSet
temp-table rows to retrieve in each FILL
operation.size
- The new value for the BATCH-SIZE
attribute.rowid afterRowid()
ROWID
of the row in the after-image table that is the current version of
the row in the before-image table currently associated with this buffer. This row can
be a new or modified row.ROWID
of the row in the after-image table that is the current version
of the row in the before-image tablerowid beforeRowid()
ROWID
of the row in the before-image table that is the current version of
the row in the before-image table currently associated with this buffer. This row can
be a new or modified row.ROWID
of the row in the before-image table that is the current version
of the row in the before-image tableinteger rowState()
DataSet
temp-table row associated with this
buffer object.DataSet
temp-table row associated with this
buffer object.logical acceptRowChanges()
DataSet
temp-table.true
on success.logical rejectRowChanges()
DataSet
temp-table.true
on success.logical saveRowChanges()
DataSet
temp-table to the associated data
source.true
on success.logical saveRowChanges(NumberType buffIndex)
DataSet
temp-table to the associated data source.buffIndex
- The index of the buffer in the data source.true
on success.logical saveRowChanges(Text buffName)
DataSet
temp-table to the associated data source.buffName
- The name of the buffer in the data source.true
on success.logical saveRowChanges(NumberType buffIndex, Text skipList)
DataSet
temp-table to the associated data source.buffIndex
- The index of the buffer in the data source.skipList
- A list of field names that should not be assigned after a new row is created
(comma-separated).true
on success.logical saveRowChanges(Text buffName, Text skipList)
DataSet
temp-table to the associated data source.buffName
- The name of the buffer in the data source.skipList
- A list of field names that should not be assigned after a new row is created
(comma-separated).true
on success.logical saveRowChanges(unknown buffInfo, Text skipList)
DataSet
temp-table to the associated data source.
Note: this form is used when unknown literal ?
is used to specify
the buffer. In either case, numeric or character, the meaning is the same.
buffInfo
- Unknown value.skipList
- A list of field names that should not be assigned after a new row is created
(comma-separated).true
on success.logical saveRowChanges(NumberType buffIndex, Text skipList, logical noLobs)
DataSet
temp-table to the associated data source.buffIndex
- The index of the buffer in the data source.skipList
- A list of field names that should not be assigned after a new row is created
(comma-separated).noLobs
- Use true
to specify the BLOB and CLOB fields should be ignored in the
save operation.true
on success.logical saveRowChanges(unknown buffInfo, Text skipList, logical noLobs)
DataSet
temp-table to the associated data source.
Note: this form is used when unknown literal ?
is used to specify
the buffer. In either case, numeric or character, the meaning is the same.
buffInfo
- Unknown value.skipList
- A list of field names that should not be assigned after a new row is created
(comma-separated).noLobs
- Use true
to specify the BLOB and CLOB fields should be ignored in the
save operation.true
on success.logical saveRowChanges(Text buffName, Text skipList, logical noLobs)
DataSet
temp-table to the associated data source.buffName
- The name of the buffer in the data source.skipList
- A list of field names that should not be assigned after a new row is created
(comma-separated).noLobs
- Use true
to specify the BLOB and CLOB fields should be ignored in the
save operation.true
on success.logical attachDataSource(handle ds)
DataSource
object to this temp-table Buffer
in a DataSet
object.ds
- The handle to the DataSource
to be attached.true
on success.logical attachDataSource(handle ds, character pairList)
DataSource
object to this temp-table Buffer
in a DataSet
object.ds
- The handle to the DataSource
to be attached.pairList
- A comma-delimited list of field name pairs that specify a mapping between different
field names in the DataSource
buffer and the DataSset
temp-table
buffer.true
on success.logical attachDataSource(handle ds, character pairList, character exceptFields)
DataSource
object to this temp-table Buffer
in a DataSet
object.ds
- The handle to the DataSource
to be attached.pairList
- A comma-delimited list of field name pairs that specify a mapping between different
field names in the DataSource
buffer and the DataSset
temp-table
buffer.exceptFields
- A comma-separated list of fields in the DataSet
object buffer that will not
be populated with data from the data source.true
on success.logical attachDataSource(handle ds, character pairList, character exceptFields, character includeFields)
DataSource
object to this temp-table Buffer
in a DataSet
object.ds
- The handle to the DataSource
to be attached.pairList
- A comma-delimited list of field name pairs that specify a mapping between different
field names in the DataSource
buffer and the DataSset
temp-table
buffer.exceptFields
- A comma-separated list of fields in the DataSet
object buffer that will not
be populated with data from the data source.includeFields
- A comma-separated list of fields to include in the DataSet
object buffer,
as an alternative to specifying fields to exclude in except-fields.true
on success.logical detachDataSource()
DataSource
from the temp-table buffer in a DataSet
object.true
on success.handle dataSource()
DataSource
object currently attached to the DataSet
object buffer.DATA-SOURCE
as described above.handle afterBuffer()
AFTER-BUFFER
attribute as described above.rowid originRowid()
rowid
of the row in the original before-image table that corresponds to
the row in the change table currently associated with this buffer handle.ORIGIN-ROWID
atribute as described above.handle beforeBuffer()
BEFORE-BUFFER
attribute as described above.character dataSourceCompleteMap()
DataSet
temp-table buffer that are mapped to corresponding fields in an attached data-source object.DATA-SOURCE-COMPLETE-MAP
attribute.rowid dataSourceRowid()
DataSource
row corresponding to this buffer object.DATA-SOURCE-ROWID
ABL attribute.rowid dataSourceRowid(int64 joinLevel)
DataSource
row corresponding to this buffer object.joinLevel
- The level of join, if the data-source is a join.DATA-SOURCE-ROWID
ABL attribute.rowid dataSourceRowid(character buffName)
DataSource
row corresponding to this buffer object.buffName
- The name of one of the data-source buffers.DATA-SOURCE-ROWID
ABL attribute.void dataSourceRowid(rowid val)
DataSource
row corresponding to this buffer object.val
- The new value of DATA-SOURCE-ROWID
ABL attribute.void dataSourceRowid(int64 joinLevel, rowid val)
DataSource
row corresponding to this buffer object.joinLevel
- The level of join, if the data-source is a join.val
- The new value of DATA-SOURCE-ROWID
ABL attribute.void dataSourceRowid(character buffName, rowid val)
DataSource
row corresponding to this buffer object.buffName
- The name of one of the data-source buffers.val
- The new value of DATA-SOURCE-ROWID
ABL attribute.handle dataSet()
DataSet
object of which the buffer is a member.DataSet
object of which the buffer is a member.integer numChildRelations()
NUM-CHILD-RELATIONS
attribute as described above.handle parentRelation()
PARENT-RELATION
attribute as described above.logical markNew()
ROW-STATE
of
ROW-CREATED
for a table with only new data.true
on success.logical markRowState(int64 newState)
ROW-STATE
attribute for the current record/row.newState
- The new state the record is marked with. Legal values: ROW_CREATED
,
ROW_MODIFIED
, ROW_DELETED
, and ROW_UNMODIFIED
.true
on success.logical markRowState(long newState)
ROW-STATE
attribute for the current record/row.newState
- The new state the record is marked with. Legal values: ROW_CREATED
,
ROW_MODIFIED
, ROW_DELETED
, and ROW_UNMODIFIED
.true
on success.logical markRowState(int64 newState, handle before)
ROW-STATE
attribute for the current record/row.newState
- The new state the record is marked with. Legal values: ROW_CREATED
,
ROW_MODIFIED
, ROW_DELETED
, and ROW_UNMODIFIED
.before
- A handle to the before-image source buffer.true
on success.logical markRowState(long newState, handle before)
ROW-STATE
attribute for the current record/row.newState
- The new state the record is marked with. Legal values: ROW_CREATED
,
ROW_MODIFIED
, ROW_DELETED
, and ROW_UNMODIFIED
.before
- A handle to the before-image source buffer.true
on success.handle childRelation(long index)
DataRelation
object for which the buffer is the parent.index
- The index of the data-relation object (1-based).DataRelation
object for which the buffer is the parent.handle childRelation(int64 index)
DataRelation
object for which the buffer is the parent.index
- The index of the data-relation object (1-based).DataRelation
object for which the buffer is the parent.logical querySynchronize()
true
if the synchronization was performed.character attachedPairlist()
DataSet
temp-table buffer that are mapped to corresponding fields in an attached DataSource
object. This list includes only the field name pairs you specified with the most recently
attached data-source object, in the order they were specified.logical mergeRowChanges()
DataSet
object loaded
with the GET-CHANGES()
method into the corresponding rows of a single temp-table
into the original (target) DataSet
buffer.true
if operation is successful.logical mergeRowChanges(handle original)
DataSet
object loaded
with the GET-CHANGES()
method into the corresponding rows of a single temp-table
into the original (target) DataSet
buffer.original
- A handle to the original (target) buffer object of a single target DataSet
temp-table to merge with the changed rows from the source object.true
if operation is successful.logical mergeRowChanges(handle original, boolean allCopyMode)
DataSet
object loaded
with the GET-CHANGES()
method into the corresponding rows of a single temp-table
into the original (target) DataSet
buffer.original
- A handle to the original (target) buffer object of a single target DataSet
temp-table to merge with the changed rows from the source object.allCopyMode
- Use TRUE
to indicates that all rows of the source after-image table must be
merged.true
if operation is successful.logical mergeRowChanges(handle original, logical allCopyMode)
DataSet
object loaded
with the GET-CHANGES()
method into the corresponding rows of a single temp-table
into the original (target) DataSet
buffer.original
- A handle to the original (target) buffer object of a single target DataSet
temp-table to merge with the changed rows from the source object.allCopyMode
- Use TRUE
to indicates that all rows of the source after-image table must be
merged.true
if operation is successful.logical isMultiTenant()
void setMultiTenant(logical l)
l
- The flag value.void setMultiTenant(boolean l)
l
- The flag value.logical serializeRow(character targetFormat, TargetData target, logical formatted, character encoding, logical omitInitialValues)
targetFormat
- The format ("xml" or "json").target
- Data target.formatted
- True
to format the data for making it more readable; false
to write it
as unformatted text. Unknown value is treated as false
.encoding
- Name of the character encoding to use.omitInitialValues
- True
to omit data for fields whose values match their initial values.True
if the operation completed successfully, else false
.logical serializeRow(character targetFormat, TargetData target, logical formatted, character encoding)
targetFormat
- The format ("xml" or "json").target
- Data target.formatted
- True
to format the data for making it more readable; false
to write it
as unformatted text. Unknown value is treated as false
.encoding
- Name of the character encoding to use.True
if the operation completed successfully, else false
.logical serializeRow(character targetFormat, TargetData target, logical formatted)
targetFormat
- The format ("xml" or "json").target
- Data target.formatted
- True
to format the data for making it more readable; false
to write it
as unformatted text. Unknown value is treated as false
.True
if the operation completed successfully, else false
.logical serializeRow(character targetFormat, TargetData target)
targetFormat
- The format ("xml" or "json").target
- Data target.True
if the operation completed successfully, else false
.logical serializeRow(character targetFormat, TargetData target, logical formatted, character encoding, logical omitInitialValues, logical omitOuterObject)
targetFormat
- The format ("xml" or "json").target
- Data target.formatted
- True
to format the data for making it more readable; false
to write it
as unformatted text. Unknown value is treated as false
.encoding
- Name of the character encoding to use.omitInitialValues
- True
to omit data for fields whose values match their initial values.omitOuterObject
- True
to omit data for the outermost object from the output.True
if the operation completed successfully, else false
.logical autoDelete()
void autoDelete(boolean autoDelete)
autoDelete
- The flag state.void autoDelete(logical autoDelete)
autoDelete
- The flag state.