DABin2ReadOnlyDataTable

 

Adds a new calculated field to the table. Please refer to the documentation for DACalculatedFieldDefinition for more details.

- (void) addCalculatedField:(DACalculatedFieldDefinition *)field

Parameters:

• field: DACalculatedFieldDefinition instance we want to add to given DADataTable

---

Creates and adds a new calculated field to the table. Please refer to the documentation of DACalculatedFieldDefinition for more details.

- (DACalculatedFieldDefinition *) addCalculatedFieldName:(NSString *)name dataType:(enum DADataType)dataType target:(id)target selector:(SEL)selector

Parameters:

• name: The unique name for the new calculated field.
• dataType: The DADataType of the calculated field.
• target: Reference to the object that will provide the method for calculating this field.
• selector: Selector of method on the target that will calculate the field.

---

Adds a new usual or cached calculated field to the table. Please refer to the documentation for DACalculatedFieldDefinition for more details.

- (DACalculatedFieldDefinition *) addCalculatedFieldName:(NSString *)fieldName dataType:(enum DADataType)dataType target:(id)target selector:(SEL)selector cached:(BOOL)cached

Parameters:

• fieldName: The unique name for the new calculated field.
• dataType: The DADataType of the calculated field.
• target: Reference to the object that will provide the method for calculating this field.
• selector: Selector of method on the target that will calculate the field.
• cached: Boolean flag. If YES then new cached calculated field will be added to the table. Please refer to the documentation for DACachedCalculatedFieldDefinition for more details.

---

- (DAFieldDefinition *) addFieldWithName:(NSString *)name

Parameters:

• name:

---

- (DAInternalFieldDefinition *) addInternalFieldWithName:(NSString *)fieldName

Parameters:

• fieldName:

---

Adds lookup field definition to the table. Please refer to the documentation for DALookupFieldDefinition for more details.

- (void) addLookupField:(DALookupFieldDefinition *)field

Parameters:

• field: DACalculatedFieldDefinition instance we want to add to given DADataTable

---

Creates and appends a lookup field to the table. Please refer to the documentation for DALookupFieldDefinition for more details.

- (DALookupFieldDefinition *) addLookupFieldName:(NSString *)name sourceField:(DAFieldDefinition *)sourceField lookupTable:(DADataTable *)lookupTable lookupKeyField:(DAFieldDefinition *)lookupKeyField lookupResultField:(DAFieldDefinition *)lookupResultField

Parameters:

• name: The unique name for the new calculated field.
• sourceField: Initializes the sourceField property.
• lookupTable: Initializes the lookupTable property.
• lookupKeyField: Initializes the lookupKeyField property.
• lookupResultField: Initializes the lookupResultField property.

---

Appends a new row to the table. If the row has any AutoInc columns, new negative ID values will be generated automatically for these. All other columns will be initialized as null. A reference to the newly added row will be returned to the caller.

This method triggers the 'TableChanged' notification for the DADataTable.

- (DADataTableRow *) addNewRow

---

Adds a new row for the table.

- (DADataTableRow *) addNewRowInEditMode:(BOOL)editMode

Parameters:

• editMode: When YES then new row will be added in edit mode. Edit mode is different from the usual mode so that all changes are not visible for the table until they will be fixed by post method or cancelled by discard method.

---

- (DADataTableRow *) addNewRowWithDataFromArray:(NSArray *)data inEditMode:(BOOL)editMode

Parameters:

• data:
• editMode:

---

method which allows adding new row with the data from the dictionary in one go. If your table has an autoincrement key field then just omit passing its temporary value in the dictionary. It will be generated automatically by library (otherwize it will throw an exception saying that you cannot specify custom value for autoincrement field.) Also, you don’t need to pass values for ALL fields. You can specify there only ones you need. It also can be quite convenient for setting default values for the row.

- (DADataTableRow *) addNewRowWithDataFromDictionary:(NSDictionary *)data inEditMode:(BOOL)editMode

Parameters:

• data: Dictionary with data for new row
• editMode: boolean flag which specify do we create new row in EditMode or not

---

- (void) addRowToChangedList:(DADataTableRow *)changedRow

Parameters:

• changedRow:

---

- (void) addRowToEditedList:(DADataTableRow *)row

Parameters:

• row:

---

Appends all rows from given table. Finally fires DA_NOTIFICATION_TABLE_CHANGED and DA_NOTIFICATION_TABLE_INDEX_MUST_UPDATE events.

