|
Расширение набора стандартных функций
и классов Borland Delphi
Описание библиотеки AcedUtils для Borland
Delphi на платформе Win32
Страницы
| 1
| 2 |
3
|
Несколько пользователей могут одновременно читать данные из одного файла
методом LoadFile. Однако, если кто-либо открыл файл методом OpenFile,
другие пользователи не могут открыть этот файл для чтения или для
записи, пока он не будет закрыт методом CloseFile. При отказе в открытии
файла на экране появляется сообщение для пользователя с предложением
подождать или повторить попытку открытия файла. Кроме того, пользователь
может отменить текущую операцию, в результате чего методы LoadFile,
OpenFile и SaveFileDirect вернут значение False. При успешном открытии
файла эти методы возвращают True.
В первых четырех байтах файла данных хранится его версия – число,
которое изменяется при каждом сохранении данных на диске. Если основной
набор данных коллекции не менялся с момента ее загрузки в память или с
момента предыдущего сохранения на диске (свойство Changed коллекции
равно False), и при вызове метода LoadFile оказывается, что версия файла
данных не изменилась за это время, то фактического считывания данных не
происходит, так как в этом нет необходимости. То же самое происходит при
открытии файла методом OpenFile. Это позволяет уменьшить нагрузку на
файловый сервер, сократить объем информации, передаваемой по сети, и в
целом повысить производительность приложения.
Индексы для коллекции
В коллекции TSerializableCollection элементы упорядочены по возрастанию
значения уникального идентификатора элемента. Такой порядок не всегда
удобен. Например, конечному пользователю обычно нужен список,
отсортированный по именам или по датам и т.п. С этой целью при создании
коллекции в конструктор класса TSerializableCollection передается
массив, содержащий так называемые индексы – объекты, задающие
альтернативный порядок сортировки элементов коллекции. Индексы должны
быть созданы заранее, до вызова конструктора коллекции. Все индексы
представляются экземплярами классов, производных от TDataIndex.
Конкретный класс выбирается в зависимости от типа признака, по которому
сортируются данные. Если этот признак – строка (например, наименование
объекта), создается индекс типа TStringIndex; если признак – дата,
используется класс TDateTimeIndex и т.д. Есть еще специальный класс
TCompoundIndex, предназначенный для сортировки элементов коллекции сразу
по нескольким признакам.
Индексы предназначены не только для задания порядка элементов коллекции.
Основной причиной использования индексов является необходимость быстрого
поиска элементов по значению индексируемого признака. Индексы позволяют
не только быстро находить отдельные элементы, но также выделять группы
элементов, для которых значение признака лежит в определенном интервале.
Кроме того, индексы могут быть уникальными, т.е. не допускающими
дублирования значения признака. При добавлении и изменении элементов
коллекция опрашивает все свои уникальные индексы на предмет того, не
вызовет ли каждое конкретное изменение нарушения уникальности
какого-либо индекса. Если такая ситуация имеет место, предполагаемые
изменения отклоняются.
Изначально все индексы находятся в неактивном состоянии, т.е. не
занимают память и не обновляются при каждом изменении коллекции. При
попытке воспользоваться индексом, например, для поиска элемента, индекс
автоматически активизируется. Его состоянием можно управлять с помощью
свойства Active, объявленного в классе TDataIndex. Следует обратить
внимание на то, что в часто изменяемых коллекциях лучше постоянно
держать все уникальные индексы в активном состоянии. В противном случае,
при любом изменении данных выполняется медленный последовательный
перебор элементов коллекции индексом для выяснения того, что значение
индексируемого признака измененного элемента уникально в пределах набора
данных.
Каждый активный индекс содержит полный набор элементов коллекции,
отсортированный по значению соответствующего признака. Свойство
Descending индекса по умолчанию равно False. Это означает, что элементы
сортируются по возрастанию значения признака. Если свойство Descending
равно True, элементы сортируются по убыванию значения признака. Для
класса TStringIndex, если свойство CaseSensitive равно False, при
сортировке и поиске элементов с помощью индекса регистр символов не
принимается во внимание. Если это свойство равно True, регистр символов
учитывается. К элементам сортированного списка можно обратиться через
свойство ItemList индекса, которое возвращает массив указателей на
элементы коллекции – экземпляры класса TSerializableObject. Число
элементов в этом массиве определяется свойством Count основной
коллекции, к которой можно обратиться через свойство Owner индекса.
Свойство Unique определяет, является ли данный индекс уникальным.
Значение этого свойства передается в конструктор класса индекса и в
дальнейшем не может быть изменено. Кроме того, при создании индекса в
его конструктор обычно передается адрес функции, которая возвращает
значение индексируемого признака для элемента коллекции. В случае класса
TCompoundIndex вместо этого передается адрес функции, которая сравнивает
между собой два элемента коллекции.
В каждом индексе есть методы для поиска элементов. Метод ScanPointer
выполняет линейный поиск указателя во внутреннем массиве индекса. Этим
методом стоит пользоваться только если никакие другие не подходят. Метод
Contains возвращает True, если в коллекции присутствует элемент с
указанным значением признака. Функция IndexOf находит во внутреннем
массиве первый элемент с определенным значением признака и возвращает
его индекс в качестве результата, а функция SearchObject в аналогичной
ситуации возвращает сам элемент. Во всех индексах, кроме TCompoundIndex,
есть функции SelectRange для нахождения диапазона во внутреннем массиве,
в котором значение признака больше или равно значению Key1 и меньше
значения Key2. При сортировке элементов по убыванию эти функции выделяют
диапазон, в котором значение признака меньше или равно значению Key1 и
больше значения Key2. Имеется также вариант этой функции, которая
возвращает индекс первого элемента массива, для которого индексируемый
признак больше или равен (меньше или равен в случае, когда Descending
равно True) указанному значению. В классе TStringIndex есть еще метод
StartsWith для выделения диапазона во внутреннем массиве, где значение
признака для всех элементов начинается с указанной подстроки с учетом
или без учета регистра символов в зависимости от значения свойства
CaseSensitive.
Модуль AcedExcelReport
Предназначен для генерации отчетов с помощью пакета Microsoft Excel.
Отчеты создаются на основе XLT-шаблонов или как новые рабочие книги. При
построении отчетов, кроме AcedExcelReport, используются модули: Variants,
ActiveX, ComObj и, главное, Excel97, содержащий данные библиотеки типов
Microsoft Excel. Версии этой библиотеки для Office 2000 и Office XP мало
чем отличаются от Excel 97 с точки зрения возможностей, используемых при
генерации отчетов. Однако, при подключении к программе модулей Excel2000
и ExcelXP нарушается совместимость со старой версией Microsoft Excel 97.
При построении отчетов в Excel через COM-интерфейсы особое внимание
следует уделить сокращению числа обращений к серверу, особенно через
интерфейс IDispatch. Например, вместо того, чтобы последовательно
заполнять данными отдельные ячейки прямоугольной области рабочего листа,
гораздо эффективнее создать в памяти вариантный массив, заполнить его, и
передать в Excel сразу все значения ячеек прямоугольной области.
Построение отчета обычно начинается с подготовки данных, которые нужно
представить в виде таблицы. При этом могут создаваться временные списки
типа TArrayList для группирования, сортировки данных и т.п. Затем, когда
уже известно количество элементов в каждой области отчета, создаются
массивы типа Variant вызовом функции VarArrayCreate из модуля Variants.
В эту функцию передаются диапазоны индексов создаваемого массива и тип
элементов массива, который может быть равен varVariant, если в массив
помещаются данные различного типа. При создании вариантного массива для
последующего проецирования его на рабочий лист Microsoft Excel надо
учитывать, что первый индекс в этом массиве задает строку, а второй –
столбец рабочего листа. После создания массива он заполняется данными,
которые нужно показать в отчете. Все значения типа Currency должны быть
преобразованы к типу Double функцией G_CurrencyToDouble из модуля
AcedCommon перед помещением их в вариантный массив или в ячейку рабочего
листа. Для подсчета итоговых сумм лучше использовать функции рабочего
листа, а не вычислять эти суммы в процессе группирования данных и не
помещать их в отчет в виде готовых чисел.
Следующим этапом после подготовки данных и заполнения вариантных
массивов является запуск приложения Microsoft Excel и создание рабочей
книги. Для запуска Microsoft Excel вызывается функция StartExcel из
модуля AcedExcelReport. Если на компьютере пользователя Microsoft Excel
не установлен, на экране появляется соответствующее сообщение для
пользователя и функция возвращает False. В случае успеха она возвращает
True. Если Excel уже запущен, функция StartExcel ничего не делает,
просто возвращает True. Для создания новой рабочей книги вызывается
функция CreateExcelWorkbook. В нее как var-параметр передается
переменная типа Excel97._Workbook, в которой затем сохраняется ссылка на
созданный экземпляр рабочей книги. Один из вариантов функции
CreateExcelWorkbook создает пустую рабочую книгу с заданным числом
листов. Другой вариант этой функции создает рабочую книгу на основе
указанного XLT-шаблона. В случае успеха эта функция возвращает True, а
если в процессе создания рабочей книги произошло исключение, оно
перехватывается и функция возвращает False. После этого настраивается
внешний вид рабочей книги. Это делается вызовом процедуры
InitializeExcelWorkbook. При этом можно определить заголовок окна, в
котором показывается отчет, а также указать на необходимость или
отсутствие необходимости отображения ярлычков листов рабочей книги,
нулевых значений на листе, заголовков строк и столбцов (A, B, C…1, 2,
3…), линий сетки, горизонтальной и вертикальной полосы прокрутки
рабочего листа.
Получить ссылку на первый лист рабочей книги можно следующим образом: (WB.Worksheets[1]
as _Worksheet), где WB – ссылка на рабочую книгу. Диапазон всех ячеек
рабочего листа возвращается функцией Get_Cells, вызванной для экземпляра
класса _Worksheet. Ссылку на этот диапазон лучше сразу сохранить в
отдельной переменной, чтобы впоследствии передавать ее в качестве
параметра в различные функций из модуля AcedExcelReport. Следует
обратить внимание на то, что по умолчанию нумерация строк и столбцов на
рабочем листе начинается с единицы. Если предпочтительно использовать
нумерацию с нуля, можно установить в единицу глобальные переменные
ExcelRowOffset и ExcelColumnOffset, объявленные в модуле AcedExcelReport.
Значения этих переменных прибавляются, соответственно, к номеру строки и
номеру столбца при вызове любой функции из AcedExcelReport, в которую
передается номер строки и/или номер столбца. Переменные ExcelRowOffset и
ExcelColumnOffset позволяют произвольным образом задать начало отсчета
на рабочем листе. Например, если таблица данных начинается с ячейки B5,
можно присвоить ExcelRowOffset значение 5, а ExcelColumnOffset значение
2 и при обращении к ячейкам таблицы данных использовать индексацию с
нуля. Эти переменные обнуляются при вызове процедуры
InitializeExcelWorkbook.
Обратиться к запущенному экземпляру приложения Microsoft Excel можно
через глобальную переменную ExcelApp, объявленную в модуле
AcedExcelReport. Для завершения работы приложения Microsoft Excel и
выгрузки его из памяти предназначена процедура ShutdownExcel. Обычно ее
не нужно вызывать из прикладной программы, т.к. ShutdownExcel вызывается
из раздела finalization модуля AcedExcelReport.
Классы TExcelRange, TExcelInterval
Эти классы используются для группирования ячеек рабочего листа.
Экземпляр класса TExcelInterval представляет собой прямоугольный
диапазон ячеек, экземпляр TExcelRange – коллекцию прямоугольных
диапазонов. Когда экземпляр класса TExcelRange проецируется на рабочий
лист, вся коллекция диапазонов может быть представлена одним объектом
типа Excel97.ExcelRange. Таким образом можно применять различные
операции, например, заливку фона ячеек или прорисовку границ, ко всему
диапазону сразу, даже если он содержит несмежные ячейки. В модуле
AcedExcelReport коллекция интервалов TExcelRange используется, кроме
того, для получения текстовой ссылки на диапазон ячеек, которая
передается в качестве аргумента для функций рабочего листа, типа "СУММ"
или "СЧЁТ".
При создании интервала, т.е. экземпляра класса TExcelInterval, в его
конструктор передается номер столбца, строки и, возможно, число строк и
столбцов в интервале. Если число строк и столбцов не указано, создается
интервал, состоящий из одной ячейки. Кроме того, можно создать интервал,
который представляет все ячейки одной или нескольких строк или все
ячейки одного или нескольких столбцов рабочего листа. Чтобы
спроецировать интервал на рабочий лист, т.е. получить объект типа
Excel97.ExcelRange, нужно вызвать функцию GetRange. Для того, чтобы
проверить равенство двух интервалов, используется функция Equals. Метод
Clone возвращает экземпляр класса, представляющий копию интервала. В
классе TExcelInterval имеются свойства, возвращающие номер первой и
последней строк интервала, а также номера первого и последнего столбцов.
Экземпляр класса TExcelRange создается в виде пустой коллекции. Но в его
конструктор можно передать данные первого интервала, который сразу будет
добавлен в коллекцию. Кроме того, коллекция интервалов может быть
создана на основе другого экземпляра TExcelRange. В этом случае в нее
добавляются копии всех интервалов исходной коллекции. Новые интервалы
добавляются в коллекцию методами Add, AddRows, AddColumns. Чтобы
полностью очистить коллекцию и освободить память, занимаемую каждым
интервалом, используется метод Clear. К отдельным интервалам в составе
коллекции можно обратиться через свойство Intervals. Число интервалов
возвращается свойством IntervalCount. Метод Equals сравнивает коллекцию
с другой коллекцией интервалов. Если две коллекции содержат одни и те же
(равные) интервалы, метод возвращает True, если есть какие-либо
различия, возвращается False. Метод Clone возвращает копию коллекции,
содержащую копии каждого интервала. Для удобства использования интервалы
могут быть отсортированы методом EnsureSorted коллекции. Сортировка
выполняется по строкам, а затем по столбцам левой верхней ячейки
интервала.
Чтобы получить объект типа Excel97.ExcelRange представляющий коллекцию
интервалов TExcelRange, надо вызвать функцию GetRange этого класса.
Методы GetAbsoluteAddress и GetRelativeAddress класса TExcelRange
возвращают текстовую строку, содержащую ссылку на все ячейки коллекции
интервалов. Первый метод отличается от второго тем, что он возвращает
абсолютную ссылку, т.е., например, строку "R1C1:R2C5;R6:R8". Второй
метод возвращает строку, содержащую ссылку относительно указанной
ячейки. Например, для той же коллекции интервалов ссылка относительно
ячейки R2C5 представляется строкой: "R[-1]C[-4]:RC;R[4]:R[6]".
Функции для построения отчета
В модуле AcedExcelReport определены глобальные функции, часто
используемые при построении отчетов. Для выполнения других действий
можно обращаться к объектам Microsoft Excel через интерфейсы,
объявленные в модуле Excel97, сгенерированном из библиотеки типов. В
AcedExcelReport есть несколько функций, возвращающих ссылку на диапазон
ячеек рабочего листа, т.е. объект типа Excel97.ExcelRange. В частности,
функция GetExcelCell возвращает ячейку рабочего листа, находящуюся на
пересечении заданной строки и столбца; функция GetExcelRange возвращает
прямоугольный диапазон ячеек. Функция GetNamedExcelRange возвращает
именованный диапазон ячеек. Функции GetExcelRows и GetExcelColumns
возвращают диапазоны, состоящие из всех ячеек определенных строк или
столбцов. Чтобы установить значение ячейки или поставить вариантный
массив в соответствие ячейкам прямоугольного диапазона, нужно получить
ссылку на диапазон функциями GetExcelCell или GetExcelRange, а затем
присвоить соответствующее значение свойству Value этого диапазона. То же
самое касается, например, изменения шрифта текста с помощью свойства
Font диапазона ячеек, задания режима горизонтального/вертикального
выравнивания текста с помощью свойств: HorizontalAlignment,
VerticalAlignment, задания режима переноса текста свойством WrapText, а
также объединения ячеек рабочего листа вызовом метода Merge диапазона
ячеек.
Функция InsertExcelRows предназначена для вставки на рабочем листе одной
или нескольких строк перед указанной строкой. Функция InserExceltColumns
вставляет один или несколько столбцов перед указанным столбцом.
Процедуры AssignAbsoluteFormula и AssignRelativeFormula используются для
назначения ячейкам рабочего листа формул, реализующих групповые
операции, такие как суммирование данных, нахождение максимального
значения в диапазоне, подсчет числа непустых ячеек и т.д. При записи
формулы адрес обрабатываемого диапазона ячеек указывается в виде
абсолютной ссылки (процедурой AssignAbsoluteFormula) или в виде
относительной ссылки (процедурой AssignRelativeFormula). Строку,
содержащую абсолютную ссылку на прямоугольный диапазон ячеек, можно
получить вызовом функции GetAbsoluteAddress. Аналогичную строку,
содержащую относительную ссылку на диапазон ячеек, возвращает функция
GetRelativeAddress.
Для форматирования границ ячеек вызывается процедура DrawExcelBorders. В
нее передается диапазон ячеек в виде объекта Excel97.ExcelRange. Второй
параметр (CellBorders) выбирает, какие именно границы ячеек должны
отображаться. Здесь передается одна из констант xlcb… или комбинация
таких констант. Остальные параметры процедуры DrawExcelBorders задают
толщину, стиль и цвет линий. Чтобы, наоборот, удалить прорисовку границ
используется процедура ClearExcelBorders. Для применения заливки к
диапазону ячеек рабочего листа вызывается процедура FillExcelInterior.
Кроме ссылки на диапазон ячеек в нее передается цвет заливки (одна из
констант xlColor…), шаблон, накладываемый поверх заливки (одна из
констант xlPattern, объявленных в модуле Excel97) и цвет линий шаблона.
После того, как содержимое отчета полностью подготовлено, можно
воспользоваться процедурами FreezeExcelRows и FreezeExcelColumns, чтобы
облегчить просмотр данных. Эти процедуры задают, соответственно, строки
и столбцы, которые не должны перемещаться при прокрутке окна рабочей
книги. Иногда бывает удобно выделить шапку таблицы, чтобы она всегда
была на экране независимо от длины таблицы. Если предполагается, что
пользователь не будет изменять готовый отчет, можно вызвать процедуру
ProtectExcelWorksheet для защиты рабочего листа от случайных изменений.
Если просматривать отчет удобнее в режиме панорамирования, можно
воспользоваться процедурой G_ToggleKey из модуля AcedCommon для
включения режима Scroll Lock клавиатуры. После выполнения всех
подготовительных действий вызывается процедура ShowExcelWorkbook, в
которую передается ссылка на рабочую книгу, полученная ранее при вызове
функции CreateExcelWorkbook. Процедура ShowExcelWorkbook отображает
рабочую книгу на экране и устанавливает ее свойство Saved в значение
True, чтобы при закрытии книги не спрашивалось, нужно ли сохранять
изменения.
Описание демонстрационного проекта
Кроме исходного кода модулей библиотека AcedUtils включает пример,
реализующий полноценное приложение для работы с данными на основе
коллекций из модуля AcedStorage. Пример включает несколько отчетов,
которые строятся с помощью функций из модуля AcedExcelReport. Рассмотрим
подробнее задачу, решаемую этим приложением, и некоторые особенности
реализации хранилища данных на основе файлового сервера.
Программа предназначена для учета товаров, поступающих от различных
поставщиков. Товары классифицируются по категориям. Основные типы и
наборы данных, используемые приложением, описываются в модуле DataTypes,
являющемся аналогом модуля данных. Структура базы данных состоит из трех
таблиц: поставщики товаров (коллекция Suppliers), категории товаров
(коллекция Categories) и сами товары (коллекция Products). Каждая из
этих сущностей описывается классом, производным от класса
TSerializableObject из модуля AcedStorage. Атрибуты сущностей, т.е. поля
таблиц базы данных, представляются свойствами этих классов. Обычно
каждому такому свойству соответствует private-поле в классе объекта,
используемое для хранения значения этого свойства. Кроме того, в модуле
DataTypes имеется класс TPictureObject, предназначенный для сохранения в
бинарном потоке и чтения из потока данных объекта типа TPicture. Этот
класс используется для хранения изображения, ассоциированного с
категорией товаров, которая представляется классом TCategoryObject.
Класс TSupplierObject описывает поставщика товара. Он включает свойства:
ID – уникальный идентификатор записи (наследуется от класса
TSerializableObject); CompanyName – наименование поставщика; Country –
страна поставщика; CityRegion – строка с названием города и, возможно,
области; Address – адрес поставщика; PostalCode – почтовый индекс;
PhoneFax – номера телефонов и факсов; HttpEmail – адреса электронной
почты и web-сайта поставщика; ContactPerson – представитель поставщика,
с которым поддерживается контакт; Comments – дополнительная информация о
поставщике. Как и во всяком классе, производном от TSerializableObject,
в классе TSupplierObject перекрываются методы: Load, Save, Equals, Clone
базового класса. В частности, в методе Load выполняется чтение состояния
объекта из бинарного потока. Значения всех полей, в том числе FID,
унаследованного из TSerializableObject, считываются методами класса
TBinaryReader. Метод Save помещает соответствующие данные в бинарный
поток, представляемый классом TBinaryWriter. На примере класса
TSupplierObject демонстрируется один из приемов оптимального
использования пространства в бинарном потоке. Вместо того, чтобы
сохранять все подряд значения полей, в методе Save создается переменная
Flags, содержащая битовую карту используемых полей, т.е. полей, значения
которых отличны от значений по умолчанию. Эта битовая карта помещается в
бинарный поток в виде однобайтного значения. Затем в потоке сохраняются
значения только тех полей, которые помечены как используемые. В методе
Load сначала считывается битовая карта, а затем значения полей, которые
помечены в ней единичными битами. В методе Equals класса TSupplierObject
выполняется сравнение значений каждого из полей объекта с
соответствующими полями другого экземпляра того же класса. Если все поля
обоих экземпляров равны, функция возвращает True, в противном случае –
False. Метод Clone создает новый экземпляр класса TSupplierObject и
копирует в него значения всех полей данного объекта, включая поле FID,
унаследованное от класса-предка.
Класс TCategoryObject предназначен для описания категории товара. Он
содержит наименование категории (свойство CategoryName), комментарий
(свойство Comments) и рисунок, иллюстрирующий данную категорию (свойство
Picture). Кроме того, класс TCategoryName включает свойство ID,
унаследованное от класса-предка TSerializableObject. Аналогично
TSupplierObject, в данном классе перекрываются методы Load, Save, Equals
и Clone базового класса. Кроме того, перекрывается виртуальный
конструктор Create для создания объекта типа TPictureObject,
представляющего рисунок, и метод Destroy для освобождения этого объекта.
Следует обратить внимание на то, как в этом классе сохраняется и
считывается значение уникального идентификатора записи – поля FID
базового класса TSerializableObject. Предполагается, что число возможных
категорий товара не превышает 255, поэтому идентификатор записи хранится
в виде байта, а не значения типа Integer. При этом сама коллекция
категорий товаров представляется экземпляром класса
TBytePrimaryKeyCollection.
Класс TProductObject содержит свойства, используемые при описания
товара: ID – уникальный идентификатор записи; ProductName – наименование
товара; SupplierID – внешний ключ, содержащий ссылку на элемент
коллекции Suppliers, представляющий поставщика товара; CategoryID –
внешний ключ, содержащий ссылку на элемент коллекции Categories,
представляющий категорию товара; QuantityPerUnit – строка, описывающая
единицу измерения товара; UnitPrice – цена единицы товара; UnitsInStock
– количество товара на складе; UnitsOnOrder – ожидаемое количество
товара; Discontinued – признак того, что поставки товара прекращены;
Little – признак того, что на складе осталось мало соответствующего
товара. На примере класса TProductObject демонстрируется работа с
версиями объектов. Предполагается, что в первоначальной версии данного
класса отсутствовало свойство Little, оно было добавлено во второй
версии. Сохраняемая версия элементов коллекции определяется параметром
Version при вызове конструктора класса данной коллекции. Так, при вызове
конструктора для коллекции Products во втором параметре передается
значение 2. В методе Load класса TProductObject проверяется значение
параметра Version. Если версия равна 1, данные сохранены в исходном
формате, т.е. без поля FLittle. Если сохраненная версия данных равна 2,
в бинарном потоке присутствует значение поля FLittle, которое должно
быть прочитано методом ReadBoolean класса TBinaryReader.
Класс TPictureObject, используемый для хранения рисунка, иллюстрирующего
категорию товара, может сам по себе найти применение во многих
приложениях. Он позволяет сохранять в бинарном потоке растровый рисунок
(TBitmap), метафайл (TMetafile) или иконку (TIcon), которые
представляются классом TPicture из модуля Graphics. Причем, данные
изображения постоянно находятся в упакованном виде и распаковываются
только, когда нужно загрузить изображение в объект TPicture. Метод Load
класса TPictureObject считывает изображение из объекта TPicture,
бинарного потока, представленного классом TBinaryReader, или другого
экземпляра класса TPictureObject. Метод Save сохраняет изображение в
потоке. Метод Assign загружает рисунок в объект TPicture. Функция Equals
возвращает True, если данный экземпляр класса TPictureObject, содержит
то же самое изображение, что и экземпляр, переданный в функцию как
параметр. Свойства IsBitmap, IsMetafile, IsIcon класса TPictureObject
позволяют проверить тип изображения, представленного объектом. Свойство
Bytes возвращает указатель на массив байт, содержащий упакованное
изображение. Свойство Length – длину этого массива в байтах.
Коллекции Suppliers, Categories, Products создаются процедурой
CreateCollections в модуле DataTypes, которая вызывается из раздела
инициализации этого модуля. Перед созданием каждой из коллекций
создаются индексы, предназначенные для упорядочивания элементов
коллекций по какому-либо признаку. Так, поставщики сортируются по
значению свойства CompanyName, т.е. по наименованию поставщика, список
категорий – по наименованию категории, товары – по наименованию товара,
идентификатору поставщика и идентификатору категории. Индексы по
наименованиям являются уникальными, что обеспечивает отсутствие в
коллекциях элементов с дублирующимися наименованиями. Индексы по внешним
ключам в коллекции товаров используются для проверки наличия подчиненных
записей в таблице товаров при попытке удаления записи из главной таблицы
– коллекции поставщиков или коллекции категорий товаров. Так как
количество поставщиков может быть большим, для коллекции Suppliers
включается режим хеширования элементов по значению уникального
идентификатора (свойство MaintainHash устанавливается в True).
Уничтожаются коллекции процедурой FreeCollections, вызываемой из раздела
finalization модуля DataTypes.
Для удобства загрузки и сохранения коллекций в модуле DataTypes
определены глобальные функции, такие как LoadSuppliers, LoadProducts,
SaveSuppliers и т.п., предназначенные для работы с данными в режиме
многопользовательского доступа. Функция LoadSuppliers и аналогичные ей
функции для загрузки коллекций Categories и Products просто вызывают
метод LoadFile соответствующей коллекции и передают в него имя файла
данных и, в случае коллекции поставщиков, пароль для дешифрования файла
данных. Функции для сохранения изменений в файле реализуют более сложный
алгоритм. Рассмотрим его на примере функции SaveSuppliers, используемой
для сохранения на диске коллекции поставщиков. В начале функции с
помощью свойства HasChanges проверяется наличие в памяти каких-либо
кэшированных изменений для коллекции Suppliers. Если изменений нет, то
отсутствует необходимость перезаписи файла данных. Если изменения есть,
соответствующий файл данных открывается методом OpenFile коллекции. При
этом указывается пароль, используемый для шифрования и дешифрования
данных коллекции, а также указывается константа dcmFast, включающая
режим быстрого сжатия данных для экономии места на диске и сокращения
объема информации, пересылаемой по сети. В случае невозможности открытия
файла данных (например, если этот файл открыт для записи другим
пользователем и его приложение почему-то зависло), кэш изменений очищает
и на экран выводится сообщение об ошибке. После того, как файл данных
успешно открыт и, при наличии в нем изменений, перечитан с диска, для
коллекции Suppliers вызывается метод ApplyChanges. Этот метод применяет
кэшированные изменения к набору данных коллекции. Если изменения
применены успешно, коллекция сохраняется на диске вызовом метода
SaveIfChanged. Если в процессе применения изменений возникли какие-либо
проблемы, данные коллекции перечитываются с диска методом UndoIfChanged,
а затем на экран выводится сообщение об ошибке. Метод UndoIfChanged
перечитывает данные с диска только в случае, если коллекция содержит
изменения, т.е. ее свойство Changed равно True. В конце работы файл
данных должен быть обязательно закрыт методом CloseFile коллекции. Для
большей надежности вызов метода CloseFile помещается в раздел finally
блока try-finally структурированной обработки исключений.
Рассмотрим, как выполняется добавление, изменение, удаление записей на
примере коллекции поставщиков. Корректировка списка поставщиков
производится с помощью формы TSuppliersForm, определенной в модуле
SuppliersUnit. При этом используется глобальная переменная
SupplierObject типа TSupplierObject, объявленная в модуле DataTypes.
Когда пользователь хочет добавить в список нового поставщика и нажимает
соответствующую кнопку, вызывается функция NewItem коллекции Suppliers,
создающая новый экземпляр класса TSupplierObject, который затем
присваивается глобальной переменной SupplierObject. Для ввода данных о
новом поставщике на экране отображается форма TSupplierForm из модуля
SupplierUnit. Эта форма позволяет пользователю скорректировать значения
свойств экземпляра класса TSupplierObject, назначенного переменной
SupplierObject. Когда пользователь заполнит все необходимые поля и
нажмет кнопку для сохранения изменений, выполняется предварительная
проверка введенных данных. Например, проверяется, что наименование
поставщика не является пустой строкой и что это наименование не
дублируется в списке. Позже, при сохранении данных, это привело бы к
ошибке, вызванной нарушением уникальности индекса, и откату всех
изменений. Такие ошибки удобнее выявлять на этапе предварительной
проверки, чтобы позволить пользователю исправить некорректно введенные
данные. Если предварительная проверка прошла успешно, форма ввода данных
закрывается, для коллекции Suppliers вызывается метод EndEdit,
сохраняющий информацию о добавлении записи в кэше изменений. Затем
вызывается рассмотренная выше глобальная функция SaveSuppliers из модуля
DataTypes для применения кэшированных изменений к набору данных и
сохранения коллекции на диске. Если пользователь отказался от сохранения
изменений закрытием по Escape формы ввода данных, вызывается метод
CancelEdit коллекции Suppliers для уничтожения объекта, присвоенного
переменной SupplierObject. Корректировка записи о поставщике отличается
от добавления нового поставщика только тем, что в начале вместо NewItem
вызывается функция BeginEdit коллекции поставщиков Suppliers, в которую
передается идентификатор редактируемого элемента коллекции.
Когда пользователь удаляет поставщика из коллекции Suppliers, на экране
сначала появляется окно для подтверждения удаления записи. Затем
открывается файл данных для коллекции товаров Products вызовом метода
OpenFile. Используя индекс по внешнему ключу SupplierID коллекции
Products, проверяется наличие в списке товаров элемента, ссылающегося на
удаляемого поставщика. Если такой товар присутствует в списке, поставщик
не может быть удален. Если на этого поставщика никто не ссылается, для
коллекции Suppliers вызывается метод Delete, в который передается
идентификатор удаляемого элемента. Затем вызывается функция
SaveSuppliers для фактического удаления записи из набора данных и
сохранения измененной коллекции на диске. Файл данных коллекции Products
закрывается только после сохранения всех изменений в коллекции Suppliers.
Это нужно, чтобы другой пользователь не мог в момент удаления поставщика
добавить товар, который на него ссылается. С этой же целью в момент
сохранения коллекции товаров Products вызовом глобальной функции
SaveProducts для каждого добавленного или измененного товара проверяется
наличие в коллекции Suppliers поставщика, идентификатор которого
назначен свойству SupplierID данного товара.
Заключение
В документе описана библиотека функций и классов AcedUtils, призванная
помочь разработчику на Borland Delphi в создании быстрых и экономичных с
точки зрения использования ресурсов памяти и дискового пространства
приложений, работающих на платформе Win32.
Страницы
| 1
| 2 |
3
|
Дата: 10.08.2005, Автор:
Андрей Дрязгов, Сайт:
http://acedutils.narod.ru.
|
Базы данных
