Swift中解决两个Struct Model命名冲突的方法

方法1：创建独立的命名空间结构体包裹整个模型组 #

把每个API对应的所有模型（主模型+内部嵌套类型）封装到专属的顶层结构体中，以此实现命名空间隔离：

// 美国国家气象局预警API专属命名空间
struct NWSAlertNamespace {
    // 预警主模型
    struct AlertModel: Codable {
        let context: [ContextElement]
        // 其他业务属性...
    }
    
    // 预警模型内部的ContextElement
    struct ContextElement: Codable {
        let contextClass: ContextClass
        // 其他属性...
    }
    
    // 预警模型内部的ContextClass
    struct ContextClass: Codable {
        // 属性定义...
    }
}

// 美国国家气象局预报API专属命名空间
struct NWSForecastNamespace {
    // 预报主模型
    struct ForecastModel: Codable {
        let context: [ContextElement]
        // 其他业务属性...
    }
    
    // 预报模型内部的ContextElement
    struct ContextElement: Codable {
        let contextClass: ContextClass
        // 其他属性...
    }
    
    // 预报模型内部的ContextClass
    struct ContextClass: Codable {
        // 属性定义...
    }
}

使用方式 #

解码时通过命名空间明确指定要使用的模型类型：

// 解码预警数据
do {
    let alertModel = try JSONDecoder().decode(NWSAlertNamespace.AlertModel.self, from: alertAPIResponseData)
    // 访问内部类型示例：NWSAlertNamespace.ContextElement
} catch {
    print("预警数据解码失败：\(error)")
}

// 解码预报数据
do {
    let forecastModel = try JSONDecoder().decode(NWSForecastNamespace.ForecastModel.self, from: forecastAPIResponseData)
    // 访问内部类型示例：NWSForecastNamespace.ContextElement
} catch {
    print("预报数据解码失败：\(error)")
}

方法2：将内部类型直接嵌套在主模型内部 #

把每个主模型的内部依赖类型直接嵌套到主结构体中，让主模型本身充当命名空间：

// 预警主模型，内部嵌套专属的ContextElement、ContextClass
struct AlertModel: Codable {
    let context: [ContextElement]
    // 其他业务属性...
    
    struct ContextElement: Codable {
        let contextClass: ContextClass
        // 其他属性...
        
        struct ContextClass: Codable {
            // 属性定义...
        }
    }
}

// 预报主模型，内部嵌套专属的ContextElement、ContextClass
struct ForecastModel: Codable {
    let context: [ContextElement]
    // 其他业务属性...
    
    struct ContextElement: Codable {
        let contextClass: ContextClass
        // 其他属性...
        
        struct ContextClass: Codable {
            // 属性定义...
        }
    }
}

使用方式 #

解码时直接使用顶层主模型，内部类型通过主模型访问：

// 解码预警数据
do {
    let alertModel = try JSONDecoder().decode(AlertModel.self, from: alertAPIResponseData)
    // 访问内部类型示例：AlertModel.ContextElement
} catch {
    print("预警数据解码失败：\(error)")
}

// 解码预报数据
do {
    let forecastModel = try JSONDecoder().decode(ForecastModel.self, from: forecastAPIResponseData)
    // 访问内部类型示例：ForecastModel.ContextElement
} catch {
    print("预报数据解码失败：\(error)")
}

核心原理 #

Swift中嵌套类型的作用域被限制在外部类型的范围内，不同外部类型下的同名内部类型不会产生命名冲突。同时Codable协议对嵌套类型有完美支持，不需要额外编写解码逻辑，只要所有嵌套类型都遵守Codable协议即可。

如果你的模型是通过自动生成工具（如QuickType）生成的，只需修改生成代码的结构，将内部类型嵌套到对应主模型或命名空间结构体中即可快速适配。

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