- (void) appendTable:(DADataTable *)newTable

Parameters:

• newTable: table whose rows will be appended to the current table.

---

Creates a new DAIndex for the specified field, if none was created before, and returns a reference to the caller. In contrast to indexForField:, the created index will be persisted for future use. It can be removed later, for example to conserve memory, by calling dropIndexForField:.

- (DAIndex *) buildIndexForField:(NSString *)indexField

Parameters:

• indexField: Name of the field in given DADataTable for which we want to build DAIndex

---

Boolean flag, when it is YES then whole table is in busy mode and any changes can be done here. This usually happens when a table is serialized into a briefcase or creates a delta with changes based on current data table.

@property (readonly) BOOL busy

---

Cancels all changes in the table. Each row in [table changedRows] will be sent a cancelChangesForRow message.

- (void) cancelAllChanges

---

Cancels changes for given row. If row was added then this method will remove it. If row was deleted then this method will restore it.

- (void) cancelChangeForRow:(DADataTableRow *)row

Parameters:

• row: Row which changes should be canceled.

---

Cancels changes in a specified row. Deprecated, please use cancelChangeForRow: method instead.

- (void) cancelChangesForRow:(DADataTableRow *)row

Parameters:

• row: DACalculatedFieldDefinition instance for which we want to cancel changes

---

@property (readonly) NSArray_DataTableRow *changedRows

---

Returns a set of default NSPredicateEditorRowTemplates that can be used to let the user define a custom filter based on the fields in the table. Lookup fields will be handled automatically by these templates, to provide popup buttons for all valid lookup values. See also Working with NSPredicateEditor (Xcode) and the Filters sample.

- (NSArray *) defaultPredicateEditorRowTemplates

---

This method discards all changes for the table that was made in edit mode and restores the original values. Finally method turns off edit mode for rows in the table.

- (void) discardAll

---

Removes an index that was previously created through buildIndexForField:.

- (void) dropIndexForField:(NSString *)indexField

Parameters:

• indexField:

---

Returns the DAFieldDefinition for the field with the given name.

- (DAFieldDefinition *) fieldByName:(NSString *)name

Parameters:

• name: Name of the field to obtain the DAFieldDefinition for.

---

- (DAFieldDefinition *) fieldByPosition:(NSUInteger)aPos

Parameters:

• aPos:

---

@property (readonly) NSInteger fieldCount

---

@property (readonly) NSArray_FieldDefinition *fields

---

Applies a predicate condition to filter the rows in the table. In contrast to rowsFilteredUsingPredicate*, which returns a new filtered array of rows, this method will filter the actual list of rows in the table; all rows not matching the predicate will be discarded from the DADataTable, any pending changes in those rows will be lost.

Use this method if you want to permanently reduce the number of rows maintained by your client application. Use rowsFilteredUsingPredicate*, instead, if you merely want to temporarily work with a reduced subset of the rows, for example for display in a view.

This method triggers the 'TableChanged' notification for the DADataTable.

- (void) filterUsingPredicate:(NSPredicate *)predicate

Parameters:

• predicate:

---

- (NSArray *) getPersistentFields

---

Builds and returns DADataTableRow instance from given array of the values.

- (DADataTableRow *) getRowWithData:(NSArray *)data

Parameters:

• data: array of the data for new row.

---

Returns whether the table contains any rows with open changes (YES) or not (NO). This is equivalent to [changedRows count] > 0.

@property (readonly) BOOL hasChanges

---

Returns a DAIndex for the specified field. If no index was created before by calling buildIndexForField:, a new index will be created and returned; this newly created index will not be cached for future use.

Use this method to create and obtain a temporary index that can be discarded after use, or to obtain an index previously created through buildIndexForField:.

- (DAIndex *) indexForField:(NSString *)indexField

Parameters:

• indexField: Name of the field for which we are obtaining index

---

- (InstanceType) init

---

- (InstanceType) initWithData:(NSData *)aData offset:(int)aOffset name:(NSString *)aName

Parameters:

• aData:
• aOffset:
• aName:

---

- (InstanceType) initWithSchemaTable:(DASchemaDataTable *)schemaTable

Parameters:

• schemaTable:

---

@property (readonly) NSArray_FieldDefinition *keyFields

---

