/// <summary>
/// Initialize LiteEngine using initial engine settings
/// </summary>
public LiteEngine(EngineSettings settings)
{
_settings = settings ?? throw new ArgumentNullException(nameof(settings));
// clear checkpoint if database is readonly
if (_settings.ReadOnly)
{
_settings.Checkpoint = 0;
}
LOG($"start initializing{(_settings.ReadOnly ? " (readonly)" : "")}", "ENGINE");
try
{
// initialize locker service (no dependency)
_locker = new LockService(settings.Timeout, settings.ReadOnly);
// initialize disk service (will create database if needed)
_disk = new DiskService(settings);
// read page with no cache ref (has a own PageBuffer) - do not Release() support
var buffer = _disk.ReadFull(FileOrigin.Data).First();
// if first byte are 1 this datafile are encrypted but has do defined password to open
if (buffer[0] == 1)
{
throw new LiteException(0, "This data file is encrypted and needs a password to open");
}
_header = new HeaderPage(buffer);
// initialize wal-index service
_walIndex = new WalIndexService(_disk, _locker);
// if exists log file, restore wal index references (can update full _header instance)
if (_disk.GetLength(FileOrigin.Log) > 0)
{
_walIndex.RestoreIndex(ref _header);
}
// initialize sort temp disk
_sortDisk = new SortDisk(settings.CreateTempFactory(), CONTAINER_SORT_SIZE, settings.UtcDate);
// initialize transaction monitor as last service
_monitor = new TransactionMonitor(_header, _locker, _disk, _walIndex, _settings);
// register system collections
this.InitializeSystemCollections();
LOG("initialization completed", "ENGINE");
}
catch (Exception ex)
{
LOG(ex.Message, "ERROR");
// explicit dispose (but do not run shutdown operation)
this.Dispose(true);
throw;
}
}
/// <summary>
/// Initialize LiteEngine using initial engine settings
/// </summary>
public LiteEngine(EngineSettings settings)
{
_settings = settings ?? throw new ArgumentNullException(nameof(settings));
LOG($"start initializing{(_settings.ReadOnly ? " (readonly)" : "")}", "ENGINE");
try
{
// initialize disk service (will create database if needed)
_disk = new DiskService(settings, MEMORY_SEGMENT_SIZES);
// get header page from disk service
_header = _disk.Header;
// test for same collation
if (settings.Collation != null && settings.Collation.ToString() != _header.Pragmas.Collation.ToString())
{
throw new LiteException(0, $"Datafile collation '{_header.Pragmas.Collation}' is different from engine settings. Use Rebuild database to change collation.");
}
// initialize locker service
_locker = new LockService(_header.Pragmas);
// initialize wal-index service
_walIndex = new WalIndexService(_disk, _locker);
// restore wal index references, if exists
_walIndex.RestoreIndex(_header);
// initialize sort temp disk
_sortDisk = new SortDisk(settings.CreateTempFactory(), CONTAINER_SORT_SIZE, _header.Pragmas);
// initialize transaction monitor as last service
_monitor = new TransactionMonitor(_header, _settings, _locker, _disk, _walIndex);
// register system collections
this.InitializeSystemCollections();
LOG("initialization completed", "ENGINE");
}
catch (Exception ex)
{
LOG(ex.Message, "ERROR");
// explicit dispose (but do not run shutdown operation)
this.Dispose(true);
throw;
}
}
/// <summary>
/// Initialize database
/// </summary>
public async Task OpenAsync()
{
LOG("start initializing", "ENGINE");
try
{
// open async stream
if (_stream is IAsyncInitialize s)
{
await s.InitializeAsync();
}
// initialize disk service (will create database if needed)
_disk = await DiskService.CreateAsync(_stream, _collation, MEMORY_SEGMENT_SIZES, MAX_EXTENDS);
// get header page from disk service
_header = _disk.Header;
// test for same collation
if (_collation.ToString() != _header.Pragmas.Collation.ToString())
{
throw new LiteException(0, $"Datafile collation '{_header.Pragmas.Collation}' is different from engine settings. Use Rebuild database to change collation.");
}
// initialize wal-index service
_walIndex = new WalIndexService(_disk);
// restore wal index references, if exists
await _walIndex.RestoreIndex(_header);
// register system collections
// this.InitializeSystemCollections();
_disposed = false;
LOG("initialization completed", "ENGINE");
}
catch (Exception ex)
{
LOG(ex.Message, "ERROR");
// explicit dispose (but do not run shutdown operation)
await this.DisposeAsync();
throw;
}
}
