DataSet (P2J - Progress 4GL to Java Conversion and Runtime)

java.lang.Object
- com.goldencode.p2j.util.HandleResource
- - com.goldencode.p2j.util.HandleChain
  - - com.goldencode.p2j.persist.DataSet

All Implemented Interfaces:

BufferCollection, CreateLike, DataSetChangeable, DataSetInterface, DataSourceModifiable, Fillable, JsonData, NamedSerializable, RefCounter, SerializeHiddenable, TempTableDuplicator, XmlData, XmlNode, ADMData, CallbackProcedure, Clearable, CommonHandle, CommonHandleChain, Deletable, Dereferenceable, DynamicResource, Errorable, InstantiatingProcedure, Nameable, NamespaceURI, Rejectable, UniqueID, WrappedResource, Printable

Direct Known Subclasses:

StaticDataSet
```
public class DataSet
extends HandleChain
implements ADMData, BufferCollection, CallbackProcedure, Clearable, CreateLike, DataSetChangeable, DataSetInterface, DataSourceModifiable, Dereferenceable, DynamicResource, Errorable, Fillable, JsonData, NamedSerializable, NamespaceURI, Rejectable, RefCounter, SerializeHiddenable, TempTableDuplicator, UniqueID, XmlData, XmlNode
```
DataSet objects are collections of one or more related temp-tables. Each temp-table of these can attach to a DataSource object that allows filling of the temp-table from the data source, or updating the data source from the temp-table. A DataSet object can optionally contain a set of data relations between the temp-tables.

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static class`	`DataSet.Builder` Builder class that helps construct a `DataSet` object statically, that is, using the `DEFINE DATASET` statement.
`static class`	`DataSet.FieldPair` Container immutable class that abstracts a field mapping between the parent and child tables/buffers in a data relation.

Field Summary

Fields
Modifier and Type	Field and Description
`private java.lang.String`	`admData` The value of `ADM-DATA` ABL attribute.
`private static InvokeConfig`	`AFTER_FILL_CALL_SITE` The call-site for the `AFTER_FILL_EVENT` event callback.
`static java.lang.String`	`AFTER_FILL_EVENT` The `AFTER-FILL` event string constant in upper case.
`private static InvokeConfig`	`BEFORE_FILL_CALL_SITE` The call-site for the `BEFORE_FILL_EVENT` event callback.
`static java.lang.String`	`BEFORE_FILL_EVENT` The `BEFORE-FILL` event string constant in upper case.
`private java.util.ArrayList<BufferImpl>`	`buffers` The ordered list of buffers contained in this `DataSet`.
`private boolean`	`buildInProgress` Flags the short period of time when the `Builder` constructs the object.
`private java.util.Map<java.lang.String,CallbackData>`	`callbacks` A map with all known callbacks.
`private boolean`	`dataSourceModified` Current value of the `DATA-SOURCE-MODIFIED` attribute.
`private boolean`	`defaultActive` The default value for active attribute for first `DataRelation`.
`private boolean`	`deleted` Marks the valid objects.
`private java.util.Set<QueryWrapper>`	`deleteQueries` The set of queries created by this dataset which need to be cleaned.
`private static NanoTimer`	`DYN_PARAM` Instrumentation for `createDynamicDataSet(com.goldencode.p2j.persist.DataSetParameter, com.goldencode.p2j.util.handle)`.
`private boolean`	`dynamic` Flags the dynamically constructed objects (using `CREATE` as opposed to statically defined objects, with `DEFINE`).
`private boolean`	`error` The current value of boolean `ERROR` attribute: indicates whether an error occurred during a `FILL` or `SAVE-ROW-CHANGES` operation, but can also be altered programmatically (writable).
`private static boolean`	`fullDebugString` Flag for debugging level.
`private static CentralLogger`	`log` Logger for objects of this type.
`private java.lang.String`	`name` The current value of `NAME` attribute.
`private java.lang.String`	`nsPrefix` The namespace prefix of this `DataSet`.
`private java.lang.String`	`nsUri` The value of `NAMESPACE-URI` attribute of this `DataSet`.
`private java.util.Set<DataSetParameter>`	`outputParams` Destination `DataSet` parameters for output copy if necessary before scope closes.
`private boolean`	`postponedDelete` Flag indicating the delete was explicitly called for a BY-REFERENCE handle.
`private java.util.Map<BufferImpl,BufferImpl>`	`proxies` The original proxy object associated with the buffers contained in this `DataSet`.
`private StaticDataSet`	`proxyDataSet` Back-reference to the defining static dataset proxy.
`protected boolean`	`referenceOnly` Flags the `REFERENCE-ONLY` `DataSet`s.
`private java.util.Set<StaticDataSet>`	`refs` The list of references of this object.
`private boolean`	`rejected` The current value of boolean `REJECTED` attribute: indicates whether a change to the data of this `DataSet` is rejected.
`private java.util.ArrayList<DataRelation>`	`relations` The list of `DataRelation` s from this data set.
`private boolean`	`reuseFillQuery` Flag indicating that the fill query for buffers can be re-used.
`private boolean`	`serializeHidden` Flags a hidden (name is not written) `DataSet` when serialized.
`private java.lang.String`	`serializeName` The serialization name of this `DataSet`.
`private static NanoTimer`	`STATIC_PARAM` Instrumentation for `associate(com.goldencode.p2j.persist.DataSetParameter, com.goldencode.p2j.persist.DataSet, boolean, boolean)`.
`private java.util.Map<BufferImpl,QueryWrapper>`	`topNavQueries` The current set of `TOP-NAV-QUERY` values mapped by their buffers.
`private java.lang.Long`	`uuid` Corresponds to UNIQUE-ID attribute.
`private java.lang.String`	`xmlNodeName` The name of the XML node for serialized data of this `DataSet`.

Fields inherited from class com.goldencode.p2j.util.HandleChain
nextSibling, prevSibling, wa

Fields inherited from class com.goldencode.p2j.util.HandleResource
instProc, pm

Fields inherited from interface com.goldencode.p2j.persist.Fillable
FM_APPEND, FM_EMPTY, FM_MERGE, FM_NOFILL, FM_REPLACE

Fields inherited from interface com.goldencode.p2j.persist.XmlNode
ATTRIBUTE, ELEMENT, HIDDEN, TEXT

Constructor Summary

Constructors
Constructor and Description
`DataSet()` Constructor to allow building a dataset with no linkage (used for the case of the surrogate resource `StaticDataSet`, which delegates the calls to either the default dataset or the bound dataset.
`DataSet(java.lang.String legacyName, boolean dynamic, boolean referenceOnly)` Initialize this resource by determining its type.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`(package private) boolean`	`_areRelationsActive()` Checks whether AT LEAST one data-relation objects in this `DataSet` object is active.
`boolean`	`_dynamic()` Returns `true` if the buffer is dynamic.
`int`	`_getNumTopBuffers()` Obtain the number of top-level buffers in this `DataSet` object.
`java.lang.String`	`_name()` Get the `name` attribute of handle as a string.
`private void`	`_setTopBufferQuery(handle queryHandle, BufferImpl topBuffer)` Low level implementation of `TOP-NAV-QUERY` method.
`logical`	`acceptChanges()` Accepts changes to the data in target object (a temp-table or all temp-tables in a `DataSet`).
`logical`	`addBuffer(Buffer buf)` Adds one new buffer to a query object or dynamic `DataSet` object, without affecting the other buffers, if any.
`logical`	`addBuffer(character bufName)` Adds one new buffer to a query object or dynamic `DataSet` object, without affecting the other buffers, if any.
`logical`	`addBuffer(handle bufHandle)` Adds one new buffer to a query object or dynamic `DataSet` object, without affecting the other buffers, if any.
`logical`	`addBuffer(java.lang.String bufName)` Adds one new buffer to a query object or dynamic `DataSet` object, without affecting the other buffers, if any.
`protected void`	`addOutputParam(DataSetParameter dsParam)` Register an output dataset parameter.
`handle`	`addParentIdRelation(handle parent, handle child)` Creates a new data-relation object for a pair of parent and child buffers of this `DataSet` based on the `RECID` of the parent buffer to this `DataSet` object.
`handle`	`addParentIdRelation(handle parent, handle child, Text parentIdField)` Creates a new data-relation object for a pair of parent and child buffers of this `DataSet` based on the `RECID` of the parent buffer to this `DataSet` object.
`handle`	`addParentIdRelation(handle parent, handle child, Text parentIdField, Text parentFieldsBefore)` Creates a new data-relation object for a pair of parent and child buffers of this `DataSet` based on the `RECID` of the parent buffer to this `DataSet` object.
`handle`	`addParentIdRelation(handle parent, handle child, Text parentIdField, Text parentFieldsBefore, Text parentFieldsAfter)` Creates a new data-relation object for a pair of parent and child buffers of this `DataSet` based on the `RECID` of the parent buffer to this `DataSet` object.
`(package private) void`	`addReference(StaticDataSet staticDataSet)` Adds a new reference to this dataset.
`handle`	`addRelation(handle parent, handle child, Text pairs)` Creates a new data-relation object for a pair of parent and child buffers of this `DataSet` object.
`handle`	`addRelation(handle parent, handle child, Text pairs, logical reposition)` Creates a new data-relation object for a pair of parent and child buffers of this `DataSet` object.
`handle`	`addRelation(handle parent, handle child, Text pairs, logical reposition, logical nested)` Creates a new data-relation object for a pair of parent and child buffers of this `DataSet` object.
`handle`	`addRelation(handle parent, handle child, Text pairs, logical reposition, logical nested, logical active)` Creates a new data-relation object for a pair of parent and child buffers of this `DataSet` object.
`handle`	`addRelation(handle parent, handle child, Text pairs, logical reposition, logical nested, logical active, logical recursive)` Creates a new data-relation object for a pair of parent and child buffers of this `DataSet` object.
`handle`	`addRelation(handle parent, handle child, Text pairs, logical reposition, logical nested, logical active, logical recursive, logical fkeyHidden)` Creates a new data-relation object for a pair of parent and child buffers of this `DataSet` object.
`handle`	`addRelationImpl(handle parent, handle child, Text pairs, logical reposition, logical nested, logical active, logical recursive, logical fkeyHidden, boolean nullOnDuplicate)` Actual implementation of `addRelation`.
`private handle`	`addRelationWorker(java.lang.String relName, Buffer parent, Buffer child, java.lang.String[] fields, java.lang.String strPairs, boolean reposition, boolean nested, boolean active, boolean recursive, boolean fkeyHidden, boolean dynamic)` Adds a data-relation object for a pair of parent and child buffers to this `DataSet` object.
`boolean`	`allowDelete(handle ref, boolean explicit)` Check if the resource can veto the delete or not, before attempting the `HandleChain.delete()` call.
`protected DataRelation`	`allowsActiveChild(Buffer childBuffer)` Checks whether a buffer can be at this moment the child side in a relation of this `DataSet`.
`logical`	`applyCallback(java.lang.String eventName)` Applies a callback procedure, which allows execution of a defined event without duplicating the event procedure definition.
`logical`	`areRelationsActive()` Checks whether AT LEAST one data-relation objects in this `DataSet` object is active.
`handle`	`asHandle()` Convert this dataset to a handle.
`static void`	`associate(DataSetParameter dsLocal, DataSet dsTarget)` Associate two `DataSet` with one another, such that all relevant records can be copied between them at prescribed times.
`static void`	`associate(DataSetParameter dsLocal, DataSet dsTarget, boolean input, boolean output)` Associate two `DataSet` with one another, such that all relevant records can be copied between them at prescribed times.
`static void`	`associate(DataSetParameter dsSrc, DataSet dsTarget, boolean input, boolean output, java.util.EnumSet<ParameterOption> options)` Associate two `DataSet` with one another, such that all relevant records can be copied between them at prescribed times.
`static void`	`associate(DataSetParameter dsSrc, DataSet dsTarget, boolean input, boolean output, ParameterOption option)` Associate two `DataSet` with one another, such that all relevant records can be copied between them at prescribed times.
`static void`	`associate(DataSetParameter dsSrc, DataSet dsTarget, java.util.EnumSet<ParameterOption> options)` Associate two `DataSet` with one another, such that all relevant records can be copied between them at prescribed times.
`static void`	`associate(DataSetParameter dsSrc, DataSet dsTarget, ParameterOption option)` Associate two `DataSet` with one another, such that all relevant records can be copied between them at prescribed times.
`private static void`	`associateImpl(DataSetParameter dsSrc, DataSet dsTarget, java.util.EnumSet<ParameterOption> options)` Associate two `DataSet` with one another, such that all relevant records can be copied between them at prescribed times.
`handle`	`bufferHandle()` Obtain the handle to a particular buffer of this `DataSet`.
`handle`	`bufferHandle(character buffName)` Obtain the handle to a particular buffer of this `DataSet`.
`handle`	`bufferHandle(int bufIndex)` Obtain the handle to a particular buffer of this `DataSet`.
`handle`	`bufferHandle(int64 bufIndex)` Obtain the handle to a particular buffer of this `DataSet`.
`handle`	`bufferHandle(java.lang.String buffName)` Obtain the handle to a particular buffer of this `DataSet`.
`logical`	`clear()` Returns the resource to it's clear state.
`private void`	`clearImpl(boolean delete, boolean resetProperties)` Clears the dataset.
`logical`	`copyDataset(handle srcDS)` Copies a source `DataSet` object into this `DataSet` object.
`logical`	`copyDataset(handle srcDS, logical append)` Copies a source `DataSet` object into this `DataSet` object.
`logical`	`copyDataset(handle srcDS, logical append, logical replace)` Copies a source `DataSet` object into this `DataSet` object.
`logical`	`copyDataset(handle srcDS, logical append, logical replace, logical looseCopy)` Copies a source `DataSet` object into this `DataSet` object.
`logical`	`copyDataset(handle srcDS, logical append, logical replace, logical looseCopy, Text pairList)` Copies a source `DataSet` object into this `DataSet` object.
`logical`	`copyDataset(handle srcDS, logical append, logical replace, logical looseCopy, Text pairList, logical currentOnly)` Copies a source `DataSet` object into this `DataSet` object.
`logical`	`copyDataset(handle srcDS, logical append, logical replace, logical looseCopy, Text pairList, logical currentOnly, Text prefix)` Copies a source `DataSet` object into this `DataSet` object.
`protected logical`	`copyDatasetImpl(handle hSrcDS, boolean append, boolean replace, boolean looseCopy, java.lang.String pairList, boolean currentOnly, java.lang.String prefix)` The implementation of `COPY-DATASET` method.
`logical`	`copyTempTable(handle other)` Copies the other TEMP-TABLE.
`logical`	`copyTempTable(handle other, boolean append)` Copies the other TEMP-TABLE.
`logical`	`copyTempTable(handle other, boolean append, boolean replace)` Copies the other TEMP-TABLE.
`logical`	`copyTempTable(handle other, boolean append, boolean replace, boolean looseCopy)` Copies the other TEMP-TABLE.
`logical`	`copyTempTable(handle other, boolean append, boolean replace, boolean looseCopy, java.lang.String prefix)` Copies the other TEMP-TABLE.
`logical`	`copyTempTable(handle other, logical append)` Copies the other TEMP-TABLE.
`logical`	`copyTempTable(handle other, logical append, logical replace)` Copies the other TEMP-TABLE.
`logical`	`copyTempTable(handle other, logical append, logical replace, logical looseCopy)` Copies the other TEMP-TABLE.
`logical`	`copyTempTable(handle other, logical append, logical replace, logical looseCopy, character prefix)` Copies the other TEMP-TABLE.
`private static void`	`copyTempTableOptions(AbstractTempTable src, AbstractTempTable dst)` Copy the temp-table options from the source to the destination.
`static void`	`create(handle dsHandle)` Factory method.
`static void`	`create(handle dsHandle, character widgetPool)` Factory method.
`static void`	`create(handle dsHandle, java.lang.String widgetPool)` Factory method.
`static void`	`createDynamicDataSet(DataSetParameter dsParam, handle dsHandle)` Dynamically create a `DataSet` from the `DataSetParameter` provided.
`static void`	`createDynamicDataSet(DataSetParameter dsParam, handle dsHandle, boolean input, boolean output)` Dynamically create a `DataSet` from the `DataSetParameter` provided.
`static void`	`createDynamicDataSet(DataSetParameter dsParam, handle dsHandle, boolean input, boolean output, ParameterOption option)` Dynamically create a `DataSet` from the `DataSetParameter` provided.
`static void`	`createDynamicDataSet(DataSetParameter dsParam, handle dsHandle, ParameterOption option)` Dynamically create a `DataSet` from the `DataSetParameter` provided.
`private static void`	`createDynamicDataSetImpl(DataSetParameter dsParam, handle dsHandle, ParameterOption option)` Dynamically create a `DataSet` from the `DataSetParameter` provided.
`logical`	`createLike(character dsName)` Duplicates the structure of an existing `DataSet`, copying its entire structure.
`logical`	`createLike(character dsName, character prefix)` Duplicates the structure of an existing `DataSet`, copying its entire structure.
`logical`	`createLike(handle hds)` Duplicates the structure of an existing `DataSet`, copying its entire structure.
`logical`	`createLike(handle hds, character prefix)` Duplicates the structure of an existing `DataSet`, copying its entire structure.
`logical`	`createLike(handle hds, java.lang.String prefix)` Duplicates the structure of an existing `DataSet`, copying its entire structure.
`logical`	`createLike(java.lang.String dsName)` Duplicates the structure of an existing `DataSet`, copying its entire structure.
`logical`	`createLike(java.lang.String dsName, java.lang.String prefix)` Duplicates the structure of an existing `DataSet`, copying its entire structure.
`private logical`	`createLikeImpl(DataSet sourceDS, java.lang.String prefix)` Actual implementation of `CREATE-LIKE` method.
`<T extends BaseDataType> T`	`dereference(java.lang.Class<T> type, java.lang.String memberName)` Dereference a named member from this collection.
`BaseDataType`	`dereference(java.lang.String memberName)` Dereference a named member from this collection.
`void`	`dereference(java.lang.String memberName, java.lang.Object value)` This overloaded method is used when the dereference is the left-side of an assignment.
`java.lang.Object`	`derefPoly(java.lang.String memberName)` Emitted for `::` operator used as r-value in a dynamic extent assignment, as the conversion rules doesn't know if the target field is extent or scalar.
`logical`	`emptyDataset()` Empties this `DataSet` object of all records in its associated temp-tables.
`logical`	`error()` Returns the state of the ERROR attribute
`void`	`error(boolean value)` Setter for ERROR attribute.
`void`	`error(logical value)` Setter for ERROR attribute.
`logical`	`fill()` Fills a `DataSet` object, recursively, based on its defined data sources, data relations, and queries.
`character`	`fillMode()` Obtain the mode in which the `fill()` method fills a `DataSet` member buffer.
`void`	`fillMode(java.lang.String mode)` Configures the mode in which the `fill()` method fills a `DataSet` member buffer.
`void`	`fillMode(Text mode)` Configures the mode in which the `fill()` method fills a `DataSet` member buffer.
`private void`	`finishBuild()` Declares this static `DataSet` as build.
`private boolean`	`flushAllBuffers()` Flush all buffers (including secondary buffers and associated before-buffers) used in this dataset.
`character`	`getADMData()` Get the value of the ADM-DATA attribute.
`BufferImpl`	`getBufferByIndex(int bufIndex)` Lookup a buffer by its index.
`BufferImpl`	`getBufferByName(java.lang.String name)` Lookup a buffer by its name.
`BufferImpl`	`getBufferBySerializeName(java.lang.String serializeName)` Lookup a buffer by its serialize-name.
`java.util.List<BufferImpl>`	`getBuffers()` Get the list of `buffers` for the runtime instance of this resource.
`handle`	`getCallbackProcContext(java.lang.String eventName)` Retrieves the handle of the procedure that contains the internal procedure associated with the ABL callback for the specified event
`character`	`getCallbackProcName(java.lang.String eventName)` Retrieves the name of the internal procedure associated with the ABL callback for the specified event.
`private static InvokeConfig`	`getCallSite(java.lang.String eventName)` Get the `callsite` for the specified event.
`logical`	`getChanges(handle original)` Loads the empty target (`DataSet` or `TempTable`) object with changed rows from original (source) object.
`logical`	`getChanges(handle original, boolean parentMode)` Loads the empty target (`DataSet` or `TempTable`) object with changed rows from original (source) object.
`logical`	`getChanges(handle original, logical parentMode)` Loads the empty target (`DataSet` or `TempTable`) object with changed rows from original (source) object.
`private java.lang.String`	`getDataAsJson()` Get the JSON representation of data of this DATASET.
`int`	`getIndexOf(BufferImpl buffer)` Searches whether a buffer is part of the dataset.
`handle`	`getNextSibling()` Get the `NEXT-SIBLING` attribute of this DataSet.
`java.lang.String`	`getNsUri()` Returns the value of the the NAMESPACE-URI attribute as String.
`integer`	`getNumRelations()` Get the number of data-relation objects of this `DataSet` object.
`integer`	`getNumTopBuffers()` Obtain the number of top-level buffers in this `DataSet` object.
`handle`	`getPrevSibling()` Get the `PREV-SIBLING` attribute of this DataSet.
`StaticDataSet`	`getProxyDataSet()` Get the defining `proxyDataSet`;
`handle`	`getRelation()` Gets the handle of the specified data-relation object.
`java.util.Optional<DataRelation>`	`getRelation(Buffer buffer)` Query the relation by its buffer.
`handle`	`getRelation(long index)` Gets the handle of the specified data-relation object.
`handle`	`getRelation(NumberType index)` Gets the handle of the specified data-relation object.
`handle`	`getRelation(java.lang.String name)` Gets the handle of the specified data-relation object.
`handle`	`getRelation(Text name)` Gets the handle of the specified data-relation object.
`DataRelation`	`getRelationNative()` Gets the handle of the specified data-relation object.
`DataRelation`	`getRelationNative(long index)` Gets the handle of the specified data-relation object.
`java.util.stream.Stream<DataRelation>`	`getRelations()` Get relations as stream.
`java.util.ArrayList<DataRelation>`	`getRelations(Buffer buffer, boolean parent, boolean child, boolean active)` Queries the list of `DataRelation` s for a buffer.
`private java.lang.String`	`getSchema()` Obtain a short description of the dataset structure: buffers and relations between them.
`logical`	`getSerializeHidden()` Checks whether fields are written when the temp-table is serialized, for example into JSON or XML.
`character`	`getSerializeName()` Implementation of the read access of the `SERIALIZE-NAME` attribute.
`private java.lang.String`	`getSqlData()` Get the SQL representation of data of this DATASET.
`handle`	`getTopBuffer()` Gets the top-level buffer of this `DataSet` object at the specified index position.
`handle`	`getTopBuffer(long index)` Gets the top-level buffer of this `DataSet` object at the specified index position.
`handle`	`getTopBuffer(NumberType index)` Gets the top-level buffer of this `DataSet` object at the specified index position.
`private java.util.List<Buffer>`	`getTopBufferList()` Obtain the list of top-buffers.
`BufferImpl`	`getTopBufferNative(long index)` Gets the top-level buffer of this `DataSet` object at the specified index position.
`handle`	`getTopNavQuery()` Obtain default navigation query for a top-level buffer of this `DataSet` object.
`private handle`	`getTopNavQuery(BufferImpl buffer)` Obtain the current `TOP-NAV-QUERY` for a specified buffer.
`handle`	`getTopNavQuery(long index)` Obtain default navigation query for a top-level buffer of this `DataSet` object.
`handle`	`getTopNavQuery(NumberType index)` Obtain default navigation query for a top-level buffer of this `DataSet` object.
`handle`	`getTopNavQuery(java.lang.String bufName)` Obtain default navigation query for a top-level buffer of this `DataSet` object.
`handle`	`getTopNavQuery(Text bufName)` Obtain default navigation query for a top-level buffer of this `DataSet` object.
`integer`	`getUniqueID()` Obtain an integer values that uniques identifies this resource.
`character`	`getXmlDataType()` Obtain the XML Schema data type for the buffer-field object.
`character`	`getXmlNodeName()` Obtain the name of the XML element or attribute representing the target object (a `DataSet`) name in an XML document.
`java.lang.String`	`getXmlNodeNameInternal()` Obtain the name of the XML element or attribute representing the target object.
`character`	`getXmlNodeType()` Obtain the XML node type of this object.
`protected boolean`	`hasNameConstraints()` Allows each resource to declare whether it has some naming constraints.
`private static void`	`invalidTopNavQuery(int errCode, java.lang.String bufName)` Notifies the user about an attempt to set an invalid value for `TOP-NAV-QUERY` attribute.
`protected boolean`	`invokeCallback(handle self, CallbackData cbd)` Invokes a callback procedure or a callback method.
`private boolean`	`isAlterable()` Checks whether this object can be altered (added buffers and relations).
`protected boolean`	`isBound()` Checks if this `REFERENCE-ONLY` `DataSet` was bound to a real `DataSet`.
`private static boolean`	`isCallbackName(java.lang.String someName)` Test whether a string is a valid CALLBACK name for `DataSet`s.
`protected boolean`	`isCompatibleWith(DataSet other)` Test the compatibility of two datasets.
`logical`	`isDataSourceModified()` Checks whether the data in the data source has been modified.
`protected boolean`	`isPostponedDelete()` Check if this dataset was attempted to be deleted, but was postponed because of the handle being a DATASET-HANDLE BY-REFERENCE.
`(package private) boolean`	`isReuseFillQuery()` Check if the buffer's fill query can be `re-used`.
`logical`	`mergeChanges(handle original)` Merges the changed rows of all temp-tables or a single temp-table in a source `DataSet` object loaded with the `GET-CHANGES()` method into the corresponding rows of all temp-tables or a single temp-table (respectively) in the original (target) `DataSet` object.
`logical`	`mergeChanges(handle original, boolean allCopyMode)` Merges the changed rows of all temp-tables or a single temp-table in a source `DataSet` object loaded with the `GET-CHANGES()` method into the corresponding rows of all temp-tables or a single temp-table (respectively) in the original (target) `DataSet` object.
`logical`	`mergeChanges(handle original, logical allCopyMode)` Merges the changed rows of all temp-tables or a single temp-table in a source `DataSet` object loaded with the `GET-CHANGES()` method into the corresponding rows of all temp-tables or a single temp-table (respectively) in the original (target) `DataSet` object.
`character`	`name()` Get the `name` attribute of handle.
`void`	`name(character name)` Sets the name of this handle.
`void`	`name(java.lang.String name)` Sets the `name` attribute of the object referred by this handle.
`character`	`namespacePrefix()` Returns the value of the the NAMESPACE-PREFIX attribute.
`void`	`namespacePrefix(character prefix)` Setter for NAMESPACE-PREFIX attribute.
`void`	`namespacePrefix(java.lang.String prefix)` Setter for NAMESPACE-PREFIX attribute.
`character`	`namespaceURI()` Returns the value of the the NAMESPACE-URI attribute.
`void`	`namespaceURI(character uri)` Setter for NAMESPACE-URI attribute.
`void`	`namespaceURI(java.lang.String uri)` Setter for NAMESPACE-URI attribute.
`integer`	`numBuffers()` Obtain the number of buffers in this `DataSet`.
`integer`	`numReferences()` Obtain number of references to a `Buffer`, `DataSet`, or `TempTable` object that is defined as a parameter to which reference-only objects are bound.
`protected void`	`performOutputCopy(DataSetParameter outputParam)` Copy output data for the linked `DataSet` parameter, if any.
`private static int`	`positionOf(BufferImpl[] buffers, BufferImpl item)` Locates a `BufferImpl` in an array of objects of same type.
`private static void`	`readFromXml(java.lang.String xmlDataset, boolean append, handle ds)` Read the DATASET from XML.
`logical`	`readJson(SourceData source)` Implementation of the READ-JSON method.
`logical`	`readJson(SourceData source, character readMode)` Implementation of the READ-JSON method.
`logical`	`readXml(SourceData source, character readMode, character schemaLocation, logical overrideDefaultMapping)` Implementation of the READ-XML method.
`logical`	`readXml(SourceData source, character readMode, character schemaLocation, logical overrideDefaultMapping, character fieldTypeMapping)` Implementation of the READ-XML method.
`logical`	`readXml(SourceData source, character readMode, character schemaLocation, logical overrideDefaultMapping, character strMapping, character verifySchemaMode)` Implementation of the READ-XML method.
`logical`	`readXmlSchema(SourceData source, logical override)` Reads XML Schema from an XML document and uses that schema to either create a schema for a `DataSet` or `TempTable` or verify existing schema in a `DataSet`, `TempTable` or temp-table `Buffer` object.
`logical`	`readXmlSchema(SourceData source, logical override, Text mapping)` Reads XML Schema from an XML document and uses that schema to either create a schema for a `DataSet` or `TempTable` or verify existing schema in a `DataSet`, `TempTable` or temp-table `Buffer` object.
`logical`	`readXmlSchema(SourceData source, logical override, Text strMapping, Text verifyMode)` Reads XML Schema from an XML document and uses that schema to either create a schema for a `DataSet` or `TempTable` or verify existing schema in a `DataSet`, `TempTable` or temp-table `Buffer` object.
`DataSet`	`ref()` Obtains the original `DataSet` definition.
`logical`	`rejectChanges()` Rejects changes to the data in target object (a temp-table or all temp-tables in a `DataSet`).
`logical`	`rejected()` Returns the state of the REJECTED attribute
`void`	`rejected(boolean value)` Setter for REJECTED attribute.
`void`	`rejected(logical value)` Setter for REJECTED attribute.
`(package private) void`	`removeReference(StaticDataSet staticDataSet)` Removes a reference to this dataset.
`void`	`resetNames()` Reset name, nsPrefix and nsURI.
`protected boolean`	`resourceDelete()` Delete the resource.
`void`	`setADMData(character value)` Set the value of the ADM-DATA attribute.
`void`	`setADMData(java.lang.String value)` Set the value of the ADM-DATA attribute.
`logical`	`setBuffers(Buffer... bufs)` Binds all buffers for a dynamic `DataSet` object at the same time.
`logical`	`setBuffers(handle... hBuffers)` Binds all buffers for a dynamic `DataSet` object at the same time.
`logical`	`setBuffers(java.lang.Object... bufs)` Binds all buffers for a dynamic `DataSet` object at the same time.
`(package private) boolean`	`setBuffersImpl(Buffer... bufs)` Binds all buffers for a dynamic `DataSet` object at the same time.
`logical`	`setCallback(java.lang.String callbackName, java.lang.String routineName, object<?> context)` Configures a callback.
`logical`	`setCallbackProcedure(java.lang.String eventName, java.lang.String callback, handle context)` Associates an internal procedure with an ABL callback event.
`void`	`setDataSourceModified(boolean mod)` Manually mark the data in the target structure as modified.
`void`	`setDataSourceModified(logical mod)` Manually mark the data in the target structure as modified.
`void`	`setPostponedDelete(boolean postponed)` Set the `postponedDelete` flag.
`void`	`setProxyDataSet(StaticDataSet proxyDataSet)` Set the back-reference to the defining static proxy dataset.
`void`	`setRelationsActive(boolean active)` Configures whether all data-relation objects in this `DataSet` object to be active or inactive.
`void`	`setRelationsActive(logical active)` Configures whether all data-relation objects in this `DataSet` object to be active or inactive.
`void`	`setSerializeHidden(boolean val)` Allow to configure whether fields are written when the temp-table is serialized, for example into JSON or XML.
`void`	`setSerializeHidden(logical val)` Allow to configure whether fields are written when the temp-table is serialized, for example into JSON or XML.
`void`	`setSerializeName(java.lang.String sName)` Implementation of the write access of the `SERIALIZE-NAME` attribute.
`void`	`setSerializeName(Text sName)` Implementation of the write access of the `SERIALIZE-NAME` attribute.
`void`	`setTopNavQuery(handle queryHandle)` Configures the default navigation query for a top-level buffer of this `DataSet` object.
`void`	`setTopNavQuery(long index, handle queryHandle)` Configures the default navigation query for a top-level buffer of this `DataSet` object.
`void`	`setTopNavQuery(NumberType index, handle queryHandle)` Configures the default navigation query for a top-level buffer of this `DataSet` object.
`void`	`setTopNavQuery(java.lang.String bufName, handle queryHandle)` Configures the default navigation query for a top-level buffer of this `DataSet` object.
`void`	`setTopNavQuery(Text bufName, handle queryHandle)` Configures the default navigation query for a top-level buffer of this `DataSet` object.
`void`	`setXmlDataType(java.lang.String newType)` Configures the XML Schema data type for the buffer-field object.
`void`	`setXmlDataType(Text newType)` Configures the XML Schema data type for the buffer-field object.
`void`	`setXmlNodeName(java.lang.String name)` Sets the name of the XML element or attribute representing the target object (either a `DataSet`, a `TempTable`, a `TemporaryBuffer`, or a temp-table `BufferField`) name in an XML document.
`void`	`setXmlNodeName(Text name)` Sets the name of the XML element or attribute representing the target object (either a `DataSet`, a `TempTable`, a `TemporaryBuffer`, or a temp-table `BufferField`) name in an XML document.
`void`	`setXmlNodeType(java.lang.String newType)` Allows to specify how a this object will be represented in XML and XML Schema.
`void`	`setXmlNodeType(Text newType)` Allows to specify how a this object will be represented in XML and XML Schema.
`java.lang.String`	`toString()` Obtain a short description of the dataset used for debugging.
`boolean`	`valid()` Reports if this object is valid for use.
`logical`	`writeJson(TargetData target)` Implementation of the WRITE-JSON method.
`logical`	`writeJson(TargetData target, logical formatted)` Implementation of the WRITE-JSON method.
`logical`	`writeJson(TargetData target, logical formatted, character encoding)` Implementation of the WRITE-JSON method.
`logical`	`writeJson(TargetData target, logical formatted, character encoding, logical omitInitials)` Implementation of the WRITE-JSON method.
`logical`	`writeJson(TargetData target, logical formatted, character encoding, logical omitInitials, logical omitOuterObject)` Implementation of the WRITE-JSON method.
`logical`	`writeJson(TargetData target, logical formatted, character encoding, logical omitInitialValues, logical omitOuterObject, logical writeBeforeImage)` Implementation of the WRITE-JSON method.
`(package private) static java.lang.String`	`writeToXml(handle dsHandle, boolean useBeforeImage, boolean isHandle)` Write the specified DATASET handle to a XML.
`logical`	`writeXml(TargetData target)` Implementation of the WRITE-XML method.
`logical`	`writeXml(TargetData target, logical formatted)` Implementation of the WRITE-XML method.
`logical`	`writeXml(TargetData target, logical formatted, character encoding)` Implementation of the WRITE-XML method.
`logical`	`writeXml(TargetData target, logical formatted, character encoding, character schemaLocation)` Implementation of the WRITE-XML method.
`logical`	`writeXml(TargetData target, logical formatted, character encoding, character schemaLocation, logical writeXmlSchema)` Implementation of the WRITE-XML method.
`logical`	`writeXml(TargetData target, logical formatted, character encoding, character schemaLocation, logical writeXmlSchema, logical minXmlSchema)` Implementation of the WRITE-XML method.
`logical`	`writeXml(TargetData target, logical formatted, character encoding, character schemaLocation, logical writeXmlSchema, logical minXmlSchema, logical writeBeforeImage)` Implementation of the WRITE-XML method.
`logical`	`writeXml(TargetData target, logical formatted, character encoding, character schemaLocation, logical writeXmlSchema, logical minXmlSchema, logical beforeImage, logical noInitialVals)` Implementation of the WRITE-XML method.
`logical`	`writeXmlSchema(TargetData target)` Writes an XML representation of the definition of this `DataSet`.
`logical`	`writeXmlSchema(TargetData target, logical formatted)` Writes an XML representation of the definition of this `DataSet`.
`logical`	`writeXmlSchema(TargetData target, logical formatted, Text encoding)` Writes an XML representation of the definition of this `DataSet`.
`logical`	`writeXmlSchema(TargetData target, logical formatted, Text encoding, logical minXmlSchema)` Writes an XML representation of the definition of this `DataSet`.
`logical`	`writeXmlSchema(TargetData target, logical formatted, Text encoding, logical minXmlSchema, logical omitInitVal)` Writes an XML representation of the definition of this `DataSet`.

Methods inherited from class com.goldencode.p2j.util.HandleChain
delete, firstResource, firstResource, getHead, getNextSibling, getPrevSibling, getPrivateData, getTail, hasName, hasNameReadOnly, hasNextSibling, hasParent, hasPrevSibling, hasPrivateData, interlink, isChained, lastResource, lastResource, moveInChain, readOnlyError, readOnlyError, resolveChainType, setHead, setNextSibling, setNextSibling, setPrevSibling, setPrevSibling, setPrivateData, setPrivateData, setPrivateData, validateName

Methods inherited from class com.goldencode.p2j.util.HandleResource
_instantiatingProcedure, addToPool, doDelete, equals, hashCode, id, id, implicitDeletion, incrementTrigger, instantiatingProcedure, invalidAttribute, processResource, registerResource, resourceType, setInstantiatingProcedure, type, unableToAssignUnknown, unknown

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface com.goldencode.p2j.util.CallbackProcedure
applyCallback, getCallbackProcContext, getCallbackProcName, setCallback, setCallback, setCallback, setCallback, setCallback, setCallback, setCallbackProcedure, setCallbackProcedure, setCallbackProcedure, setCallbackProcedure, setCallbackProcedure, setCallbackProcedure, setCallbackProcedure

Methods inherited from interface com.goldencode.p2j.persist.DataSourceModifiable
isDataSourceModified

Methods inherited from interface com.goldencode.p2j.util.Dereferenceable
dereference, dereference, dereference, dereference

Methods inherited from interface com.goldencode.p2j.util.DynamicResource
dynamic

Methods inherited from interface com.goldencode.p2j.util.CommonHandle
resourceType

Methods inherited from interface com.goldencode.p2j.util.WrappedResource
id, id, unknown

Methods inherited from interface com.goldencode.util.Printable
asString, print

- Field Detail
  - BEFORE_FILL_EVENT
```
public static final java.lang.String BEFORE_FILL_EVENT
```
    The BEFORE-FILL event string constant in upper case.
    
    See Also:
    
    Constant Field Values
  - AFTER_FILL_EVENT
```
public static final java.lang.String AFTER_FILL_EVENT
```
    The AFTER-FILL event string constant in upper case.
    
    See Also:
    
    Constant Field Values
  - BEFORE_FILL_CALL_SITE
```
private static final InvokeConfig BEFORE_FILL_CALL_SITE
```
    The call-site for the BEFORE_FILL_EVENT event callback.
  - AFTER_FILL_CALL_SITE
```
private static final InvokeConfig AFTER_FILL_CALL_SITE
```
    The call-site for the AFTER_FILL_EVENT event callback.
  - uuid
```
private java.lang.Long uuid
```
    Corresponds to UNIQUE-ID attribute.
  - STATIC_PARAM
```
private static final NanoTimer STATIC_PARAM
```
    Instrumentation for associate(com.goldencode.p2j.persist.DataSetParameter, com.goldencode.p2j.persist.DataSet, boolean, boolean).
  - DYN_PARAM
```
private static final NanoTimer DYN_PARAM
```
    Instrumentation for createDynamicDataSet(com.goldencode.p2j.persist.DataSetParameter, com.goldencode.p2j.util.handle).
  - log
```
private static final CentralLogger log
```
    Logger for objects of this type.
  - admData
```
private java.lang.String admData
```
    The value of ADM-DATA ABL attribute.
  - nsUri
```
private java.lang.String nsUri
```
    The value of NAMESPACE-URI attribute of this DataSet.
  - nsPrefix
```
private java.lang.String nsPrefix
```
    The namespace prefix of this DataSet.
  - xmlNodeName
```
private java.lang.String xmlNodeName
```
    The name of the XML node for serialized data of this DataSet.
  - serializeName
```
private java.lang.String serializeName
```
    The serialization name of this DataSet. The default is dataset's name.
  - defaultActive
```
private boolean defaultActive
```
    The default value for active attribute for first DataRelation.
  - name
```
private java.lang.String name
```
    The current value of NAME attribute. It can be modified for dynamic DataSets but immutable for static DataSets.
  - error
```
private boolean error
```
    The current value of boolean ERROR attribute: indicates whether an error occurred during a FILL or SAVE-ROW-CHANGES operation, but can also be altered programmatically (writable).
  - rejected
```
private boolean rejected
```
    The current value of boolean REJECTED attribute: indicates whether a change to the data of this DataSet is rejected. The attribute is writable.
  - callbacks
```
private java.util.Map<java.lang.String,CallbackData> callbacks
```
    A map with all known callbacks. The keys MUST be in UPPERCASE.
  - dynamic
```
private final boolean dynamic
```
    Flags the dynamically constructed objects (using CREATE as opposed to statically defined objects, with DEFINE).
  - referenceOnly
```
protected boolean referenceOnly
```
    Flags the REFERENCE-ONLY DataSets.
  - buildInProgress
```
private boolean buildInProgress
```
    Flags the short period of time when the Builder constructs the object. During this period, some setters are allowed for STATICally build DATASETs.
  - postponedDelete
```
private boolean postponedDelete
```
    Flag indicating the delete was explicitly called for a BY-REFERENCE handle.
  - serializeHidden
```
private boolean serializeHidden
```
    Flags a hidden (name is not written) DataSet when serialized. This flag overlaps with XML-NODE-TYPE attribute. A value of false is equivalent to XML-NODE-TYPE set to "ELEMENT" (the default) and false means that the XML-NODE-TYPE is "HIDDEN".
  - deleted
```
private boolean deleted
```
    Marks the valid objects. When destroyed, the flag is set to false.
  - dataSourceModified
```
private boolean dataSourceModified
```
    Current value of the DATA-SOURCE-MODIFIED attribute.
  - buffers
```
private final java.util.ArrayList<BufferImpl> buffers
```
    The ordered list of buffers contained in this DataSet.
  - proxies
```
private final java.util.Map<BufferImpl,BufferImpl> proxies
```
    The original proxy object associated with the buffers contained in this DataSet.
  - topNavQueries
```
private java.util.Map<BufferImpl,QueryWrapper> topNavQueries
```
    The current set of TOP-NAV-QUERY values mapped by their buffers.
  - deleteQueries
```
private java.util.Set<QueryWrapper> deleteQueries
```
    The set of queries created by this dataset which need to be cleaned.
  - relations
```
private final java.util.ArrayList<DataRelation> relations
```
    The list of DataRelation s from this data set.
  - outputParams
```
private java.util.Set<DataSetParameter> outputParams
```
    Destination DataSet parameters for output copy if necessary before scope closes.
  - refs
```
private java.util.Set<StaticDataSet> refs
```
    The list of references of this object.
  - proxyDataSet
```
private StaticDataSet proxyDataSet
```
    Back-reference to the defining static dataset proxy.
  - reuseFillQuery
```
private boolean reuseFillQuery
```
    Flag indicating that the fill query for buffers can be re-used.
  - fullDebugString
```
private static boolean fullDebugString
```
    Flag for debugging level. When true the full dataset is returned at the expense of CPU clocks. When false only the essential dataset structure is returned. Intentionally this is defined as non-final private here and has no accessors so that it can be r/w only at debug time.
- Constructor Detail
  - DataSet
```
DataSet()
```
    Constructor to allow building a dataset with no linkage (used for the case of the surrogate resource StaticDataSet, which delegates the calls to either the default dataset or the bound dataset.
  - DataSet
```
DataSet(java.lang.String legacyName,
        boolean dynamic,
        boolean referenceOnly)
