DataRow (common 0.2.2 API)

java.lang.Object
- xyz.cofe.data.DataRow

All Implemented Interfaces:

Closeable, Serializable, AutoCloseable
```
public class DataRow
extends Object
implements Closeable, Serializable
```
Строка данных таблицы, с поддержкой отката изменений.
- Строка может пренадлежать таблице или нет (свойство table).
- Строка хранит счетчик изменений changeCount
- Строка хранит в себе два набора:
  origin - оригинальные данные
  data - текущие данные
- Оба набора данных задаются в конструкторе, счетчик измений устанавливается в 0.
- Изменения вносятся в текущий набор, при каждом изменении увеличивается счетчик changeCount.
- Отличия текущих данных от оргинальных, можно получить методом: getChangedValues()
- метод fixChanges() - сохраняет внесенные изменения в оригинальные данные, счетчик сбрасывает в 0
- метод cancelChanges() - откатывает измененияЮ счетчик сбрасывает в 0
В зависимости от состояния таблицы, строка может находится в следующих состояниях:
- Detached - Строка не присоединена к таблице
- Fixed - Строка присоединена к таблице и счетчик изменений 0
- Updated - Строка присоединена к таблице и счетчик изменений более 0 (содержит измененные данные)
- Inserted - Строка присоединена к таблице, и помечена для добавления
- Deleted - Строка присоединена к таблице, и помечена для удаления
Author:

Kamnev Georgiy

See Also:

Serialized Form

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

static class DataRow.ChangedValue
Описывает изенеия строки

Nested Classes
Modifier and Type	Class and Description
`static class`	`DataRow.ChangedValue` Описывает изенеия строки

Field Summary

Fields
Modifier and Type	Field and Description
`protected Set<Integer>`	`changed` Номера (от 0) измененных колонок
`protected int`	`changes` Счетчик изменений
`protected Object[]`	`data`
`protected Object[]`	`origin`
`protected DataTable`	`table`

Constructor Summary

Constructors
Constructor and Description
`DataRow(DataRow sample)` Конструктор копирования
`DataRow(DataTable table, Object... data)` Создает строку таблицы
`DataRow(DataTable dataTable, Object[] data, Object[] origin, int changes)` Конструктор десиариализации

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`cancelChanges()` Откатывает изменения
`void`	`cancelChanges(boolean addEvents)` Откатывает изменения и добавляет событие в очередь
`void`	`close()` Закрывает строку и освобождает ссылки
`void`	`fixChanges()` Фиксировать изменения
`void`	`fixChanges(boolean addEvents)` Фиксировать изменения
`Object`	`get(int column)` Возвращает данные из указанной колонки
`int`	`getChangeCount()` Возвращает кол-во изменений с последней фиксации
`Integer[]`	`getChangedColumn()` Возвращает индексы измененных колонок
`List<DataRow.ChangedValue>`	`getChangedValues()` Возвращает список изменений
`Object[]`	`getData()` Возвращает рабочие данные строки
`Object[]`	`getOrigin()` Возвращает зафиксированные данные
`DataRowState`	`getState()` Возвращает состояние строки
`DataTable`	`getTable()` Указывает таблицу строки
`boolean`	`isChanged()` Возвращает факт наличия не зафиксированных данных
`boolean`	`isDeleted()` Возвращает true если строка отмечена как удаленная
`boolean`	`isDetached()` Указывает присоединена ли строка к таблице
`boolean`	`isInserted()` Возвращает true если строка отмечена как новая (inserted)
`boolean`	`isUpdated()` Возвращает true если строка быда обновлена, но не фиксированна
`void`	`set(int column, Object value)` Указывает значение колонки
`void`	`set(int column, Object value, boolean addEvents)` Указывает значение колонки
`void`	`setTable(DataTable table)` Указывает таблицу сторки

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

- Field Detail
  - changes
```
protected int changes
```
    Счетчик изменений
  - changed
```
protected final Set<Integer> changed
```
    Номера (от 0) измененных колонок
  - data
```
protected Object[] data
```
  - origin
```
protected Object[] origin
```
  - table
```
protected transient volatile DataTable table
```
- Constructor Detail
  - DataRow
```
public DataRow(DataTable table,
               Object... data)
```
    Создает строку таблицы
    
    Parameters:
    
    table - таблица
    
    data - данные строки
  - DataRow
