xyz.cofe.data

Class DataTable

java.lang.Object

xyz.cofe.data.DataTable

public class DataTable
extends Object

Таблица с данными.

Каждая строка таблицы может находится в нескольких состояниях:
Fixed, Updated - содержится в коллекции рабочих строк (getWorkedRows())
Inserted - содержится в коллекции рабочих строк и коллекции новых строк (getWorkedRows())

Author:

Kamnev Georgiy

See Also:

DataRow

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	DataTable.InternalRun Выполенеие внутреннего кода
class	DataTable.NullRowsDisabler Запрещает вставлять null ссылки в качестве строк
class	DataTable.ReadonlyColumnsConstraint Ограничение на операции с колонками.
class	DataTable.WorkedRowsOnDeletedTacking Слушает изменения рабочего набора и при добавлении новой строки в WorkedRows отмечает ее как новую (getInsertedRows().add()) при удалении из рабочего набора строки, удаляет ее так же из (getInsertedRows)
class	DataTable.WorkedRowsOnUpdateInsertTracking Слушает изменения рабочего набора и при добавлении новой строки в WorkedRows отмечает ее как новую (getInsertedRows().add()) при удалении из рабочего набора строки, удаляет ее так же из (getInsertedRows)

Field Summary

Fields

Modifier and Type	Field and Description
protected AtomicInteger	dropCallLevel
protected AtomicInteger	eventLockLevel
protected LinkedBlockingQueue<DataEvent>	eventQueue
protected DataEventSupport	listeners

Constructor Summary

Constructors

Constructor and Description
DataTable() Конструктор по умолчанию
DataTable(DataColumn[] columns) Конструктор
DataTable(DataColumn[] columns, Iterable<DataRow> rows, Iterable<DataRow> inserted, Iterable<DataRow> deleted) Конструктор де сериализации
DataTable(DataColumn[] columns, Iterable<Object[]> initialData) Конструктор

Method Summary

Modifier and Type	Method and Description
void	addColumn(DataColumn dc) Добавляет колонку к таблице
void	addDataEvent(DataEvent ev) Добавляет событие в очередь
Closeable	addDataEventListener(DataEventListener ls) Добавляет подписчика на события
Closeable	addDataEventListener(DataEventListener ls, boolean weak) Добавляет подписчика на события
protected DataTable.InternalRun	createInternalRun() Создаение объекта для доступа к внутренним объектам
void	delete(DataRow row) Удаляет строку
void	drop() Удаление всех данны, включая изменения и удаление структуры
void	dropColumns() Удаляет все колонки
void	fireEvent(DataEvent event) Уведомляет подписчиков о событии
void	fireEventQueue() Рассылает события из очереди подписчикам
void	fixed() Зафиксировать все строки.
void	fixed(DataRow row) Фиксация изменений
void	fixed(DataRow row, boolean addEvents) Фиксация изменений
DataColumn	getColumn(int cidx) Возвращает колонку по ее индексу
DataColumn[]	getColumns() Возвращает массив колонок
int	getColumnsCount() Возвращает кол-во колонок в таблице
DataEventListener[]	getDataEventListeners() Возвращает список подписчиков
DataRow	getRow(int row) Возвращает строку по индексу из рабочего набора
int	getRowsCount() Возвращает кол-во строк в рабочем наборе
Iterable<DataRow>	getRowsIterable() Итератор по рабочему набору строк
Iterable<DataRow>	getRowsIterable(DataRowState... states) Итератор по строкам
Iterable<DataRow>	getRowsIterableAll() Возвращает все строки включая удаленные
Iterator<DataRow>	getRowsIterator() Итератор по рабочему набору строк
long	getScn() Возвращает еткущий номер изенений
boolean	hasDataEventListener(DataEventListener ls) Проверка наличия подписчика
int	indexOf(DataRow mrow) Возвращает индекст строки в таблице
void	insert(DataRow row) Производит вставку строки
DataTableInserting	insert(Object... values) Производит вставку строки
boolean	isDeleted(DataRow row) Возвращает true если строка отмечена как удаленная
boolean	isInserted(DataRow row) Возвращает true если строка отмечена как новая (inserted)
boolean	isTrackChanges() Указывает отслеживать изменения
boolean	isUpdated(DataRow row) Возвращает true если строка быда обновлена, но не фиксированна
<T extends DataEvent> Closeable	listen(Class<T> evnType, boolean weakRef, Reciver<T> listener) Подписка на события определенного типа
<T extends DataEvent> Closeable	listen(Class<T> evnType, Reciver<T> listener) Подписка на события определенного типа
Object	lockRun(Func0 run) Выполнение кода в режиме блокировки таблицы и последующим уведомлением о событии
void	lockRun(Runnable run) Выполнение кода в режиме блокировки таблицы и последующим уведомлением о событии
protected Object	lockRunInternal(Func1<Object,DataTable.InternalRun> run) Выполнение внутреннего кода
protected long	nextScn() Указывает текущий номер изменений
Closeable	onColumnAdded(boolean weak, Reciver<DataColumnAdded> listener) Добавление на событие добавления колонки
Closeable	onColumnAdded(Reciver<DataColumnAdded> listener) Добавление на событие добавления колонки
Closeable	onColumnRemoved(boolean weak, Reciver<DataColumnAdded> listener) Добавление на событие - колонка удалена
Closeable	onColumnRemoved(Reciver<DataColumnRemoved> listener) Добавление на событие - колонка удалена
Closeable	onDataTableDropped(boolean weak, Reciver<DataTableDropped> listener) Добавление на событие полного удаления таблицы, включая структуры
Closeable	onDataTableDropped(Reciver<DataTableDropped> listener) Добавление на событие полного удаления таблицы, включая структуры
Closeable	onRowDeleted(boolean weak, Reciver<DataRowDeleted> listener) Добавление на событие: строка почена под удаление
Closeable	onRowDeleted(Reciver<DataRowDeleted> listener) Добавление на событие: строка почена под удаление
Closeable	onRowErased(boolean weak, Reciver<DataRowErased> listener) Добавление на событие окончательного удаляения строки
Closeable	onRowErased(Reciver<DataRowErased> listener) Добавление на событие окончательного удаляения строки
Closeable	onRowUndeleted(boolean weak, Reciver<DataRowUndeleted> listener) Добавление на событие отката удаляения строки
Closeable	onRowUndeleted(Reciver<DataRowUndeleted> listener) Добавление на событие отката удаляения строки
void	removeColumn(DataColumn dc) Удаляет колонку из таблицы
void	removeColumnByIndex(int colIdx) Удаляет колонку по ее индексу
void	removeDataEventListener(DataEventListener ls) Удаляет подписчика
void	rollback() Откат изменений таблицы
void	rollback(boolean addEvents) Откат изменений таблицы
void	rollback(DataRow row) Откат изменений строки
void	rollback(DataRow row, boolean addEvents) Откат изменений строки
List<DataRow>	rowsList(DataRowState... states) Возвращает строки ввиде списка
void	setTrackChanges(boolean track) Указывает отслеживать изменения
DataRowState	stateOf(DataRow row) Возвращает состояние строки

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

