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 filedirectory/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'