```
    Initialize this resource by determining its type.
    
    Parameters:
    
    legacyName - The legacy name of the DataSet. Used for lookup.
    
    dynamic - Flag indicating if this is a static or dynamic resource.
    
    referenceOnly - Flag indicating if this is a REFERENCE-ONLY resource.
    
    Throws:
    
    java.lang.IllegalStateException - If the resource type could not be determined from a LegacyResource annotation, after checking the interface hierarchy, or more than one interface is annotated.
- Method Detail
  - create
```
public static void create(handle dsHandle)
```
    Factory method. Corresponds to CREATE DATASET statement. Creates a new DataSet and stores the object in the supplied handle.
    
    Parameters:
    
    dsHandle - The destination handle.
  - create
```
public static void create(handle dsHandle,
                          java.lang.String widgetPool)
```
    Factory method. Corresponds to CREATE DATASET statement. Creates a new DataSet and stores the object in the supplied handle.
    
    Parameters:
    
    dsHandle - The destination handle.
    
    widgetPool - The widget pool to created the new DataSet into.
  - create
```
public static void create(handle dsHandle,
                          character widgetPool)
```
    Factory method. Corresponds to CREATE DATASET statement. Creates a new DataSet and stores the object in the supplied handle.
    
    Parameters:
    
    dsHandle - The destination handle.
    
    widgetPool - The widget pool to created the new DataSet into.
  - associate
```
public static void associate(DataSetParameter dsLocal,
                             DataSet dsTarget,
                             boolean input,
                             boolean output)
