TempTableBuilder (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.AbstractTempTable
    - - com.goldencode.p2j.persist.TempTableBuilder

All Implemented Interfaces:

BufferHandle, CreateLike, DataSourceModifiable, EmptyTempTable, ErrorString, JsonData, NamedSerializable, PrimaryIndex, RefCounter, TempTable, TempTableDuplicator, UndoStateProvider, XmlData, XmlNode, ADMData, Clearable, CommonHandle, CommonHandleChain, Deletable, Dereferenceable, DynamicResource, Errorable, InstantiatingProcedure, Nameable, NamespaceURI, Rejectable, UniqueID, WrappedResource, Printable
```
public class TempTableBuilder
extends AbstractTempTable
```
Implementation of buffer of a dynamic TEMP-TABLE and the associated attributes and methods. This TempTable interface is needed by CommonHandle in order to store the handle to the table.

Author:

om

Nested Class Summary
- Nested classes/interfaces inherited from class com.goldencode.p2j.persist.AbstractTempTable
  AbstractTempTable.CallingFunction
- Nested classes/interfaces inherited from interface com.goldencode.p2j.persist.TempTable
  TempTable.BeforeType

Field Summary

Fields
Modifier and Type	Field and Description
`private boolean`	`addFunctionCalled` Flag that indicates that an ADD-* function was called for the table (CLEAR function resets this flag).
`private static java.util.Set<java.lang.Character>`	`allowedSpecialChars` Special characters (not letters or digits) allowed in dynamic table names.
`private static NanoTimer`	`CREATE_DYN_TT` Instrumentation for `tempTablePrepareImpl(String, String, boolean)`.
`private static java.util.Map<java.lang.String,java.lang.Integer>`	`datatypesMatchLen` Used during data type name validation.
`private static java.lang.String`	`DATETIMETZ_TYPE_NAME` datetime-tz 4GL type name.
`private static java.util.Map<java.lang.String,java.lang.String>`	`defaultFormatStrings` Data type name to default format string.
`private boolean`	`deleted` Determines if the table object was deleted.
`private java.lang.Class<? extends TempTableBuffer>`	`dmoBufIface` Generated DMO buffer class.
`private java.lang.Class<? extends DataModelObject>`	`dmoIface` Generated DMO buffer class.
`private DmoMeta`	`dmoInfo` Object which contains metadata about the DMO.
`private java.util.Map<java.lang.String,P2JField>`	`fields` Table fields keyed by their legacy normalized names.
`private boolean`	`implicitBeforeTable` Flag indicating if the `tempTablePrepare(java.lang.String)` should implicitly create the before-table - used when the `createLike(com.goldencode.p2j.util.handle, java.lang.String)` source table has a before-table.
`private java.util.Map<java.lang.String,P2JIndex>`	`indexes` Table indexes keyed by their normalized names.
`private boolean`	`postponedDelete` Flag indicating the delete was explicitly called for a BY-REFERENCE handle.

Fields inherited from class com.goldencode.p2j.persist.AbstractTempTable
admData, allBuffers, beforeTableType, DEFAULT_COPY_TEMP_TABLE_PREFIX, defaultBuffer, error, errorString, peerTable, SM_DEFAULT, SM_FULL, SM_MIN, SM_NONE, tableInfo, undoable

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

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

Fields inherited from interface com.goldencode.p2j.persist.TempTable
SCHEMA_MARSHAL_FULL, SCHEMA_MARSHAL_MIN, SCHEMA_MARSHAL_NONE

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

Constructor Summary

Constructors
Constructor and Description

TempTableBuilder()
Create a new TEMP-TABLE resource.

Constructors
Constructor and Description
`TempTableBuilder()` Create a new TEMP-TABLE resource.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`boolean`	`_clear()` Check whether this TEMP-TABLE is in CLEAR state: I.e.
`boolean`	`_dynamic()` Checks whether the resource is dynamic or static.
`java.lang.String`	`_name()` Get the `name` attribute of handle as a string.
`boolean`	`_prepared()` Returns `true` if this temp-table is in prepared state (after a successful call to `tempTablePrepare(java.lang.String)`).
`private void`	`addAllFields(BufferImpl source)` Add all fields from the source Buffer to this table.
`private void`	`addAllFields(java.util.Collection<P2JField> fields)` Add all fields from the given collection to the table.
`private void`	`addAllIndexes(java.util.Collection<P2JIndex> indexes)` Add all indexes from the given collection to the table.
`void`	`addField(P2JField field)` Add new field to the table.
`logical`	`addFieldLike(character name, character source)` Adds to the temp-table a field like the one specified.
`logical`	`addFieldLike(character name, handle source)` Adds to the temp-table a field like the one specified.
`logical`	`addFieldLike(character name, java.lang.String source)` Adds to the temp-table a field like the one specified.
`logical`	`addFieldLike(java.lang.String name, character source)` Adds to the temp-table a field like the one specified.
`logical`	`addFieldLike(java.lang.String name, handle source)` Adds to the temp-table a field like the one specified.
`logical`	`addFieldLike(java.lang.String name, java.lang.String source)` Adds to the temp-table a field like the one specified.
`logical`	`addFieldsFrom(character tableName)` Adds fields from another table into this temp-table.
`logical`	`addFieldsFrom(character tableName, character except)` Adds fields from another table into this temp-table.
`logical`	`addFieldsFrom(handle hbuf)` Adds fields from another table into this temp-table.
`logical`	`addFieldsFrom(handle hbuf, character except)` Adds fields from another table into this temp-table.
`logical`	`addFieldsFrom(handle hbuf, java.lang.String except)` Adds fields from another table into this temp-table.
`logical`	`addFieldsFrom(java.lang.String tableName)` Adds fields from another table into this temp-table.
`logical`	`addFieldsFrom(java.lang.String tableName, character except)` Adds fields from another table into this temp-table.
`logical`	`addFieldsFrom(java.lang.String tableName, java.lang.String except)` Adds fields from another table into this temp-table.
`logical`	`addFieldToIndex(character indexName, character field)` Construct an index of this temp-table by adding a new field to it.
`logical`	`addFieldToIndex(character indexName, character field, character ascending)` Construct an index of this temp-table by adding a new field to it.
`logical`	`addFieldToIndex(character indexName, character field, java.lang.String ascending)` Construct an index of this temp-table by adding a new field to it.
`logical`	`addFieldToIndex(character indexName, java.lang.String field)` Construct an index of this temp-table by adding a new field to it.
`logical`	`addFieldToIndex(character indexName, java.lang.String field, character ascending)` Construct an index of this temp-table by adding a new field to it.
`logical`	`addFieldToIndex(character indexName, java.lang.String field, java.lang.String ascending)` Construct an index of this temp-table by adding a new field to it.
`logical`	`addFieldToIndex(java.lang.String indexName, character field)` Construct an index of this temp-table by adding a new field to it.
`logical`	`addFieldToIndex(java.lang.String indexName, character field, character ascending)` Construct an index of this temp-table by adding a new field to it.
`logical`	`addFieldToIndex(java.lang.String indexName, character field, java.lang.String ascending)` Construct an index of this temp-table by adding a new field to it.
`logical`	`addFieldToIndex(java.lang.String indexName, java.lang.String field)` Construct an index of this temp-table by adding a new field to it.
`logical`	`addFieldToIndex(java.lang.String indexName, java.lang.String field, character ascending)` Construct an index of this temp-table by adding a new field to it.
`logical`	`addFieldToIndex(java.lang.String indexName, java.lang.String field, java.lang.String ascending)` Construct an index of this temp-table by adding a new field to it.
`protected boolean`	`addFunctionWasCalled()` Determine if an ADD-* function was called for the table (CLEAR function resets the state).
`private void`	`addIndex(P2JIndex index)` Add new index to the table.
`logical`	`addIndexLike(character name, character sourceName, character dbTable)` Adds to the temp-table an index like the one specified.
`logical`	`addIndexLike(character name, character sourceName, handle sourceBuffer)` Adds to the temp-table an index like the one specified.
`private logical`	`addIndexLike(P2JIndex srcIndex)` Adds to the temp-table an index like the one specified.
`logical`	`addIndexLike(java.lang.String name, java.lang.String sourceName, handle sourceBuffer)` Adds to the temp-table an index like the one specified.
`logical`	`addIndexLike(java.lang.String name, java.lang.String sourceName, java.lang.String dbTable)` Adds to the temp-table an index like the one specified.
`logical`	`addNewField(character name, character type)` Adds a field with the specified properties to the temp-table.
`logical`	`addNewField(character name, character type, integer extent)` Adds a field with the specified properties to the temp-table.
`logical`	`addNewField(character name, character type, integer extent, character format)` Adds a field with the specified properties to the temp-table.
`logical`	`addNewField(character name, character type, integer extent, character format, BaseDataType initial)` Adds a field with the specified properties to the temp-table.
`logical`	`addNewField(character name, character type, integer extent, character format, BaseDataType initial, character label)` Adds a field with the specified properties to the temp-table.
`logical`	`addNewField(character name, character type, integer extent, character format, BaseDataType initial, character label, character columnLabel)` Adds a field with the specified properties to the temp-table.
`logical`	`addNewField(character name, character type, integer extent, character format, BaseDataType initial, character label, character columnLabel, character help, character xmlNodeType, character codePage, boolean serializeHidden, boolean caseSensitive)` Adds a field with the specified properties to the temp-table.
`protected void`	`addNewField(PropertyDefinition propertyDefinition)` Add new field from property definition data.
`private boolean`	`addNewField(java.lang.String name, ParmType type, java.lang.Long extent, java.lang.String format, java.lang.String initial, java.lang.String label, java.lang.String columnLabel, java.lang.String help, java.lang.String xmlNodeType, java.lang.String codePage, boolean serializeHidden, boolean caseSensitive)` Adds a field with the specified properties to the temp-table.
`logical`	`addNewIndex(character name)` Adds a new empty index with the specified name to the temp-table.
`logical`	`addNewIndex(character name, logical unique)` Adds a new empty index with the specified name to the temp-table.
`logical`	`addNewIndex(character name, logical unique, logical primary)` Adds a new empty index with the specified name to the temp-table.
`logical`	`addNewIndex(character name, logical unique, logical primary, logical word)` Adds a new empty index with the specified name to the temp-table.
`boolean`	`allowDelete(handle ref, boolean explicit)` Check if the resource can veto the delete or not, before attempting the `HandleChain.delete()` call.
`static TempTable`	`asTempTable(Temporary buf)` Get the TEMP-TABLE associated with this temporary buffer.
`static handle`	`buffer(Buffer buf)` Get the BUFFER handle associated with this temporary buffer.
`static P2JField`	`buildField(Property prop, ParmType parmType, BaseDataType initialValue)` Build a `P2JField` instance with the specified details.
`logical`	`clear()` Returns the temp-table to it's clear state, removing all defined fields, indexes, all records in the table and all corresponding buffers.
`private P2JField`	`copyField(java.lang.String targetName, P2JField srcField)` Returns a new field with the new specified name and all other parameters copied from the source field.
`private P2JIndex`	`copyIndex(P2JIndex srcIndex)` Returns a new index with all parameters copied from the source index.
`static void`	`create(handle tth)` Dynamically creates a temporary table at runtime and assign it to a handle.
`static void`	`create(handle tth, character widgetPool)` Dynamically creates a temporary table at runtime and assign it to a handle.
`static void`	`create(handle tth, java.lang.String widgetPool)` Dynamically creates a temporary table at runtime and assign it to a handle.
`(package private) boolean`	`createBeforeTable(java.lang.String beforeName, java.lang.String afterName)` Creates the before table and link it to current table.
`private void`	`createDefaultBuffer()` Create default buffer for the table.
`void`	`createFromTableWrapper(TableWrapper tableWrapper, int tableParameterIndex)` Build temporary table from a table wrapper object.
`logical`	`createLike(character tableName)` Duplicates the structure of an existing table, copying the field definitions, and optionally, the indexes.
`logical`	`createLike(character tableName, character indexName)` Duplicates the structure of an existing table, copying the field definitions, and optionally, the indexes.
`logical`	`createLike(handle hbuf)` Duplicates the structure of an existing table, copying the field definitions, and optionally, the indexes.
`logical`	`createLike(handle hbuf, character indexName)` Duplicates the structure of an existing table, copying the field definitions, and optionally, the indexes.
`logical`	`createLike(handle hbuf, java.lang.String indexName)` Duplicates the structure of an existing table, copying the field definitions, and optionally, the indexes.
`logical`	`createLike(java.lang.String tableName)` Duplicates the structure of an existing table, copying the field definitions, and optionally, the indexes.
`logical`	`createLike(java.lang.String tableName, java.lang.String indexName)` Duplicates the structure of an existing table, copying the field definitions, and optionally, the indexes.
`BufferImpl`	`createRemoteTable(java.lang.String tableName, java.util.Iterator<PropertyDefinition> props, java.lang.Runnable indexProvider, java.lang.String xmlns, java.lang.String xmlPrefix, int schemaMarshalLevel)` Create a temp-table with the specified definition, as received from a remote side.
`BufferImpl`	`createRemoteTable(java.lang.String tableName, java.util.Iterator<PropertyDefinition> props, java.lang.String tableIndexes, java.lang.String xmlns, java.lang.String xmlPrefix, int schemaMarshalLevel)` Create a temp-table with the specified definition, as received from a remote side.
`BufferImpl`	`createTable(java.lang.String tableName, java.util.Iterator<PropertyDefinition> props, java.lang.Runnable indexProvider, java.lang.String xmlns, java.lang.String xmlPrefix, int schemaMarshalLevel)` Create a temp-table with the specified definition.
`BufferImpl`	`createTable(java.lang.String tableName, java.util.Iterator<PropertyDefinition> props, java.lang.String tableIndexes, java.lang.String xmlns, java.lang.String xmlPrefix, int schemaMarshalLevel)` Create a temp-table with the specified definition.
`private logical`	`createTableLikeImpl(character tableName, character indexName, boolean handleIndex)` Duplicates the structure of an existing table, copying the field definitions, and optionally, the indexes.
`private logical`	`createTableLikeImpl(handle hbuf, character indexName, boolean handleIndex)` Duplicates the structure of an existing table, copying the field definitions, and optionally, the indexes.
`handle`	`defaultBufferHandle()` Obtain the handle to the buffer that was created by default for this temporary table.
`Buffer`	`defaultBufferHandleNative()` Obtain the buffer that was created by default for this temporary table.
`private void`	`displayCouldNotFindAddIndex(java.lang.String indexName)` Display "Could not find index {indexName} during ADD-INDEX-FIELD" error message.
`private void`	`displayCouldNotFindLikeField(java.lang.String fieldName)` Display "Could not find source field {fieldName} during ADD-LIKE-FIELD." error message.
`private void`	`displayCouldNotFindLikeIndex(java.lang.String tableName, java.lang.String indexName)` Display "ADD-LIKE-INDEX could not find index {indexName} in table {tableName}" error message.
`private void`	`displayCouldNotFindLikeTable(java.lang.String tableName)` Display "Could not find table {tableName} during ADD-LIKE-FIELD.
`private void`	`displayCouldNotFindLikeTableName(java.lang.String tableName)` Display "TEMP-TABLE method could not find LIKE table name {tableName}}" error message.
`private void`	`displayDuplicateIndex(java.lang.String indexName)` Display "Duplicate index name {indexName} for temp-table" error message.
`private void`	`displayDuplicateOrInvalidIndexField(java.lang.String indexName, java.lang.String fieldName)` Display "Attempt to add duplicate or inappropriate word index field {fieldName} to index {indexName}" error message.
`private void`	`displayUnableToCreateLikeIndex()` Display "Unable to create index for TEMP-TABLE in ADD-LIKE-INDEX" error message.
`private void`	`displayUnableToEvaluate()` Display "Unable to evaluate arguments for TEMP-TABLE method" error message.
`private void`	`displayUnableToFindIndex(java.lang.String tableName, java.lang.String indexName)` Display "Unable to find index {indexName} in table {tableName}" error message.
`private void`	`displayUnableToPrepareTableFields()` Display "Unable to prepare TEMP-TABLE fields" error message.
`private void`	`displayUnableToPrepareTableIndices()` Display "Unable to prepare TEMP-TABLE indices" error message.
`private void`	`doAddFieldsFrom(java.util.Collection<P2JField> srcFields, character except)` Add specified set of fields to the table.
`logical`	`dynamic()` Checks whether the resource is dynamic or static.
`private Persistence`	`findExistingTable(java.lang.String fullTableName, boolean tableNameSearch)` Search for an existing table with the specified name.
`private static P2JIndex`	`findIndexByName(java.util.Collection<P2JIndex> indexes, java.lang.String indexName)` Find index in the collection of indexes by its name.
`private boolean`	`forceClear()` Unconditionally delete all buffers for this table, drop DMO definitions and temporary table, clear TEMP-TABLE data structures.
`void`	`forceDelete()` Unconditionally delete all buffers for this table, drop DMO definitions and temporary table, clear TEMP-TABLE data structures and mark the table as deleted (i.e.
`java.lang.String`	`getCodePage(java.lang.String property)` Get code page of the specified CLOB field.
`java.util.function.Supplier`	`getCodePageSupplier(java.lang.String property)` Get code page supplier of the specified CLOB field.
`static java.lang.String`	`getDefaultDataTypeFormat(java.lang.String datatype)` Get default format for the given data type.
`java.lang.Class<? extends TempTableBuffer>`	`getDMOBufInterface()` Get buffer interface which backs this table.
`java.lang.Class<? extends Record>`	`getDMOClass()` Get DMO implementation class associated with this table.
`java.lang.Class<? extends DataModelObject>`	`getDMOInterface()` Get DMO interface which backs this table.
`DmoMeta`	`getDmoMeta()` Obtain the `DmoMeta` structure which contains the legacy meta information.
`static P2JField`	`getExistingField(Persistence persistence, java.lang.String tableName4GL, java.lang.String fieldName4GL)` Get the field (legacy name) of an existing table.
`static P2JField`	`getExistingField(RecordBuffer buffer, java.lang.String propertyName)` Get the field of an existing table.
`static java.util.Collection<P2JField>`	`getExistingFields(Persistence persistence, java.lang.String tableName4GL)` Get the fields of an existing table.
`static java.util.Collection<P2JField>`	`getExistingFields(RecordBuffer buffer)` Get the fields of an existing table.
`static P2JIndex`	`getExistingIndex(Persistence persistence, java.lang.String tableName4GL, java.lang.String indexName4GL)` Get the index of an existing table.
`static P2JIndex`	`getExistingIndex(RecordBuffer buffer, java.lang.String indexName4GL)` Get the index of an existing table.
`static java.util.Collection<P2JIndex>`	`getExistingIndexes(Persistence persistence, java.lang.Class<? extends Record> dmoClass, TempTable tempTable)` Get the indexes of an existing table.
`static java.util.Collection<P2JIndex>`	`getExistingIndexes(Persistence persistence, java.lang.String tableName4GL)` Get the indexes of an existing table.
`static java.util.Collection<P2JIndex>`	`getExistingIndexes(RecordBuffer buffer)` Get the indexes of an existing table.
`static TempTable`	`getExistingTempTable(java.lang.String normalizedTableName4GL)` Get the active static temp table with the given name.
`P2JField`	`getField(java.lang.String fieldName)` Get field by its name.
`java.util.Collection<P2JField>`	`getFields()` Get the collection of table fields.
`P2JIndex`	`getIndex(java.lang.String indexName)` Get index by its name.
`java.util.Collection<P2JIndex>`	`getIndexes()` Get table indexes.
`static java.lang.String`	`getLegacyTableName(RecordBuffer buffer)` Get legacy table name.
`static java.lang.String[]`	`getOrderedPropertyNames(TempTable tempTable)` Get the array of ORM property names ordered in the same way as they were specified in 4GL for the given temp-table.
`static java.lang.String[]`	`getPropertyNamesArray(java.lang.Class<? extends DataModelObject> dmoIface, TempTable tempTable)` Get the array of DMO property names ordered in the same way as they were specified in 4GL for the given table (for the possible denormalized tables).
`private boolean`	`hasField(java.lang.String fieldName)` Checks whether the field with specified name already exist.
`private boolean`	`hasIndex(java.lang.String indexName)` Checks whether the index with specified name already exist.
`protected boolean`	`hasNameConstraints()` Allows each resource to declare whether it has some naming constraints.
`protected boolean`	`hasNameReadOnly()` Check if this resource supports the NAME attribute only in read-only mode.
`protected boolean`	`hasNextSibling()` Check if this resource supports the NEXT-SIBLING attribute.
`protected boolean`	`hasPrevSibling()` Check if this resource supports the PREV-SIBLING attribute.
`private boolean`	`hasSameNormalizedName(java.lang.String name1, java.lang.String name2)` Determines if two names has the same normalized form.
`(package private) boolean`	`isPostponedDelete()` Check if this temp-table was attempted to be deleted, but was postponed because of the handle being a TABLE-HANDLE BY-REFERENCE.
`character`	`name()` Get table NAME attribute.
`void`	`name(character name)` Set table NAME attribute.
`private java.util.Set<java.lang.String>`	`parseFieldList(character list)` Split comma-separated list of field names into the set of separate field names.
`private void`	`parseIndexString(java.lang.String tableIndexes)` Add indexes based on multiIxCols string.
`character`	`primaryIndex()` Get the PRIMARY attribute.
`void`	`primaryIndex(java.lang.String primary)` Set the PRIMARY attribute.
`boolean`	`readTable(java.lang.String tableName, TableReader reader)` Read XML/JSON data from the input source and store it in the just created empty TEMP-TABLE.
`protected boolean`	`resourceDelete()` Worker to be implemented by each resource.
`void`	`setCodePage(java.lang.String property, java.lang.String codePage)` Set code page for the specified CLOB field.
`void`	`setCodePageSupplier(java.lang.String property, java.util.function.Supplier supplier)` Set code page supplier for the specified CLOB field.
`(package private) void`	`setDmoIface(DmoMeta dmoInfo, java.lang.Class<? extends DataModelObject> dmoIface, java.lang.Class<? extends TempTableBuffer> dmoBufIface)` Set DMO interface class which corresponds the table.
`void`	`setPostponedDelete(boolean postponed)` Set the `postponedDelete` flag.
`static handle`	`tempTable(Temporary buf)` Get the TEMP-TABLE handle associated with this temporary buffer.This allows chaining of methods/attributes on a buffer using its TEMP-TABLE interface.
`logical`	`tempTablePrepare(character name)` Signals that all the field and index definitions for a temp-table have been provided.
`logical`	`tempTablePrepare(character name, boolean before)` Signals that all the field and index definitions for a temp-table have been provided.
`logical`	`tempTablePrepare(character name, logical before)` Signals that all the field and index definitions for a temp-table have been provided.
`logical`	`tempTablePrepare(java.lang.String name)` Signals that all the field and index definitions for a temp-table have been provided.
`logical`	`tempTablePrepare(java.lang.String name, boolean before)` Signals that all the field and index definitions for a temp-table have been provided.
`logical`	`tempTablePrepare(java.lang.String name, logical before)` Signals that all the field and index definitions for a temp-table have been provided.
`boolean`	`tempTablePrepare(java.lang.String tableName, java.lang.String beforeName)` The implementation of `TEMP-TABLE-PREPARE` method.
`(package private) logical`	`tempTablePrepareImpl(java.lang.String tableName, java.lang.String beforeName, boolean isBeforeTable)` The implementation of `TEMP-TABLE-PREPARE` method.
`java.lang.String`	`toString()` Returns a string representation of the object.
`boolean`	`valid()` Reports if this object is valid for use.
`static ParmType`	`validateDatatype(java.lang.String datatype)` Validates data type name which was passed to ADD-NEW-FIELD function.
`static void`	`validateDateFormatOnAddNewField(java.lang.String fmt)` Validates date format on adding new field.
`static boolean`	`validateFormat(ParmType parmType, java.lang.String format)` Validate format for the given data type.

Methods inherited from class com.goldencode.p2j.persist.AbstractTempTable
_hasRecords, _isTrackingChanges, canUndo, changeErrorString, copyTempTable, copyTempTable, copyTempTable, copyTempTable, copyTempTable, copyTempTable, copyTempTable, copyTempTable, copyTempTable, defaultBuffer, deleteAll, deleteAllBuffers, deleteAllImpl, deleteForAll, dereference, dereference, dereference, derefPoly, deregisterBuffer, displayCannotClear, displayCopyTempTableHalfDefined, displayCopyTempTableInvalidFirstArg, displayCouldNotFindLikeTableFromHandle, displayCreateLikeNotFirst, displayNotPrepared, displayPrepared, displayPreparedIgnoring, displayUnableAddFieldsFrom, displayUnableAssignUnknownUndo, displayUnableCreateLike, displayUninitialized, error, error, error, errorString, flushBuffers, getADMData, getAfterTable, getAfterTableNative, getBeforeTable, getBeforeTableNative, getMutableInfo, getOriginHandle, getOriginTable, getRecordBufferByHandle, getSchemaMarshal, getSchemaMarshalLevel, getSerializeName, getUniqueID, getXmlDataType, getXmlNodeName, getXmlNodeType, hasRecords, isDataSourceModified, isMinSchemaMarshal, isNoSchemaMarshal, isTrackingChanges, isUndoable, namespacePrefix, namespacePrefix, namespacePrefix, namespaceURI, namespaceURI, namespaceURI, numReferences, prepared, primaryIndex, readJson, readJson, readXml, readXml, readXml, readXmlSchema, readXmlSchema, readXmlSchema, registerBuffer, rejected, rejected, rejected, setADMData, setADMData, setCanUndo, setDataSourceModified, setDataSourceModified, setMinSchemaMarshal, setMinSchemaMarshal, setNoSchemaMarshal, setNoSchemaMarshal, setOriginTable, setSchemaMarshal, setSchemaMarshal, setSchemaMarshalLevel, setSerializeName, setSerializeName, setTrackingChanges, setTrackingChanges, setXmlDataType, setXmlDataType, setXmlNodeName, setXmlNodeName, setXmlNodeType, setXmlNodeType, tableDefinition, validateAllBuffers, writeJson, writeJson, writeJson, writeJson, writeJson, writeJson, writeXml, writeXml, writeXml, writeXml, writeXml, writeXml, writeXml, writeXml, writeXmlSchema, writeXmlSchema, writeXmlSchema, writeXmlSchema, writeXmlSchema

Methods inherited from class com.goldencode.p2j.util.HandleChain
delete, firstResource, firstResource, getHead, getNextSibling, getNextSibling, getPrevSibling, getPrevSibling, getPrivateData, getTail, hasName, hasParent, hasPrivateData, interlink, isChained, lastResource, lastResource, moveInChain, name, 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.CommonHandleChain
getNextSibling, getPrevSibling, getPrivateData, setPrivateData, setPrivateData

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

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

Methods inherited from interface com.goldencode.p2j.util.Nameable
name

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

Methods inherited from interface com.goldencode.p2j.util.Deletable
delete

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

Methods inherited from interface com.goldencode.p2j.util.InstantiatingProcedure
instantiatingProcedure

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

- Field Detail
  - DATETIMETZ_TYPE_NAME
```
private static final java.lang.String DATETIMETZ_TYPE_NAME
```
    datetime-tz 4GL type name.
    
    See Also:
    
    Constant Field Values
  - CREATE_DYN_TT
```
private static final NanoTimer CREATE_DYN_TT
```
    Instrumentation for tempTablePrepareImpl(String, String, boolean).
  - allowedSpecialChars
```
private static final java.util.Set<java.lang.Character> allowedSpecialChars
```
    Special characters (not letters or digits) allowed in dynamic table names.
  - datatypesMatchLen
```
private static final java.util.Map<java.lang.String,java.lang.Integer> datatypesMatchLen
```
    Used during data type name validation. Map that stores the minimal possible length of a data type name abbreviation. E.g. instead "integer" you can specify "integ", "int" or "i" because the minimal length for this type is 1.
  - defaultFormatStrings
```
private static final java.util.Map<java.lang.String,java.lang.String> defaultFormatStrings
```
    Data type name to default format string.
  - fields
```
private final java.util.Map<java.lang.String,P2JField> fields
```
    Table fields keyed by their legacy normalized names.
  - indexes
```
private final java.util.Map<java.lang.String,P2JIndex> indexes
```
    Table indexes keyed by their normalized names.
  - dmoInfo
```
private DmoMeta dmoInfo
```
    Object which contains metadata about the DMO.
  - dmoIface
```
private java.lang.Class<? extends DataModelObject> dmoIface
```
    Generated DMO buffer class.
  - dmoBufIface
```
private java.lang.Class<? extends TempTableBuffer> dmoBufIface
```
    Generated DMO buffer class.
  - deleted
```
private boolean deleted
```
    Determines if the table object was deleted.
  - addFunctionCalled
```
private boolean addFunctionCalled
```
    Flag that indicates that an ADD-* function was called for the table (CLEAR function resets this flag). The value of this flag is used in CREATE-LIKE.
  - postponedDelete
```
private boolean postponedDelete
```
    Flag indicating the delete was explicitly called for a BY-REFERENCE handle.
  - implicitBeforeTable
```
private boolean implicitBeforeTable
```
    Flag indicating if the tempTablePrepare(java.lang.String) should implicitly create the before-table - used when the createLike(com.goldencode.p2j.util.handle, java.lang.String) source table has a before-table.
- Constructor Detail
  - TempTableBuilder
```
public TempTableBuilder()
```
    Create a new TEMP-TABLE resource.
- Method Detail
  - createRemoteTable
```
public BufferImpl createRemoteTable(java.lang.String tableName,
                                    java.util.Iterator<PropertyDefinition> props,
                                    java.lang.String tableIndexes,
                                    java.lang.String xmlns,
                                    java.lang.String xmlPrefix,
                                    int schemaMarshalLevel)
```
    Create a temp-table with the specified definition, as received from a remote side.
    
    Parameters:
    
    tableName - The table name.
    
    props - The property definitions.
    
    tableIndexes - The index definitions.
    
    xmlns - The XML namespace.
    
    xmlPrefix - The XML prefix.
    
    schemaMarshalLevel - The SCHEMA-MARSHAL level for the serialized temp-table.
    
    Returns:
    
    default buffer for the table
  - createRemoteTable
```
public BufferImpl createRemoteTable(java.lang.String tableName,
                                    java.util.Iterator<PropertyDefinition> props,
                                    java.lang.Runnable indexProvider,
                                    java.lang.String xmlns,
                                    java.lang.String xmlPrefix,
                                    int schemaMarshalLevel)
```
    Create a temp-table with the specified definition, as received from a remote side.
    
    Parameters:
    
    tableName - The table name.
    
    props - The property definitions.
    
    indexProvider - indexes' provider.
    
    xmlns - The XML namespace.
    
    xmlPrefix - The XML prefix.
    
    schemaMarshalLevel - The SCHEMA-MARSHAL level for the serialized temp-table.
    
    Returns:
    
    default buffer for the table
  - create
```
public static void create(handle tth,
                          java.lang.String widgetPool)
```
    Dynamically creates a temporary table at runtime and assign it to a handle. The table is empty and will be populated with fields, indexes and relations subsequent statements. This method is the P2J equivalent of CREATE TEMP-TABLE statement of Progress 4GL.
    
    Parameters:
    
    tth - The handle to assign the newly created temporary table to.
    
    widgetPool - The name of the widget pool that contains the temp-table. null if the unnamed pool must be used.
  - create
```
public static void create(handle tth,
                          character widgetPool)
```
    Dynamically creates a temporary table at runtime and assign it to a handle. The table is empty and will be populated with fields, indexes and relations subsequent statements. This method is the P2J equivalent of CREATE TEMP-TABLE statement of Progress 4GL.
    
    Parameters:
    
    tth - The handle to assign the newly created temporary table to.
    
    widgetPool - The name of the widget pool that contains the temp-table. null if the unnamed pool must be used.
  - create
```
public static void create(handle tth)
```
    Dynamically creates a temporary table at runtime and assign it to a handle. The table is empty and will be populated with fields, indexes and relations subsequent statements. This method is the P2J equivalent of CREATE TEMP-TABLE statement of Progress 4GL.
    
    Parameters:
    
    tth - The handle to assign the newly created temporary table to.
  - buffer
```
public static handle buffer(Buffer buf)
```
    Get the BUFFER handle associated with this temporary buffer. This allows chaining of methods/attributes on a buffer using its BUFFER interface.
    
    Parameters:
    
    buf - A temporary buffer for which the associated BUFFER resource is needed.
    
    Returns:
    
    See above.
  - tempTable
```
public static handle tempTable(Temporary buf)
```
    Get the TEMP-TABLE handle associated with this temporary buffer.This allows chaining of methods/attributes on a buffer using its TEMP-TABLE interface. Some attributes/methods are accessible only via the proper interface. Otherwise, 4052 error will be generated at runtime.
    
    Parameters:
    
    buf - A temporary buffer for which the associated TEMP-TABLE resource is needed.
    
    Returns:
    
    See above.
  - asTempTable
```
public static TempTable asTempTable(Temporary buf)
```
    Get the TEMP-TABLE associated with this temporary buffer. This method allows simplifying the generated code when a TEMP-TABLE method/attribute of a buffer that has TEMP-TABLE namespace specified. If the TEMP-TABLE is specified but the method/attribute is not from TempTable the tempTable(com.goldencode.p2j.persist.Temporary) should be used as it allows to correctly generate the 4052 error message (~ is not a queryable attribute for ~).
    
    Parameters:
    
    buf - A temporary buffer for which the associated TEMP-TABLE resource is needed.
    
    Returns:
    
    See above.
  - getExistingTempTable
```
public static TempTable getExistingTempTable(java.lang.String normalizedTableName4GL)
```
    Get the active static temp table with the given name.
    
    Parameters:
    
    normalizedTableName4GL - Normalized legacy name of the temp table.
    
    Returns:
    
    active static temp table with the given name or null if a table wasn't found by the given name.
  - getExistingField
```
public static P2JField getExistingField(Persistence persistence,
                                        java.lang.String tableName4GL,
                                        java.lang.String fieldName4GL)
```
    Get the field (legacy name) of an existing table.
    
    Parameters:
    
    persistence - Persistence which corresponds the target database.
    
    tableName4GL - 4GL table name.
    
    fieldName4GL - 4GL field name.
    
    Returns:
    
    field with the specified name or null if there is no such field.
  - getExistingField
```
public static P2JField getExistingField(RecordBuffer buffer,
                                        java.lang.String propertyName)
```
    Get the field of an existing table.
    
    Parameters:
    
    buffer - A record buffer which backs records of the target table.
    
    propertyName - The property name.
    
    Returns:
    
    field with the specified name or null if there is no such field.
  - getExistingIndex
```
public static P2JIndex getExistingIndex(RecordBuffer buffer,
                                        java.lang.String indexName4GL)
```
    Get the index of an existing table.
    
    Parameters:
    
    buffer - A record buffer which backs records of the target table.
    
    indexName4GL - 4GL index name.
    
    Returns:
    
    index with the specified name or null if there is no such index.
  - getExistingIndex
```
public static P2JIndex getExistingIndex(Persistence persistence,
                                        java.lang.String tableName4GL,
                                        java.lang.String indexName4GL)
```
    Get the index of an existing table.
    
    Parameters:
    
    persistence - Persistence which corresponds the target database.
    
    tableName4GL - 4GL table name.
    
    indexName4GL - 4GL index name.
    
    Returns:
    
    index with the specified name or null if there is no such index.
  - getExistingIndexes
```
public static java.util.Collection<P2JIndex> getExistingIndexes(Persistence persistence,
                                                                java.lang.String tableName4GL)
```
    Get the indexes of an existing table.
    
    Parameters:
    
    persistence - Persistence which corresponds the target database.
    
    tableName4GL - 4GL table name.
    
    Returns:
    
    collection of the indexes of the target table or null if there is no such table.
  - getExistingIndexes
```
public static java.util.Collection<P2JIndex> getExistingIndexes(Persistence persistence,
                                                                java.lang.Class<? extends Record> dmoClass,
                                                                TempTable tempTable)
```
    Get the indexes of an existing table.
    
    Parameters:
    
    persistence - Persistence which corresponds the target database.
    
    dmoClass - DMO class.
    
    tempTable - The temp-table instance, for temporary DMOs.
    
    Returns:
    
    collection of the indexes of the target table or null if there is no such table.
  - getExistingIndexes
```
public static java.util.Collection<P2JIndex> getExistingIndexes(RecordBuffer buffer)
```
    Get the indexes of an existing table.
    
    Parameters:
    
    buffer - A record buffer which backs records of the target table.
    
    Returns:
    
    collection of the indexes of the target table or null if there is no such table.
  - getExistingFields
```
public static java.util.Collection<P2JField> getExistingFields(RecordBuffer buffer)
```
    Get the fields of an existing table. The P2JField.name are legacy field names, not properties. The order in which they are returned is the native order in which they were defined/added.
    
    Parameters:
    
    buffer - A record buffer which backs records of the target table.
    
    Returns:
    
    collection of the fields of the target table or null if there is no such table.
  - buildField
```
public static P2JField buildField(Property prop,
                                  ParmType parmType,
                                  BaseDataType initialValue)
```
    Build a P2JField instance with the specified details.
    
    Parameters:
    
    prop - The field's annotation.
    
    parmType - The field's type.
    
    initialValue - The field's initial value.
    
    Returns:
    
    See above.
  - getExistingFields
```
public static java.util.Collection<P2JField> getExistingFields(Persistence persistence,
                                                               java.lang.String tableName4GL)
```
    Get the fields of an existing table. The list contains the original fields (not-denormalized).
    
    Parameters:
    
    persistence - Persistence which corresponds the target database.
    
    tableName4GL - 4GL table name.
    
    Returns:
    
    collection of the fields of the target table or null if there is no such table.
  - getOrderedPropertyNames
```
public static java.lang.String[] getOrderedPropertyNames(TempTable tempTable)
```
    Get the array of ORM property names ordered in the same way as they were specified in 4GL for the given temp-table. NB: should not be used for the denormalized tables!!!
    
    Parameters:
    
    tempTable - Temp-table object which backs the target table.
    
    Returns:
    
    array of ORM property names ordered in the same way as they were specified in 4GL for the given temp-table.
  - getPropertyNamesArray
```
public static java.lang.String[] getPropertyNamesArray(java.lang.Class<? extends DataModelObject> dmoIface,
                                                       TempTable tempTable)
```
    Get the array of DMO property names ordered in the same way as they were specified in 4GL for the given table (for the possible denormalized tables).
    
    Parameters:
    
    dmoIface - DMO interface associated with the target table.
    
    tempTable - Temp-table object which backs the target table or null if the table is a permanent table.
    
    Returns:
    
    array of DMO property names
  - getLegacyTableName
```
public static java.lang.String getLegacyTableName(RecordBuffer buffer)
```
    Get legacy table name.
    
    Parameters:
    
    buffer - A buffer of the target table.
    
    Returns:
    
    legacy table name.
  - findIndexByName
```
private static P2JIndex findIndexByName(java.util.Collection<P2JIndex> indexes,
                                        java.lang.String indexName)
```
    Find index in the collection of indexes by its name.
    
    Parameters:
    
    indexes - Collection of indexes to be searched.
    
    indexName - Name of the target index.
    
    Returns:
    
    index with the specified name or null if there is no such index.
  - validateDateFormatOnAddNewField
```
public static void validateDateFormatOnAddNewField(java.lang.String fmt)
                                            throws ErrorConditionException
```
    Validates date format on adding new field.
    
    Parameters:
    
    fmt - Date format.
    
    Throws:
    
    ErrorConditionException - Date format is wrong.
  - getDefaultDataTypeFormat
```
public static java.lang.String getDefaultDataTypeFormat(java.lang.String datatype)
```
    Get default format for the given data type.
    
    Parameters:
    
    datatype - Data type (string representation as in Enum.toString().
    
    Returns:
    
    default format for the given data type.
  - validateFormat
```
public static boolean validateFormat(ParmType parmType,
                                     java.lang.String format)
```
    Validate format for the given data type.
    
    Parameters:
    
    parmType - Data type.
    
    format - Format string to check.
    
    Returns:
    
    true if format is valid.
  - validateDatatype
```
public static ParmType validateDatatype(java.lang.String datatype)
```
    Validates data type name which was passed to ADD-NEW-FIELD function.
    
    Parameters:
    
    datatype - Data type name.
    
    Returns:
    
    corresponding ParmType or null if validation has failed.
  - isPostponedDelete
```
boolean isPostponedDelete()
```
    Check if this temp-table was attempted to be deleted, but was postponed because of the handle being a TABLE-HANDLE BY-REFERENCE.
    
    Returns:
    
    The postponedDelete.
  - setPostponedDelete
```
public void setPostponedDelete(boolean postponed)
```
    Set the postponedDelete flag.
    
    Parameters:
    
    postponed - Flag indicating that delete is postponed.
  - createLike
```
public logical createLike(handle hbuf,
                          java.lang.String indexName)
```
    Duplicates the structure of an existing table, copying the field definitions, and optionally, the indexes. This method is the P2J equivalent of CREATE-LIKE method of Progress 4GL.
    
    Parameters:
    
    hbuf - A handle to a buffer or table from which to copy the definitions.
    
    indexName - The name of a single index which is copied from the source table.
    
    Returns:
    
    true on success.
  - createLike
```
public logical createLike(handle hbuf,
                          character indexName)
```
    Duplicates the structure of an existing table, copying the field definitions, and optionally, the indexes. This method is the P2J equivalent of CREATE-LIKE method of Progress 4GL.
    
    Parameters:
    
    hbuf - A handle to a buffer or table from which to copy the definitions.
    
    indexName - The name of a single index which is copied from the source table.
    
    Returns:
    
    true on success.
  - createLike
```
public logical createLike(java.lang.String tableName,
                          java.lang.String indexName)
```
    Duplicates the structure of an existing table, copying the field definitions, and optionally, the indexes. This method is the P2J equivalent of CREATE-LIKE method of Progress 4GL.
    
    Parameters:
    
    tableName - The name of a table to create the copy of.
    
    indexName - The name of a single index which is copied from the source table.
    
    Returns:
    
    true on success.
  - createLike
```
public logical createLike(character tableName,
                          character indexName)
```
    Duplicates the structure of an existing table, copying the field definitions, and optionally, the indexes. This method is the P2J equivalent of CREATE-LIKE method of Progress 4GL.
    
    Parameters:
    
    tableName - The name of a table to create the copy of.
    
    indexName - The name of a single index which is copied from the source table.
    
    Returns:
    
    true on success.
  - createLike
```
public logical createLike(handle hbuf)
```
    Duplicates the structure of an existing table, copying the field definitions, and optionally, the indexes. This method is the P2J equivalent of CREATE-LIKE method of Progress 4GL.
    
    Parameters:
    
    hbuf - A handle to a buffer or table from which to copy the definitions.
    
    Returns:
    
    true on success.
  - createLike
```
public logical createLike(java.lang.String tableName)
```
    Duplicates the structure of an existing table, copying the field definitions, and optionally, the indexes. This method is the P2J equivalent of CREATE-LIKE method of Progress 4GL.
    
    Parameters:
    
    tableName - The name of a table to create the copy of.
    
    Returns:
    
    true on success.
  - createLike
```
public logical createLike(character tableName)
```
    Duplicates the structure of an existing table, copying the field definitions, and optionally, the indexes. This method is the P2J equivalent of CREATE-LIKE method of Progress 4GL.
    
    Parameters:
    
    tableName - The name of a table to create the copy of.
    
    Returns:
    
    true on success.
  - addNewField
```
public logical addNewField(character name,
                           character type)
```
    Adds a field with the specified properties to the temp-table. This method is the P2J equivalent of ADD-NEW-FIELD method of Progress 4GL.
    
    Parameters:
    
    name - The name of the field to be created in the temp-table.
    
    type - The data type of the specified field.
    
    Returns:
    
    true on success.
  - addNewField
```
public logical addNewField(character name,
                           character type,
                           integer extent)
```
    Adds a field with the specified properties to the temp-table. This method is the P2J equivalent of ADD-NEW-FIELD method of Progress 4GL.
    
    Parameters:
    
    name - The name of the field to be created in the temp-table.
    
    type - The data type of the specified field.
    
    extent - An integer expression specifying the extent of an array.
    
    Returns:
    
    true on success.
  - addNewField
```
public logical addNewField(character name,
                           character type,
                           integer extent,
                           character format)
```
    Adds a field with the specified properties to the temp-table. This method is the P2J equivalent of ADD-NEW-FIELD method of Progress 4GL.
    
    Parameters:
    
    name - The name of the field to be created in the temp-table.
    
    type - The data type of the specified field.
    
    extent - An integer expression specifying the extent of an array.
    
    format - The data format for the defined data type. If empty or unknown, format is replaced with default format. Null value means that format is not used in ADD-NEW-FIELD.
    
    Returns:
    
    true on success.
  - addNewField
```
public logical addNewField(character name,
                           character type,
                           integer extent,
                           character format,
                           BaseDataType initial)
```
    Adds a field with the specified properties to the temp-table. This method is the P2J equivalent of ADD-NEW-FIELD method of Progress 4GL.
    
    Parameters:
    
    name - The name of the field to be created in the temp-table.
    
    type - The data type of the specified field.
    
    extent - An integer expression specifying the extent of an array.
    
    format - The data format for the defined data type. If empty or unknown, format is replaced with default format. Null value means that format is not used in ADD-NEW-FIELD.
    
    initial - An expression that evaluates to the initial value of the defined field. TODO: this method will probably be overloaded because of this.
    
    Returns:
    
    true on success.
  - addNewField
```
public logical addNewField(character name,
                           character type,
                           integer extent,
                           character format,
                           BaseDataType initial,
                           character label)
```
    Adds a field with the specified properties to the temp-table. This method is the P2J equivalent of ADD-NEW-FIELD method of Progress 4GL.
    
    Parameters:
    
    name - The name of the field to be created in the temp-table.
    
    type - The data type of the specified field.
    
    extent - An integer expression specifying the extent of an array.
    
    format - The data format for the defined data type. If empty or unknown, format is replaced with default format. Null value means that format is not used in ADD-NEW-FIELD.
    
    initial - An expression that evaluates to the initial value of the defined field. TODO: this method will probably be overloaded because of this.
    
    label - The label of the defined field. If null or unknown the name parameter will be used.
    
    Returns:
    
    true on success.
  - addNewField
```
public logical addNewField(character name,
                           character type,
                           integer extent,
                           character format,
                           BaseDataType initial,
                           character label,
                           character columnLabel)
```
    Adds a field with the specified properties to the temp-table. This method is the P2J equivalent of ADD-NEW-FIELD method of Progress 4GL.
    When a parameter is set to null, it means it was not specified by the business logic.
    
    Parameters:
    
    name - The name of the field to be created in the temp-table.
    
    type - The data type of the specified field.
    
    extent - An integer expression specifying the extent of an array.
    
    format - The data format for the defined data type. If empty or unknown, format is replaced with default format. Null value means that format is not used in ADD-NEW-FIELD.
    
    initial - An expression that evaluates to the initial value of the defined field. TODO: this method will probably be overloaded because of this.
    
    label - The label of the defined field. If null or unknown the name parameter will be used.
    
    columnLabel - The label of the column associated with the defined field
    
    Returns:
    
    true on success.
  - addNewField
```
public logical addNewField(character name,
                           character type,
                           integer extent,
                           character format,
                           BaseDataType initial,
                           character label,
                           character columnLabel,
                           character help,
                           character xmlNodeType,
                           character codePage,
                           boolean serializeHidden,
                           boolean caseSensitive)
```
    Adds a field with the specified properties to the temp-table. This method is the P2J equivalent of ADD-NEW-FIELD method of Progress 4GL.
    When a parameter is set to null, it means it was not specified by the business logic.
    
    Parameters:
    
    name - The name of the field to be created in the temp-table.
    
    type - The data type of the specified field.
    
    extent - An integer expression specifying the extent of an array.
    
    format - The data format for the defined data type. If empty or unknown, format is replaced with default format. Null value means that format is not used in ADD-NEW-FIELD.
    
    initial - An expression that evaluates to the initial value of the defined field. TODO: this method will probably be overloaded because of this.
    
    label - The label of the defined field. If null or unknown the name parameter will be used.
    
    columnLabel - The label of the column associated with the defined field. If null or unknown the label will be used.
    
    help - Field HELP attribute value.
    
    xmlNodeType - Field XML node type.
    
    codePage - Field code page.
    
    serializeHidden - Field SERIALIZE-HIDDEN attribute value.
    
    caseSensitive - Field CASE-SENSITIVE attribute value.
    
    Returns:
    
    true on success.
  - addNewIndex
```
public logical addNewIndex(character name)
```
    Adds a new empty index with the specified name to the temp-table. Index components must be added with the ADD-INDEX-FIELD() method. This method is the P2J equivalent of ADD-NEW-INDEX method of Progress 4GL.
    
    Parameters:
    
    name - The name of the index to be created.
    
    Returns:
    
    true on success.
  - addNewIndex
```
public logical addNewIndex(character name,
                           logical unique)
```
    Adds a new empty index with the specified name to the temp-table. Index components must be added with the ADD-INDEX-FIELD() method. This method is the P2J equivalent of ADD-NEW-INDEX method of Progress 4GL.
    
    Parameters:
    
    name - The name of the index to be created.
    
    unique - TRUE if this index is unique.
    
    Returns:
    
    true on success.
  - addNewIndex
```
public logical addNewIndex(character name,
                           logical unique,
                           logical primary)
```
    Adds a new empty index with the specified name to the temp-table. Index components must be added with the ADD-INDEX-FIELD() method. This method is the P2J equivalent of ADD-NEW-INDEX method of Progress 4GL.
    
    Parameters:
    
    name - The name of the index to be created.
    
    unique - TRUE if this index is unique.
    
    primary - TRUE if this is the primary index.
    
    Returns:
    
    true on success.
  - addNewIndex
```
public logical addNewIndex(character name,
                           logical unique,
                           logical primary,
                           logical word)
```
    Adds a new empty index with the specified name to the temp-table. Index components must be added with the ADD-INDEX-FIELD() method. This method is the P2J equivalent of ADD-NEW-INDEX method of Progress 4GL.
    If a parameter is null, it means it was not set.
    
    Parameters:
    
    name - The name of the index to be created.
    
    unique - TRUE if this index is unique.
    
    primary - TRUE if this is the primary index.
    
    word - TRUE if this is a word index.
    
    Returns:
    
    true on success.
  - addFieldLike
```
public logical addFieldLike(java.lang.String name,
                            java.lang.String source)
```
    Adds to the temp-table a field like the one specified. This method is the P2J equivalent of ADD-LIKE-FIELD method of Progress 4GL.
    
    Parameters:
    
    name - The name of the field to be created in the temp-table.
    
    source - Database field name from which to copy the field. The table name must be qualified with the database name.
    
    Returns:
    
    true on success.
  - addFieldLike
```
public logical addFieldLike(java.lang.String name,
                            character source)
```
    Adds to the temp-table a field like the one specified. This method is the P2J equivalent of ADD-LIKE-FIELD method of Progress 4GL.
    
    Parameters:
    
    name - The name of the field to be created in the temp-table.
    
    source - Database field name from which to copy the field. The table name must be qualified with the database name.
    
    Returns:
    
    true on success.
  - addFieldLike
```
public logical addFieldLike(character name,
                            java.lang.String source)
```
    Adds to the temp-table a field like the one specified. This method is the P2J equivalent of ADD-LIKE-FIELD method of Progress 4GL.
    
    Parameters:
    
    name - The name of the field to be created in the temp-table.
    
    source - Database field name from which to copy the field. The table name must be qualified with the database name.
    
    Returns:
    
    true on success.
  - addFieldLike
```
public logical addFieldLike(character name,
                            character source)
```
    Adds to the temp-table a field like the one specified. This method is the P2J equivalent of ADD-LIKE-FIELD method of Progress 4GL.
    
    Parameters:
    
    name - The name of the field to be created in the temp-table.
    
    source - Database field name from which to copy the field. The table name must be qualified with the database name.
    
    Returns:
    
    true on success.
  - addFieldLike
```
public logical addFieldLike(java.lang.String name,
                            handle source)
```
    Adds to the temp-table a field like the one specified. This method is the P2J equivalent of ADD-LIKE-FIELD method of Progress 4GL.
    
    Parameters:
    
    name - The name of the field to be created in the temp-table.
    
    source - Handle to field name from which to copy the field.
    
    Returns:
    
    true on success.
  - addFieldLike
```
public logical addFieldLike(character name,
                            handle source)
```
    Adds to the temp-table a field like the one specified. This method is the P2J equivalent of ADD-LIKE-FIELD method of Progress 4GL.
    
    Parameters:
    
    name - The name of the field to be created in the temp-table.
    
    source - Handle to field name from which to copy the field.
    
    Returns:
    
    true on success.
  - addFieldToIndex
```
public logical addFieldToIndex(java.lang.String indexName,
                               java.lang.String field,
                               java.lang.String ascending)
```
    Construct an index of this temp-table by adding a new field to it. This method requires the index to be first declared with addNewIndex(com.goldencode.p2j.util.character) and cannot be called after the AbstractTempTable.prepared().
    
    Parameters:
    
    indexName - The name of the index being built.
    
    field - The name of the temp-table to be added to the index.
    
    ascending - "asc" if the ascending ordering, "desc" for descending other -> error.
    
    Returns:
    
    true for success.
  - addFieldToIndex
```
public logical addFieldToIndex(java.lang.String indexName,
                               java.lang.String field,
                               character ascending)
```
    Construct an index of this temp-table by adding a new field to it. This method requires the index to be first declared with addNewIndex(com.goldencode.p2j.util.character) and cannot be called after the AbstractTempTable.prepared().
    
    Parameters:
    
    indexName - The name of the index being built.
    
    field - The name of the temp-table to be added to the index.
    
    ascending - "asc" if the ascending ordering, "desc" for descending other -> error.
    
    Returns:
    
    true for success.
  - addFieldToIndex
```
public logical addFieldToIndex(character indexName,
                               java.lang.String field,
                               java.lang.String ascending)
```
    Construct an index of this temp-table by adding a new field to it. This method requires the index to be first declared with addNewIndex(com.goldencode.p2j.util.character) and cannot be called after the AbstractTempTable.prepared().
    
    Parameters:
    
    indexName - The name of the index being built.
    
    field - The name of the temp-table to be added to the index.
    
    ascending - "asc" if the ascending ordering, "desc" for descending other -> error.
    
    Returns:
    
    true for success.
  - addFieldToIndex
```
public logical addFieldToIndex(character indexName,
                               java.lang.String field,
                               character ascending)
```
    Construct an index of this temp-table by adding a new field to it. This method requires the index to be first declared with addNewIndex(com.goldencode.p2j.util.character) and cannot be called after the AbstractTempTable.prepared().
    
    Parameters:
    
    indexName - The name of the index being built.
    
    field - The name of the temp-table to be added to the index.
    
    ascending - "asc" if the ascending ordering, "desc" for descending other -> error.
    
    Returns:
    
    true for success.
  - addFieldToIndex
```
public logical addFieldToIndex(java.lang.String indexName,
                               character field,
                               java.lang.String ascending)
```
    Construct an index of this temp-table by adding a new field to it. This method requires the index to be first declared with addNewIndex(com.goldencode.p2j.util.character) and cannot be called after the AbstractTempTable.prepared().
    
    Parameters:
    
    indexName - The name of the index being built.
    
    field - The name of the temp-table to be added to the index.
    
    ascending - "asc" if the ascending ordering, "desc" for descending other -> error.
    
    Returns:
    
    true for success.
  - addFieldToIndex
```
public logical addFieldToIndex(java.lang.String indexName,
                               character field,
                               character ascending)
```
    Construct an index of this temp-table by adding a new field to it. This method requires the index to be first declared with addNewIndex(com.goldencode.p2j.util.character) and cannot be called after the AbstractTempTable.prepared().
    
    Parameters:
    
    indexName - The name of the index being built.
    
    field - The name of the temp-table to be added to the index.
    
    ascending - "asc" if the ascending ordering, "desc" for descending other -> error.
    
    Returns:
    
    true for success.
  - addFieldToIndex
```
public logical addFieldToIndex(character indexName,
                               character field,
                               java.lang.String ascending)
```
    Construct an index of this temp-table by adding a new field to it. This method requires the index to be first declared with addNewIndex(com.goldencode.p2j.util.character) and cannot be called after the AbstractTempTable.prepared().
    
    Parameters:
    
    indexName - The name of the index being built.
    
    field - The name of the temp-table to be added to the index.
    
    ascending - "asc" if the ascending ordering, "desc" for descending other -> error.
    
    Returns:
    
    true for success.
  - addFieldToIndex
```
public logical addFieldToIndex(character indexName,
                               character field,
                               character ascending)
```
    Construct an index of this temp-table by adding a new field to it. This method requires the index to be first declared with addNewIndex(com.goldencode.p2j.util.character) and cannot be called after the AbstractTempTable.prepared().
    
    Parameters:
    
    indexName - The name of the index being built.
    
    field - The name of the temp-table to be added to the index.
    
    ascending - "asc" if the ascending ordering, "desc" for descending other -> error.
    
    Returns:
    
    true for success.
  - addFieldToIndex
```
public logical addFieldToIndex(java.lang.String indexName,
                               java.lang.String field)
```
    Construct an index of this temp-table by adding a new field to it. The new added filed will sort ascending the table. This method requires the index to be first declared with addNewIndex(com.goldencode.p2j.util.character) and cannot be called after the AbstractTempTable.prepared().
    
    Parameters:
    
    indexName - The name of the index being built.
    
    field - The name of the temp-table to be added to the index.
    
    Returns:
    
    true for success.
  - addFieldToIndex
```
public logical addFieldToIndex(character indexName,
                               java.lang.String field)
```
    Construct an index of this temp-table by adding a new field to it. The new added filed will sort ascending the table. This method requires the index to be first declared with addNewIndex(com.goldencode.p2j.util.character) and cannot be called after the AbstractTempTable.prepared().
    
    Parameters:
    
    indexName - The name of the index being built.
    
    field - The name of the temp-table to be added to the index.
    
    Returns:
    
    true for success.
  - addFieldToIndex
```
public logical addFieldToIndex(java.lang.String indexName,
                               character field)
```
    Construct an index of this temp-table by adding a new field to it. The new added filed will sort ascending the table. This method requires the index to be first declared with addNewIndex(com.goldencode.p2j.util.character) and cannot be called after the AbstractTempTable.prepared().
    
    Parameters:
    
    indexName - The name of the index being built.
    
    field - The name of the temp-table to be added to the index.
    
    Returns:
    
    true for success.
  - addFieldToIndex
```
public logical addFieldToIndex(character indexName,
                               character field)
```
    Construct an index of this temp-table by adding a new field to it. The new added filed will sort ascending the table. This method requires the index to be first declared with addNewIndex(com.goldencode.p2j.util.character) and cannot be called after the AbstractTempTable.prepared().
    
    Parameters:
    
    indexName - The name of the index being built.
    
    field - The name of the temp-table to be added to the index.
    
    Returns:
    
    true for success.
  - addIndexLike
```
public logical addIndexLike(java.lang.String name,
                            java.lang.String sourceName,
                            java.lang.String dbTable)
```
    Adds to the temp-table an index like the one specified. This method is the P2J equivalent of ADD-LIKE-FIELD method of Progress 4GL.
    
    Parameters:
    
    name - The name of the index to which the source index is being copied. Progress ignores this option and uses the name of the source index instead.
    
    sourceName - The name of the index in the source table that is being copied to the temp-table.
    
    dbTable - The database table name from which to copy the index.
    
    Returns:
    
    true on success.
  - addIndexLike
```
public logical addIndexLike(character name,
                            character sourceName,
                            character dbTable)
```
    Adds to the temp-table an index like the one specified. This method is the P2J equivalent of ADD-LIKE-FIELD method of Progress 4GL.
    
    Parameters:
    
    name - The name of the index to which the source index is being copied. Progress ignores this option and uses the name of the source index instead.
    
    sourceName - The name of the index in the source table that is being copied to the temp-table.
    
    dbTable - The database table name from which to copy the index.
    
    Returns:
    
    true on success.
  - addIndexLike
```
public logical addIndexLike(java.lang.String name,
                            java.lang.String sourceName,
                            handle sourceBuffer)
```
    Adds to the temp-table an index like the one specified. This method is the P2J equivalent of ADD-LIKE-FIELD method of Progress 4GL.
    
    Parameters:
    
    name - The name of the index to which the source index is being copied. Progress ignores this option and uses the name of the source index instead.
    
    sourceName - The name of the index in the source table that is being copied to the temp-table.
    
    sourceBuffer - Buffer handle from which to copy the index.
    
    Returns:
    
    true on success.
  - addIndexLike
```
public logical addIndexLike(character name,
                            character sourceName,
                            handle sourceBuffer)
```
    Adds to the temp-table an index like the one specified. This method is the P2J equivalent of ADD-LIKE-FIELD method of Progress 4GL.
    
    Parameters:
    
    name - The name of the index to which the source index is being copied. Progress ignores this option and uses the name of the source index instead.
    
    sourceName - The name of the index in the source table that is being copied to the temp-table.
    
    sourceBuffer - Buffer handle from which to copy the index.
    
    Returns:
    
    true on success.
  - _prepared
```
public boolean _prepared()
```
    Returns true if this temp-table is in prepared state (after a successful call to tempTablePrepare(java.lang.String)). This method implements the read-only PREPARED attribute from 4GL.
    
    Specified by:
    
    _prepared in class AbstractTempTable
    
    Returns:
    
    true if this table is prepared.
  - _clear
```
public boolean _clear()
```
    Check whether this TEMP-TABLE is in CLEAR state: I.e. the temp-table is first created or immediately after the CLEAR() method is applied. The other two state of a temp-table are: UNPREPARED and PREPARED. The UNPREPARED state between the first definitional method has been applied and before the TEMP-TABLE-PREPARE() method is applied.
    This method is FWD-internal. The programmer can check whether the temp-table is in an UNPREPARED or PREPARED state by checking the PREPARED attribute, but the CLEAR state is transparent.
    
    Specified by:
    
    _clear in class AbstractTempTable
    
    Returns:
    
    true if this table is in CLEAR state.
  - dynamic
```
public logical dynamic()
```
    Checks whether the resource is dynamic or static.
    
    Returns:
    
    true if the resource is dynamic, false otherwise.
  - _dynamic
```
public boolean _dynamic()
```
    Checks whether the resource is dynamic or static.
    
    Returns:
    
    true if the resource is dynamic, false otherwise.
  - primaryIndex
```
public character primaryIndex()
```
    Get the PRIMARY attribute.
    
    Specified by:
    
    primaryIndex in interface PrimaryIndex
    
    Overrides:
    
    primaryIndex in class AbstractTempTable
    
    Returns:
    
    The primary index.
  - primaryIndex
```
public void primaryIndex(java.lang.String primary)
```
    Set the PRIMARY attribute.
    
    Specified by:
    
    primaryIndex in interface PrimaryIndex
    
    Overrides:
    
    primaryIndex in class AbstractTempTable
    
    Parameters:
    
    primary - The primary index.
  - clear
```
public logical clear()
```
    Returns the temp-table to it's clear state, removing all defined fields, indexes, all records in the table and all corresponding buffers.
    
    Returns:
    
    true if operation is successful
  - tempTablePrepareImpl
```
logical tempTablePrepareImpl(java.lang.String tableName,
                             java.lang.String beforeName,
                             boolean isBeforeTable)
```
    The implementation of TEMP-TABLE-PREPARE method. This method is invoked from both user API and also from DataSet when a DATASET is duplicated.
    
    Parameters:
    
    tableName - Temp-table name to be used in subsequent query statements which refer to this temp-table.
    
    beforeName - The name of the before table name. If null the BEFORE_TABLE won't be created. In case of creating a before-table, this is the after-table name.
    
    isBeforeTable - Flag indicating the prepare is for a before-table.
    
    Returns:
    
    true on success.
  - createBeforeTable
```
boolean createBeforeTable(java.lang.String beforeName,
                          java.lang.String afterName)
```
    Creates the before table and link it to current table.
    
    Parameters:
    
    beforeName - The name of the before table to be build.
    
    afterName - The name of the after table associated with the before table.
    
    Returns:
    
    true if operation is successful and false otherwise.
  - tempTablePrepare
```
public logical tempTablePrepare(java.lang.String name)
```
    Signals that all the field and index definitions for a temp-table have been provided. After the call to this method no fields and indexes can be added to this temporary table.
    This method is the P2J equivalent of TEMP-TABLE-PREPARE method of Progress 4GL.
    
    Parameters:
    
    name - Temp-table name to be used in subsequent query statements that refer to this temp-table.
    
    Returns:
    
    true on success.
  - tempTablePrepare
```
public boolean tempTablePrepare(java.lang.String tableName,
                                java.lang.String beforeName)
```
    The implementation of TEMP-TABLE-PREPARE method. This method is invoked from internal APIs like dataset XML import.
    
    Parameters:
    
    tableName - Temp-table name to be used in subsequent query statements which refer to this temp-table.
    
    beforeName - The name of the before table name. If null the BEFORE_TABLE won't be created.
    
    Returns:
    
    true on success.
  - tempTablePrepare
```
public logical tempTablePrepare(character name)
```
    Signals that all the field and index definitions for a temp-table have been provided. After the call to this method no fields and indexes can be added to this temporary table.
    This method is the P2J equivalent of TEMP-TABLE-PREPARE method of Progress 4GL.
    
    Parameters:
    
    name - Temp-table name to be used in subsequent query statements that refer to this temp-table.
    
    Returns:
    
    true on success.
  - tempTablePrepare
```
public logical tempTablePrepare(java.lang.String name,
                                boolean before)
```
    Signals that all the field and index definitions for a temp-table have been provided. After the call to this method no fields and indexes can be added to this temporary table. This method is the P2J equivalent of TEMP-TABLE-PREPARE method of Progress 4GL.
    
    Parameters:
    
    name - Temp-table name to be used in subsequent query statements which refer to this temp-table.
    
    before - Create the BEFORE-TABLE also if true.
    
    Returns:
    
    true on success.
  - tempTablePrepare
```
public logical tempTablePrepare(java.lang.String name,
                                logical before)
```
    Signals that all the field and index definitions for a temp-table have been provided. After the call to this method no fields and indexes can be added to this temporary table. This method is the P2J equivalent of TEMP-TABLE-PREPARE method of Progress 4GL.
    
    Parameters:
    
    name - Temp-table name to be used in subsequent query statements which refer to this temp-table.
    
    before - Create the BEFORE-TABLE also if true.
    
    Returns:
    
    true on success.
  - tempTablePrepare
```
public logical tempTablePrepare(character name,
                                boolean before)
```
    Signals that all the field and index definitions for a temp-table have been provided. After the call to this method no fields and indexes can be added to this temporary table. This method is the P2J equivalent of TEMP-TABLE-PREPARE method of Progress 4GL.
    
    Parameters:
    
    name - Temp-table name to be used in subsequent query statements which refer to this temp-table.
    
    before - Create the BEFORE-TABLE also if true.
    
    Returns:
    
    true on success.
  - tempTablePrepare
```
public logical tempTablePrepare(character name,
                                logical before)
```
    Signals that all the field and index definitions for a temp-table have been provided. After the call to this method no fields and indexes can be added to this temporary table. This method is the P2J equivalent of TEMP-TABLE-PREPARE method of Progress 4GL.
    
    Parameters:
    
    name - Temp-table name to be used in subsequent query statements which refer to this temp-table.
    
    before - Create the BEFORE-TABLE also if true.
    
    Returns:
    
    true on success.
  - addFieldsFrom
```
public logical addFieldsFrom(java.lang.String tableName)
```
    Adds fields from another table into this temp-table. The fields that are already in the temp-table are ignored. This is the P2J implementation of the ADD-FIELDS-FROM of 4GL.
    
    Parameters:
    
    tableName - The name of the table from which to copy the field definitions.
    
    Returns:
    
    true for success.
  - addFieldsFrom
```
public logical addFieldsFrom(handle hbuf)
```
    Adds fields from another table into this temp-table. The fields that are already in the temp-table are ignored. This is the P2J implementation of the ADD-FIELDS-FROM of 4GL.
    
    Parameters:
    
    hbuf - A handle to a buffer or table from which to copy the field definitions.
    
    Returns:
    
    true for success.
  - addFieldsFrom
```
public logical addFieldsFrom(character tableName)
```
    Adds fields from another table into this temp-table. The fields that are already in the temp-table are ignored. This is the P2J implementation of the ADD-FIELDS-FROM of 4GL.
    
    Parameters:
    
    tableName - The name of the table from which to copy the field definitions.
    
    Returns:
    
    true for success.
  - addFieldsFrom
```
public logical addFieldsFrom(handle hbuf,
                             java.lang.String except)
```
    Adds fields from another table into this temp-table. The fields that are already in the temp-table are ignored. This is the P2J implementation of the ADD-FIELDS-FROM of 4GL.
    
    Parameters:
    
    hbuf - A handle to a buffer or table from which to copy the field definitions.
    
    except - A comma-separated list of field names to be excluded from the copy process.
    
    Returns:
    
    true for success.
  - addFieldsFrom
```
public logical addFieldsFrom(java.lang.String tableName,
                             java.lang.String except)
```
    Adds fields from another table into this temp-table. The fields that are already in the temp-table are ignored. This is the P2J implementation of the ADD-FIELDS-FROM of 4GL.
    
    Parameters:
    
    tableName - The name of the table from which to copy the field definitions.
    
    except - A comma-separated list of field names to be excluded from the copy process.
    
    Returns:
    
    true for success.
  - addFieldsFrom
```
public logical addFieldsFrom(java.lang.String tableName,
                             character except)
```
    Adds fields from another table into this temp-table. The fields that are already in the temp-table are ignored. This is the P2J implementation of the ADD-FIELDS-FROM of 4GL.
    
    Parameters:
    
    tableName - The name of the table from which to copy the field definitions.
    
    except - A comma-separated list of field names to be excluded from the copy process.
    
    Returns:
    
    true for success.
  - addFieldsFrom
```
public logical addFieldsFrom(handle hbuf,
                             character except)
```
    Adds fields from another table into this temp-table. The fields that are already in the temp-table are ignored. This is the P2J implementation of the ADD-FIELDS-FROM of 4GL.
    
    Parameters:
    
    hbuf - A handle to a buffer or table from which to copy the field definitions.
    
    except - A comma-separated list of field names to be excluded from the copy process.
    
    Returns:
    
    true for success.
  - addFieldsFrom
```
public logical addFieldsFrom(character tableName,
                             character except)
```
    Adds fields from another table into this temp-table. The fields that are already in the temp-table are ignored. This is the P2J implementation of the ADD-FIELDS-FROM of 4GL.
    
    Parameters:
    
    tableName - The name of the table from which to copy the field definitions.
    
    except - A comma-separated list of field names to be excluded from the copy process.
    
    Returns:
    
    true for success.
  - createTable
```
public BufferImpl createTable(java.lang.String tableName,
                              java.util.Iterator<PropertyDefinition> props,
                              java.lang.String tableIndexes,
                              java.lang.String xmlns,
                              java.lang.String xmlPrefix,
                              int schemaMarshalLevel)
```
    Create a temp-table with the specified definition.
    
    Parameters:
    
    tableName - The table name.
    
    props - The property definitions.
    
    tableIndexes - The index definitions.
    
    xmlns - The XML namespace.
    
    xmlPrefix - The XML prefix.
    
    schemaMarshalLevel - The SCHEMA-MARSHAL level for the serialized temp-table.
    
    Returns:
    
    default buffer for the table
  - createTable
```
public BufferImpl createTable(java.lang.String tableName,
                              java.util.Iterator<PropertyDefinition> props,
                              java.lang.Runnable indexProvider,
                              java.lang.String xmlns,
                              java.lang.String xmlPrefix,
                              int schemaMarshalLevel)
```
    Create a temp-table with the specified definition.
    
    Parameters:
    
    tableName - The table name.
    
    props - The property definitions.
    
    indexProvider - indexes' provider.
    
    xmlns - The XML namespace.
    
    xmlPrefix - The XML prefix.
    
    schemaMarshalLevel - The SCHEMA-MARSHAL level for the serialized temp-table.
    
    Returns:
    
    default buffer for the table
  - createFromTableWrapper
```
public void createFromTableWrapper(TableWrapper tableWrapper,
                                   int tableParameterIndex)
```
    Build temporary table from a table wrapper object.
    
    Parameters:
    
    tableWrapper - Table wrapper containing table definitions.
    
    tableParameterIndex - 1-based index of corresponding TABLE[-HANDLE] parameter (in function declaration). Used for error handling.
  - defaultBufferHandle
```
public handle defaultBufferHandle()
```
    Obtain the handle to the buffer that was created by default for this temporary table. Every dynamic temp-table is created with at least one buffer. This buffer's object handle is returned by this method. It cannot be called until the table has been prepared using tempTablePrepare() method. This method is the P2J equivalent of DEFAULT-BUFFER-HANDLE attribute.
    
    Returns:
    
    The default buffer handle for the temporary table.
  - defaultBufferHandleNative
```
public Buffer defaultBufferHandleNative()
```
    Obtain the buffer that was created by default for this temporary table. Every dynamic temp-table is created with at least one buffer. This buffer object is returned by this method. Note that it cannot be called until the table has been prepared using tempTablePrepare() method. This method is the P2J equivalent of DEFAULT-BUFFER-HANDLE attribute.
    
    Returns:
    
    The default buffer for the temporary table.
  - name
```
public void name(character name)
```
    Set table NAME attribute. Note that it can be changed only after the table has been prepared.
    
    Specified by:
    
    name in interface Nameable
    
    Overrides:
    
    name in class HandleChain
    
    Parameters:
    
    name - New table name.
  - name
```
public character name()
```
    Get table NAME attribute.
    
    Specified by:
    
    name in interface Nameable
    
    Overrides:
    
    name in class HandleChain
    
    Returns:
    
    name Table NAME attribute value. If the table hasn't been prepared, unknown value is returned.
  - _name
```
public java.lang.String _name()
```
    Get the name attribute of handle as a string.
    
    Overrides:
    
    _name in class HandleChain
    
    Returns:
    
    See above.
  - hasPrevSibling
```
protected boolean hasPrevSibling()
```
    Check if this resource supports the PREV-SIBLING attribute.
    
    Overrides:
    
    hasPrevSibling in class HandleChain
    
    Returns:
    
    Always false.
  - hasNextSibling
```
protected boolean hasNextSibling()
```
    Check if this resource supports the NEXT-SIBLING attribute.
    
    Overrides:
    
    hasNextSibling in class HandleChain
    
    Returns:
    
    Always false.
  - hasNameReadOnly
```
protected boolean hasNameReadOnly()
```
    Check if this resource supports the NAME attribute only in read-only mode.
    
    Overrides:
    
    hasNameReadOnly in class HandleChain
    
    Returns:
    
    Always false, as NAME attribute is writable.
  - 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)
  - valid
```
public boolean valid()
```
    Reports if this object is valid for use.
    
    Returns:
    
    true if we are valid (can be used).
  - resourceDelete
```
protected boolean resourceDelete()
```
    Worker to be implemented by each resource. Called by HandleChain.delete().
    
    Overrides:
    
    resourceDelete in class HandleResource
    
    Returns:
    
    true if the resource was deleted.
  - forceDelete
```
public void forceDelete()
```
    Unconditionally delete all buffers for this table, drop DMO definitions and temporary table, clear TEMP-TABLE data structures and mark the table as deleted (i.e. subsequent valid() calls return false).
  - allowDelete
```
public boolean allowDelete(handle ref,
                           boolean explicit)
```
    Check if the resource can veto the delete or not, before attempting the HandleChain.delete() call.
    
    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 handle reference is registered as an OUTPUT TABLE-HANDLE parameter, or the dataset for any temp-table's buffers is registered as an OUTPUT TABLE-HANDLE parameter.
  - getFields
```
public java.util.Collection<P2JField> getFields()
```
    Get the collection of table fields.
    
    Overrides:
    
    getFields in class AbstractTempTable
    
    Returns:
    
    the collection of table fields.
  - getField
```
public P2JField getField(java.lang.String fieldName)
```
    Get field by its name.
    
    Parameters:
    
    fieldName - Field name.
    
    Returns:
    
    field with the specified name (normalized field names are compared).
  - getIndex
```
public P2JIndex getIndex(java.lang.String indexName)
```
    Get index by its name.
    
    Parameters:
    
    indexName - Index name.
    
    Returns:
    
    index with the specified name (normalized index names are compared).
  - getIndexes
```
public java.util.Collection<P2JIndex> getIndexes()
```
    Get table indexes.
    
    Returns:
    
    see above.
  - getDmoMeta
```
public DmoMeta getDmoMeta()
```
    Obtain the DmoMeta structure which contains the legacy meta information.
    
    Returns:
    
    DmoMeta structure which contains the legacy meta information
  - getDMOInterface
```
public java.lang.Class<? extends DataModelObject> getDMOInterface()
```
    Get DMO interface which backs this table.
    
    Returns:
    
    DMO interface which backs this table or null if the table is not initialized yet.
  - getDMOBufInterface
```
public java.lang.Class<? extends TempTableBuffer> getDMOBufInterface()
```
    Get buffer interface which backs this table.
    
    Returns:
    
    DMO buffer interface which backs this table or null if the table is not initialized yet.
  - getDMOClass
```
public java.lang.Class<? extends Record> getDMOClass()
```
    Get DMO implementation class associated with this table.
    
    Returns:
    
    DMO implementation class associated with this table or null if the table is not initialized yet.
  - setCodePageSupplier
```
public void setCodePageSupplier(java.lang.String property,
                                java.util.function.Supplier supplier)
```
    Set code page supplier for the specified CLOB field.
    
    Parameters:
    
    property - The ORM property name of the CLOB field.
    
    supplier - The code page supplier of the specified CLOB field.
  - setCodePage
```
public void setCodePage(java.lang.String property,
                        java.lang.String codePage)
```
    Set code page for the specified CLOB field.
    
    Parameters:
    
    property - The ORM property name of the CLOB field.
    
    codePage - The code page of the specified CLOB field.
  - getCodePage
```
public java.lang.String getCodePage(java.lang.String property)
```
    Get code page of the specified CLOB field.
    
    Parameters:
    
    property - The ORM property name of the CLOB field.
    
    Returns:
    
    The code page of the specified CLOB field or null if not configured so the default must be used.
  - getCodePageSupplier
```
public java.util.function.Supplier getCodePageSupplier(java.lang.String property)
```
    Get code page supplier of the specified CLOB field.
    
    Parameters:
    
    property - The ORM property name of the CLOB field.
    
    Returns:
    
    null in this implementation.
  - setDmoIface
```
void setDmoIface(DmoMeta dmoInfo,
                 java.lang.Class<? extends DataModelObject> dmoIface,
                 java.lang.Class<? extends TempTableBuffer> dmoBufIface)
```
    Set DMO interface class which corresponds the table.
    
    Parameters:
    
    dmoInfo - Object which contains metadata about the DMO.
    
    dmoIface - DMO interface class which corresponds the table.
    
    dmoBufIface - DMO buffer interface class which corresponds the table.
  - addFunctionWasCalled
```
protected boolean addFunctionWasCalled()
```
    Determine if an ADD-* function was called for the table (CLEAR function resets the state).
    
    Specified by:
    
    addFunctionWasCalled in class AbstractTempTable
    
    Returns:
    
    true if an ADD-* function was called for the table.
  - addNewField
```
protected void addNewField(PropertyDefinition propertyDefinition)
```
    Add new field from property definition data.
    
    Parameters:
    
    propertyDefinition - Definition of the field to add.
  - addNewField
```
private boolean addNewField(java.lang.String name,
                            ParmType type,
                            java.lang.Long extent,
                            java.lang.String format,
                            java.lang.String initial,
                            java.lang.String label,
                            java.lang.String columnLabel,
                            java.lang.String help,
                            java.lang.String xmlNodeType,
                            java.lang.String codePage,
                            boolean serializeHidden,
                            boolean caseSensitive)
```
    Adds a field with the specified properties to the temp-table. This method is the P2J equivalent of ADD-NEW-FIELD method of Progress 4GL.
    When a parameter is set to null, it means it was not specified by the business logic.
    
    Parameters:
    
    name - The name of the field to be created in the temp-table.
    
    type - The data type of the specified field.
    
    extent - An integer expression specifying the extent of an array.
    
    format - The data format for the defined data type. If empty or unknown, format is replaced with default format. Null value means that format is not used in ADD-NEW-FIELD.
    
    initial - An expression that evaluates to the initial value of the defined field. TODO: this method will probably be overloaded because of this.
    
    label - The label of the defined field. If null or unknown the name parameter will be used.
    
    columnLabel - The label of the column associated with the defined field
    
    help - Field HELP attribute value.
    
    xmlNodeType - Field XML node type.
    
    codePage - Field code page.
    
    serializeHidden - Field SERIALIZE-HIDDEN attribute value.
    
    caseSensitive - Field CASE-SENSITIVE attribute value.
    
    Returns:
    
    true on success.
  - createTableLikeImpl
```
private logical createTableLikeImpl(character tableName,
                                    character indexName,
                                    boolean handleIndex)
```
    Duplicates the structure of an existing table, copying the field definitions, and optionally, the indexes. This method is the P2J equivalent of CREATE-LIKE method of Progress 4GL.
    
    Parameters:
    
    tableName - The name of a table to create the copy of.
    
    indexName - The name of a single index which is copied from the source table.
    
    handleIndex - true if indexName parameter should be taken into consideration. This parameter is required because unknown index name represents an index with empty name rather than "index not specified" case.
    
    Returns:
    
    true on success.
  - createTableLikeImpl
```
private logical createTableLikeImpl(handle hbuf,
                                    character indexName,
                                    boolean handleIndex)
```
    Duplicates the structure of an existing table, copying the field definitions, and optionally, the indexes. This method is the P2J equivalent of CREATE-LIKE method of Progress 4GL.
    
    Parameters:
    
    hbuf - A handle to a buffer or table from which to copy the definitions.
    
    indexName - The name of a single index which is copied from the source table.
    
    handleIndex - true if indexName parameter should be taken into consideration. This parameter is required because unknown index name represents an index with empty name rather than "index not specified" case.
    
    Returns:
    
    true on success.
  - addIndexLike
```
private logical addIndexLike(P2JIndex srcIndex)
```
    Adds to the temp-table an index like the one specified. This method is the P2J equivalent of ADD-LIKE-FIELD method of Progress 4GL.
    
    Parameters:
    
    srcIndex - The index in the source table that is being copied to the temp-table.
    
    Returns:
    
    true on success.
  - doAddFieldsFrom
```
private void doAddFieldsFrom(java.util.Collection<P2JField> srcFields,
                             character except)
```
    Add specified set of fields to the table. If a field is in the except-list or was already added to the table, it is ignored.
    
    Parameters:
    
    srcFields - Set of fields to be added.
    
    except - Comma-separated list of field names that should be excluded from the copy process.
  - createDefaultBuffer
```
private void createDefaultBuffer()
```
    Create default buffer for the table.
  - displayUnableToPrepareTableFields
```
private void displayUnableToPrepareTableFields()
```
    Display "Unable to prepare TEMP-TABLE fields" error message.
  - displayUnableToPrepareTableIndices
```
private void displayUnableToPrepareTableIndices()
```
    Display "Unable to prepare TEMP-TABLE indices" error message.
  - displayUnableToEvaluate
```
private void displayUnableToEvaluate()
```
    Display "Unable to evaluate arguments for TEMP-TABLE method" error message.
  - displayCouldNotFindLikeTable
```
private void displayCouldNotFindLikeTable(java.lang.String tableName)
```
    Display "Could not find table {tableName} during ADD-LIKE-FIELD. Table names must not be abbreviated." error message.
    
    Parameters:
    
    tableName - Table name.
  - displayCouldNotFindLikeTableName
```
private void displayCouldNotFindLikeTableName(java.lang.String tableName)
```
    Display "TEMP-TABLE method could not find LIKE table name {tableName}}" error message.
    
    Parameters:
    
    tableName - Table name.
  - displayDuplicateIndex
```
private void displayDuplicateIndex(java.lang.String indexName)
```
    Display "Duplicate index name {indexName} for temp-table" error message.
    
    Parameters:
    
    indexName - Index name.
  - displayCouldNotFindLikeField
```
private void displayCouldNotFindLikeField(java.lang.String fieldName)
```
    Display "Could not find source field {fieldName} during ADD-LIKE-FIELD." error message.
    
    Parameters:
    
    fieldName - Field name.
  - displayCouldNotFindLikeIndex
```
private void displayCouldNotFindLikeIndex(java.lang.String tableName,
                                          java.lang.String indexName)
```
    Display "ADD-LIKE-INDEX could not find index {indexName} in table {tableName}" error message.
    
    Parameters:
    
    tableName - Table name.
    
    indexName - Index name.
  - displayCouldNotFindAddIndex
```
private void displayCouldNotFindAddIndex(java.lang.String indexName)
```
    Display "Could not find index {indexName} during ADD-INDEX-FIELD" error message.
    
    Parameters:
    
    indexName - Index name.
  - displayUnableToCreateLikeIndex
```
private void displayUnableToCreateLikeIndex()
```
    Display "Unable to create index for TEMP-TABLE in ADD-LIKE-INDEX" error message.
  - displayDuplicateOrInvalidIndexField
```
private void displayDuplicateOrInvalidIndexField(java.lang.String indexName,
                                                 java.lang.String fieldName)
```
    Display "Attempt to add duplicate or inappropriate word index field {fieldName} to index {indexName}" error message.
    
    Parameters:
    
    indexName - Index name.
    
    fieldName - Field name.
  - displayUnableToFindIndex
```
private void displayUnableToFindIndex(java.lang.String tableName,
                                      java.lang.String indexName)
```
    Display "Unable to find index {indexName} in table {tableName}" error message.
    
    Parameters:
    
    tableName - Table name.
    
    indexName - Index name.
  - forceClear
```
private boolean forceClear()
```
    Unconditionally delete all buffers for this table, drop DMO definitions and temporary table, clear TEMP-TABLE data structures.
    
    Returns:
    
    true if operation was successful.
  - parseFieldList
```
private java.util.Set<java.lang.String> parseFieldList(character list)
```
    Split comma-separated list of field names into the set of separate field names.
    
    Parameters:
    
    list - Comma-separated list of fields.
    
    Returns:
    
    The set of separate field names or null if there are no fields in the input list. Names are returned in lower case, spaces are kept.
  - findExistingTable
```
private Persistence findExistingTable(java.lang.String fullTableName,
                                      boolean tableNameSearch)
```
    Search for an existing table with the specified name. Displays error message in the case of error.
    
    Parameters:
    
    fullTableName - Table name in format "databaseName.tableName" or "tableName". In the latter case table search is performed in all permanent databases and then the temporary database. Dynamic tables are ignored.
    
    tableNameSearch - true if it is called from ADD-LIKE-INDEX, ADD-FIELDS-FROM or CREATE-LIKE, false if it is called from ADD-FIELD-LIKE. Affects error messaging.
    
    Returns:
    
    persistence which corresponds the target database or null if there is no such table.
  - hasSameNormalizedName
```
private boolean hasSameNormalizedName(java.lang.String name1,
                                      java.lang.String name2)
```
    Determines if two names has the same normalized form. See TextOps.rightTrimLower(String) for more information.
    
    Parameters:
    
    name1 - First name to compare.
    
    name2 - Second name to compare.
    
    Returns:
    
    true if two names has the same normalized form.
  - copyField
```
private P2JField copyField(java.lang.String targetName,
                           P2JField srcField)
```
    Returns a new field with the new specified name and all other parameters copied from the source field.
    
    Parameters:
    
    targetName - The name of the new field.
    
    srcField - Source field to copy.
    
    Returns:
    
    see above.
  - copyIndex
```
private P2JIndex copyIndex(P2JIndex srcIndex)
```
    Returns a new index with all parameters copied from the source index. Index components are NOT copied.
    
    Parameters:
    
    srcIndex - Source index to copy.
    
    Returns:
    
    see above.
  - addField
```
public void addField(P2JField field)
```
    Add new field to the table. Doesn't check whether the field with the same name already exists.
    Note: This method was made public in order to be directly accessed from XmlImport.
    
    Parameters:
    
    field - Field to add.
  - readTable
```
public boolean readTable(java.lang.String tableName,
                         TableReader reader)
                  throws PersistenceException
```
    Read XML/JSON data from the input source and store it in the just created empty TEMP-TABLE.
    
    Specified by:
    
    readTable in class AbstractTempTable
    
    Parameters:
    
    tableName - table name
    
    reader - XML/JSON source reader and table creator.
    
    Returns:
    
    true on success.
    
    Throws:
    
    PersistenceException - if there is any error reading or storing XML/JSON data.
  - addIndex
```
private void addIndex(P2JIndex index)
```
    Add new index to the table. Doesn't check whether the index with the same name already exists.
    
    Parameters:
    
    index - Index to add.
  - hasField
```
private boolean hasField(java.lang.String fieldName)
```
    Checks whether the field with specified name already exist.
    
    Parameters:
    
    fieldName - Field name to check.
    
    Returns:
    
    true if there is a field which has the same name (in normalized form, see TextOps.rightTrimLower(String)).
  - hasIndex
```
private boolean hasIndex(java.lang.String indexName)
```
    Checks whether the index with specified name already exist.
    
    Parameters:
    
    indexName - Index name to check.
    
    Returns:
    
    true if there is an index which has the same name (in normalized form, see TextOps.rightTrimLower(String)).
  - addAllIndexes
```
private void addAllIndexes(java.util.Collection<P2JIndex> indexes)
```
    Add all indexes from the given collection to the table.
    
    Parameters:
    
    indexes - Indexes to add.
  - addAllFields
```
private void addAllFields(java.util.Collection<P2JField> fields)
```
    Add all fields from the given collection to the table.
    
    Parameters:
    
    fields - Fields to add.
  - addAllFields
```
private void addAllFields(BufferImpl source)
```
    Add all fields from the source Buffer to this table.
    
    Parameters:
    
    source - Fields to add.
  - parseIndexString
```
private void parseIndexString(java.lang.String tableIndexes)
```
    Add indexes based on multiIxCols string.
    
    Parameters:
    
    tableIndexes - multiIxCols string to be parsed.
  - toString
```
public java.lang.String toString()
```
    Returns a string representation of the object.
    
    Overrides:
    
    toString in class HandleResource
    
    Returns:
    
    string representation of the object.

Class TempTableBuilder

Nested Class Summary

Nested classes/interfaces inherited from class com.goldencode.p2j.persist.AbstractTempTable

Nested classes/interfaces inherited from interface com.goldencode.p2j.persist.TempTable

Field Summary

Fields inherited from class com.goldencode.p2j.persist.AbstractTempTable

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.TempTable

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

Constructor Summary

Method Summary

Methods inherited from class com.goldencode.p2j.persist.AbstractTempTable

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.CommonHandleChain

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

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

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

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

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

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

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

Methods inherited from interface com.goldencode.util.Printable

Field Detail

DATETIMETZ_TYPE_NAME

CREATE_DYN_TT

allowedSpecialChars

datatypesMatchLen

defaultFormatStrings

fields

indexes

dmoInfo

dmoIface

dmoBufIface

deleted

addFunctionCalled

postponedDelete

implicitBeforeTable

Constructor Detail

TempTableBuilder

Method Detail

createRemoteTable

createRemoteTable

create

create

create

buffer

tempTable

asTempTable

getExistingTempTable

getExistingField

getExistingField

getExistingIndex

getExistingIndex

getExistingIndexes

getExistingIndexes

getExistingIndexes

getExistingFields

buildField

getExistingFields

getOrderedPropertyNames

getPropertyNamesArray

getLegacyTableName

findIndexByName

validateDateFormatOnAddNewField

getDefaultDataTypeFormat

validateFormat

validateDatatype

isPostponedDelete

setPostponedDelete

createLike

createLike

createLike

createLike

createLike

createLike

createLike

addNewField