Overview

VLDSession stores a user, their current HealthKit subscriptions and all pending record uploads. This data is persisted between app launches but is deleted if endSession is called.

VLDSession is a singleton object and must be accessed by its sharedInstance method. The different components of the Validic Mobile library rely on a valid user existing in the current VLDSession singleton object.

Notifications

When VLDSession uploads a record it will send an NSNotification. To listen for this notification add an observer to the NSNotificationCenter with the name kVLDRecordSubmittedNotification. The object property of the notification will contain the VLDRecord object uploaded.

If a 400 error is returned from the server, the record will be discarded and an NSNotification will be posted. To listen for this notification add an observer to the NSNotificationCenter with the name kVLDRecordSubmissionFailedNotification. The object property of the notification will contain the invalid VLDRecord object. The userInfo dictionary for this notification will contain one key, error with the NSError object for the failed upload.

When an image is uploaded VLDSession will send out an NSNotification with the name kVLDRecordImageSubmittedNotification. The object property of the notification will contain a VLDMedia instance. If the image fails to upload an NSNotification will be sent out with the name kVLDRecordImageSubmissionFailedNotification and the object property of the notification will be the record object associated with the image and the userInfo dictionary will contain a value for the key error with the NSError object describing the problem.