```
    Associate two DataSet with one another, such that all relevant records can be copied between them at prescribed times.
    
    Parameters:
    
    dsLocal - The local object relative to the current procedure. If this is an INPUT parameter then this is the 'source'. This encapsulates the actual parameter sent by caller.
    
    dsTarget - A dataset defined in current external procedure.
    
    input - If true, records are copied from source table to destination table immediately upon invocation of this method, otherwise they are not.
    
    output - When true, the records are copied from destination table back to source table when the current transaction or subtransaction is committed; otherwise they are not.
    
    See Also:
    
    TemporaryBuffer.associate(TableParameter, Temporary, boolean, boolean)
  - associate
```
public static void associate(DataSetParameter dsSrc,
                             DataSet dsTarget,
                             boolean input,
                             boolean output,
                             ParameterOption option)
```
    Associate two DataSet with one another, such that all relevant records can be copied between them at prescribed times.
    
    Parameters:
    
    dsSrc - The local object relative to the current procedure. If this is an INPUT parameter then this is the 'source'. This encapsulates the actual parameter sent by caller.
    
    dsTarget - A dataset defined in current external procedure.
    
    input - If true, records are copied from source table to destination table immediately upon invocation of this method, otherwise they are not.
    
    output - When true, the records are copied from destination table back to source table when the current transaction or subtransaction is committed; otherwise they are not.
    
    option - Dataset parameter option (APPEND, BY-VALUE, BIND or BY-REFERENCE).
    
    See Also:
    
    TemporaryBuffer.associate(TableParameter, Temporary, boolean, boolean)
  - associate
```
public static void associate(DataSetParameter dsSrc,
                             DataSet dsTarget,
                             boolean input,
                             boolean output,
                             java.util.EnumSet<ParameterOption> options)
```
    Associate two DataSet with one another, such that all relevant records can be copied between them at prescribed times.
    
    Parameters:
    
    dsSrc - The local object relative to the current procedure. If this is an INPUT parameter then this is the 'source'. This encapsulates the actual parameter sent by caller.
    
    dsTarget - A dataset defined in current external procedure.
    
    input - If true, records are copied from source table to destination table immediately upon invocation of this method, otherwise they are not.
    
    output - When true, the records are copied from destination table back to source table when the current transaction or subtransaction is committed; otherwise they are not.
    
    options - Dataset parameter options (APPEND, BY-VALUE, BIND or BY-REFERENCE).
    
    See Also:
    
    TemporaryBuffer.associate(TableParameter, Temporary, boolean, boolean)
  - associate
```
public static void associate(DataSetParameter dsLocal,
                             DataSet dsTarget)
```
    Associate two DataSet with one another, such that all relevant records can be copied between them at prescribed times.
    
    Parameters:
    
    dsLocal - The local object relative to the current procedure. If this is an INPUT parameter then this is the 'source'. This encapsulates the actual parameter sent by caller.
    
    dsTarget - A dataset defined in current external procedure.
    
    See Also:
    
    TemporaryBuffer.associate(TableParameter, Temporary)
  - associate
```
public static void associate(DataSetParameter dsSrc,
                             DataSet dsTarget,
                             ParameterOption option)
```
    Associate two DataSet with one another, such that all relevant records can be copied between them at prescribed times.
    
    Parameters:
    
    dsSrc - The local object relative to the current procedure. If this is an INPUT parameter then this is the 'source'. This encapsulates the actual parameter sent by caller.
    
    dsTarget - A dataset defined in current external procedure.
    
    option - Dataset parameter option (APPEND, BY-VALUE, BIND or BY-REFERENCE).
    
    See Also:
    
    TemporaryBuffer.associate(TableParameter, Temporary)
  - associate
```
public static void associate(DataSetParameter dsSrc,
                             DataSet dsTarget,
                             java.util.EnumSet<ParameterOption> options)
```
    Associate two DataSet with one another, such that all relevant records can be copied between them at prescribed times.
    
    Parameters:
    
    dsSrc - The local object relative to the current procedure. If this is an INPUT parameter then this is the 'source'. This encapsulates the actual parameter sent by caller.
    
    dsTarget - A dataset defined in current external procedure.
    
    options - Dataset parameter options (APPEND, BY-VALUE, BIND or BY-REFERENCE).
    
    See Also:
    
    TemporaryBuffer.associate(TableParameter, Temporary)
  - associateImpl
```
private static void associateImpl(DataSetParameter dsSrc,
                                  DataSet dsTarget,
                                  java.util.EnumSet<ParameterOption> options)
```
    Associate two DataSet with one another, such that all relevant records can be copied between them at prescribed times.
    
    Parameters:
    
    dsSrc - The local object relative to the current procedure. If this is an INPUT parameter then this is the 'source'. This encapsulates the actual parameter sent by caller.
    
    dsTarget - A dataset defined in current external procedure.
    
    options - Dataset parameter options (APPEND, BY-VALUE, BIND or BY-REFERENCE).
    
    See Also:
    
    TemporaryBuffer.associate(TableParameter, Temporary)
  - createDynamicDataSet
```
public static void createDynamicDataSet(DataSetParameter dsParam,
                                        handle dsHandle)
```
    Dynamically create a DataSet from the DataSetParameter provided. The new DataSet will be stored in dsHandle. This method is used at the beginning of a method/function in order to properly convert the PARAMETER DATASET-HANDLE constructs.
    
    Parameters:
    
    dsParam - The DataSetParameter. This is the actual parameter for the routine.
    
    dsHandle - A handle to store the reference to the new DataSet during the scope of this routine.
  - createDynamicDataSet
```
public static void createDynamicDataSet(DataSetParameter dsParam,
                                        handle dsHandle,
                                        boolean input,
                                        boolean output)
```
    Dynamically create a DataSet from the DataSetParameter provided. The new DataSet will be stored in dsHandle. This method is used at the beginning of a method/function in order to properly convert the PARAMETER DATASET-HANDLE constructs.
    
    Parameters:
    
    dsParam - The DataSetParameter. This is the actual parameter for the routine.
    
    dsHandle - A handle to store the reference to the new DataSet during the scope of this routine.
    
    input - If true then this is an INPUT or INPUT-OUTPUT parameter.
    
    output - If true then this is an OUTPUT or INPUT-OUTPUT parameter.
  - createDynamicDataSet
```
public static void createDynamicDataSet(DataSetParameter dsParam,
                                        handle dsHandle,
                                        boolean input,
                                        boolean output,
                                        ParameterOption option)
```
    Dynamically create a DataSet from the DataSetParameter provided. The new DataSet will be stored in dsHandle. This method is used at the beginning of a method/function in order to properly convert the PARAMETER DATASET-HANDLE constructs.
    
    Parameters:
    
    dsParam - The DataSetParameter. This is the actual parameter for the routine (src).
    
    dsHandle - A handle to store the reference to the new DataSet during the scope of this routine (target).
    
    input - If true then this is an INPUT or INPUT-OUTPUT parameter.
    
    output - If true then this is an OUTPUT or INPUT-OUTPUT parameter.
    
    option - Dataset parameter option (APPEND, BY-VALUE, BIND or BY-REFERENCE).
  - createDynamicDataSet
```
public static void createDynamicDataSet(DataSetParameter dsParam,
                                        handle dsHandle,
                                        ParameterOption option)
```
    Dynamically create a DataSet from the DataSetParameter provided. The new DataSet will be stored in dsHandle. This method is used at the beginning of a method/function in order to properly convert the PARAMETER DATASET-HANDLE constructs.
    
    Parameters:
    
    dsParam - The DataSetParameter. This is the actual parameter for the routine (src).
    
    dsHandle - A handle to store the reference to the new DataSet during the scope of this routine (target).
    
    option - Dataset parameter option (APPEND, BY-VALUE, BIND or BY-REFERENCE).
  - createDynamicDataSetImpl
```
private static void createDynamicDataSetImpl(DataSetParameter dsParam,
                                             handle dsHandle,
                                             ParameterOption option)
```
    Dynamically create a DataSet from the DataSetParameter provided. The new DataSet will be stored in dsHandle. This method is used at the beginning of a method/function in order to properly convert the PARAMETER DATASET-HANDLE constructs.
    
    Parameters:
    
    dsParam - The DataSetParameter. This is the actual parameter for the routine (src).
    
    dsHandle - A handle to store the reference to the new DataSet during the scope of this routine (target).
    
    option - Dataset parameter option (APPEND, BY-VALUE, BIND or BY-REFERENCE).
  - setProxyDataSet
```
public void setProxyDataSet(StaticDataSet proxyDataSet)
```
    Set the back-reference to the defining static proxy dataset.
    
    Parameters:
    
    proxyDataSet - The defining proxy dataset.
  - getProxyDataSet
```
public StaticDataSet getProxyDataSet()
```
    Get the defining proxyDataSet;
    
    Returns:
    
    See above.
  - asHandle
```
public handle asHandle()
```
    Convert this dataset to a handle.
    
    Returns:
    
    See above.
  - resetNames
```
public void resetNames()
```
    Reset name, nsPrefix and nsURI.
  - name
```
public void name(character name)
```
    Sets the name of this handle. The name cannot be unknown.
    
    Specified by:
    
    name in interface Nameable
    
    Overrides:
    
    name in class HandleChain
    
    Parameters:
    
    name - The new name to be set.
  - name
```
public character name()
```
    Get the name attribute of handle.
    
    Specified by:
    
    name in interface Nameable
    
    Overrides:
    
    name in class HandleChain
    
    Returns:
    
    See above.
  - _name
```
public java.lang.String _name()
```
    Get the name attribute of handle as a string.
    
    Overrides:
    
    _name in class HandleChain
    
    Returns:
    
    See above.
  - name
```
public void name(java.lang.String name)
```
    Sets the name attribute of the object referred by this handle.
    
    Specified by:
    
    name in interface Nameable
    
    Overrides:
    
    name in class HandleChain
    
    Parameters:
    
    name - The new name to be set to target object.
  - derefPoly
```
public java.lang.Object derefPoly(java.lang.String memberName)
```
    Emitted for :: operator used as r-value in a dynamic extent assignment, as the conversion rules doesn't know if the target field is extent or scalar.
    
    Specified by:
    
    derefPoly in interface Dereferenceable
    
    Parameters:
    
    memberName - The name of the member to be extracted.
    
    Returns:
    
    The value of the member (scalar or extent) or unknown (?) if there is no such member.
  - dereference
```
public BaseDataType dereference(java.lang.String memberName)
```
    Dereference a named member from this collection. If this collection is a ProDataSet then the returned value is a handle to a named buffer, if the collection is a buffer the returned value is the field value with the respective name. In the case that this collection does not have a named member with the name specified memberName the unknown value is returned.
    
    Specified by:
    
    dereference in interface Dereferenceable
    
    Parameters:
    
    memberName - The name of the member to be extracted.
    
    Returns:
    
    The value of the member or unknown (?) if there is no such member.
  - dereference
```
public <T extends BaseDataType> T dereference(java.lang.Class<T> type,
                                              java.lang.String memberName)
```
    Dereference a named member from this collection. If this collection is a ProDataSet then the returned value is a handle to a named buffer, if the collection is a buffer the returned value is the field value with the respective name. In the case that this collection does not have a named member with the name specified memberName the unknown value is returned.
    
    Specified by:
    
    dereference in interface Dereferenceable
    
    Parameters:
    
    type - The expected type of the returned value.
    
    memberName - The name of the member to be extracted.
    
    Returns:
    
    The value of the member or unknown (?) if there is no such member.
  - dereference
```
public void dereference(java.lang.String memberName,
                        java.lang.Object value)