listeners

protected final transient DataEventSupport listeners

eventQueue

protected final LinkedBlockingQueue<DataEvent> eventQueue

eventLockLevel

protected final transient AtomicInteger eventLockLevel

dropCallLevel

protected final transient AtomicInteger dropCallLevel

Constructor Detail

DataTable

public DataTable()

Конструктор по умолчанию

DataTable

public DataTable(DataColumn[] columns)

Конструктор

Parameters:

columns - Описания колонок таблицы

DataTable

public DataTable(DataColumn[] columns,
                 Iterable<Object[]> initialData)

Конструктор

Parameters:

columns - Описания колонок таблицы

initialData - Начальные данные

DataTable

public DataTable(DataColumn[] columns,
                 Iterable<DataRow> rows,
                 Iterable<DataRow> inserted,
                 Iterable<DataRow> deleted)

Конструктор де сериализации

Parameters:

columns - Набор колонок

rows - Фиксированные/Модифицированные строки

inserted - Добавленные, но не фиксированные строки

deleted - Удаленные, но не фиксированные строки

Method Detail

addDataEventListener

public Closeable addDataEventListener(DataEventListener ls,
                                      boolean weak)

Добавляет подписчика на события

Parameters:

ls - Подписчик

weak - true - добавить как weak ссылку

Returns:

Отписка

addDataEventListener

public Closeable addDataEventListener(DataEventListener ls)

Добавляет подписчика на события

Parameters:

ls - Подписчик

Returns:

Отписка

removeDataEventListener

public void removeDataEventListener(DataEventListener ls)

Удаляет подписчика

Parameters:

ls - подписчик

hasDataEventListener

public boolean hasDataEventListener(DataEventListener ls)

Проверка наличия подписчика

Parameters:

ls - подписчик

Returns:

true подписан

getDataEventListeners

public DataEventListener[] getDataEventListeners()

Возвращает список подписчиков

Returns:

подписчики

fireEvent

public void fireEvent(DataEvent event)

Уведомляет подписчиков о событии

Parameters:

event - событие

addDataEvent

public void addDataEvent(DataEvent ev)

