Isar class abstract

An instance of the Isar Database.

Properties

directory String?
The directory containing the database file or null on the web.
read-only
hashCode int
The hash code for this object.
read-onlyinherited
isOpen bool
Is the instance open?
read-only
name String
Name of the instance.
final
path String?
The full path of the database file is directory/name.isar and the lock file directory/name.isar.lock.
read-only
runtimeType Type
A representation of the runtime type of the object.
read-onlyinherited

Methods

clear() Future<void>
Remove all data in this instance and reset the auto increment values.
clearSync() → void
Remove all data in this instance and reset the auto increment values.
close({bool deleteFromDisk = false}) Future<bool>
Releases an Isar instance.
collection<T>() IsarCollection<T>
Get a collection by its type.
copyToFile(String targetPath) Future<void>
Copy a compacted version of the database to the specified file.
getSize({bool includeIndexes = false, bool includeLinks = false}) Future<int>
Returns the size of all the collections in bytes. Not supported on web.
getSizeSync({bool includeIndexes = false, bool includeLinks = false}) int
Returns the size of all collections in bytes. Not supported on web.
noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
toString() String
A string representation of this object.
inherited
txn<T>(Future<T> callback()) Future<T>
Executes an asynchronous read-only transaction.
txnSync<T>(T callback()) → T
Executes a synchronous read-only transaction.
verify() Future<void>
Verifies the integrity of the database file.
writeTxn<T>(Future<T> callback(), {bool silent = false}) Future<T>
Executes an asynchronous read-write transaction.
writeTxnSync<T>(T callback(), {bool silent = false}) → T
Executes a synchronous read-write transaction.

Operators

operator ==(Object other) bool
The equality operator.
inherited

Static Properties

instanceNames Set<String>
A list of all Isar instances opened in the current isolate.
read-only

Static Methods

addCloseListener(IsarCloseCallback callback) → void
Registers a listener that is called whenever an Isar instance is released.
addOpenListener(IsarOpenCallback callback) → void
Registers a listener that is called whenever an Isar instance is opened.
getInstance([String name = defaultName]) Isar?
Returns an Isar instance opened in the current isolate by its name. If no name is provided, the default instance is returned.
initializeIsarCore({Map<IsarAbi, String> libraries = const {}, bool download = false}) Future<void>
Initialize Isar Core manually. You need to provide Isar Core libraries for every platform your app will run on.
open(List<CollectionSchema> schemas, {required String directory, String name = defaultName, int maxSizeMiB = Isar.defaultMaxSizeMiB, bool relaxedDurability = true, CompactCondition? compactOnLaunch, bool inspector = true}) Future<Isar>
Open a new Isar instance.
openSync(List<CollectionSchema> schemas, {required String directory, String name = defaultName, int maxSizeMiB = Isar.defaultMaxSizeMiB, bool relaxedDurability = true, CompactCondition? compactOnLaunch, bool inspector = true}) Isar
Open a new Isar instance.
removeCloseListener(IsarCloseCallback callback) → void
Removes a previously registered IsarOpenCallback.
removeOpenListener(IsarOpenCallback callback) → void
Removes a previously registered IsarOpenCallback.
splitWords(String input) List<String>
Split a String into words according to Unicode Annex #29. Only words containing at least one alphanumeric character will be included.

Constants

autoIncrement → const Id
Placeholder for an auto-increment id.
isarAutoIncrementId
defaultMaxSizeMiB → const int
The default max Isar size.
1024
defaultName → const String
The default Isar instance name.
'default'
maxId → const Id
Largest valid id.
isarMaxId
minId → const Id
Smallest valid id.
isarMinId
version → const String
The version of the Isar library.
'3.1.0+1'