```
    This overloaded method is used when the dereference is the left-side of an assignment. The implementation will extract the member from the collection and assign it the new value.
    
    Specified by:
    
    dereference in interface Dereferenceable
    
    Parameters:
    
    memberName - The name of the member to be extracted.
    
    value - The new value that will be assigned to the extracted field.
  - getPrevSibling
```
public handle getPrevSibling()
```
    Get the PREV-SIBLING attribute of this DataSet. Actually always returns null because this attribute is not supported by DataSets. Only NEXT-SIBLING is supported.
    
    Specified by:
    
    getPrevSibling in interface CommonHandleChain
    
    Overrides:
    
    getPrevSibling in class HandleChain
    
    Returns:
    
    Always null.
  - getNextSibling
```
public handle getNextSibling()
```
    Get the NEXT-SIBLING attribute of this DataSet. Actually always returns the super's getPrevSibling() because DataSets are queued in reverse order(!).
    TODO: investigate other handle resource that manifest the same from the point of NEXT/PREV-SIBLING.
    
    Specified by:
    
    getNextSibling in interface CommonHandleChain
    
    Overrides:
    
    getNextSibling in class HandleChain
    
    Returns:
    
    Always null.
  - clear
```
public logical clear()
```
    Returns the resource to it's clear state. The buffers and relations are removed. However, the content of the dataset tables is not dropped (ie, the tables are not cleared and will keep their current data).
    
    Specified by:
    
    clear in interface Clearable
    
    Returns:
    
    true if operation is successful
  - clearImpl
```
private void clearImpl(boolean delete,
                       boolean resetProperties)
```
    Clears the dataset. Deletes the relations, unlinks the buffers and reset all internal data to default values.
    After being invoked on a dynamic DataSet the object gets ready to be repopulated. In this case the method can be invoked multiple times.
    In the case of a static DataSets, the method is called only once, when the object is destroyed. It only makes it easy for GC to free the occupied resources.
    
    Parameters:
    
    delete - The dataset will be deleted. If there are dynamic buffers associated with it having AUTO-DELETE attribute set they will be also deleted.
    
    resetProperties - If true all attributes of the dataset are set to unknown values.
  - _dynamic
```
public boolean _dynamic()
```
    Returns true if the buffer is dynamic.
    This is not emitted by conversion, is used internally by FWD.
    
    Specified by:
    
    _dynamic in interface DynamicResource
    
    Returns:
    
    true if the resource is dynamic, false otherwise.
  - getChanges
```
public logical getChanges(handle original)
```
    Loads the empty target (DataSet or TempTable) object with changed rows from original (source) object.
    
    Specified by:
    
    getChanges in interface DataSetChangeable
    
    Parameters:
    
    original - Handle to original object (DataSet or TempTable) that contains the changed rows to load into the target object.
    
    Returns:
    
    true if operation is successful.
  - getChanges
```
public logical getChanges(handle original,
                          logical parentMode)
```
    Loads the empty target (DataSet or TempTable) object with changed rows from original (source) object.
    
    Specified by:
    
    getChanges in interface DataSetChangeable
    
    Parameters:
    
    original - Handle to original object (DataSet or TempTable) that contains the changed rows to load into the target object.
    
    parentMode - When TRUE the target gets the changed parent rows of each changed child row.
    
    Returns:
    
    true if operation is successful.
  - getChanges
```
public logical getChanges(handle original,
                          boolean parentMode)
```
    Loads the empty target (DataSet or TempTable) object with changed rows from original (source) object.
    
    Specified by:
    
    getChanges in interface DataSetChangeable
    
    Parameters:
    
    original - Handle to original object (DataSet or TempTable) that contains the changed rows to load into the target object.
    
    parentMode - When TRUE the target gets the changed parent rows of each changed child row.
    
    Returns:
    
    true if operation is successful.
  - mergeChanges
```
public logical mergeChanges(handle original)
```
    Merges the changed rows of all temp-tables or a single temp-table in a source DataSet object loaded with the GET-CHANGES() method into the corresponding rows of all temp-tables or a single temp-table (respectively) in the original (target) DataSet object.
    
    Specified by:
    
    mergeChanges in interface DataSetChangeable
    
    Parameters:
    
    original - A handle to the original (target) DataSet object or the buffer object of a single target DataSet temp-table to merge with the changed rows from the source object.
    
    Returns:
    
    true if operation is successful.
  - mergeChanges
```
public logical mergeChanges(handle original,
                            logical allCopyMode)
```
    Merges the changed rows of all temp-tables or a single temp-table in a source DataSet object loaded with the GET-CHANGES() method into the corresponding rows of all temp-tables or a single temp-table (respectively) in the original (target) DataSet object.
    
    Specified by:
    
    mergeChanges in interface DataSetChangeable
    
    Parameters:
    
    original - A handle to the original (target) DataSet object or the 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.
    
    Returns:
    
    true if operation is successful.
  - mergeChanges
```
public logical mergeChanges(handle original,
                            boolean allCopyMode)
```
    Merges the changed rows of all temp-tables or a single temp-table in a source DataSet object loaded with the GET-CHANGES() method into the corresponding rows of all temp-tables or a single temp-table (respectively) in the original (target) DataSet object.
    
    Specified by:
    
    mergeChanges in interface DataSetChangeable
    
    Parameters:
    
    original - A handle to the original (target) DataSet object or the 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.
    
    Returns:
    
    true if operation is successful.
  - createLike
```
public logical createLike(handle hds)
```
    Duplicates the structure of an existing DataSet, copying its entire structure. This method is the P2J equivalent of CREATE-LIKE method of Progress 4GL.
    
    Specified by:
    
    createLike in interface CreateLike
    
    Parameters:
    
    hds - A handle to a DataSet from which to copy the definitions.
    
    Returns:
    
    true on success.
  - createLike
```
public logical createLike(java.lang.String dsName)
```
    Duplicates the structure of an existing DataSet, copying its entire structure. This method is the P2J equivalent of CREATE-LIKE method of Progress 4GL.
    
    Specified by:
    
    createLike in interface CreateLike
    
    Parameters:
    
    dsName - The name of DataSet from which to copy the definitions.
    
    Returns:
    
    true on success.
  - createLike
```
public logical createLike(character dsName)
```
    Duplicates the structure of an existing DataSet, copying its entire structure. This method is the P2J equivalent of CREATE-LIKE method of Progress 4GL.
    
    Specified by:
    
    createLike in interface CreateLike
    
    Parameters:
    
    dsName - The name of DataSet from which to copy the definitions.
    
    Returns:
    
    true on success.
  - createLike
```
public logical createLike(handle hds,
                          java.lang.String prefix)
```
    Duplicates the structure of an existing DataSet, copying its entire structure. This method is the P2J equivalent of CREATE-LIKE method of Progress 4GL.
    
    Specified by:
    
    createLike in interface CreateLike
    
    Parameters:
    
    hds - A handle to a DataSet from which to copy the definitions.
    
    prefix - The prefix to prepend to each of the source DataSet member buffer names, which creates a new name for each new member buffer.
    
    Returns:
    
    true on success.
  - createLike
```
public logical createLike(handle hds,
                          character prefix)
```
    Duplicates the structure of an existing DataSet, copying its entire structure. This method is the P2J equivalent of CREATE-LIKE method of Progress 4GL.
    
    Specified by:
    
    createLike in interface CreateLike
    
    Parameters:
    
    hds - A handle to a DataSet from which to copy the definitions.
    
    prefix - The prefix to prepend to each of the source DataSet member buffer names, which creates a new name for each new member buffer.
    
    Returns:
    
    true on success.
  - createLike
```
public logical createLike(java.lang.String dsName,
                          java.lang.String prefix)
```
    Duplicates the structure of an existing DataSet, copying its entire structure. This method is the P2J equivalent of CREATE-LIKE method of Progress 4GL.
    
    Specified by:
    
    createLike in interface CreateLike
    
    Parameters:
    
    dsName - The name of DataSet from which to copy the definitions.
    
    prefix - The prefix to prepend to each of the source DataSet member buffer names, which creates a new name for each new member buffer.
    
    Returns:
    
    true on success.
  - createLike
```
public logical createLike(character dsName,
                          character prefix)
```
    Duplicates the structure of an existing DataSet, copying its entire structure. This method is the P2J equivalent of CREATE-LIKE method of Progress 4GL.
    
    Specified by:
    
    createLike in interface CreateLike
    
    Parameters:
    
    dsName - The name of DataSet from which to copy the definitions.
    
    prefix - The prefix to prepend to each of the source DataSet member buffer names, which creates a new name for each new member buffer.
    
    Returns:
    
    true on success.
  - copyTempTable
```
public logical copyTempTable(handle other)
```
    Copies the other TEMP-TABLE. Other must be a TEMP-TABLE handle. By default, all current records are dropped before copy operation.
    The only reason the TempTableDuplicator is implemented by DataSet is that we found it static code (@code DATASET DSet:COPY-TEMP-TABLE()}). If the method was referenced via handle interface, the handle would automatically unwrap it to an invalidAttrAccessProxy. Because the method is accessed directly from the object, however, makes it mandatory that the DataSet to implement the interface.
    
    Specified by:
    
    copyTempTable in interface TempTableDuplicator
    
    Parameters:
    
    other - Some other temp-table to copy from.
    
    Returns:
    
    true if operation is successful.
  - copyTempTable
```
public logical copyTempTable(handle other,
                             logical append)
```
    Copies the other TEMP-TABLE. Other must be a TEMP-TABLE handle. By default, all current records are dropped before copy operation.
    The only reason the TempTableDuplicator is implemented by DataSet is that we found it static code (@code DATASET DSet:COPY-TEMP-TABLE()}). If the method was referenced via handle interface, the handle would automatically unwrap it to an invalidAttrAccessProxy. Because the method is accessed directly from the object, however, makes it mandatory that the DataSet to implement the interface.
    
    Specified by:
    
    copyTempTable in interface TempTableDuplicator
    
    Parameters:
    
    other - Some other temp-table to copy from.
    
    append - Append mode.
    
    Returns:
    
    true if operation is successful.
  - copyTempTable
```
public logical copyTempTable(handle other,
                             logical append,
                             logical replace)
```
    Copies the other TEMP-TABLE. Other must be a TEMP-TABLE handle. By default, all current records are dropped before copy operation.
    The only reason the TempTableDuplicator is implemented by DataSet is that we found it static code (@code DATASET DSet:COPY-TEMP-TABLE()}). If the method was referenced via handle interface, the handle would automatically unwrap it to an invalidAttrAccessProxy. Because the method is accessed directly from the object, however, makes it mandatory that the DataSet to implement the interface.
    
    Specified by:
    
    copyTempTable in interface TempTableDuplicator
    
    Parameters:
    
    other - Some other temp-table to copy from.
    
    append - Append mode.
    
    replace - Replace mode.
    
    Returns:
    
    true if operation is successful
  - copyTempTable
```
public logical copyTempTable(handle other,
                             logical append,
                             logical replace,
                             logical looseCopy)
```
    Copies the other TEMP-TABLE. Other must be a TEMP-TABLE handle. By default, all current records are dropped before copy operation.
    The only reason the TempTableDuplicator is implemented by DataSet is that we found it static code (@code DATASET DSet:COPY-TEMP-TABLE()}). If the method was referenced via handle interface, the handle would automatically unwrap it to an invalidAttrAccessProxy. Because the method is accessed directly from the object, however, makes it mandatory that the DataSet to implement the interface.
    
    Specified by:
    
    copyTempTable in interface TempTableDuplicator
    
    Parameters:
    
    other - Some other temp-table to copy from.
    
    append - Append mode.
    
    replace - Replace mode.
    
    looseCopy - Loose copy mode.
    
    Returns:
    
    true if operation is successful.
  - copyTempTable
```
public logical copyTempTable(handle other,
                             boolean append)
```
    Copies the other TEMP-TABLE. Other must be a TEMP-TABLE handle. By default, all current records are dropped before copy operation.
    The only reason the TempTableDuplicator is implemented by DataSet is that we found it static code (@code DATASET DSet:COPY-TEMP-TABLE()}). If the method was referenced via handle interface, the handle would automatically unwrap it to an invalidAttrAccessProxy. Because the method is accessed directly from the object, however, makes it mandatory that the DataSet to implement the interface.
    
    Specified by:
    
    copyTempTable in interface TempTableDuplicator
    
    Parameters:
    
    other - Some other temp-table to copy from.
    
    append - Append mode.
    
    Returns:
    
    true if operation is successful.
  - copyTempTable
```
public logical copyTempTable(handle other,
                             boolean append,
                             boolean replace)
```
    Copies the other TEMP-TABLE. Other must be a TEMP-TABLE handle. By default, all current records are dropped before copy operation.
    The only reason the TempTableDuplicator is implemented by DataSet is that we found it static code (@code DATASET DSet:COPY-TEMP-TABLE()}). If the method was referenced via handle interface, the handle would automatically unwrap it to an invalidAttrAccessProxy. Because the method is accessed directly from the object, however, makes it mandatory that the DataSet to implement the interface.
    
    Specified by:
    
    copyTempTable in interface TempTableDuplicator
    
    Parameters:
    
    other - Some other temp-table to copy from.
    
    append - Append mode.
    
    replace - Replace mode.
    
    Returns:
    
    true if operation is successful.
  - copyTempTable
```
public logical copyTempTable(handle other,
                             boolean append,
                             boolean replace,
                             boolean looseCopy)
```
    Copies the other TEMP-TABLE. Other must be a TEMP-TABLE handle. By default, all current records are dropped before copy operation.
    The only reason the TempTableDuplicator is implemented by DataSet is that we found it static code (@code DATASET DSet:COPY-TEMP-TABLE()}). If the method was referenced via handle interface, the handle would automatically unwrap it to an invalidAttrAccessProxy. Because the method is accessed directly from the object, however, makes it mandatory that the DataSet to implement the interface.
    
    Specified by:
    
    copyTempTable in interface TempTableDuplicator
    
    Parameters:
    
    other - Some other temp-table to copy from.
    
    append - Append mode.
    
    replace - Replace mode.
    
    looseCopy - Loose copy mode.
    
    Returns:
    
    true if operation is successful.
  - copyTempTable
```
public logical copyTempTable(handle other,
                             logical append,
                             logical replace,
                             logical looseCopy,
                             character prefix)
```
    Copies the other TEMP-TABLE. Other must be a TEMP-TABLE handle. By default, all current records are dropped before copy operation. Only the first parameter is mandatory so this method will probably be heavy overloaded.
    The only reason the TempTableDuplicator is implemented by DataSet is that we found it static code (@code DATASET DSet:COPY-TEMP-TABLE()}). If the method was referenced via handle interface, the handle would automatically unwrap it to an invalidAttrAccessProxy. Because the method is accessed directly from the object, however, makes it mandatory that the DataSet to implement the interface.
    
    Specified by:
    
    copyTempTable in interface TempTableDuplicator
    
    Parameters:
    
    other - Some other temp-table to copy from.
    
    append - Append mode.
    
    replace - Replace mode.
    
    looseCopy - Loose copy mode.
    
    prefix - Prefix for naming the copied temp-table.
    
    Returns:
    
    true if operation is successful.
  - copyTempTable
```
public logical copyTempTable(handle other,
                             boolean append,
                             boolean replace,
                             boolean looseCopy,
                             java.lang.String prefix)
```
    Copies the other TEMP-TABLE. Other must be a TEMP-TABLE handle. By default, all current records are dropped before copy operation. Only the first parameter is mandatory so this method will probably be heavy overloaded.
    The only reason the TempTableDuplicator is implemented by DataSet is that we found it static code (@code DATASET DSet:COPY-TEMP-TABLE()}). If the method was referenced via handle interface, the handle would automatically unwrap it to an invalidAttrAccessProxy. Because the method is accessed directly from the object, however, makes it mandatory that the DataSet to implement the interface.
    
    Specified by:
    
    copyTempTable in interface TempTableDuplicator
    
    Parameters:
    
    other - Some other temp-table to copy from.
    
    append - Append mode.
    
    replace - Replace mode.
    
    looseCopy - Loose copy mode.
    
    prefix - Prefix for naming the copied temp-table.
    
    Returns:
    
    true if operation is successful.
  - isReuseFillQuery
```
boolean isReuseFillQuery()
```
    Check if the buffer's fill query can be re-used.
  - fill
```
public logical fill()
```
    Fills a DataSet object, recursively, based on its defined data sources, data relations, and queries. When invoked on one of its member Buffer objects a partial fill is performed, by starting at the respective level.
    
    Specified by:
    
    fill in interface Fillable
    
    Returns:
    
    true if operation is successful.
  - fillMode
```
public character fillMode()
```
    Obtain the mode in which the fill() method fills a DataSet member buffer. The default mode is MERGE.
    Note: Undocumented feature: query all buffers and returns the common fill mode if one exist. Otherwise returns unknown value.
    
    Specified by:
    
    fillMode in interface Fillable
    
    Returns:
    
    always unknown value.
  - fillMode
```
public void fillMode(java.lang.String mode)
```
    Configures the mode in which the fill() method fills a DataSet member buffer. The allowed modes are: APPEND, EMPTY, MERGE, NO-FILL, and REPLACE.
    Note: Undocumented feature: set the fill mode on all buffers.
    
    Specified by:
    
    fillMode in interface Fillable
    
    Parameters:
    
    mode - The new fill mode for the buffers of this dataset.
  - fillMode
```
public void fillMode(Text mode)
```
    Configures the mode in which the fill() method fills a DataSet member buffer. The allowed modes are: APPEND, EMPTY, MERGE, NO-FILL, and REPLACE.
    Note: Undocumented feature: set the fill mode on all buffers.
    
    Specified by:
    
    fillMode in interface Fillable
    
    Parameters:
    
    mode - the new fill mode for this buffer.
  - numReferences
```
public integer numReferences()
```
    Obtain number of references to a Buffer, DataSet, or TempTable object that is defined as a parameter to which reference-only objects are bound. This corresponds to the read-only NUM-REFERENCES attribute.
    
    Specified by:
    
    numReferences in interface RefCounter
    
    Returns:
    
    number of references to this object.
  - isDataSourceModified
```
public logical isDataSourceModified()
```
    Checks whether the data in the data source has been modified.
    
    Specified by:
    
    isDataSourceModified in interface DataSourceModifiable
    
    Returns:
    
    true when the data has been modified.
  - setDataSourceModified
```
public void setDataSourceModified(logical mod)
```
    Manually mark the data in the target structure as modified.
    
    Specified by:
    
    setDataSourceModified in interface DataSourceModifiable
    
    Parameters:
    
    mod - true when the data is marked as modified and false otherwise.
  - setDataSourceModified
```
public void setDataSourceModified(boolean mod)
```
    Manually mark the data in the target structure as modified.
    
    Specified by:
    
    setDataSourceModified in interface DataSourceModifiable
    
    Parameters:
    
    mod - true when the data is marked as modified and false otherwise.
  - acceptChanges
```
public logical acceptChanges()
```
    Accepts changes to the data in target object (a temp-table or all temp-tables in a DataSet).
    
    Specified by:
    
    acceptChanges in interface DataSetChangeable
    
    Returns:
    
    true if operation is successful.
  - rejectChanges
```
public logical rejectChanges()
```
    Rejects changes to the data in target object (a temp-table or all temp-tables in a DataSet).
    
    Specified by:
    
    rejectChanges in interface DataSetChangeable
    
    Returns:
    
    true if operation is successful.
  - applyCallback
```
public logical applyCallback(java.lang.String eventName)
```
    Applies a callback procedure, which allows execution of a defined event without duplicating the event procedure definition.
    
    Specified by:
    
    applyCallback in interface CallbackProcedure
    
    Parameters:
    
    eventName - The event whose callback will be called.
    
    Returns:
    
    true if operation is successful.
  - getCallbackProcName
```
public character getCallbackProcName(java.lang.String eventName)
```
    Retrieves the name of the internal procedure associated with the ABL callback for the specified event.
    
    Specified by:
    
    getCallbackProcName in interface CallbackProcedure
    
    Parameters:
    
    eventName - The name of the event.
    
    Returns:
    
    the name of the internal procedure associated with specified event.
  - getCallbackProcContext
```
public handle getCallbackProcContext(java.lang.String eventName)
```
    Retrieves the handle of the procedure that contains the internal procedure associated with the ABL callback for the specified event
    
    Specified by:
    
    getCallbackProcContext in interface CallbackProcedure
    
    Parameters:
    
    eventName - The name of the event.
    
    Returns:
    
    a handle to the procedure that contains the callback procedure.
  - setCallback
```
public logical setCallback(java.lang.String callbackName,
                           java.lang.String routineName,
                           object<?> context)
