(Swift 2) Async Methods Returning an Object

Demonstrates how to call an asynchronous method that returns an object. This example reads email from a POP3 server using the Async versions of the Chilkat methods.

Chilkat Downloads for the Swift Programming Language MAC OS X (Cocoa) Objective-C/Swift Libs iOS Objective-C/Swift Libs

func chilkatTest() {
    // All Chilkat classes can be unlocked at once at the beginning of a program
    // by calling UnlockBundle.  It requires a Bundle unlock code.
    let chilkatGlob = CkoGlobal()
    var success: Bool = chilkatGlob.UnlockBundle("Anything for 30-day trial.")
    if success != true {
        print("\(chilkatGlob.LastErrorText)")
        return
    }

    let mailman = CkoMailMan()

    // Set the POP3 server's hostname
    mailman.MailHost = "pop.someMailServer.com"

    // Set the POP3 login/password and any other requirements..
    mailman.PopUsername = "myLogin"
    mailman.PopPassword = "myPassword"
    mailman.PopSsl = true
    mailman.MailPort = 995

    // Connect to the POP3 server:
    var task: CkoTask? = mailman.Pop3BeginSessionAsync()
    if mailman.LastMethodSuccess == false {
        print("\(mailman.LastErrorText)")
        return
    }

    // Start the background task.
    success = task!.Run()
    if !success {
        print("\(task!.LastErrorText)")
        task = nil
        return
    }

    // Wait for the POP3 connect task to finish.
    // The true/false returned by Wait applies to the Wait method call, not the task.
    var maxWaitMs: Int = 30000
    success = task!.Wait(maxWaitMs)
    if !success || (task!.StatusInt.intValue != 7) || (task!.TaskSuccess != true) {
        if !success {
            // The task.LastErrorText applies to the Wait method call.
            print("\(task!.LastErrorText)")
        }
        else {
            // The ResultErrorText applies to the underlying task method call (i.e. the Pop3BeginSession)
            print("\(task!.Status)")
            print("\(task!.ResultErrorText)")
        }

        task = nil
        return
    }

    task = nil

    // Get the number of messages in the mailbox.
    task = mailman.GetMailboxCountAsync()

    // To keep the example short, we'll skip handling failures.
    // The failures would be handled in the same way as shown above.

    success = task!.Run()
    success = task!.Wait(maxWaitMs)
    var numMessages: Int = task!.GetResultInt().intValue
    task = nil
    if numMessages == 0 {
        return
    }

    let email = CkoEmail()

    var i: Int
    for i = 1; i <= numMessages; i++ {

        task = mailman.FetchByMsgnumAsync(i)
        if mailman.LastMethodSuccess == false {
            print("\(mailman.LastErrorText)")
            return
        }

        success = task!.Run()
        success = task!.Wait(maxWaitMs)
        if !success || (task!.StatusInt.intValue != 7) || (task!.TaskSuccess != true) {
            if !success {
                // The task.LastErrorText applies to the Wait method call.
                print("\(task!.LastErrorText)")
            }
            else {
                // The ResultErrorText applies to the underlying task method call (i.e. the FetchByMsgnum)
                print("\(task!.Status)")
                print("\(task!.ResultErrorText)")
            }

            task = nil
            return
        }

        // Each Chilkat object that can be a return value of an asynchronous task will
        // have a method named LoadTaskResult.  The object returned in the underlying
        // asynchronous method call is retrieved by calling LoadTaskResult. 

        // To say it another way: The application will provide a pre-existing object of
        // the desired return type (in this case it is an email object).  This object is
        // loaded by calling LoadTaskResult.  

        success = email.LoadTaskResult(task)
        task = nil

        if !success {
            print("\(email.LastErrorText)")
            return
        }
        else {
            print("\(email.From): \(email.Subject)\n")
        }

    }


}