DittoSDK.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 (DittoDocumentID id)
	Creates an accessor for a single document by its unique identifier. More...
unsafe DittoDocumentID	Insert (Dictionary< string, object > data, DittoDocumentID 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< DittoAttachmentFetchEvent > onFetchEvent)
	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 DittoSDK.DittoCollection.FetchAttachment ( DittoAttachmentToken  token, Action< DittoAttachmentFetchEvent >  onFetchEvent  )

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 attachment's fetch attempt as it tries to download it. Assuming it succeeds in downloading the attachment it wall call the onFetchEvent lambda with a completed event object, which will hold a reference to the attachment.

Parameters

token	The DittoAttachmentToken relevant to the attachment that you wish to download and observe.
onFetchEvent	A lambda that will be called when the attachment fetch attempt has a new event to deliver.

Returns

A DittoAttachmentFetcher object, which must be kept alive for the fetch request to proceed and for you to be notified about the attachment fetch attempt's events. 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 DittoSDK.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 DittoSDK.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 DittoSDK.DittoCollection.FindById ( DittoDocumentID  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()

unsafe DittoDocumentID DittoSDK.DittoCollection.Insert ( Dictionary< string, object >  data, DittoDocumentID  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 Ditto 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 document ID or null if the document could not be inserted.

NewAttachment()

unsafe DittoAttachment DittoSDK.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 Ditto'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 DittoSDK.DittoCollection.Name

get

Gets the name of the collection.