Добавляет событие в очередь

Parameters:

ev - событие

fireEventQueue

public void fireEventQueue()

Рассылает события из очереди подписчикам

lockRun

public void lockRun(Runnable run)

Выполнение кода в режиме блокировки таблицы и последующим уведомлением о событии

Parameters:

run - код

See Also:

fireEventQueue()

lockRun

public Object lockRun(Func0 run)

Выполнение кода в режиме блокировки таблицы и последующим уведомлением о событии

Parameters:

run - код

Returns:

результат выполения кода

See Also:

fireEventQueue()

createInternalRun

protected DataTable.InternalRun createInternalRun()

Создаение объекта для доступа к внутренним объектам

Returns:

доступ к внутренним объектам

lockRunInternal

protected Object lockRunInternal(Func1<Object,DataTable.InternalRun> run)

Выполнение внутреннего кода

Parameters:

run - внутренний код

Returns:

Результат выполнения

listen

public <T extends DataEvent> Closeable listen(Class<T> evnType,
                                              boolean weakRef,
                                              Reciver<T> listener)

Подписка на события определенного типа

Type Parameters:

T - Тип события

Parameters:

evnType - Тип события

weakRef - Добавить подписчика как weak ссылку

listener - Подписчик

Returns:

Отписка от события

listen

public <T extends DataEvent> Closeable listen(Class<T> evnType,
                                              Reciver<T> listener)

Подписка на события определенного типа

Type Parameters:

T - Тип события

Parameters:

evnType - Тип события

listener - Подписчик

Returns:

Отписка от получения событий

onColumnAdded

public Closeable onColumnAdded(boolean weak,
                               Reciver<DataColumnAdded> listener)

Добавление на событие добавления колонки

Parameters:

weak - Добавить подписчика как weak ссылку

listener - Подписчик

Returns:

Отписка от получения событий

onColumnAdded

public Closeable onColumnAdded(Reciver<DataColumnAdded> listener)

Добавление на событие добавления колонки

Parameters:

listener - Подписчик

Returns:

Отписка от получения событий

onColumnRemoved

public Closeable onColumnRemoved(boolean weak,
                                 Reciver<DataColumnAdded> listener)

Добавление на событие - колонка удалена

Parameters:

weak - Добавить подписчика как weak ссылку

listener - Подписчик

Returns:

Отписка от получения событий

onColumnRemoved

public Closeable onColumnRemoved(Reciver<DataColumnRemoved> listener)

Добавление на событие - колонка удалена

Parameters:

listener - Подписчик

Returns:

Отписка от получения событий

onRowDeleted

public Closeable onRowDeleted(boolean weak,
                              Reciver<DataRowDeleted> listener)

Добавление на событие: строка почена под удаление

Parameters:

weak - Добавить подписчика как weak ссылку

listener - Подписчик

Returns:

Отписка от получения событий

onRowDeleted

public Closeable onRowDeleted(Reciver<DataRowDeleted> listener)

Добавление на событие: строка почена под удаление

Parameters:

listener - Подписчик

Returns:

Отписка от получения событий

onRowUndeleted

public Closeable onRowUndeleted(boolean weak,
                                Reciver<DataRowUndeleted> listener)

Добавление на событие отката удаляения строки

Parameters:

weak - Добавить подписчика как weak ссылку

listener - Подписчик

Returns:

Отписка от получения событий

onRowUndeleted

public Closeable onRowUndeleted(Reciver<DataRowUndeleted> listener)

Добавление на событие отката удаляения строки

Parameters:

listener - Подписчик

Returns:

Отписка от получения событий

onRowErased

public Closeable onRowErased(boolean weak,
                             Reciver<DataRowErased> listener)

Добавление на событие окончательного удаляения строки

Parameters:

weak - Добавить подписчика как weak ссылку

listener - Подписчик

Returns:

Отписка от получения событий

onRowErased

public Closeable onRowErased(Reciver<DataRowErased> listener)

Добавление на событие окончательного удаляения строки

Parameters:

listener - Подписчик

Returns:

Отписка от получения событий

onDataTableDropped

public Closeable onDataTableDropped(boolean weak,
                                    Reciver<DataTableDropped> listener)

Добавление на событие полного удаления таблицы, включая структуры

Parameters:

weak - Добавить подписчика как weak ссылку

listener - Подписчик

Returns:

Отписка от получения событий

onDataTableDropped

public Closeable onDataTableDropped(Reciver<DataTableDropped> listener)

Добавление на событие полного удаления таблицы, включая структуры

Parameters:

listener - Подписчик

Returns:

Отписка от получения событий

isTrackChanges

public boolean isTrackChanges()