Locks the table to avoid triggering 'TableChanged' notifications. This can be helpful when a lot of changes will be made to the table at once, but observers that track changes are listening to 'TableChanged' notifications. If data was changed while the table was in locked state, a single 'TableChanged' notification will be fired after the table is unlocked.

- (void) lock

---

@property (readonly) NSArray_FieldDefinition *loggedFields

---

- (void) mergeChangesForAllRows

---

- (void) mergeChangesForRow:(DADataTableRow *)aRow

Parameters:

• aRow:

---

Updates the current table with data from the passed, based on a single primary key (PK) field. By comparing values for the key field, the method tries to locate the same row in the destination table and replace it, if found. If not found, the row will be added as new to the destination table. This method does not delete any rows.

It is assumed that both tables have the same structure.

- (void) mergeTable:(DADataTable *)newTable withPrimaryKey:(NSString *)PK

Parameters:

• newTable: The DADataTable to merge into the current table.
• PK: primary keys column name.

---

Updates the current table with data from the passed, based on a list of several primary key (PK) fields. By comparing values for the key fields, the method tries to locate the same row in the destination table and replace it, if found. If not found, the row will be added as new to the destination table. This method does not delete any rows.

It is assumed that both tables have the same structure structure.

- (void) mergeTable:(DADataTable *)newTable withPrimaryKeys:(NSArray *)PKs

Parameters:

• newTable: The DADataTable to merge into the current table.
• PKs: Array of primary keys column names.

---

Specifies the name of the table.

@property (readonly) NSString *name

---

Confirms and fixes all changes in the table made in edit mode

- (void) postAll

---

Returns a set of default NSPredicateEditorRowTemplates that can be used to let the user define a custom filter based on a single field in the table. See also defaultPredicateEditorRowTemplates.

- (NSArray *) predicateEditorRowTemplatesForFieldName:(NSString *)field

Parameters:

• field: Field name for which we are getting templates

---

Method merges the changes from given delta with the table.

- (void) processDelta:(DADelta *)delta andMergeChanges:(BOOL)applyChanges

Parameters:

• delta: delta with changes we need to merge into the table
• applyChanges: boolean flag, if YES then changes will be committed in the table (i.e. table will not have pending changes)

---

@property (readonly) NSArray_FieldDefinition *realFields

---

+ (void) registerRowClass:(Class)class forTableName:(NSString *)name

Parameters:

• class:
• name:

---

Removes a specified row from the table and adds it to changedRows list, so it will be deleted on the server when applying changes.

- (void) removeRow:(DADataTableRow *)row

Parameters:

• row:

---

Removes a row at a specified index from the table and adds it to the changedRows list, so it will be deleted on the server when applying changes.

- (void) removeRowAtIndex:(NSUInteger)index

Parameters:

• index: index of the row we want to remove

---

- (void) removeRowFromChangedList:(DADataTableRow *)row

Parameters:

• row:

---

- (void) removeRowFromEditedList:(DADataTableRow *)row

Parameters:

• row:

---

Replaces all rows in the table with all rows from given table.

- (void) replaceRowsWithDataFromTable:(DADataTable *)newTable

Parameters:

• newTable: source table

---

- (DADataTableRow *) rowAtIndex:(NSInteger)aRow

Parameters:

• aRow:

---

- (void) rowChanged:(DADataTableRow *)row

Parameters:

• row:

---

- (void) rowChanged:(DADataTableRow *)row forFieldPosition:(NSInteger)fieldPositions

Parameters:

• row:
• fieldPositions:

---

@property (readonly) Class rowClass

---

@property (readonly) NSInteger rowCount

---

@property (readonly) NSArray_DataTableRow *rows

---

Returns a new array with a subset of of rows filtered according to the predicate.

- (NSArray *) rowsFilteredUsingPredicate:(NSPredicate *)predicate

Parameters:

• predicate: Predicate to use for filtering.

---

Returns a new array with a subset of of rows filtered according to the predicate and also sorted by given field using localizedCaseInsensitiveCompare: selector.

- (NSArray *) rowsFilteredUsingPredicate:(NSPredicate *)predicate localizedCaseInsensitivelySortedByField:(NSString *)sortField ascending:(BOOL)ascending

Parameters:

• predicate: Predicate to use for filtering.
• sortField: Name of the field for sorting result set.
• ascending: Boolean flag specifies sorting mode.

---

