Logged out, click to login

JEDI Online help - Details

Back to unit JvAppStorage.pas Back Edit Search Administration


Abstract base class for application data storage.

TJvCustomAppStorage is the abstract base class for application storage. The base class provides the abstract interface to read and write data in addition to some generic methods to manipulate or retrieve data.<br> <br> The application storage components are used with various components in the JEDI-VCL library to provide a means to store their data to a user specified destination. Because all storages use this component interface, other components don't need to worry about how their information is stored or where it is stored.<br> <br> Data is referenced much like a file on an Operating \System. The storage system uses paths and uses the concept of folders and values (much like folders and files on an OS). The storage component can specify a root path that is to serve as the absolute root of the storage (i.e. the storage can not reference anything that is not a child of this root path).<br> Components and user code can specify paths that are either relative to a <LINK<br> TJvCustomAppStorage.Path, previously set path> or relative to the root folder.<br> <br> Folder names consisting solely of '.' (dot) characters are used to reference folders above the current one. Using one dot refers to the current folder. Every additional dot goes up one level in the storage tree. Example: if the current path is set to 'MyFolder1\MyFolder1.1\MyFolder1.1.1', a path specified as '..\MyFolder1.1.2' would translate into 'MyFolder1\MyFolder1.1\MyFolder1.1.2' and a path specified as '...\MyFolder1.2\MyFolder1.2.1' or '..\..\MyFolder1.2\MyFolder1.2.1' would translate into 'MyFolder1\MyFolder1.2\MyFolder1.2.1'.<br> <br> In addition you can link other storages into the storage tree, where each sub storage would be accessible through a specific path. This allows one to use a single storage to access both generic settings (common for the machine the application runs on, e.g. a registry backend pointing to<br> HKEY_LOCAL_MACHINE) and user settings (unique for each user, e.g. an INI file backend pointing to an<br> INI file in the current users home directory), making the access to the settings easier to use. Not all storages may surface this linking mechanism, but most do.<br> <br> You should not instantiate a TJvCustomAppStorage but rather one of its descendants.<br>

Last changed by obones on 2009-01-04 20:48:22 CET

Copyright (c) 2004 by the JVCL Team; all rights reserved
Uses PclZip by phpconcept and parts of the PEAR library