```
    Configures a callback. Creates an association between a method within a class instance or an internal procedure within a persistent procedure, with an ABL callback event.
    
    Specified by:
    
    setCallback in interface CallbackProcedure
    
    Parameters:
    
    callbackName - The name of a callback.
    
    routineName - The name of a method or an internal procedure to be associated.
    
    context - The context in which the callback will be executed.
    
    Returns:
    
    true if callbackName is a correct callback name. The rest of parameters are ignored (note: manual states otherwise).
  - setCallbackProcedure
```
public logical setCallbackProcedure(java.lang.String eventName,
                                    java.lang.String callback,
                                    handle context)
```
    Associates an internal procedure with an ABL callback event.
    
    Specified by:
    
    setCallbackProcedure in interface CallbackProcedure
    
    Parameters:
    
    eventName - The eventName of the event.
    
    callback - The eventName of the internal procedure associated with the callback event.
    
    context - A handle to a procedure that contains the internal procedure specified by callback. If not specified, THIS-PROCEDURE is used as the procedure context.
    
    Returns:
    
    true when the method ends with success.
  - namespaceURI
```
public character namespaceURI()
```
    Returns the value of the the NAMESPACE-URI attribute.
    
    Specified by:
    
    namespaceURI in interface NamespaceURI
    
    Returns:
    
    See above.
  - namespaceURI
```
public void namespaceURI(java.lang.String uri)
```
    Setter for NAMESPACE-URI attribute.
    
    Specified by:
    
    namespaceURI in interface NamespaceURI
    
    Parameters:
    
    uri - The new value of the NAMESPACE-URI attribute.
  - namespaceURI
```
public void namespaceURI(character uri)
```
    Setter for NAMESPACE-URI attribute.
    
    Specified by:
    
    namespaceURI in interface NamespaceURI
    
    Parameters:
    
    uri - The new value of the NAMESPACE-URI attribute.
  - getXmlNodeName
```
public character getXmlNodeName()
```
    Obtain the name of the XML element or attribute representing the target object (a DataSet) name in an XML document. If not set the name is returned. If the name is empty "ProDataSet" is returned.
    
    Specified by:
    
    getXmlNodeName in interface XmlNode
    
    Returns:
    
    the name of the XML element for this object.
  - getXmlNodeNameInternal
```
public java.lang.String getXmlNodeNameInternal()
```
    Obtain the name of the XML element or attribute representing the target object. May return null, unlike the getXmlNodeName() attribute implementation.
    
    Returns:
    
    the name of the XML element for this object.
  - getNsUri
```
public java.lang.String getNsUri()
```
    Returns the value of the the NAMESPACE-URI attribute as String.
    
    Returns:
    
    See above.
  - setXmlNodeName
```
public void setXmlNodeName(java.lang.String name)
```
    Sets the name of the XML element or attribute representing the target object (either a DataSet, a TempTable, a TemporaryBuffer, or a temp-table BufferField) name in an XML document.
    
    Specified by:
    
    setXmlNodeName in interface XmlNode
    
    Parameters:
    
    name - The new name of the XML element for this object.
  - setXmlNodeName
```
public void setXmlNodeName(Text name)
```
    Sets the name of the XML element or attribute representing the target object (either a DataSet, a TempTable, a TemporaryBuffer, or a temp-table BufferField) name in an XML document.
    
    Specified by:
    
    setXmlNodeName in interface XmlNode
    
    Parameters:
    
    name - The new name of the XML element for this object.
  - getSerializeName
```
public character getSerializeName()
```
    Implementation of the read access of the SERIALIZE-NAME attribute.
    
    Specified by:
    
    getSerializeName in interface NamedSerializable
    
    Returns:
    
    the current value of the SERIALIZE-NAME attribute.
  - setSerializeName
```
public void setSerializeName(Text sName)
```
    Implementation of the write access of the SERIALIZE-NAME attribute.
    
    Specified by:
    
    setSerializeName in interface NamedSerializable
    
    Parameters:
    
    sName - the new value for the SERIALIZE-NAME attribute.
  - setSerializeName
```
public void setSerializeName(java.lang.String sName)
```
    Implementation of the write access of the SERIALIZE-NAME attribute.
    
    Specified by:
    
    setSerializeName in interface NamedSerializable
    
    Parameters:
    
    sName - the new value for the SERIALIZE-NAME attribute.
  - error
```
public logical error()
```
    Returns the state of the ERROR attribute
    
    Specified by:
    
    error in interface Errorable
    
    Returns:
    
    Current state of the ERROR attribute.
  - error
```
public void error(boolean value)
```
    Setter for ERROR attribute.
    
    Specified by:
    
    error in interface Errorable
    
    Parameters:
    
    value - The new value of ERROR attribute.
  - error
```
public void error(logical value)
```
    Setter for ERROR attribute.
    
    Specified by:
    
    error in interface Errorable
    
    Parameters:
    
    value - The new value of ERROR attribute.
  - rejected
```
public logical rejected()
```
    Returns the state of the REJECTED attribute
    
    Specified by:
    
    rejected in interface Rejectable
    
    Returns:
    
    Current state of the REJECTED attribute.
  - rejected
```
public void rejected(boolean value)
```
    Setter for REJECTED attribute.
    
    Specified by:
    
    rejected in interface Rejectable
    
    Parameters:
    
    value - The new value of REJECTED attribute.
  - rejected
```
public void rejected(logical value)
```
    Setter for REJECTED attribute.
    
    Specified by:
    
    rejected in interface Rejectable
    
    Parameters:
    
    value - The new value of REJECTED attribute.
  - valid
```
public boolean valid()
```
    Reports if this object is valid for use. The DataSet is valid
    
    Specified by:
    
    valid in interface WrappedResource
    
    Returns:
    
    true if we are valid (can be used).
  - getADMData
```
public character getADMData()
```
    Get the value of the ADM-DATA attribute.
    
    Specified by:
    
    getADMData in interface ADMData
    
    Returns:
    
    See above.
  - setADMData
```
public void setADMData(java.lang.String value)
```
    Set the value of the ADM-DATA attribute.
    
    Specified by:
    
    setADMData in interface ADMData
    
    Parameters:
    
    value - The new value.
  - setADMData
```
public void setADMData(character value)
```
    Set the value of the ADM-DATA attribute.
    
    Specified by:
    
    setADMData in interface ADMData
    
    Parameters:
    
    value - The new value.
  - emptyDataset
```
public logical emptyDataset()
```
    Empties this DataSet object of all records in its associated temp-tables.
    
    Specified by:
    
    emptyDataset in interface DataSetInterface
    
    Returns:
    
    true on success.
  - getRelation
```
public handle getRelation()
```
    Gets the handle of the specified data-relation object.
    
    Specified by:
    
    getRelation in interface DataSetInterface
    
    Returns:
    
    the handle of the specified data-relation object.
  - getRelationNative
```
public DataRelation getRelationNative()
```
    Gets the handle of the specified data-relation object.
    
    Returns:
    
    the handle of the specified data-relation object.
  - getRelation
```
public handle getRelation(NumberType index)
```
    Gets the handle of the specified data-relation object.
    
    Specified by:
    
    getRelation in interface DataSetInterface
    
    Parameters:
    
    index - The index (1-based) of the data-relation to be returned.
    
    Returns:
    
    the handle of the specified data-relation object.
  - getRelation
```
public handle getRelation(long index)
```
    Gets the handle of the specified data-relation object.
    
    Specified by:
    
    getRelation in interface DataSetInterface
    
    Parameters:
    
    index - The index (1-based) of the data-relation to be returned.
    
    Returns:
    
    the handle of the specified data-relation object.
  - getRelationNative
```
public DataRelation getRelationNative(long index)
```
    Gets the handle of the specified data-relation object.
    
    Parameters:
    
    index - The index (1-based) of the data-relation to be returned.
    
    Returns:
    
    the handle of the specified data-relation object.
  - getRelations
```
public java.util.stream.Stream<DataRelation> getRelations()
```
    Get relations as stream.
    
    Returns:
    
    relations as stream
  - getRelation
```
public handle getRelation(Text name)
```
    Gets the handle of the specified data-relation object.
    
    Specified by:
    
    getRelation in interface DataSetInterface
    
    Parameters:
    
    name - The name of the data-relation to be returned.
    
    Returns:
    
    the handle of the specified data-relation object.
  - getRelation
```
public handle getRelation(java.lang.String name)
```
    Gets the handle of the specified data-relation object.
    
    Specified by:
    
    getRelation in interface DataSetInterface
    
    Parameters:
    
    name - The name of the data-relation to be returned.
    
    Returns:
    
    the handle of the specified data-relation object.
  - getTopBuffer
```
public handle getTopBuffer()
```
    Gets the top-level buffer of this DataSet object at the specified index position.
    
    Specified by:
    
    getTopBuffer in interface DataSetInterface
    
    Returns:
    
    the top-level buffer at the position 1.
  - getTopBuffer
```
public handle getTopBuffer(long index)
```
    Gets the top-level buffer of this DataSet object at the specified index position.
    
    Specified by:
    
    getTopBuffer in interface DataSetInterface
    
    Parameters:
    
    index - The 1-based index of the top-level buffer.
    
    Returns:
    
    the top-level buffer at the specified index position.
  - getTopBufferNative
```
public BufferImpl getTopBufferNative(long index)
```
    Gets the top-level buffer of this DataSet object at the specified index position.
    
    Parameters:
    
    index - The 1-based index of the top-level buffer.
    
    Returns:
    
    the top-level buffer at the specified index position.
  - getTopBuffer
```
public handle getTopBuffer(NumberType index)
```
    Gets the top-level buffer of this DataSet object at the specified index position.
    
    Specified by:
    
    getTopBuffer in interface DataSetInterface
    
    Parameters:
    
    index - The 1-based index of the top-level buffer.
    
    Returns:
    
    the top-level buffer at the specified index position.
  - getTopNavQuery
```
public handle getTopNavQuery()
```
    Obtain default navigation query for a top-level buffer of this DataSet object. This method correspond to the getter side of TOP-NAV-QUERY ABL attribute.
    
    Specified by:
    
    getTopNavQuery in interface DataSetInterface
    
    Returns:
    
    the default navigation query for a top-level buffer.
  - getTopNavQuery
```
public handle getTopNavQuery(long index)
```
    Obtain default navigation query for a top-level buffer of this DataSet object. This method correspond to the getter side of TOP-NAV-QUERY ABL attribute.
    
    Specified by:
    
    getTopNavQuery in interface DataSetInterface
    
    Parameters:
    
    index - The 1-based index of the top-level buffer.
    
    Returns:
    
    the default navigation query for a top-level buffer.
  - getTopNavQuery
```
public handle getTopNavQuery(NumberType index)
```
    Obtain default navigation query for a top-level buffer of this DataSet object. This method correspond to the getter side of TOP-NAV-QUERY ABL attribute.
    
    Specified by:
    
    getTopNavQuery in interface DataSetInterface
    
    Parameters:
    
    index - The 1-based index of the top-level buffer.
    
    Returns:
    
    the default navigation query for a top-level buffer.
  - getTopNavQuery
```
public handle getTopNavQuery(java.lang.String bufName)
```
    Obtain default navigation query for a top-level buffer of this DataSet object. This method correspond to the getter side of TOP-NAV-QUERY ABL attribute.
    
    Specified by:
    
    getTopNavQuery in interface DataSetInterface
    
    Parameters:
    
    bufName - The name of the top-level buffer.
    
    Returns:
    
    the default navigation query for a top-level buffer.
  - getTopNavQuery
```
public handle getTopNavQuery(Text bufName)
```
    Obtain default navigation query for a top-level buffer of this DataSet object. This method correspond to the getter side of TOP-NAV-QUERY ABL attribute.
    
    Specified by:
    
    getTopNavQuery in interface DataSetInterface
    
    Parameters:
    
    bufName - The name of the top-level buffer.
    
    Returns:
    
    the default navigation query for a top-level buffer.
  - setTopNavQuery
```
public void setTopNavQuery(handle queryHandle)
```
    Configures the default navigation query for a top-level buffer of this DataSet object. This method correspond to the setter side of TOP-NAV-QUERY ABL attribute.
    
    Specified by:
    
    setTopNavQuery in interface DataSetInterface
    
    Parameters:
    
    queryHandle - The new default navigation query for a top-level buffer.
  - setTopNavQuery
```
public void setTopNavQuery(long index,
                           handle queryHandle)
```
    Configures the default navigation query for a top-level buffer of this DataSet object. This method correspond to the setter side of TOP-NAV-QUERY ABL attribute.
    
    Specified by:
    
    setTopNavQuery in interface DataSetInterface
    
    Parameters:
    
    index - The 1-based index of the top-level buffer.
    
    queryHandle - The new default navigation query for a top-level buffer.
  - setTopNavQuery
```
public void setTopNavQuery(NumberType index,
                           handle queryHandle)
```
    Configures the default navigation query for a top-level buffer of this DataSet object. This method correspond to the setter side of TOP-NAV-QUERY ABL attribute.
    
    Specified by:
    
    setTopNavQuery in interface DataSetInterface
    
    Parameters:
    
    index - The 1-based index of the top-level buffer.
    
    queryHandle - The new default navigation query for a top-level buffer.
  - setTopNavQuery
```
public void setTopNavQuery(java.lang.String bufName,
                           handle queryHandle)
```
    Configures the default navigation query for a top-level buffer of this DataSet object. This method correspond to the setter side of TOP-NAV-QUERY ABL attribute.
    
    Specified by:
    
    setTopNavQuery in interface DataSetInterface
    
    Parameters:
    
    bufName - The name of the top-level buffer.
    
    queryHandle - The new default navigation query for a top-level buffer.
  - setTopNavQuery
```
public void setTopNavQuery(Text bufName,
                           handle queryHandle)
```
    Configures the default navigation query for a top-level buffer of this DataSet object. This method correspond to the setter side of TOP-NAV-QUERY ABL attribute.
    
    Specified by:
    
    setTopNavQuery in interface DataSetInterface
    
    Parameters:
    
    bufName - The name of the top-level buffer.
    
    queryHandle - The new default navigation query for a top-level buffer.
  - areRelationsActive
```
public logical areRelationsActive()
```
    Checks whether AT LEAST one data-relation objects in this DataSet object is active. All data-relation objects in a DataSet object are active by default.
    
    Specified by:
    
    areRelationsActive in interface DataSetInterface
    
    Returns:
    
    true when all data-relation objects are active.
  - setRelationsActive
```
public void setRelationsActive(logical active)
```
    Configures whether all data-relation objects in this DataSet object to be active or inactive. Setting this attribute to TRUE will activate all data-relation objects. Setting it to FALSE will deactivate all data-relation objects instead.
    
    Specified by:
    
    setRelationsActive in interface DataSetInterface
    
    Parameters:
    
    active - The new value for RELATIONS-ACTIVE attribute.
  - setRelationsActive
```
public void setRelationsActive(boolean active)
```
    Configures whether all data-relation objects in this DataSet object to be active or inactive. Setting this attribute to TRUE will activate all data-relation objects. Setting it to FALSE will deactivate all data-relation objects instead.
    
    Specified by:
    
    setRelationsActive in interface DataSetInterface
    
    Parameters:
    
    active - The new value for RELATIONS-ACTIVE attribute.
  - getNumRelations
```
public integer getNumRelations()
```
    Get the number of data-relation objects of this DataSet object.
    
    Specified by:
    
    getNumRelations in interface DataSetInterface
    
    Returns:
    
    the number of data-relation objects of this DataSet object.
  - getNumTopBuffers
```
public integer getNumTopBuffers()
```
    Obtain the number of top-level buffers in this DataSet object.
    
    Specified by:
    
    getNumTopBuffers in interface DataSetInterface
    
    Returns:
    
    the number of top-level buffers in this DataSet object.
  - addRelation
```
public handle addRelation(handle parent,
                          handle child,
                          Text pairs)
```
    Creates a new data-relation object for a pair of parent and child buffers of this DataSet object. This method applies only to DataSet objects dynamically created.
    
    Specified by:
    
    addRelation in interface DataSetInterface
    
    Parameters:
    
    parent - The handle to the parent buffer in the data-relation object.
    
    child - The handle to the child buffer in the data-relation object.
    
    pairs - A comma-delimited list of parent-field, child-field pairs describing the relationship between parent and child buffers in the new data-relation object.
    
    Returns:
    
    A handle to the newly created DataRelation.
  - addRelation
```
public handle addRelation(handle parent,
                          handle child,
                          Text pairs,
                          logical reposition)
```
    Creates a new data-relation object for a pair of parent and child buffers of this DataSet object. This method applies only to DataSet objects dynamically created.
    
    Specified by:
    
    addRelation in interface DataSetInterface
    
    Parameters:
    
    parent - The handle to the parent buffer in the data-relation object.
    
    child - The handle to the child buffer in the data-relation object.
    
    pairs - A comma-delimited list of parent-field, child-field pairs describing the relationship between parent and child buffers in the new data-relation object.
    
    reposition - The reposition mode. If TRUE, the relation mode is REPOSITION. Otherwise the relation mode is SELECTION. The default value is SELECTION.
    
    Returns:
    
    A handle to the newly created DataRelation.
  - addRelation
```
public handle addRelation(handle parent,
                          handle child,
                          Text pairs,
                          logical reposition,
                          logical nested)
```
    Creates a new data-relation object for a pair of parent and child buffers of this DataSet object. This method applies only to DataSet objects dynamically created.
    
    Specified by:
    
    addRelation in interface DataSetInterface
    
    Parameters:
    
    parent - The handle to the parent buffer in the data-relation object.
    
    child - The handle to the child buffer in the data-relation object.
    
    pairs - A comma-delimited list of parent-field, child-field pairs describing the relationship between parent and child buffers in the new data-relation object.
    
    reposition - The reposition mode. If TRUE, the relation mode is REPOSITION. Otherwise the relation mode is SELECTION. The default value is SELECTION.
    
    nested - Use TRUE to nest child rows of DataSet buffers within their parent rows when writing the XML representation of data. When FALSE is passed, all child rows are written after all parent rows are written. The default value is FALSE.
    
    Returns:
    
    A handle to the newly created DataRelation.
  - addRelation
```
public handle addRelation(handle parent,
                          handle child,
                          Text pairs,
                          logical reposition,
                          logical nested,
                          logical active)