```
public DataRow(DataTable dataTable,
               Object[] data,
               Object[] origin,
               int changes)
```
    Конструктор десиариализации
    
    Parameters:
    
    dataTable - Таблица к которой относится строка
    
    data - Текущие данные
    
    origin - Оригинальные данные
    
    changes - Кол-во изменений
  - DataRow
```
public DataRow(DataRow sample)
```
    Конструктор копирования
    
    Parameters:
    
    sample - Образец для копирования
- Method Detail
  - getData
```
public Object[] getData()
```
    Возвращает рабочие данные строки
    
    Returns:
    
    данные
  - getOrigin
```
public Object[] getOrigin()
```
    Возвращает зафиксированные данные
    
    Returns:
    
    зафиксированные данные
  - getChangedColumn
```
public Integer[] getChangedColumn()
```
    Возвращает индексы измененных колонок
    
    Returns:
    
    индексы
  - isChanged
```
public boolean isChanged()
```
    Возвращает факт наличия не зафиксированных данных
    
    Returns:
    
    true - если незафиксированные данные
  - getChangeCount
```
public int getChangeCount()
```
    Возвращает кол-во изменений с последней фиксации
    
    Returns:
    
    кол-во изменений
  - getChangedValues
```
public List<DataRow.ChangedValue> getChangedValues()
```
    Возвращает список изменений
    
    Returns:
    
    список изменений
  - cancelChanges
```
public void cancelChanges()
```
    Откатывает изменения
  - cancelChanges
```
public void cancelChanges(boolean addEvents)
```
    Откатывает изменения и добавляет событие в очередь
    
    Parameters:
    
    addEvents - добавить событие в очередь таблицы
  - fixChanges
```
public void fixChanges()
```
    Фиксировать изменения
  - fixChanges
```
public void fixChanges(boolean addEvents)
```
    Фиксировать изменения
    
    Parameters:
    
    addEvents - добавить событие в очередь таблицы
  - close
```
public void close()
           throws IOException
```
    Закрывает строку и освобождает ссылки
    
    Specified by:
    
    close in interface Closeable
    
    Specified by:
    
    close in interface AutoCloseable
    
    Throws:
    
    IOException - Ошибка клонирования
  - get
```
public Object get(int column)
```
    Возвращает данные из указанной колонки
    
    Parameters:
    
    column - колонка
    
    Returns:
    
    данные
  - set
```
public void set(int column,
                Object value)
```
    Указывает значение колонки
    
    Parameters:
    
    column - колонка
    
    value - значение
  - set
```
public void set(int column,
                Object value,
                boolean addEvents)
```
    Указывает значение колонки
    
    Parameters:
    
    column - колонка
    
    value - значение
    
    addEvents - true - добавляет событие в очередь таблицы
  - getTable
```
public DataTable getTable()
```
    Указывает таблицу строки
    
    Returns:
    
    таблица
  - setTable
```
public void setTable(DataTable table)
```
    Указывает таблицу сторки
    
    Parameters:
    
    table - таблица
  - isDetached
```
public boolean isDetached()
```
    Указывает присоединена ли строка к таблице
    
    Returns:
    
    true - есть ссылка на таблицу
  - isDeleted
```
public boolean isDeleted()
```
    Возвращает true если строка отмечена как удаленная
    
    Returns:
    
    true - отмечена под удаление
  - isInserted
```
public boolean isInserted()
```
    Возвращает true если строка отмечена как новая (inserted)
    
    Returns:
    
    true - строка добавлена но не фиксирована
  - isUpdated
```
public boolean isUpdated()
```
    Возвращает true если строка быда обновлена, но не фиксированна
    
    Returns:
    
    true - строка была обновлена, но не фиксированна
  - getState
```
public DataRowState getState()
```
    Возвращает состояние строки
    
    Returns:
    
    состояние строки

Class DataRow

Nested Class Summary

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

changes

changed

data

origin

table

Constructor Detail

DataRow

DataRow

DataRow

Method Detail

getData

getOrigin

getChangedColumn

isChanged

getChangeCount

getChangedValues

cancelChanges

cancelChanges

fixChanges

fixChanges

close

get

set

set

getTable

setTable

isDetached

isDeleted

isInserted

isUpdated

getState