Returns a new array with a subset of of rows filtered according to the predicate, and also sorted by the specified field.

- (NSArray *) rowsFilteredUsingPredicate:(NSPredicate *)predicate sortedByField:(NSString *)sortField ascending:(BOOL)ascending

Parameters:

• predicate: Predicate to use for filtering.
• sortField: FieldName to use for sorting.
• ascending: YES if ascending and NO if descending.

---

Method returns a new array that lists rows sorted by given field in "Finder style". "Finder style" here means case insencetive with proper strings and numbers comparison - like in OS X Finder application.

- (NSArray *) rowsFinderStyleSortedByField:(NSString *)sortField ascending:(BOOL)ascending

Parameters:

• sortField: Name of the field that should be used for sorting
• ascending: Boolean flag, when YES then result array will be sorted in ascending way. When NO then in descending way.

---

Method returns a new array that lists rows sorted by given field in the localized case insensetive way.

- (NSArray *) rowsLocalizedCaseInsensitivelySortedByField:(NSString *)sortField ascending:(BOOL)ascending

Parameters:

• sortField: Name of the field that should be used for sorting
• ascending: Boolean flag, when YES then result array will be sorted in ascending way. When NO then in descending way.

---

Returns a dictionary with rows where dictionary key is the value of the given field.

- (NSDictionary *) rowsPartitionedByField:(NSString *)fieldName

Parameters:

• fieldName: name of the grouping field.

---

Returns a dictionary with rows where dictionary key is the value of the given field.

- (NSDictionary *) rowsPartitionedByField:(NSString *)fieldName includeNull:(BOOL)includeNull

Parameters:

• fieldName: Name of the field on which we need to group rows
• includeNull: If YES then for Null values it creates null value group

---

Returns a dictionary with rows grouped by values of given field. Where grouping value is the key of the dictonary.

- (NSDictionary *) rowsPartitionedByField:(NSString *)fieldName includeNull:(BOOL)includeNull sortedByField:(NSString *)sortfield ascending:(BOOL)ascending

Parameters:

• fieldName: Name of the field on which we need to group rows
• includeNull: If YES then it creates null value group for Null values of given field
• sortfield: Name of the field on which we want to sort result rows
• ascending: Boolean flag, when YES then grouped rows in dictionary will be sorted in ascending way. When NO then in descending way.

---

Returns a new array with all rows in the table, sorted by the specified field.

- (NSArray *) rowsSortedByField:(NSString *)sortField ascending:(BOOL)ascending

Parameters:

• sortField: Name of the field on which we want to sort result rows
• ascending: Boolean flag, when YES then grouped rows in dictionary will be sorted in ascending way. When NO then in descending way.

---

- (void) setBusy:(BOOL)value

Parameters:

• value:

---

- (void) setName:(NSString *)aName

Parameters:

• aName:

---

- (void) setRows:(NSMutableArray *)newRows

Parameters:

• newRows:

---

- (void) setupRealFields:(NSMutableArray *)aFields

Parameters:

• aFields:

---

- (void) setupSchemaWithFields:(NSMutableArray *)aFields andParams:(NSMutableArray *)aParams

Parameters:

• aFields:
• aParams:

---

- (void) setValue:(id)aValue forRow:(NSUInteger)rowIndex position:(NSUInteger)fieldIndex

Parameters:

• aValue:
• rowIndex:
• fieldIndex:

---

- (void) triggerTableChangedNotification

---

- (void) triggerTableChangedNotificationForField:(DAFieldDefinition *)field

Parameters:

• field:

---

Unlocks the table to allow triggering 'TableChanged' notifications. If data was changed while the table was in locked state, a single 'TableChanged' notification will be fired when the table gets unlocked.

- (void) unlock

---

@property (assign) BOOL useFullDelta

---

- (void) validateNewRowData:(NSDictionary *)data

Parameters:

• data:

---

- (id) valueForRow:(DADataTableRow *)row position:(NSUInteger)fieldIndex

Parameters:

• row:
• fieldIndex:

---

- (id) valueForRowAtIndex:(NSUInteger)rowIndex position:(NSUInteger)fieldIndex

Parameters:

• rowIndex:
• fieldIndex:

---

This method serializes all table data including the schema into the bytes buffer using Bin2 format.

- (void) writeToData:(NSMutableData *)aData

Parameters:

• aData: Instance of the bytes buffer where we want to serialize data.

 