```
    Creates a new data-relation object for a pair of parent and child buffers of this DataSet object. This method applies only to DataSet objects dynamically created.
    
    Specified by:
    
    addRelation in interface DataSetInterface
    
    Parameters:
    
    parent - The handle to the parent buffer in the data-relation object.
    
    child - The handle to the child buffer in the data-relation object.
    
    pairs - A comma-delimited list of parent-field, child-field pairs describing the relationship between parent and child buffers in the new data-relation object.
    
    reposition - The reposition mode. If TRUE, the relation mode is REPOSITION. Otherwise the relation mode is SELECTION. The default value is SELECTION.
    
    nested - Use TRUE to nest child rows of DataSet buffers within their parent rows when writing the XML representation of data. When FALSE is passed, all child rows are written after all parent rows are written. The default value is FALSE.
    
    active - Use false to make the newly created relation inactive.
    
    Returns:
    
    A handle to the newly created DataRelation.
  - addRelation
```
public handle addRelation(handle parent,
                          handle child,
                          Text pairs,
                          logical reposition,
                          logical nested,
                          logical active,
                          logical recursive)
```
    Creates a new data-relation object for a pair of parent and child buffers of this DataSet object. This method applies only to DataSet objects dynamically created.
    
    Specified by:
    
    addRelation in interface DataSetInterface
    
    Parameters:
    
    parent - The handle to the parent buffer in the data-relation object.
    
    child - The handle to the child buffer in the data-relation object.
    
    pairs - A comma-delimited list of parent-field, child-field pairs describing the relationship between parent and child buffers in the new data-relation object.
    
    reposition - The reposition mode. If TRUE, the relation mode is REPOSITION. Otherwise the relation mode is SELECTION. The default value is SELECTION.
    
    nested - Use TRUE to nest child rows of DataSet buffers within their parent rows when writing the XML representation of data. When FALSE is passed, all child rows are written after all parent rows are written. The default value is FALSE.
    
    active - Use false to make the newly created relation inactive.
    
    recursive - Using TRUE till causes the data-relation to be filled recursively.
    
    Returns:
    
    A handle to the newly created DataRelation.
  - addRelation
```
public handle addRelation(handle parent,
                          handle child,
                          Text pairs,
                          logical reposition,
                          logical nested,
                          logical active,
                          logical recursive,
                          logical fkeyHidden)
```
    Creates a new data-relation object for a pair of parent and child buffers of this DataSet object. This method applies only to DataSet objects dynamically created.
    Note:
    There is a bug/quirk in OE when this is performed. If a relation (for same buffer pair) is added a second time, it is accepted, leading to two "parallel" relations to be created. FWD will warn this in log. When/if OE decides to fix the bug/quirk, the handling code should also be removed.
    
    Specified by:
    
    addRelation in interface DataSetInterface
    
    Parameters:
    
    parent - The handle to the parent buffer in the data-relation object.
    
    child - The handle to the child buffer in the data-relation object.
    
    pairs - A comma-delimited list of parent-field, child-field pairs describing the relationship between parent and child buffers in the new data-relation object.
    
    reposition - The reposition mode. If TRUE, the relation mode is REPOSITION. Otherwise the relation mode is SELECTION. The default value is SELECTION.
    
    nested - Use TRUE to nest child rows of DataSet buffers within their parent rows when writing the XML representation of data. When FALSE is passed, all child rows are written after all parent rows are written. The default value is FALSE.
    
    active - Use false to make the newly created relation inactive.
    
    recursive - Using TRUE till causes the data-relation to be filled recursively.
    
    fkeyHidden - When set to TRUE the foreign key fields in nested data-relations will be omitted when writing the XML representation of data. If this option is used, the NESTED argument must be TRUE.
    
    Returns:
    
    A handle to the newly created DataRelation.
  - addRelationImpl
```
public handle addRelationImpl(handle parent,
                              handle child,
                              Text pairs,
                              logical reposition,
                              logical nested,
                              logical active,
                              logical recursive,
                              logical fkeyHidden,
                              boolean nullOnDuplicate)
```
    Actual implementation of addRelation.
    Creates a new data-relation object for a pair of parent and child buffers of this DataSet object. This method applies only to DataSet objects dynamically created.
    Note:
    There is a bug/quirk in OE when this is performed. If a relation (for same buffer pair) is added a second time, it is accepted, leading to two "parallel" relations to be created. FWD will warn this in log. When/if OE decides to fix the bug/quirk, the handling code should also be removed.
    
    Parameters:
    
    parent - The handle to the parent buffer in the data-relation object.
    
    child - The handle to the child buffer in the data-relation object.
    
    pairs - A comma-delimited list of parent-field, child-field pairs describing the relationship between parent and child buffers in the new data-relation object.
    
    reposition - The reposition mode. If TRUE, the relation mode is REPOSITION. Otherwise the relation mode is SELECTION. The default value is SELECTION.
    
    nested - Use TRUE to nest child rows of DataSet buffers within their parent rows when writing the XML representation of data. When FALSE is passed, all child rows are written after all parent rows are written. The default value is FALSE.
    
    active - Use false to make the newly created relation inactive.
    
    recursive - Using TRUE till causes the data-relation to be filled recursively.
    
    fkeyHidden - When set to TRUE the foreign key fields in nested data-relations will be omitted when writing the XML representation of data. If this option is used, the NESTED argument must be TRUE.
    
    nullOnDuplicate - if true the method will return null if a duplicate relation is detected. Otherwise it will throw error condition #11979, eventually returning invalid handle.
    
    Returns:
    
    A handle to the newly created DataRelation.
  - addParentIdRelation
```
public handle addParentIdRelation(handle parent,
                                  handle child)
```
    Creates a new data-relation object for a pair of parent and child buffers of this DataSet based on the RECID of the parent buffer to this DataSet object. This method applies only to DataSet objects dynamically created. The newly created object will have the PARENT-ID-RELATION attribute set to TRUE.
    
    Specified by:
    
    addParentIdRelation in interface DataSetInterface
    
    Parameters:
    
    parent - The handle to the parent buffer in the data-relation object.
    
    child - The handle to the child buffer in the data-relation object.
    
    Returns:
    
    A handle to the newly created DataRelation object.
  - addParentIdRelation
```
public handle addParentIdRelation(handle parent,
                                  handle child,
                                  Text parentIdField)
```
    Creates a new data-relation object for a pair of parent and child buffers of this DataSet based on the RECID of the parent buffer to this DataSet object. This method applies only to DataSet objects dynamically created. The newly created object will have the PARENT-ID-RELATION attribute set to TRUE.
    
    Specified by:
    
    addParentIdRelation in interface DataSetInterface
    
    Parameters:
    
    parent - The handle to the parent buffer in the data-relation object.
    
    child - The handle to the child buffer in the data-relation object.
    
    parentIdField - Denotes the RECID field in child-buffer-handle on which this parent-id-relation object is based.
    
    Returns:
    
    A handle to the newly created DataRelation object.
  - addParentIdRelation
```
public handle addParentIdRelation(handle parent,
                                  handle child,
                                  Text parentIdField,
                                  Text parentFieldsBefore)
```
    Creates a new data-relation object for a pair of parent and child buffers of this DataSet based on the RECID of the parent buffer to this DataSet object. This method applies only to DataSet objects dynamically created. The newly created object will have the PARENT-ID-RELATION attribute set to TRUE.
    
    Specified by:
    
    addParentIdRelation in interface DataSetInterface
    
    Parameters:
    
    parent - The handle to the parent buffer in the data-relation object.
    
    child - The handle to the child buffer in the data-relation object.
    
    parentIdField - Denotes the RECID field in child-buffer-handle on which this parent-id-relation object is based.
    
    parentFieldsBefore - A list of comma-separated fields from the parent record to be written to XML before any nested child-buffer-handle records.
    
    Returns:
    
    A handle to the newly created DataRelation object.
  - addParentIdRelation
```
public handle addParentIdRelation(handle parent,
                                  handle child,
                                  Text parentIdField,
                                  Text parentFieldsBefore,
                                  Text parentFieldsAfter)
```
    Creates a new data-relation object for a pair of parent and child buffers of this DataSet based on the RECID of the parent buffer to this DataSet object. This method applies only to DataSet objects dynamically created. The newly created object will have the PARENT-ID-RELATION attribute set to TRUE.
    
    Specified by:
    
    addParentIdRelation in interface DataSetInterface
    
    Parameters:
    
    parent - The handle to the parent buffer in the data-relation object.
    
    child - The handle to the child buffer in the data-relation object.
    
    parentIdField - Denotes the RECID field in child-buffer-handle on which this parent-id-relation object is based. The default value is the name of the parent-buffer-handle appended with _id.
    
    parentFieldsBefore - A list of comma-separated fields from the parent record to be written to XML before any nested child-buffer-handle records.
    
    parentFieldsAfter - A list of comma-separated fields from the parent record to be written to XML after all nested child-buffer-handle records.
    
    Returns:
    
    A handle to the newly created DataRelation object.
  - copyDataset
```
public logical copyDataset(handle srcDS)
```
    Copies a source DataSet object into this DataSet object.
    
    Specified by:
    
    copyDataset in interface DataSetInterface
    
    Parameters:
    
    srcDS - The source DataSet.
    
    Returns:
    
    true on success.
  - copyDataset
```
public logical copyDataset(handle srcDS,
                           logical append)
```
    Copies a source DataSet object into this DataSet object.
    
    Specified by:
    
    copyDataset in interface DataSetInterface
    
    Parameters:
    
    srcDS - The source DataSet.
    
    append - When true the source temp-tables are appended to current temp-tables.
    
    Returns:
    
    true on success.
  - copyDataset
```
public logical copyDataset(handle srcDS,
                           logical append,
                           logical replace)
```
    Copies a source DataSet object into this DataSet object.
    
    Specified by:
    
    copyDataset in interface DataSetInterface
    
    Parameters:
    
    srcDS - The source DataSet.
    
    append - When true the source temp-tables are appended to current temp-tables.
    
    replace - When true the records in this temp-tables are replaced with records from the temp-tables of source DataSet.
    
    Returns:
    
    true on success.
  - copyDataset
```
public logical copyDataset(handle srcDS,
                           logical append,
                           logical replace,
                           logical looseCopy)
```
    Copies a source DataSet object into this DataSet object.
    
    Specified by:
    
    copyDataset in interface DataSetInterface
    
    Parameters:
    
    srcDS - The source DataSet.
    
    append - When true the source temp-tables are appended to current temp-tables.
    
    replace - When true the records in this temp-tables are replaced with records from the temp-tables of source DataSet.
    
    looseCopy - When TRUE, each temp-table in the source DataSet object is copied to this DataSet object based on a field mapping between the source and target temp-table buffers.
    
    Returns:
    
    true on success.
  - copyDataset
```
public logical copyDataset(handle srcDS,
                           logical append,
                           logical replace,
                           logical looseCopy,
                           Text pairList)
```
    Copies a source DataSet object into this DataSet object.
    
    Specified by:
    
    copyDataset in interface DataSetInterface
    
    Parameters:
    
    srcDS - The source DataSet.
    
    append - When true the source temp-tables are appended to current temp-tables.
    
    replace - When true the records in this temp-tables are replaced with records from the temp-tables of source DataSet.
    
    looseCopy - When TRUE, each temp-table in the source DataSet object is copied to this DataSet object based on a field mapping between the source and target temp-table buffers.
    
    pairList - A list of the target and source temp-table PAIRS to be copied, comma-delimited.
    
    Returns:
    
    true on success.
  - copyDataset
```
public logical copyDataset(handle srcDS,
                           logical append,
                           logical replace,
                           logical looseCopy,
                           Text pairList,
                           logical currentOnly)
```
    Copies a source DataSet object into this DataSet object.
    
    Specified by:
    
    copyDataset in interface DataSetInterface
    
    Parameters:
    
    srcDS - The source DataSet.
    
    append - When true the source temp-tables are appended to current temp-tables.
    
    replace - When true the records in this temp-tables are replaced with records from the temp-tables of source DataSet.
    
    looseCopy - When TRUE, each temp-table in the source DataSet object is copied to this DataSet object based on a field mapping between the source and target temp-table buffers.
    
    pairList - A list of the target and source temp-table PAIRS to be copied, comma-delimited.
    
    currentOnly - Use TRUE indicates that the AVM copy only the current record from each temp-table at each level in the source DataSet object to the target DataSet object. The default value is FALSE.
    
    Returns:
    
    true on success.
  - copyDataset
```
public logical copyDataset(handle srcDS,
                           logical append,
                           logical replace,
                           logical looseCopy,
                           Text pairList,
                           logical currentOnly,
                           Text prefix)
```
    Copies a source DataSet object into this DataSet object.
    
    Specified by:
    
    copyDataset in interface DataSetInterface
    
    Parameters:
    
    srcDS - The source DataSet.
    
    append - When true the source temp-tables are appended to current temp-tables.
    
    replace - When true the records in this temp-tables are replaced with records from the temp-tables of source DataSet.
    
    looseCopy - When TRUE, each temp-table in the source DataSet object is copied to this DataSet object based on a field mapping between the source and target temp-table buffers.
    
    pairList - A list of the target and source temp-table PAIRS to be copied, comma-delimited.
    
    currentOnly - Use TRUE indicates that the AVM copy only the current record from each temp-table at each level in the source DataSet object to the target DataSet object. The default value is FALSE.
    
    prefix - An expression used as the prefix for (re-)naming the target DataSet.
    
    Returns:
    
    true on success.
  - setBuffers
```
public logical setBuffers(handle... hBuffers)
```
    Binds all buffers for a dynamic DataSet object at the same time. Any buffers previously added to this DataSet object are removed.
    
    Specified by:
    
    setBuffers in interface BufferCollection
    
    Parameters:
    
    hBuffers - Variable argument list of buffer handles to be set. In 4GL, the maximum number of buffers per query is 18.
    
    Returns:
    
    true on success.
  - setBuffers
```
public logical setBuffers(Buffer... bufs)
```
    Binds all buffers for a dynamic DataSet object at the same time. Any buffers previously added to this DataSet object are removed.
    
    Specified by:
    
    setBuffers in interface BufferCollection
    
    Parameters:
    
    bufs - Variable argument list of buffer handles to be set. In 4GL, the maximum number of buffers per query is 18.
    
    Returns:
    
    true on success.
  - setBuffers
```
public logical setBuffers(java.lang.Object... bufs)
```
    Binds all buffers for a dynamic DataSet object at the same time. Any buffers previously added to this DataSet object are removed.
    
    Specified by:
    
    setBuffers in interface BufferCollection
    
    Parameters:
    
    bufs - Variable argument list of Buffer to be set, a mixed list of Buffer, handle or character instances.
    
    Returns:
    
    true on success
  - addBuffer
```
public logical addBuffer(handle bufHandle)
```
    Adds one new buffer to a query object or dynamic DataSet object, without affecting the other buffers, if any. Use the SET-BUFFERS( ) method to remove all prior buffers and set all buffers for the object at the same time.
    
    Specified by:
    
    addBuffer in interface BufferCollection
    
    Parameters:
    
    bufHandle - A buffer handle to add.
    
    Returns:
    
    true on success
  - addBuffer
```
public logical addBuffer(Buffer buf)
```
    Adds one new buffer to a query object or dynamic DataSet object, without affecting the other buffers, if any. Use the SET-BUFFERS( ) method to remove all prior buffers and set all buffers for the object at the same time.
    
    Specified by:
    
    addBuffer in interface BufferCollection
    
    Parameters:
    
    buf - A buffer to add.
    
    Returns:
    
    true on success
  - addBuffer
```
public logical addBuffer(java.lang.String bufName)
```
    Adds one new buffer to a query object or dynamic DataSet object, without affecting the other buffers, if any. Use the SET-BUFFERS( ) method to remove all prior buffers and set all buffers for the object at the same time.
    
    Specified by:
    
    addBuffer in interface BufferCollection
    
    Parameters:
    
    bufName - Legacy buffer name to add.
    
    Returns:
    
    true on success
  - addBuffer
```
public logical addBuffer(character bufName)
```
    Adds one new buffer to a query object or dynamic DataSet object, without affecting the other buffers, if any. Use the SET-BUFFERS( ) method to remove all prior buffers and set all buffers for the object at the same time.
    
    Specified by:
    
    addBuffer in interface BufferCollection
    
    Parameters:
    
    bufName - Legacy buffer name to add.
    
    Returns:
    
    true on success
  - numBuffers
```
public integer numBuffers()
```
    Obtain the number of buffers in this DataSet.
    
    Specified by:
    
    numBuffers in interface BufferCollection
    
    Returns:
    
    the number of buffers in this DataSet.
  - bufferHandle
```
public handle bufferHandle()
```
    Obtain the handle to a particular buffer of this DataSet.
    
    Specified by:
    
    bufferHandle in interface BufferCollection
    
    Returns:
    
    a handle to a particular buffer of this DataSet.
  - bufferHandle
```
public handle bufferHandle(int bufIndex)
```
    Obtain the handle to a particular buffer of this DataSet.
    
    Specified by:
    
    bufferHandle in interface BufferCollection
    
    Parameters:
    
    bufIndex - The sequence number of the desired buffer.
    
    Returns:
    
    a handle to a particular buffer of this DataSet.
  - bufferHandle
```
public handle bufferHandle(int64 bufIndex)
```
    Obtain the handle to a particular buffer of this DataSet.
    
    Specified by:
    
    bufferHandle in interface BufferCollection
    
    Parameters:
    
    bufIndex - The sequence number of the desired buffer.
    
    Returns:
    
    a handle to a particular buffer of this DataSet.
  - bufferHandle
```
public handle bufferHandle(java.lang.String buffName)
```
    Obtain the handle to a particular buffer of this DataSet.
    
    Specified by:
    
    bufferHandle in interface BufferCollection
    
    Parameters:
    
    buffName - The name of the desired buffer.
    
    Returns:
    
    a handle to a particular buffer of this DataSet.
  - bufferHandle
```
public handle bufferHandle(character buffName)
```
    Obtain the handle to a particular buffer of this DataSet.
    
    Specified by:
    
    bufferHandle in interface BufferCollection
    
    Parameters:
    
    buffName - The name of the desired buffer.
    
    Returns:
    
    a handle to a particular buffer of this DataSet.
  - getSerializeHidden
```
public logical getSerializeHidden()
```
    Checks whether fields are written when the temp-table is serialized, for example into JSON or XML. This represents the getter for SERIALIZE-HIDDEN ABL attribute.
    
    Specified by:
    
    getSerializeHidden in interface SerializeHiddenable
    
    Returns:
    
    true when the fields are hidden.
  - setSerializeHidden
```
public void setSerializeHidden(logical val)
```
    Allow to configure whether fields are written when the temp-table is serialized, for example into JSON or XML. This represents the setter for SERIALIZE-HIDDEN ABL attribute.
    
    Specified by:
    
    setSerializeHidden in interface SerializeHiddenable
    
    Parameters:
    
    val - true when the fields are hidden.
  - setSerializeHidden
```
public void setSerializeHidden(boolean val)
```
    Allow to configure whether fields are written when the temp-table is serialized, for example into JSON or XML. This represents the setter for SERIALIZE-HIDDEN ABL attribute.
    
    Specified by:
    
    setSerializeHidden in interface SerializeHiddenable
    
    Parameters:
    
    val - true when the fields are hidden.
  - namespacePrefix
```
public character namespacePrefix()
```
    Returns the value of the the NAMESPACE-PREFIX attribute. Only for ELEMENT or ATTRIBUTE, for other attributes return unknown value.
    
    Specified by:
    
    namespacePrefix in interface NamespaceURI
    
    Returns:
    
    See above.
  - namespacePrefix
```
public void namespacePrefix(java.lang.String prefix)
```
    Setter for NAMESPACE-PREFIX attribute.
    
    Specified by:
    
    namespacePrefix in interface NamespaceURI
    
    Parameters:
    
    prefix - The new value of the NAMESPACE-PREFIX attribute.
  - namespacePrefix
```
public void namespacePrefix(character prefix)
```
    Setter for NAMESPACE-PREFIX attribute.
    
    Specified by:
    
    namespacePrefix in interface NamespaceURI
    
    Parameters:
    
    prefix - The new value of the NAMESPACE-PREFIX attribute.
  - readJson
```
public logical readJson(SourceData source)
```
    Implementation of the READ-JSON method. Reads JSON data from the specified data source into this object.
    
    Specified by:
    
    readJson in interface JsonData
    
    Parameters:
    
    source - Data source.
    
    Returns:
    
    True if the operation completed successfully, else false.
  - readJson
```
public logical readJson(SourceData source,
                        character readMode)
