iOS Swift 4中Cloudant查询结果解析问题求助

Hey there! Let's figure out how to work with that Cloudant response you're getting from GetAllDocsOperation—I’ve been in this spot before, so let’s break it down step by step.

Understanding the Cloudant Response Structure #

First, let's clarify what that response object actually is. It’s an optional GetAllDocsResponse type, and its key property is docs—an array of Document instances. Each Document has:

• id: The unique ID of the document (non-optional)
• revision: The document’s revision ID (optional, useful for updates/deletes)
• properties: A [String: Any] dictionary holding all your custom document fields

Handling the Response with Native Cloudant Types #

You don’t need external libraries to parse this—you can work directly with the Document type and its properties dictionary. Here’s how to adjust your code:

let read = GetAllDocsOperation(databaseName: dbName){ (response, httpInfo, error) in 
    if let error = error { 
        print("Encountered an error while reading a document. Error:\(error)") 
    } else if let getAllResponse = response {
        // Loop through every document returned
        for doc in getAllResponse.docs {
            print("Document ID: \(doc.id), Revision: \(doc.revision ?? "No revision found")")
            
            // Access top-level custom fields (e.g., a "title" string field)
            if let title = doc.properties["title"] as? String {
                print("Document Title: \(title)")
            }
            
            // Handle nested fields (e.g., a "author" object with a "name" field)
            if let author = doc.properties["author"] as? [String: Any], 
               let authorName = author["name"] as? String {
                print("Author Name: \(authorName)")
            }
        }
    } 
} 
client.add(operation:read)

Using SwiftyJSON for Easier Parsing #

If you prefer SwiftyJSON for handling nested or unpredictable data structures, you can convert the properties dictionary to a JSON object. Here’s how:

First, make sure you’ve imported SwiftyJSON (import SwiftyJSON) in your file, then adjust the callback:

let read = GetAllDocsOperation(databaseName: dbName){ (response, httpInfo, error) in 
    if let error = error { 
        print("Encountered an error while reading a document. Error:\(error)") 
    } else if let getAllResponse = response {
        for doc in getAllResponse.docs {
            // Convert the properties dictionary to a SwiftyJSON object
            let docJSON = JSON(doc.properties)
            
            // Safely access fields (SwiftyJSON handles optionals gracefully)
            let title = docJSON["title"].stringValue // Returns empty string if missing
            let pageCount = docJSON["page_count"].intValue // Returns 0 if missing
            let authorEmail = docJSON["author"]["email"].string // Optional, use if let to unwrap
            
            print("Title: \(title), Pages: \(pageCount)")
            if let email = authorEmail {
                print("Author Email: \(email)")
            }
        }
    } 
} 
client.add(operation:read)

Mapping to Custom Codable Models #

For more structured data, mapping the document to a custom Codable model will make your code cleaner and type-safe. Here’s an example:

First, define your model:

struct Book: Codable {
    let id: String
    let revision: String?
    let title: String
    let pageCount: Int
    let author: Author
}

struct Author: Codable {
    let name: String
    let email: String
}

Then, parse the documents into your model in the callback:

let read = GetAllDocsOperation(databaseName: dbName){ (response, httpInfo, error) in 
    if let error = error { 
        print("Encountered an error while reading a document. Error:\(error)") 
    } else if let getAllResponse = response {
        for doc in getAllResponse.docs {
            do {
                // Convert the properties dictionary to Data
                let data = try JSONSerialization.data(withJSONObject: doc.properties)
                // Decode the data into your Book model
                var book = try JSONDecoder().decode(Book.self, from: data)
                // Add the Cloudant-specific ID and revision
                book.id = doc.id
                book.revision = doc.revision
                
                // Now you can use the typed Book object
                print("Loaded Book: \(book.title) by \(book.author.name)")
            } catch {
                print("Failed to decode document \(doc.id): \(error.localizedDescription)")
            }
        }
    } 
} 
client.add(operation:read)

Common Pitfalls to Watch For #

• Optional Values: Always unwrap optional fields safely (use if let or guard statements) to avoid crashes.
• Type Mismatches: Make sure you cast properties values to the correct type (e.g., don’t try to cast a number to a string).
• Missing Fields: SwiftyJSON’s stringValue/intValue will return default values if a field is missing, while native Swift casting will return nil. Choose the approach that fits your use case.

内容的提问来源于stack exchange，提问作者Mando Statti