Boolean flag, when it is YES then whole table is in busy mode and any changes can be done here. This usually happens when a table is serialized into a briefcase or creates a delta with changes based on current data table.

@property (readonly) BOOL busy

---

@property (readonly) NSArray_DataTableRow *changedRows

---

@property (readonly) NSInteger fieldCount

---

@property (readonly) NSArray_FieldDefinition *fields

---

Returns whether the table contains any rows with open changes (YES) or not (NO). This is equivalent to [changedRows count] > 0.

@property (readonly) BOOL hasChanges

---

@property (readonly) NSArray_FieldDefinition *keyFields

---

@property (readonly) NSArray_FieldDefinition *loggedFields

---

Specifies the name of the table.

@property (readonly) NSString *name

---

@property (readonly) NSArray_FieldDefinition *realFields

---

@property (readonly) Class rowClass

---

@property (readonly) NSInteger rowCount

---

@property (readonly) NSArray_DataTableRow *rows

---

@property (assign) BOOL useFullDelta

 

+ (void) registerRowClass:(Class)class forTableName:(NSString *)name

Parameters:

• class:
• name:

 

Adds a new calculated field to the table. Please refer to the documentation for DACalculatedFieldDefinition for more details.

- (void) addCalculatedField:(DACalculatedFieldDefinition *)field

Parameters:

• field: DACalculatedFieldDefinition instance we want to add to given DADataTable

---

Creates and adds a new calculated field to the table. Please refer to the documentation of DACalculatedFieldDefinition for more details.

- (DACalculatedFieldDefinition *) addCalculatedFieldName:(NSString *)name dataType:(enum DADataType)dataType target:(id)target selector:(SEL)selector

Parameters:

• name: The unique name for the new calculated field.
• dataType: The DADataType of the calculated field.
• target: Reference to the object that will provide the method for calculating this field.
• selector: Selector of method on the target that will calculate the field.

---

Adds a new usual or cached calculated field to the table. Please refer to the documentation for DACalculatedFieldDefinition for more details.

- (DACalculatedFieldDefinition *) addCalculatedFieldName:(NSString *)fieldName dataType:(enum DADataType)dataType target:(id)target selector:(SEL)selector cached:(BOOL)cached

Parameters:

• fieldName: The unique name for the new calculated field.
• dataType: The DADataType of the calculated field.
• target: Reference to the object that will provide the method for calculating this field.
• selector: Selector of method on the target that will calculate the field.
• cached: Boolean flag. If YES then new cached calculated field will be added to the table. Please refer to the documentation for DACachedCalculatedFieldDefinition for more details.

---

- (DAFieldDefinition *) addFieldWithName:(NSString *)name

Parameters:

• name:

---

- (DAInternalFieldDefinition *) addInternalFieldWithName:(NSString *)fieldName

Parameters:

• fieldName:

---

Adds lookup field definition to the table. Please refer to the documentation for DALookupFieldDefinition for more details.

- (void) addLookupField:(DALookupFieldDefinition *)field

Parameters:

• field: DACalculatedFieldDefinition instance we want to add to given DADataTable

---

Creates and appends a lookup field to the table. Please refer to the documentation for DALookupFieldDefinition for more details.

- (DALookupFieldDefinition *) addLookupFieldName:(NSString *)name sourceField:(DAFieldDefinition *)sourceField lookupTable:(DADataTable *)lookupTable lookupKeyField:(DAFieldDefinition *)lookupKeyField lookupResultField:(DAFieldDefinition *)lookupResultField

Parameters:

• name: The unique name for the new calculated field.
• sourceField: Initializes the sourceField property.
• lookupTable: Initializes the lookupTable property.
• lookupKeyField: Initializes the lookupKeyField property.
• lookupResultField: Initializes the lookupResultField property.

---

Appends a new row to the table. If the row has any AutoInc columns, new negative ID values will be generated automatically for these. All other columns will be initialized as null. A reference to the newly added row will be returned to the caller.

This method triggers the 'TableChanged' notification for the DADataTable.

- (DADataTableRow *) addNewRow

---

Adds a new row for the table.

- (DADataTableRow *) addNewRowInEditMode:(BOOL)editMode

Parameters:

• editMode: When YES then new row will be added in edit mode. Edit mode is different from the usual mode so that all changes are not visible for the table until they will be fixed by post method or cancelled by discard method.