```
    Implementation of the READ-JSON method. Reads JSON data from the specified data source into this object.
    
    Specified by:
    
    readJson in interface JsonData
    
    Parameters:
    
    source - Data source.
    
    readMode - Mode in which data is read into buffer. Must evaluate to APPEND, EMPTY, MERGE, or REPLACE.
    
    Returns:
    
    True if the operation completed successfully, else false.
  - writeJson
```
public logical writeJson(TargetData target)
```
    Implementation of the WRITE-JSON method. Writes JSON data from this object into the specified data target.
    
    Specified by:
    
    writeJson in interface JsonData
    
    Parameters:
    
    target - Data target.
    
    Returns:
    
    True if the operation completed successfully, else false.
  - writeJson
```
public logical writeJson(TargetData target,
                         logical formatted)
```
    Implementation of the WRITE-JSON method. Writes JSON data from this object into the specified data target.
    
    Specified by:
    
    writeJson in interface JsonData
    
    Parameters:
    
    target - Data target.
    
    formatted - True to format the JSON to make it more readable; false to write it as unformatted text. Unknown value is treated as false.
    
    Returns:
    
    True if the operation completed successfully, else false.
  - writeJson
```
public logical writeJson(TargetData target,
                         logical formatted,
                         character encoding)
```
    Implementation of the WRITE-JSON method. Writes JSON data from this object into the specified data target.
    
    Specified by:
    
    writeJson in interface JsonData
    
    Parameters:
    
    target - Data target.
    
    formatted - True to format the JSON to make it more readable; false to write it as unformatted text. Unknown value is treated as false.
    
    encoding - Name of the character encoding to use.
    
    Returns:
    
    True if the operation completed successfully, else false.
  - writeJson
```
public logical writeJson(TargetData target,
                         logical formatted,
                         character encoding,
                         logical omitInitials)
```
    Implementation of the WRITE-JSON method. Writes JSON data from this object into the specified data target.
    
    Specified by:
    
    writeJson in interface JsonData
    
    Parameters:
    
    target - Data target.
    
    formatted - True to format the JSON to make it more readable; false to write it as unformatted text. Unknown value is treated as false.
    
    encoding - Name of the character encoding to use.
    
    omitInitials - True to omit data for fields whose values match their initial values.
    
    Returns:
    
    True if the operation completed successfully, else false.
  - writeJson
```
public logical writeJson(TargetData target,
                         logical formatted,
                         character encoding,
                         logical omitInitials,
                         logical omitOuterObject)
```
    Implementation of the WRITE-JSON method. Writes JSON data from this object into the specified data target.
    
    Specified by:
    
    writeJson in interface JsonData
    
    Parameters:
    
    target - Data target.
    
    formatted - True to format the JSON to make it more readable; false to write it as unformatted text. Unknown value is treated as false.
    
    encoding - Name of the character encoding to use.
    
    omitInitials - True to omit data for fields whose values match their initial values.
    
    omitOuterObject - True to omit data for the outermost object from the output.
    
    Returns:
    
    True if the operation completed successfully, else false.
  - writeJson
```
public logical writeJson(TargetData target,
                         logical formatted,
                         character encoding,
                         logical omitInitialValues,
                         logical omitOuterObject,
                         logical writeBeforeImage)
```
    Implementation of the WRITE-JSON method. Writes JSON data from this object into the specified data target.
    
    Specified by:
    
    writeJson in interface JsonData
    
    Parameters:
    
    target - Data target.
    
    formatted - True to format the JSON to make 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.
    
    writeBeforeImage - True to write before-image data and error information, else false.
    
    Returns:
    
    True if the operation completed successfully, else false.
  - getXmlDataType
```
public character getXmlDataType()
```
    Obtain the XML Schema data type for the buffer-field object.
    
    Specified by:
    
    getXmlDataType in interface XmlNode
    
    Returns:
    
    the XML Schema data type for the buffer-field object.
  - setXmlDataType
```
public void setXmlDataType(java.lang.String newType)
```
    Configures the XML Schema data type for the buffer-field object.
    
    Specified by:
    
    setXmlDataType in interface XmlNode
    
    Parameters:
    
    newType - the new XML Schema data type for the buffer-field object.
  - setXmlDataType
```
public void setXmlDataType(Text newType)
```
    Configures the XML Schema data type for the buffer-field object.
    
    Specified by:
    
    setXmlDataType in interface XmlNode
    
    Parameters:
    
    newType - the new XML Schema data type for the buffer-field object.
  - getXmlNodeType
```
public character getXmlNodeType()
```
    Obtain the XML node type of this object. This represents the getter for XML-NODE-TYPE ABL attribute.
    
    Specified by:
    
    getXmlNodeType in interface XmlNode
    
    Returns:
    
    the XML node type of this object.
  - setXmlNodeType
```
public void setXmlNodeType(Text newType)
```
    Allows to specify how a this object will be represented in XML and XML Schema. Valid XML node types are "ELEMENT" and "HIDDEN". It overlaps theSERIALIZE-HIDDEN attribute. This represents the setter for XML-NODE-TYPE ABL attribute.
    
    Specified by:
    
    setXmlNodeType in interface XmlNode
    
    Parameters:
    
    newType - The new type.
  - setXmlNodeType
```
public void setXmlNodeType(java.lang.String newType)
```
    Allows to specify how a this object will be represented in XML and XML Schema. Valid XML node types are "ELEMENT" and "HIDDEN". It overlaps theSERIALIZE-HIDDEN} attribute. This represents the setter for XML-NODE-TYPE ABL attribute.
    
    Specified by:
    
    setXmlNodeType in interface XmlNode
    
    Parameters:
    
    newType - The new type.
  - readXml
```
public logical readXml(SourceData source,
                       character readMode,
                       character schemaLocation,
                       logical overrideDefaultMapping)
```
    Implementation of the READ-XML method. Reads XML data from the specified data source into this object.
    Defaults applied:
    - Default field type mappings
    - LOOSE schema verification mode
    Specified by:
    
    readXml in interface XmlData
    
    Parameters:
    
    source - Data source.
    
    readMode - Mode in which data is read into buffer. Must evaluate to APPEND, EMPTY, MERGE, or REPLACE.
    
    schemaLocation - Name of an external XML schema file, or empty string or unknown value to use the xsi:noNamespaceSchemaLocation value set in the XML data, if any.
    
    overrideDefaultMapping - true to override the default string-to-binary data type mappings when creating a temp-table schema from an XML schema.
    
    Returns:
    
    true if the operation completed successfully, else false.
  - readXml
```
public logical readXml(SourceData source,
                       character readMode,
                       character schemaLocation,
                       logical overrideDefaultMapping,
                       character fieldTypeMapping)
```
    Implementation of the READ-XML method. Reads XML data from the specified data source into this object.
    
    Specified by:
    
    readXml in interface XmlData
    
    Parameters:
    
    source - Data source.
    
    readMode - Mode in which data is read into buffer. Must evaluate to APPEND, EMPTY, MERGE, or REPLACE.
    
    schemaLocation - Name of an external XML schema file, or empty string or unknown value to use the xsi:noNamespaceSchemaLocation value set in the XML data, if any.
    
    overrideDefaultMapping - True to override the default string-to-binary data type mappings when creating a temp-table schema from an XML schema.
    
    fieldTypeMapping - Comma-delimited list of field name and data type name pairs to use to override data type mappings of specific fields. Specify unknown value to use default mappings.
    
    Returns:
    
    True if the operation completed successfully, else false.
  - readXml
```
public logical readXml(SourceData source,
                       character readMode,
                       character schemaLocation,
                       logical overrideDefaultMapping,
                       character strMapping,
                       character verifySchemaMode)
```
    Implementation of the READ-XML method. Reads XML data from the specified data source into this object.
    
    Specified by:
    
    readXml in interface XmlData
    
    Parameters:
    
    source - Data source.
    
    readMode - Mode in which data is read into buffer. Must evaluate to APPEND, EMPTY, MERGE, or REPLACE.
    
    schemaLocation - Name of an external XML schema file, or empty string or unknown value to use the xsi:noNamespaceSchemaLocation value set in the XML data, if any.
    
    overrideDefaultMapping - True to override the default string-to-binary data type mappings when creating a temp-table schema from an XML schema.
    
    strMapping - Comma-delimited list of field name and data type name pairs to use to override data type mappings of specific fields. Specify unknown value to use default mappings.
    
    verifySchemaMode - Schema verification mode. Must evaluate to IGNORE, LOOSE, or STRICT. Default is LOOSE.
    
    Returns:
    
    True if the operation completed successfully, else false.
  - writeXml
```
public logical writeXml(TargetData target)
```
    Implementation of the WRITE-XML method. Writes XML data from this object into the specified data target.
    
    Specified by:
    
    writeXml in interface XmlData
    
    Parameters:
    
    target - Data target.
    
    Returns:
    
    True if the operation completed successfully, else false.
  - writeXml
```
public logical writeXml(TargetData target,
                        logical formatted)
```
    Implementation of the WRITE-XML method. Writes XML data from this object into the specified data target.
    
    Specified by:
    
    writeXml in interface XmlData
    
    Parameters:
    
    target - Data target.
    
    formatted - True to format the XML to make it more readable; false to write it as unformatted text. Unknown value is treated as false.
    
    Returns:
    
    True if the operation completed successfully, else false.
  - writeXml
```
public logical writeXml(TargetData target,
                        logical formatted,
                        character encoding)
```
    Implementation of the WRITE-XML method. Writes XML data from this object into the specified data target.
    
    Specified by:
    
    writeXml in interface XmlData
    
    Parameters:
    
    target - Data target.
    
    formatted - True to format the XML to make it more readable; false to write it as unformatted text. Unknown value is treated as false.
    
    encoding - Name of the character encoding to use.
    
    Returns:
    
    True if the operation completed successfully, else false.
  - writeXml
```
public logical writeXml(TargetData target,
                        logical formatted,
                        character encoding,
                        character schemaLocation)
```
    Implementation of the WRITE-XML method. Writes XML data from this object into the specified data target.
    
    Specified by:
    
    writeXml in interface XmlData
    
    Parameters:
    
    target - Data target.
    
    formatted - True to format the XML to make it more readable; false to write it as unformatted text. Unknown value is treated as false.
    
    encoding - Name of the character encoding to use.
    
    schemaLocation - Name of an external XML schema file, or empty string or unknown value to set the xsi:noNamespaceSchemaLocation to empty string or unknown value.
    
    Returns:
    
    True if the operation completed successfully, else false.
  - writeXml
```
public logical writeXml(TargetData target,
                        logical formatted,
                        character encoding,
                        character schemaLocation,
                        logical writeXmlSchema)
```
    Implementation of the WRITE-XML method. Writes XML data from this object into the specified data target.
    
    Specified by:
    
    writeXml in interface XmlData
    
    Parameters:
    
    target - Data target.
    
    formatted - True to format the XML to make it more readable; false to write it as unformatted text. Unknown value is treated as false.
    
    encoding - Name of the character encoding to use.
    
    schemaLocation - Name of an external XML schema file, or empty string or unknown value to set the xsi:noNamespaceSchemaLocation to empty string or unknown value.
    
    writeXmlSchema - True to write XML schema information, else false.
    
    Returns:
    
    True if the operation completed successfully, else false.
  - writeXml
```
public logical writeXml(TargetData target,
                        logical formatted,
                        character encoding,
                        character schemaLocation,
                        logical writeXmlSchema,
                        logical minXmlSchema)
```
    Implementation of the WRITE-XML method. Writes XML data from this object into the specified data target.
    
    Specified by:
    
    writeXml in interface XmlData
    
    Parameters:
    
    target - Data target.
    
    formatted - True to format the XML to make it more readable; false to write it as unformatted text. Unknown value is treated as false.
    
    encoding - Name of the character encoding to use.
    
    schemaLocation - Name of an external XML schema file, or empty string or unknown value to set the xsi:noNamespaceSchemaLocation to empty string or unknown value.
    
    writeXmlSchema - True to write XML schema information, else false.
    
    minXmlSchema - True to write minimal XML schema information, else false. Must be false if writeXmlSchema is false.
    
    Returns:
    
    True if the operation completed successfully, else false.
  - writeXml
```
public logical writeXml(TargetData target,
                        logical formatted,
                        character encoding,
                        character schemaLocation,
                        logical writeXmlSchema,
                        logical minXmlSchema,
                        logical writeBeforeImage)
```
    Implementation of the WRITE-XML method. Writes XML data from this object into the specified data target.
    
    Specified by:
    
    writeXml in interface XmlData
    
    Parameters:
    
    target - Data target.
    
    formatted - True to format the XML to make it more readable; false to write it as unformatted text. Unknown value is treated as false.
    
    encoding - Name of the character encoding to use.
    
    schemaLocation - Name of an external XML schema file, or empty string or unknown value to set the xsi:noNamespaceSchemaLocation to empty string or unknown value.
    
    writeXmlSchema - True to write XML schema information, else false.
    
    minXmlSchema - True to write minimal XML schema information, else false. Must be false if writeXmlSchema is false.
    
    writeBeforeImage - True to write before-image data and error information, else false.
    
    Returns:
    
    True if the operation completed successfully, else false.
  - writeXml
```
public logical writeXml(TargetData target,
                        logical formatted,
                        character encoding,
                        character schemaLocation,
                        logical writeXmlSchema,
                        logical minXmlSchema,
                        logical beforeImage,
                        logical noInitialVals)
```
    Implementation of the WRITE-XML method. Writes XML data from this object into the specified data target.
    
    Specified by:
    
    writeXml in interface XmlData
    
    Parameters:
    
    target - Data target.
    
    formatted - True to format the XML to make it more readable; false to write it as unformatted text. Unknown value is treated as false.
    
    encoding - Name of the character encoding to use.
    
    schemaLocation - Name of an external XML schema file, or empty string or unknown value to set the xsi:noNamespaceSchemaLocation to empty string or unknown value.
    
    writeXmlSchema - True to write XML schema information, else false.
    
    minXmlSchema - True to write minimal XML schema information, else false. Must be false if writeXmlSchema is false.
    
    beforeImage - True to write before-image data and error information, else false.
    
    noInitialVals - True to omit data for fields whose values match their initial values.
    
    Returns:
    
    True if the operation completed successfully, else false.
  - writeXmlSchema
```
public logical writeXmlSchema(TargetData target)
```
    Writes an XML representation of the definition of this DataSet.
    
    Specified by:
    
    writeXmlSchema in interface XmlData
    
    Parameters:
    
    target - Data target.
    
    Returns:
    
    true if operation is successful.
  - writeXmlSchema
```
public logical writeXmlSchema(TargetData target,
                              logical formatted)
```
    Writes an XML representation of the definition of this DataSet.
    
    Specified by:
    
    writeXmlSchema in interface XmlData
    
    Parameters:
    
    target - Data target.
    
    formatted - Use true for a more human-readable document.
    
    Returns:
    
    true if operation is successful.
  - writeXmlSchema
```
public logical writeXmlSchema(TargetData target,
                              logical formatted,
                              Text encoding)
```
    Writes an XML representation of the definition of this DataSet.
    
    Specified by:
    
    writeXmlSchema in interface XmlData
    
    Parameters:
    
    target - Data target.
    
    formatted - Use true for a more human-readable document.
    
    encoding - The character encoding. The default is UTF-8.
    
    Returns:
    
    true if operation is successful.
  - writeXmlSchema
```
public logical writeXmlSchema(TargetData target,
                              logical formatted,
                              Text encoding,
                              logical minXmlSchema)
```
    Writes an XML representation of the definition of this DataSet.
    
    Specified by:
    
    writeXmlSchema in interface XmlData
    
    Parameters:
    
    target - Data target.
    
    formatted - Use true for a more human-readable document.
    
    encoding - The character encoding. The default is UTF-8.
    
    minXmlSchema - If true, the minimum amount of schema for the object will be written.
    
    Returns:
    
    true if operation is successful.
  - writeXmlSchema
```
public logical writeXmlSchema(TargetData target,
                              logical formatted,
                              Text encoding,
                              logical minXmlSchema,
                              logical omitInitVal)
```
    Writes an XML representation of the definition of this DataSet.
    
    Specified by:
    
    writeXmlSchema in interface XmlData
    
    Parameters:
    
    target - Data target.
    
    formatted - Use true for a more human-readable document.
    
    encoding - The character encoding. The default is UTF-8.
    
    minXmlSchema - If true, the minimum amount of schema for the object will be written.
    
    omitInitVal - Use true to omit the initial values.
    
    Returns:
    
    true if operation is successful.
  - readXmlSchema
```
public logical readXmlSchema(SourceData source,
                             logical override)
```
    Reads XML Schema from an XML document and uses that schema to either create a schema for a DataSet or TempTable or verify existing schema in a DataSet, TempTable or temp-table Buffer object.
    
    Specified by:
    
    readXmlSchema in interface XmlData
    
    Parameters:
    
    source - Data source.
    
    override - If true the default mapping between XML Schema string and binary data types and ABL data types when creating an ABL temp-table schema from an XML Schema will be overwritten.
    
    Returns:
    
    true if operation is successful.
  - readXmlSchema
```
public logical readXmlSchema(SourceData source,
                             logical override,
                             Text mapping)
```
    Reads XML Schema from an XML document and uses that schema to either create a schema for a DataSet or TempTable or verify existing schema in a DataSet, TempTable or temp-table Buffer object.
    
    Specified by:
    
    readXmlSchema in interface XmlData
    
    Parameters:
    
    source - Data source.
    
    override - If true the default mapping between XML Schema string and binary data types and ABL data types when creating an ABL temp-table schema from an XML Schema will be overwritten.
    
    mapping - A comma-delimited list of field name, data type pairs. This allows to specify the data type for a specific field.
    
    Returns:
    
    true if operation is successful.
  - readXmlSchema
```
public logical readXmlSchema(SourceData source,
                             logical override,
                             Text strMapping,
                             Text verifyMode)
