42

Codable第一次使用 Swift 4 的协议,我无法理解decodeIfPresentfrom的使用Decodable

/// Decodes a value of the given type for the given key, if present.
///
/// This method returns `nil` if the container does not have a value associated with `key`, or if the value is null. The difference between these states can be distinguished with a `contains(_:)` call.
///
/// - parameter type: The type of value to decode.
/// - parameter key: The key that the decoded value is associated with.
/// - returns: A decoded value of the requested type, or `nil` if the `Decoder` does not have an entry associated with the given key, or if the value is a null value.
/// - throws: `DecodingError.typeMismatch` if the encountered encoded value is not convertible to the requested type.
public func decodeIfPresent(_ type: String.Type, forKey key: KeyedDecodingContainer.Key) throws -> String?

在这里它建议它返回nil,如果值不存在关联键。如果这是唯一的原因,那么它与可选属性有何不同,因为可选变量也设置为nil如果响应中不存在值。

4

3 回答 3

92

这两行代码之间有一个微妙但重要的区别:

// Exhibit 1
foo = try container.decode(Int?.self, forKey: .foo)
// Exhibit 2
foo = try container.decodeIfPresent(Int.self, forKey: .foo)

图表 1 将解析:

{
  "foo": null,
  "bar": "something"
}

不是

{
  "bar": "something"
}

而展览 2 会很高兴地解析两者。因此,在解析器的正常用例中,JSON您需要decodeIfPresent模型中的每个可选项。

于 2017-09-19T09:32:24.217 回答
10

是的,@Sweeper 的评论是有道理的。

我将根据我的理解尝试解释它。

public class User : Decodable{

    public var firstName:String
    public var lastName:String
    public var middleName:String?
    public var address:String
    public var contactNumber:String


    public enum UserResponseKeys: String, CodingKey{
        case firstName = "first_name"
        case lastName = "last_name"
        case middleName = "middle_name"
        case address = "address"
        case contactNumber = "contact_number"
    }

    public required init(from decoder: Decoder) throws {

        let container = try decoder.container(keyedBy: UserResponseKeys.self)

        self.firstName = try container.decode(String.self, forKey: .firstName)
        self.lastName = try container.decode(String.self, forKey: .lastName)
        self.middleName = try container.decodeIfPresent(String.self, forKey: .middleName)
        self.address = try container.decode(String.self, forKey: .address)
        self.contactNumber = try container.decode(String.self, forKey: .contactNumber)
    }

}

以上是我的User类,其中我标记middleName为可选参数,因为JSON响应可能没有提供middleName键值对作为响应,所以我们可以使用decodeIfPresent.

self.middleName = try container.decodeIfPresent(String.self, forKey: .middleName)

而对于其他变量,这些变量是必填字段,所以我们确信不需要为此使用 optional。我们仅decode用于该方法,因为该方法不返回可选的。

public func decode(_ type: String.Type, forKey key: KeyedDecodingContainer.Key) throws -> String

上面的decode函数在返回StringdecodeIfPresent返回String?,所以我们可以使用可选变量来存储它。

所以最后的结论是,如果您不确定服务响应合同,或者您可能会处理任何第三方服务,其中 JSON 响应和参数可能会在您不知情的情况下发生变化,那么您可以使用decodeIfPresent它来处理响应中缺少特定参数并设置值作为nil.

于 2017-09-19T05:56:31.680 回答
3

decodeifPresent如果您想为 JSON 中可能缺少的属性使用默认值,我认为使用而不是可选属性是有意义的。

例如,让我们检查 3 种情况:

1. 所有键都存在于 JSON 中:

假设您必须解码此 JSON:

{
    "project_names": ["project1", "project2", "project3"],
    "is_pro": true
}

你可以使用这个结构:

struct Program: Codable {
    let projectNames: [String]
    let isPro: Bool
}

你会得到一个值等于的Program对象。(我想你的解码器在这个例子的其余部分)isProtruekeyDecodingStrategy.convertFromSnakeCase


2. JSON 中缺少一些键,您可以在 Swift 中使用可选键:

{
    "project_names": ["project1", "project2", "project3"]
}

您现在可以使用此结构:

struct Program: Codable {
    let projectNames: [String]
    var isPro: Bool?
}

你会得到一个值等于的Program对象。isPronil

如果 JSON 看起来像这样:

{
    "project_names": ["project1", "project2", "project3"],
    "is_pro": true
}

那么isPro将是一个Bool?with value true。也许这就是你想要的,但可能你想要Bool一个默认值为false. 那是decodeIfPresent可能有用的地方。


3. JSON 中缺少一些键,而您想要一个在 Swift 中具有默认值的非可选属性:

如果您的结构如下所示:

struct Program: Codable {
    let projectNames: [String]
    var isPro: Bool = false
}

如果您的 JSON 中不存在“is_pro”属性,那么您将收到解析错误。因为 Codable 期望找到一个值来解析 Bool 属性。

在这种情况下,一个好主意是使用带有 的初始化程序decodeIfPresent,如下所示:

struct Program: Codable {
    let projectNames: [String]
    let isPro: Bool

    init(from decoder: Decoder) throws {
        let container = try decoder.container(keyedBy: CodingKeys.self)
        self.projectNames = try container.decode([String].self, forKey: .projectNames)
        self.isPro = try container.decodeIfPresent(Bool.self, forKey: .isPro) ?? false
    }
}

这使您可以两全其美:

  • 你的结构有一个Bool,而不是一个Bool?属性
  • 您仍然可以解析不包含“is_pro”字段的 JSON
  • false如果 JSON 中不存在该字段,您可以获得默认值。
于 2020-10-25T11:03:30.367 回答