---

- (DADataTableRow *) addNewRowWithDataFromArray:(NSArray *)data inEditMode:(BOOL)editMode

Parameters:

• data:
• editMode:

---

method which allows adding new row with the data from the dictionary in one go. If your table has an autoincrement key field then just omit passing its temporary value in the dictionary. It will be generated automatically by library (otherwize it will throw an exception saying that you cannot specify custom value for autoincrement field.) Also, you don’t need to pass values for ALL fields. You can specify there only ones you need. It also can be quite convenient for setting default values for the row.

- (DADataTableRow *) addNewRowWithDataFromDictionary:(NSDictionary *)data inEditMode:(BOOL)editMode

Parameters:

• data: Dictionary with data for new row
• editMode: boolean flag which specify do we create new row in EditMode or not

---

- (void) addRowToChangedList:(DADataTableRow *)changedRow

Parameters:

• changedRow:

---

- (void) addRowToEditedList:(DADataTableRow *)row

Parameters:

• row:

---

Appends all rows from given table. Finally fires DA_NOTIFICATION_TABLE_CHANGED and DA_NOTIFICATION_TABLE_INDEX_MUST_UPDATE events.

- (void) appendTable:(DADataTable *)newTable

Parameters:

• newTable: table whose rows will be appended to the current table.

---

Creates a new DAIndex for the specified field, if none was created before, and returns a reference to the caller. In contrast to indexForField:, the created index will be persisted for future use. It can be removed later, for example to conserve memory, by calling dropIndexForField:.

- (DAIndex *) buildIndexForField:(NSString *)indexField

Parameters:

• indexField: Name of the field in given DADataTable for which we want to build DAIndex

---

Cancels all changes in the table. Each row in [table changedRows] will be sent a cancelChangesForRow message.

- (void) cancelAllChanges

---

Cancels changes for given row. If row was added then this method will remove it. If row was deleted then this method will restore it.

- (void) cancelChangeForRow:(DADataTableRow *)row

Parameters:

• row: Row which changes should be canceled.

---

Cancels changes in a specified row. Deprecated, please use cancelChangeForRow: method instead.

- (void) cancelChangesForRow:(DADataTableRow *)row

Parameters:

• row: DACalculatedFieldDefinition instance for which we want to cancel changes

---

Returns a set of default NSPredicateEditorRowTemplates that can be used to let the user define a custom filter based on the fields in the table. Lookup fields will be handled automatically by these templates, to provide popup buttons for all valid lookup values. See also Working with NSPredicateEditor (Xcode) and the Filters sample.

- (NSArray *) defaultPredicateEditorRowTemplates

---

This method discards all changes for the table that was made in edit mode and restores the original values. Finally method turns off edit mode for rows in the table.

- (void) discardAll

---

Removes an index that was previously created through buildIndexForField:.

- (void) dropIndexForField:(NSString *)indexField

Parameters:

• indexField:

---

Returns the DAFieldDefinition for the field with the given name.

- (DAFieldDefinition *) fieldByName:(NSString *)name

Parameters:

• name: Name of the field to obtain the DAFieldDefinition for.

---

- (DAFieldDefinition *) fieldByPosition:(NSUInteger)aPos

Parameters:

• aPos:

---

Applies a predicate condition to filter the rows in the table. In contrast to rowsFilteredUsingPredicate*, which returns a new filtered array of rows, this method will filter the actual list of rows in the table; all rows not matching the predicate will be discarded from the DADataTable, any pending changes in those rows will be lost.

Use this method if you want to permanently reduce the number of rows maintained by your client application. Use rowsFilteredUsingPredicate*, instead, if you merely want to temporarily work with a reduced subset of the rows, for example for display in a view.

This method triggers the 'TableChanged' notification for the DADataTable.

- (void) filterUsingPredicate:(NSPredicate *)predicate

Parameters:

• predicate:

---

- (NSArray *) getPersistentFields

---

Builds and returns DADataTableRow instance from given array of the values.

- (DADataTableRow *) getRowWithData:(NSArray *)data

Parameters:

• data: array of the data for new row.

---

Returns a DAIndex for the specified field. If no index was created before by calling buildIndexForField:, a new index will be created and returned; this newly created index will not be cached for future use.

Use this method to create and obtain a temporary index that can be discarded after use, or to obtain an index previously created through buildIndexForField:.