Указывает отслеживать изменения

Returns:

true - отслеживание включенно

setTrackChanges

public void setTrackChanges(boolean track)

Указывает отслеживать изменения

Parameters:

track - true - Отслеживать

getScn

public long getScn()

Возвращает еткущий номер изенений

Returns:

текущий номер изменений

nextScn

protected long nextScn()

Указывает текущий номер изменений

Returns:

текущий номер изменений

getColumns

public DataColumn[] getColumns()

Возвращает массив колонок

Returns:

колонки таблицы

getColumnsCount

public int getColumnsCount()

Возвращает кол-во колонок в таблице

Returns:

кол-во колонок

getColumn

public DataColumn getColumn(int cidx)

Возвращает колонку по ее индексу

Parameters:

cidx - индекс

Returns:

колонка

addColumn

public void addColumn(DataColumn dc)

Добавляет колонку к таблице

Parameters:

dc - колонка

removeColumn

public void removeColumn(DataColumn dc)

Удаляет колонку из таблицы

Parameters:

dc - колонка

removeColumnByIndex

public void removeColumnByIndex(int colIdx)

Удаляет колонку по ее индексу

Parameters:

colIdx - индекс колонки

dropColumns

public void dropColumns()

Удаляет все колонки

getRowsCount

public int getRowsCount()

Возвращает кол-во строк в рабочем наборе

Returns:

кол-во строк в рабочем наборе

getRow

public DataRow getRow(int row)

Возвращает строку по индексу из рабочего набора

Parameters:

row - индекс строки

Returns:

строка

indexOf

public int indexOf(DataRow mrow)

Возвращает индекст строки в таблице

Parameters:

mrow - строка

Returns:

индекс или -1

getRowsIterator

public Iterator<DataRow> getRowsIterator()

Итератор по рабочему набору строк

Returns:

итератор

getRowsIterable

public Iterable<DataRow> getRowsIterable()

Итератор по рабочему набору строк

Returns:

итератор

getRowsIterable

public Iterable<DataRow> getRowsIterable(DataRowState... states)

Итератор по строкам

Parameters:

states - Указывает по строкам с каким состоянием производить поиск

Returns:

Итератор

rowsList

public List<DataRow> rowsList(DataRowState... states)

Возвращает строки ввиде списка

Parameters:

states - строки с указаным состоянием будут возвращены

Returns:

состояние строк

getRowsIterableAll

public Iterable<DataRow> getRowsIterableAll()

Возвращает все строки включая удаленные

Returns:

строки

fixed

public void fixed()

Зафиксировать все строки.
Строки отмесенные как удаленные, удаляются из этой таблицы. Строки отмеченные как добавленные, переводятся в статус обычных. Строки отмеченные как измененные - переводятся в статус обычных с текущим состоянием данных.

fixed

public void fixed(DataRow row)

Фиксация изменений

Parameters:

row - Строка которую требуется зафиксировать

fixed

public void fixed(DataRow row,
                  boolean addEvents)

Фиксация изменений

Parameters:

row - Строка которую требуется зафиксировать

addEvents - true - добавить события в очередь

rollback

public void rollback()

Откат изменений таблицы

rollback

public void rollback(boolean addEvents)

Откат изменений таблицы

Parameters:

addEvents - Добавлять события в очередь

rollback

public void rollback(DataRow row)

Откат изменений строки

Parameters:

row - Строка

rollback

public void rollback(DataRow row,
                     boolean addEvents)

Откат изменений строки

Parameters:

row - Строка

addEvents - Добавлять события в очередь

drop

public void drop()

Удаление всех данны, включая изменения и удаление структуры

isDeleted

public boolean isDeleted(DataRow row)

Возвращает true если строка отмечена как удаленная

Parameters:

row - строка

Returns:

true - отмечена под удаление

isInserted

public boolean isInserted(DataRow row)

Возвращает true если строка отмечена как новая (inserted)

Parameters:

row - стока

Returns:

true - строка добавлена но не фиксирована

isUpdated

public boolean isUpdated(DataRow row)

Возвращает true если строка быда обновлена, но не фиксированна

Parameters:

row - строка

Returns:

true - строка была обновлена, но не фиксированна

stateOf

public DataRowState stateOf(DataRow row)

Возвращает состояние строки

Parameters:

row - строка

Returns:

состояние строки

insert

public DataTableInserting insert(Object... values)

Производит вставку строки

Parameters:

values - значния

Returns:

интерфейс вставки

insert

public void insert(DataRow row)

Производит вставку строки

Parameters:

row - строка

delete

public void delete(DataRow row)

Удаляет строку

Parameters:

row - строка