Attachments: Chat App
This tutorial demonstrates how to work with an attachment in a chat app:
Syncing large documents can significantly impact network performance:
Caution is advised when handling large binary data, such as a high-resolution image or video exceeding 50 megapixels; a deeply-embedded document; or a very large document.
Instead of storing files exceeding 250kb directly within a document object, carefully consider using attachments . For more information, see Attachment Objects.
The following snippet demonstrates how to create a new attachment in the demo chat app:
From the createImageMessage() function following the Large Image comment in the demo DittoChat app for iOS code:
- Pass the user instance and the URL path where the avatar image is stored.
- Create a new DittoAttachment object by calling the .newAttachment() method.
Since the demo DittoChat app does not require end users to upload an avatar image, declare the new attachment as an optional object.
Call the set() function and, using the DittoMutableDocumentPath instance, pass the DittoAttachment object
The DittoMutableDocumentPath instance links the user document object ID to the attachment object and stores the attachment's data bytes and metadata properties to the given local Ditto store (Small Peer).
Using the DittoAttachmentToken, initialize the attachment object.
Later in the code, you'll invoke the DittoAttachmentToken to retrieve the attachment data from its current storage location, which could be either the Ditto store or the peer-to-peer mesh network. For more information, see Replicating the Attachment, as follows.
Note that on the User model, the avatarToken variable is of type DittoAttachmentToken, yet we call the set() function with a DittoAttachment object. This can be confusing. The set() function, called with the attachment on a DittoMutableDocumentPath instance, causes the data bytes of the attachment at the given file location to be stored in the Ditto database, along with the metadata; the document property is initialized with a DittoAttachmentToken with which we will later fetch the attachment data asnynchronously from the peer-to-peer mesh, or from local storage if it has already been fetched.
Peers can now find the document, fetch the attachment, and use the attachment image. If you want to update a progress view, use the progress event value. In the following example, we've wrapped DittoCollection.fetchAttachment(token:deliverOn:onFetchEvent:) in an ImageAttachmentFetcher struct for convenience.
Notice that we update a progress view by calling the ImageAttachmentFetcher struct with a progress handling closure and a completion handler for handling the fetched image. Since the attachment fetcher must remain a globally available instance for the entire duration of the asynchronous fetch operation, we maintain a strong reference to the attachment fetcher as indicated with a property.
If, at any time, the attachment fetcher goes out of scope, asynchronous fetch operations silently aborts and the Attachment API fails.