```
    Reads XML Schema from an XML document and uses that schema to either create a schema for a DataSet or TempTable or verify existing schema in a DataSet, TempTable or temp-table Buffer object.
    
    Specified by:
    
    readXmlSchema in interface XmlData
    
    Parameters:
    
    source - Data source.
    
    override - If true the default mapping between XML Schema string and binary data types and ABL data types when creating an ABL temp-table schema from an XML Schema will be overwritten.
    
    strMapping - A comma-delimited list of field name, data type pairs. This allows to specify the data type for a specific field.
    
    verifyMode - Specifies how the XML will be verified against the schema. Valid values: "LOOSE" or "STRICT".
    
    Returns:
    
    true if operation is successful.
  - getUniqueID
```
public integer getUniqueID()
```
    Obtain an integer values that uniques identifies this resource.
    
    Specified by:
    
    getUniqueID in interface UniqueID
    
    Returns:
    
    an integer values that uniques identifies this resource.
  - setPostponedDelete
```
public void setPostponedDelete(boolean postponed)
```
    Set the postponedDelete flag.
    
    Parameters:
    
    postponed - Flag indicating that delete is postponed.
  - getIndexOf
```
public int getIndexOf(BufferImpl buffer)
```
    Searches whether a buffer is part of the dataset. The before buffers are not taken into consideration so for these arguments the method returns -1.
    
    Parameters:
    
    buffer - The BufferImpl to be search.
    
    Returns:
    
    The 0-base index of the buffer if it is part of the DataSet and -1 otherwise.
  - allowDelete
```
public boolean allowDelete(handle ref,
                           boolean explicit)
```
    Check if the resource can veto the delete or not, before attempting the HandleChain.delete() call.
    
    Specified by:
    
    allowDelete in interface Deletable
    
    Parameters:
    
    ref - The exact handle holding the reference, on which the delete is attempted.
    
    explicit - Flag indicating this is called via DELETE OBJECT from the application.
    
    Returns:
    
    false if the dataset is registered as a OUTPUT DATASET-HANDLE parameter or a BY-REFERENCE parameter.
  - resourceDelete
```
protected boolean resourceDelete()
```
    Delete the resource.
    
    Overrides:
    
    resourceDelete in class HandleResource
    
    Returns:
    
    true if the resource was deleted.
  - hasNameConstraints
```
protected boolean hasNameConstraints()
```
    Allows each resource to declare whether it has some naming constraints.
    
    Overrides:
    
    hasNameConstraints in class HandleChain
    
    Returns:
    
    This method always returns false, requiring that its name should be validated before assignment.
    
    See Also:
    
    HandleChain.validateName(java.lang.String)
  - isBound
```
protected boolean isBound()
```
    Checks if this REFERENCE-ONLY DataSet was bound to a real DataSet.
    
    Returns:
    
    This object is dynamically built so by convention this method always returns true (it is bound to itself).
  - isPostponedDelete
```
protected boolean isPostponedDelete()
```
    Check if this dataset was attempted to be deleted, but was postponed because of the handle being a DATASET-HANDLE BY-REFERENCE.
    
    Returns:
    
    The postponedDelete.
  - isCompatibleWith
```
protected boolean isCompatibleWith(DataSet other)
```
    Test the compatibility of two datasets. The number of buffers and their field number is checked first. The datatype of each one is not (yet).
    
    Parameters:
    
    other - The DataSet to compare with this instance.
    
    Returns:
    
    true if the two dataset are compatible (ie one can receive data from another).
  - ref
```
public DataSet ref()
```
    Obtains the original DataSet definition. This is for internal usage, in cases when that information is needed and the proxy interface will mask and make the information unavailable.
    
    Returns:
    
    the original DataSet definition.
  - getBuffers
```
public java.util.List<BufferImpl> getBuffers()
```
    Get the list of buffers for the runtime instance of this resource.
    
    Returns:
    
    The list of buffers.
  - getBufferByIndex
```
public BufferImpl getBufferByIndex(int bufIndex)
```
    Lookup a buffer by its index.
    
    Parameters:
    
    bufIndex - The index to search among the list of buffers.
    
    Returns:
    
    The buffer whose index was specified or null when there is no match.
  - performOutputCopy
```
protected void performOutputCopy(DataSetParameter outputParam)
```
    Copy output data for the linked DataSet parameter, if any.
    
    Parameters:
    
    outputParam - The DataSet parameter where to copy the data.
  - _getNumTopBuffers
```
public int _getNumTopBuffers()
```
    Obtain the number of top-level buffers in this DataSet object.
    
    Returns:
    
    the number of top-level buffers in this DataSet object.
  - allowsActiveChild
```
protected DataRelation allowsActiveChild(Buffer childBuffer)
```
    Checks whether a buffer can be at this moment the child side in a relation of this DataSet. When an existing active relation is detected having the buffer as child the error 11979 is displayed before returning false.
    
    Parameters:
    
    childBuffer - The child buffer to test.
    
    Returns:
    
    null if the requested buffer can be a child buffer in a relation in this DataSet in current configuration or the DataRelation that caused the conflict.
  - getRelations
```
public java.util.ArrayList<DataRelation> getRelations(Buffer buffer,
                                                      boolean parent,
                                                      boolean child,
                                                      boolean active)
```
    Queries the list of DataRelation s for a buffer. Depending on the requests, only the relations where the buffer is parent, child or any of them is returned.
    
    Parameters:
    
    buffer - The buffer to be queried on.
    
    parent - If true, all the relations where the buffer is parent are included.
    
    child - If true, all the relations where the buffer is child are included.
    
    active - If true, ONLY the active relations are included. Otherwise, all relations that match above constraints will be returned.
    
    Returns:
    
    The set of relations where the requested buffer is part of, depending on the value of the flags.
  - getRelation
```
public java.util.Optional<DataRelation> getRelation(Buffer buffer)
```
    Query the relation by its buffer.
    
    Parameters:
    
    buffer - The buffer to be queried on.
    
    Returns:
    
    The optional relation for the buffer
  - invokeCallback
```
protected boolean invokeCallback(handle self,
                                 CallbackData cbd)
```
    Invokes a callback procedure or a callback method. The callback procedure/method must have an INPUT parameter of type DATASET or DATASET-HANDLE. The passed parameter is this DataSet object.
    
    Parameters:
    
    cbd - A CallbackData object holding the data necessary for invocation. May be null, in which case this method will silently return yes even though nothing is performed.
    
    self - The object on which the event is applied (buffer or dataset).
    
    Returns:
    
    true if no errors were encountered during execution.
  - addOutputParam
```
protected void addOutputParam(DataSetParameter dsParam)
```
    Register an output dataset parameter.
    
    Parameters:
    
    dsParam - The dataset parameter.
  - copyDatasetImpl
```
protected logical copyDatasetImpl(handle hSrcDS,
                                  boolean append,
                                  boolean replace,
                                  boolean looseCopy,
                                  java.lang.String pairList,
                                  boolean currentOnly,
                                  java.lang.String prefix)
```
    The implementation of COPY-DATASET method. Copies all records from all tables of a source DataSet object into this DataSet object.
    
    Parameters:
    
    hSrcDS - The source DataSet.
    
    append - When true the source temp-tables are appended to current temp-tables.
    
    replace - When true the records in this temp-tables are replaced with records from the temp-tables of source DataSet.
    
    looseCopy - When TRUE, each temp-table in the source DataSet object is copied to this DataSet object based on a field mapping between the source and target temp-table buffers.
    
    pairList - A list of the target and source temp-table PAIRS to be copied, comma-delimited.
    
    currentOnly - Use TRUE indicates that the AVM copy only the current record from each temp-table at each level in the source DataSet object to the target DataSet object. The default value is FALSE.
    
    prefix - An expression used as the prefix for (re-)naming the target DataSet.
    
    Returns:
    
    true on success.
  - addReference
```
final void addReference(StaticDataSet staticDataSet)
```
    Adds a new reference to this dataset. The NUM-REFERENCES is updated if needed.
    
    Parameters:
    
    staticDataSet - The new DataSet that references this object.
  - removeReference
```
final void removeReference(StaticDataSet staticDataSet)
```
    Removes a reference to this dataset. The NUM-REFERENCES is updated if needed.
    
    Parameters:
    
    staticDataSet - The new DataSet that does not references this object any more.
  - writeToXml
```
static java.lang.String writeToXml(handle dsHandle,
                                   boolean useBeforeImage,
                                   boolean isHandle)
```
    Write the specified DATASET handle to a XML.
    This is used when the remote call sent the DATASET as XML and it must receive it in the same format (used by SOAP callers).
    
    Parameters:
    
    dsHandle - The handle referencing the dataset.
    
    useBeforeImage - Flag indicating if the before table needs to be serialized.
    
    isHandle - Flag indicating that this is used for a DATASET-HANDLE parameter.
    
    Returns:
    
    The XML representation of this dataset.
  - setBuffersImpl
```
boolean setBuffersImpl(Buffer... bufs)
```
    Binds all buffers for a dynamic DataSet object at the same time. Any buffers previously added to this DataSet object are removed.
    
    Parameters:
    
    bufs - Variable argument list of buffer handles to be set. In 4GL, the maximum number of buffers per query is 18.
    
    Returns:
    
    true on success.
  - readFromXml
```
private static void readFromXml(java.lang.String xmlDataset,
                                boolean append,
                                handle ds)
```
    Read the DATASET from XML.
    This is used when the remote call sent the DATASET as XML and it must receive it in the same format (used by SOAP callers).
    
    Parameters:
    
    xmlDataset - The XML serialized dataset.
    
    append - Flag indicating if the read mode is 'append'. Otherwise, is 'empty.
    
    ds - The handle where to read the dataset.
  - getBufferByName
```
public BufferImpl getBufferByName(java.lang.String name)
```
    Lookup a buffer by its name.
    
    Parameters:
    
    name - The name to search among the list of buffers.
    
    Returns:
    
    The buffer whose name was specified or null when there is no match.
  - getBufferBySerializeName
```
public BufferImpl getBufferBySerializeName(java.lang.String serializeName)
```
    Lookup a buffer by its serialize-name.
    
    Parameters:
    
    serializeName - The serialize-name to search among the list of buffers.
    
    Returns:
    
    The buffer whose serialize-name was specified or null when there is no match.
  - flushAllBuffers
```
private boolean flushAllBuffers()
```
    Flush all buffers (including secondary buffers and associated before-buffers) used in this dataset.
    
    Returns:
    
    true if all buffers were flushed.
  - getTopNavQuery
```
private handle getTopNavQuery(BufferImpl buffer)
```
    Obtain the current TOP-NAV-QUERY for a specified buffer. Uses lazy initialization: if not exist one is created (and prepared, but not open) now.
    
    Parameters:
    
    buffer - The buffer whose TOP-NAV-QUERY is to be returned.
    
    Returns:
    
    A handle to TOP-NAV-QUERY for specified buffer.
  - invalidTopNavQuery
```
private static void invalidTopNavQuery(int errCode,
                                       java.lang.String bufName)
```
    Notifies the user about an attempt to set an invalid value for TOP-NAV-QUERY attribute. Two error messages will be issued, the former being 14293 and the latter the one specified as parameter.
    
    Parameters:
    
    errCode - The message code (4056 or 4061).
    
    bufName - The buffer's name.
  - _setTopBufferQuery
```
private void _setTopBufferQuery(handle queryHandle,
                                BufferImpl topBuffer)
```
    Low level implementation of TOP-NAV-QUERY method. Does the final parameter checking before mapping the query to the buffer.
    
    Parameters:
    
    queryHandle - The query to be set.
    
    topBuffer - The top level buffer.
  - _areRelationsActive
```
boolean _areRelationsActive()
```
    Checks whether AT LEAST one data-relation objects in this DataSet object is active. All data-relation objects in a DataSet object are active by default.
    
    Returns:
    
    true when all data-relation objects are active.
  - addRelationWorker
```
private handle addRelationWorker(java.lang.String relName,
                                 Buffer parent,
                                 Buffer child,
                                 java.lang.String[] fields,
                                 java.lang.String strPairs,
                                 boolean reposition,
                                 boolean nested,
                                 boolean active,
                                 boolean recursive,
                                 boolean fkeyHidden,
                                 boolean dynamic)
```
    Adds a data-relation object for a pair of parent and child buffers to this DataSet object.
    
    Parameters:
    
    relName - The name of the relation.
    
    parent - The handle to the parent buffer in the data-relation object.
    
    child - The handle to the child buffer in the data-relation object.
    
    fields - An array of (parent-field, child-field) pairs describing the relationship between parent and child buffers in the new data-relation object.
    
    strPairs - The pair of fields, as string as they appear in the legacy statement.
    
    reposition - The reposition mode. If TRUE, the relation mode is REPOSITION. Otherwise the relation mode is SELECTION. The default value is SELECTION.
    
    nested - Use TRUE to nest child rows of DataSet buffers within their parent rows when writing the XML representation of data. When FALSE is passed, all child rows are written after all parent rows are written. The default value is FALSE.
    
    active - Use true to make the newly created relation active.
    
    recursive - Using TRUE will cause the data-relation to be filled recursively.
    
    fkeyHidden - When set to TRUE the foreign key fields in nested data-relations will be omitted when writing the XML representation of data. If this option is used, the NESTED argument must be TRUE.
    
    dynamic - Use true for dynamically created relations.
    
    Returns:
    
    A handle to the newly created DataRelation.
  - isAlterable
```
private boolean isAlterable()
```
    Checks whether this object can be altered (added buffers and relations). Normally, the static defined DataSet s are not alterable, but they can 'altered' by their Builder while the object is being constructed.
    
    Returns:
    
    true if new buffers or relations can be added.
  - isCallbackName
```
private static boolean isCallbackName(java.lang.String someName)
```
    Test whether a string is a valid CALLBACK name for DataSets. This method is responsible of raising the 11950 error if the name specified is unknown or not a name of a known callback for DataSet.
    
    Parameters:
    
    someName - The name to test.
    
    Returns:
    
    true only if someName is equals to "BEFORE-FILL" or "AFTER-FILL", in ignore-case mode.
  - getCallSite
```
private static InvokeConfig getCallSite(java.lang.String eventName)
```
    Get the callsite for the specified event.
    
    Parameters:
    
    eventName - The event name.
    
    Returns:
    
    see above
  - getTopBufferList
```
private java.util.List<Buffer> getTopBufferList()
```
    Obtain the list of top-buffers. From the list of all buffers are removed those buffers that are found as child buffers in an active relation.
    
    Returns:
    
    the list of top-buffers.
  - createLikeImpl
```
private logical createLikeImpl(DataSet sourceDS,
                               java.lang.String prefix)
```
    Actual implementation of CREATE-LIKE method. The sourceDS structure, including TempTable and DataRelation definitions, is copied to the this DataSet; the source data, however, is not copied.
    
    Parameters:
    
    sourceDS - The source DataSet.
    
    prefix - The name prefix for the newly created DatSet.
    
    Returns:
    
    true on success (and this object is a copy of the sourceDS), and false if the copy operation failed.
  - copyTempTableOptions
```
private static void copyTempTableOptions(AbstractTempTable src,
                                         AbstractTempTable dst)
```
    Copy the temp-table options from the source to the destination.
    
    Parameters:
    
    src - The source table.
    
    dst - The destination table.
  - positionOf
```
private static int positionOf(BufferImpl[] buffers,
                              BufferImpl item)
```
    Locates a BufferImpl in an array of objects of same type.
    
    Parameters:
    
    buffers - A buffers of items.
    
    item - The item to be located.
    
    Returns:
    
    the first occurrence of the item in the buffers or -1 if not found.
  - finishBuild
```
private void finishBuild()
```
    Declares this static DataSet as build. This will prohibit some of the setters to be called.
  - toString
```
public java.lang.String toString()
```
    Obtain a short description of the dataset used for debugging. If fullDebugString is true the full dataset (all rows of all buffers) is dumped as a JSON string. If only the dataset structure is needed, set fullDebugString to false.
    
    Overrides:
    
    toString in class HandleResource
    
    Returns:
    
    a short description of the dataset used for debugging.
    
    Throws:
    
    java.sql.SQLException
    
    PersistenceException
  - getSchema
```
private java.lang.String getSchema()
```
    Obtain a short description of the dataset structure: buffers and relations between them.
    
    Returns:
    
    a string describing the important elements of the dataset structure.
  - getDataAsJson
```
private java.lang.String getDataAsJson()
```
    Get the JSON representation of data of this DATASET. The returned value contains data from all tables of the dataset, but not the relations between them.
    
    Returns:
    
    See above.
    
    Throws:
    
    PersistenceException
    
    java.sql.SQLException - If any issue was encountered. Since this method is supposed to be called only in debug mode, it's up to programmer to decide what went wrong.
  - getSqlData
```
private java.lang.String getSqlData()
```
    Get the SQL representation of data of this DATASET. The returned value contains data from all tables of the dataset, but not the relations between them.
    
    Returns:
    
    See above.

Class DataSet

Nested Class Summary

Field Summary

Fields inherited from class com.goldencode.p2j.util.HandleChain

Fields inherited from class com.goldencode.p2j.util.HandleResource

Fields inherited from interface com.goldencode.p2j.persist.Fillable

Fields inherited from interface com.goldencode.p2j.persist.XmlNode

Constructor Summary

Method Summary

Methods inherited from class com.goldencode.p2j.util.HandleChain

Methods inherited from class com.goldencode.p2j.util.HandleResource

Methods inherited from class java.lang.Object

Methods inherited from interface com.goldencode.p2j.util.CallbackProcedure

Methods inherited from interface com.goldencode.p2j.persist.DataSourceModifiable

Methods inherited from interface com.goldencode.p2j.util.Dereferenceable

Methods inherited from interface com.goldencode.p2j.util.DynamicResource

Methods inherited from interface com.goldencode.p2j.util.CommonHandle

Methods inherited from interface com.goldencode.p2j.util.WrappedResource

Methods inherited from interface com.goldencode.util.Printable

Field Detail

BEFORE_FILL_EVENT

AFTER_FILL_EVENT

BEFORE_FILL_CALL_SITE

AFTER_FILL_CALL_SITE

uuid

STATIC_PARAM

DYN_PARAM

log

admData

nsUri

nsPrefix

xmlNodeName

serializeName

defaultActive

name

error

rejected

callbacks

dynamic

referenceOnly

buildInProgress

postponedDelete

serializeHidden

deleted

dataSourceModified

buffers

proxies

topNavQueries

deleteQueries

relations

outputParams

refs

proxyDataSet

reuseFillQuery

fullDebugString

Constructor Detail

DataSet

DataSet

Method Detail

create

create

create

associate

associate

associate

associate

associate

associate

associateImpl

createDynamicDataSet

createDynamicDataSet

createDynamicDataSet

createDynamicDataSet

createDynamicDataSetImpl

setProxyDataSet

getProxyDataSet

asHandle

resetNames

name

name