DittoSharp.DittoCollection Class Reference

A reference to a collection in a DittoStore. More...

Public Member Functions
DittoPendingCursorOperation	Find (string query)
	Creates a cursor for the documents in this collection that match the provided query. More...
DittoPendingCursorOperation	FindAll ()
	Creates a cursor for all of the documents in this collection. More...
DittoPendingIDSpecificOperation	FindById (string id)
	Creates an accessor for a single document by its unique identifier. More...
string	Insert (Dictionary< string, object > data, string id=null, bool isDefault=false)
	Inserts a document into a collection. More...
unsafe DittoAttachment	NewAttachment (string path, Dictionary< string, string > metadata=null)
	Creates a new attachment, which can then be inserted into a document. More...
DittoAttachmentFetcher	FetchAttachment (DittoAttachmentToken token, Action< DittoAttachmentStatus > onStatusChanged)
	Trigger an attachment to be downloaded locally to the device and observe its progress as it does so. More...

Properties
string	Name [get]
	Gets the name of the collection. More...

Detailed Description

A reference to a collection in a DittoStore.

This is the entrypoint for inserting documents into a collection, as well querying a collection.

Member Function Documentation

FetchAttachment()

DittoAttachmentFetcher DittoSharp.DittoCollection.FetchAttachment ( DittoAttachmentToken  token, Action< DittoAttachmentStatus >  onStatusChanged  )

inline

Trigger an attachment to be downloaded locally to the device and observe its progress as it does so.

When you encounter a document that contains an attachment the attachment will not automatically be downloaded along with the document. You trigger an attachment to be downloaded locally to a device by calling this method. It will report changes to the status of the attachment as it attempts to download it. Assuming it succeeds in downloading the attachment it wall call the onStatusChanged lambda with a completed status object, which will hold a reference to the attachment.

Parameters

token	The DittoAttachmentToken relevant to the attachment that you wish to download and observe.
onStatusChanged	A lambda that will be called when the status of the attachment download changes.

Returns

A DittoAttachmentFetcher object, which must be kept alive for the fetch request to proceed and for you to be notified about the attachment's fetch status changes. If the attachment fetcher could not be created then null will be returned. This can happen if, for example, an invalid attachment token was provided.

Find()

DittoPendingCursorOperation DittoSharp.DittoCollection.Find ( string  query )

inline

Creates a cursor for the documents in this collection that match the provided query.

Parameters

query

A ditto query string.

Returns

A cursor for the query.

FindAll()

DittoPendingCursorOperation DittoSharp.DittoCollection.FindAll ( )

inline

Creates a cursor for all of the documents in this collection.

Returns

A cursor for all documents in the collection.

FindById()

DittoPendingIDSpecificOperation DittoSharp.DittoCollection.FindById ( string  id )

inline

Creates an accessor for a single document by its unique identifier.

Parameters

id	The id of the document in this collection.

Returns

A cursor for a single document.

Insert()

string DittoSharp.DittoCollection.Insert ( Dictionary< string, object >  data, string  id = null, bool  isDefault = false  )

inline

Inserts a document into a collection.

Parameters

data	The document content.
id	The primary key or identifier for this document. If this is null then DittoKit will assign it a unique identifier. This cannot be changed once inserted.
isDefault	Set to true if the document should assume all values are default. See https://docs.ditto.live/concepts/data-model.

Returns

The unique identifier of the document.

NewAttachment()

unsafe DittoAttachment DittoSharp.DittoCollection.NewAttachment ( string  path, Dictionary< string, string >  metadata = null  )

inline

Creates a new attachment, which can then be inserted into a document.

The file residing at the provided path will be copied into DittoKit's store. The DittoAttachment object that is returned is what you can then use to insert an attachment into a document.

You can provide metadata about the attachment, which will be replicated to other peers alongside the file attachment.

Below is a snippet to how you can use the newAttachment functionality to insert an attachment into a document.

if let attachment = collection.insert.newAttachment("/path/to/my/file.pdf") { let docID = try!collection.insert(["attachment": attachment, "other": "string"]) }

Parameters

path	The path to the file that you want to create an attachment with.
metadata	Metadata relating to the attachment.

Returns

A DittoAttachment object, which can be used to insert the attachment into a document.

Property Documentation

Name

string DittoSharp.DittoCollection.Name

get

Gets the name of the collection.