- (DAIndex *) indexForField:(NSString *)indexField

Parameters:

• indexField: Name of the field for which we are obtaining index

---

- (InstanceType) init

---

- (InstanceType) initWithData:(NSData *)aData offset:(int)aOffset name:(NSString *)aName

Parameters:

• aData:
• aOffset:
• aName:

---

- (InstanceType) initWithSchemaTable:(DASchemaDataTable *)schemaTable

Parameters:

• schemaTable:

---

Locks the table to avoid triggering 'TableChanged' notifications. This can be helpful when a lot of changes will be made to the table at once, but observers that track changes are listening to 'TableChanged' notifications. If data was changed while the table was in locked state, a single 'TableChanged' notification will be fired after the table is unlocked.

- (void) lock

---

- (void) mergeChangesForAllRows

---

- (void) mergeChangesForRow:(DADataTableRow *)aRow

Parameters:

• aRow:

---

Updates the current table with data from the passed, based on a single primary key (PK) field. By comparing values for the key field, the method tries to locate the same row in the destination table and replace it, if found. If not found, the row will be added as new to the destination table. This method does not delete any rows.

It is assumed that both tables have the same structure.

- (void) mergeTable:(DADataTable *)newTable withPrimaryKey:(NSString *)PK

Parameters:

• newTable: The DADataTable to merge into the current table.
• PK: primary keys column name.

---

Updates the current table with data from the passed, based on a list of several primary key (PK) fields. By comparing values for the key fields, the method tries to locate the same row in the destination table and replace it, if found. If not found, the row will be added as new to the destination table. This method does not delete any rows.

It is assumed that both tables have the same structure structure.

- (void) mergeTable:(DADataTable *)newTable withPrimaryKeys:(NSArray *)PKs

Parameters:

• newTable: The DADataTable to merge into the current table.
• PKs: Array of primary keys column names.

---

Confirms and fixes all changes in the table made in edit mode

- (void) postAll

---

Returns a set of default NSPredicateEditorRowTemplates that can be used to let the user define a custom filter based on a single field in the table. See also defaultPredicateEditorRowTemplates.

- (NSArray *) predicateEditorRowTemplatesForFieldName:(NSString *)field

Parameters:

• field: Field name for which we are getting templates

---

Method merges the changes from given delta with the table.

- (void) processDelta:(DADelta *)delta andMergeChanges:(BOOL)applyChanges

Parameters:

• delta: delta with changes we need to merge into the table
• applyChanges: boolean flag, if YES then changes will be committed in the table (i.e. table will not have pending changes)

---

Removes a specified row from the table and adds it to changedRows list, so it will be deleted on the server when applying changes.

- (void) removeRow:(DADataTableRow *)row

Parameters:

• row:

---

Removes a row at a specified index from the table and adds it to the changedRows list, so it will be deleted on the server when applying changes.

- (void) removeRowAtIndex:(NSUInteger)index

Parameters:

• index: index of the row we want to remove

---

- (void) removeRowFromChangedList:(DADataTableRow *)row

Parameters:

• row:

---

- (void) removeRowFromEditedList:(DADataTableRow *)row

Parameters:

• row:

---

Replaces all rows in the table with all rows from given table.

- (void) replaceRowsWithDataFromTable:(DADataTable *)newTable

Parameters:

• newTable: source table

---

- (DADataTableRow *) rowAtIndex:(NSInteger)aRow

Parameters:

• aRow:

---

- (void) rowChanged:(DADataTableRow *)row

Parameters:

• row:

---

- (void) rowChanged:(DADataTableRow *)row forFieldPosition:(NSInteger)fieldPositions

Parameters:

• row:
• fieldPositions:

---

Returns a new array with a subset of of rows filtered according to the predicate.

- (NSArray *) rowsFilteredUsingPredicate:(NSPredicate *)predicate

Parameters:

• predicate: Predicate to use for filtering.

---

Returns a new array with a subset of of rows filtered according to the predicate and also sorted by given field using localizedCaseInsensitiveCompare: selector.

- (NSArray *) rowsFilteredUsingPredicate:(NSPredicate *)predicate localizedCaseInsensitivelySortedByField:(NSString *)sortField ascending:(BOOL)ascending

Parameters:

• predicate: Predicate to use for filtering.
• sortField: Name of the field for sorting result set.
• ascending: Boolean flag specifies sorting mode.

---

Returns a new array with a subset of of rows filtered according to the predicate, and also sorted by the specified field.

- (NSArray *) rowsFilteredUsingPredicate:(NSPredicate *)predicate sortedByField:(NSString *)sortField ascending:(BOOL)ascending

Parameters:

• predicate: Predicate to use for filtering.
• sortField: FieldName to use for sorting.
• ascending: YES if ascending and NO if descending.

---

Method returns a new array that lists rows sorted by given field in "Finder style". "Finder style" here means case insencetive with proper strings and numbers comparison - like in OS X Finder application.

- (NSArray *) rowsFinderStyleSortedByField:(NSString *)sortField ascending:(BOOL)ascending

Parameters:

• sortField: Name of the field that should be used for sorting
• ascending: Boolean flag, when YES then result array will be sorted in ascending way. When NO then in descending way.

---

Method returns a new array that lists rows sorted by given field in the localized case insensetive way.

- (NSArray *) rowsLocalizedCaseInsensitivelySortedByField:(NSString *)sortField ascending:(BOOL)ascending

Parameters:

• sortField: Name of the field that should be used for sorting
• ascending: Boolean flag, when YES then result array will be sorted in ascending way. When NO then in descending way.

---

Returns a dictionary with rows where dictionary key is the value of the given field.

- (NSDictionary *) rowsPartitionedByField:(NSString *)fieldName

Parameters:

• fieldName: name of the grouping field.

---

Returns a dictionary with rows where dictionary key is the value of the given field.

- (NSDictionary *) rowsPartitionedByField:(NSString *)fieldName includeNull:(BOOL)includeNull

Parameters:

• fieldName: Name of the field on which we need to group rows
• includeNull: If YES then for Null values it creates null value group

---

Returns a dictionary with rows grouped by values of given field. Where grouping value is the key of the dictonary.

- (NSDictionary *) rowsPartitionedByField:(NSString *)fieldName includeNull:(BOOL)includeNull sortedByField:(NSString *)sortfield ascending:(BOOL)ascending

Parameters:

• fieldName: Name of the field on which we need to group rows
• includeNull: If YES then it creates null value group for Null values of given field
• sortfield: Name of the field on which we want to sort result rows
• ascending: Boolean flag, when YES then grouped rows in dictionary will be sorted in ascending way. When NO then in descending way.

---

Returns a new array with all rows in the table, sorted by the specified field.

- (NSArray *) rowsSortedByField:(NSString *)sortField ascending:(BOOL)ascending

Parameters:

• sortField: Name of the field on which we want to sort result rows
• ascending: Boolean flag, when YES then grouped rows in dictionary will be sorted in ascending way. When NO then in descending way.

---

- (void) setBusy:(BOOL)value

Parameters:

• value:

---

- (void) setName:(NSString *)aName

Parameters:

• aName:

---

- (void) setRows:(NSMutableArray *)newRows

Parameters:

• newRows:

---

- (void) setupRealFields:(NSMutableArray *)aFields

Parameters:

• aFields:

---

- (void) setupSchemaWithFields:(NSMutableArray *)aFields andParams:(NSMutableArray *)aParams

Parameters:

• aFields:
• aParams:

---

- (void) setValue:(id)aValue forRow:(NSUInteger)rowIndex position:(NSUInteger)fieldIndex

Parameters:

• aValue:
• rowIndex:
• fieldIndex:

---

- (void) triggerTableChangedNotification

---

- (void) triggerTableChangedNotificationForField:(DAFieldDefinition *)field

Parameters:

• field:

---

Unlocks the table to allow triggering 'TableChanged' notifications. If data was changed while the table was in locked state, a single 'TableChanged' notification will be fired when the table gets unlocked.

- (void) unlock

---

- (void) validateNewRowData:(NSDictionary *)data

Parameters:

• data:

---

- (id) valueForRow:(DADataTableRow *)row position:(NSUInteger)fieldIndex

Parameters:

• row:
• fieldIndex:

---

- (id) valueForRowAtIndex:(NSUInteger)rowIndex position:(NSUInteger)fieldIndex

Parameters:

• rowIndex:
• fieldIndex:

---

This method serializes all table data including the schema into the bytes buffer using Bin2 format.

- (void) writeToData:(NSMutableData *)aData

Parameters:

• aData: Instance of the bytes buffer where we want to serialize data.