كود حديث لتقديم طلبات HTTP في Swift 5 باستخدام Combine واستخدامها في SwiftUI. الجزء الأول

نموذج بيانات خدمة NewsAPI.org وواجهة برمجة التطبيقات

import Foundation

struct NewsResponse: Codable {
    let status: String?
    let totalResults: Int?
    let articles: [Article]
}

struct Article: Codable, Identifiable {
    let id = UUID()
    let title: String
    let description: String?
    let author: String?
    let urlToImage: String?
    let publishedAt: Date?
    let source: Source
}

struct SourcesResponse: Codable {
    let status: String
    let sources: [Source]
}

struct Source: Codable,Identifiable {
    let id: String?
    let name: String?
    let description: String?
    let country: String?
    let category: String?
    let url: String?
}

• fetchArticles (from endpoint: Endpoint) -> AnyPublisher<[Article], Never>  - اختيار المقالات  [Article]على أساس المعلمة endpoint،
• fetchSources (for country: String) -> AnyPublisher<[Source], Never>- مجموعة مختارة من مصادر المعلومات [Source]لبلد معين country.

enum Endpoint {
    case topHeadLines
    case articlesFromCategory(_ category: String)
    case articlesFromSource(_ source: String)
    case search (searchFilter: String)
    case sources (country: String)
    
    var baseURL:URL {URL(string: "https://newsapi.org/v2/")!}
    
    func path() -> String {
        switch self {
        case .topHeadLines, .articlesFromCategory:
            return "top-headlines"
        case .search,.articlesFromSource:
            return "everything"
        case .sources:
            return "sources"
        }
    }
}

• آخر الأخبار  .topHeadLines،
• أخبار فئة معينة (الرياضة ، الصحة ، العلوم ، الأعمال ، التكنولوجيا)  .articlesFromCategory(_ category: String)،
• أخبار من مصدر محدد للمعلومات (CNN ، ABC News ، Fox News ، إلخ)  .articlesFromSource(_ source: String)،
• أي أخبار  .search (searchFilter: String)تلبي شرطًا معينًا searchFilter،
• مصادر المعلومات .sources (country:String)لبلد معين country.

init? (index: Int, text: String = "sports") {
        switch index {
        case 0: self = .topHeadLines
        case 1: self = .search(searchFilter: text)
        case 2: self = .articlesFromCategory(text)
        case 3: self = .articlesFromSource(text)
        case 4: self = .sources (country: text)
        default: return nil
        }
    }

func fetchArticles(from endpoint: Endpoint) -> AnyPublisher<[Article], Never> {
        guard let url = endpoint.absoluteURL else {              // 0
                    return Just([Article]()).eraseToAnyPublisher()
        }
           return
            URLSession.shared.dataTaskPublisher(for:url)        // 1
            .map{$0.data}                                       // 2
            .decode(type: NewsResponse.self,                    // 3
                    decoder: APIConstants .jsonDecoder)
            .map{$0.articles}                                   // 4
            .replaceError(with: [])                             // 5
            .receive(on: RunLoop.main)                          // 6
            .eraseToAnyPublisher()                              // 7
    }

• على أساس endpoint نموذج URLالطلب ، قائمة المقالات المرغوبة endpoint.absoluteURL، إذا تعذر ذلك ، قم بإرجاع مجموعة فارغة من المقالات[Article]()
• «» dataTaskPublisher(for:), Output (data: Data, response: URLResponse),   Failure - URLError,
• map { } (data: Data, response: URLResponse)  data, 
• JSON  data ,  NewsResponse, articles: [Atricle]
• map { }  - articles, 
• - [ ],
• main , UI,
• «» «» eraseToAnyPublisher() AnyPublisher.

func fetchSources() -> AnyPublisher<[Source], Never> {
        guard let url = Endpoint.sources.absoluteURL else {      // 0
                       return Just([Source]()).eraseToAnyPublisher()
           }
              return
               URLSession.shared.dataTaskPublisher(for:url)      // 1
               .map{$0.data}                                     // 2
               .decode(type: SourcesResponse.self,               // 3
                       decoder: APIConstants .jsonDecoder)
               .map{$0.sources}                                  // 4
               .replaceError(with: [])                           // 5
               .receive(on: RunLoop.main)                        // 6
               .eraseToAnyPublisher()                            // 7
    }

//     URL
     func fetch<T: Decodable>(_ url: URL) -> AnyPublisher<T, Error> {
                   URLSession.shared.dataTaskPublisher(for: url)             // 1
                    .map { $0.data}                                          // 2
                    .decode(type: T.self, decoder: APIConstants.jsonDecoder) // 3
                    .receive(on: RunLoop.main)                               // 4
                    .eraseToAnyPublisher()                                   // 5
    }

//   
     func fetchArticles(from endpoint: Endpoint)
                                     -> AnyPublisher<[Article], Never> {
         guard let url = endpoint.absoluteURL else {
                     return Just([Article]()).eraseToAnyPublisher() // 0
         }
         return fetch(url)                                          // 1
             .map { (response: NewsResponse) -> [Article] in        // 2
                             return response.articles }
                .replaceError(with: [Article]())                    // 3
                .eraseToAnyPublisher()                              // 4
     }
    
    //    
    func fetchSources(for country: String)
                                       -> AnyPublisher<[Source], Never> {
        guard let url = Endpoint.sources(country: country).absoluteURL
            else {
                    return Just([Source]()).eraseToAnyPublisher() // 0
        }
        return fetch(url)                                         // 1
            .map { (response: SourcesResponse) -> [Source] in     // 2
                            response.sources }
               .replaceError(with: [Source]())                    // 3
               .eraseToAnyPublisher()                             // 4
    }

"الناشرون" Publisherكما View Model في SwiftUI. قائمة المقالات.

• @Published var indexEndpoint: Int — Endpoint ( «», View),  
• @Published var searchString: String — ,   ( «», View  TextField),
• @Published var articles: [Article] - ( «», NewsAPI.org, «»).

قائمة مصادر المعلومات

• مربع نص  SearchViewلشريط البحث  searchString،
•  Picker للبلد country،
• قائمة  SourcesList مصادر المعلومات

• الفهرس  indexEndpoint = 3، أي خيار  .articlesFromSource (_source:String)مقابل اختيار المقالات لمصدر ثابت source،
• سلسلة  searchString كمصدر نفسه (أو بالأحرى معرفه) source.id :

تنزيل الصورة UIImageللمقالة Article.

1. إذا كانت urlمتساوية nil، ارجع Just(nil)،
2. بناء على urlشكل "الناشر" dataTaskPublisher(for:)، الذي قيمة الانتاج Outputهو الصفوف (tuple) (data: Data, response: URLResponse)وخطأ  Failure-  URLError،
3. نأخذ فقط البيانات map {}من tuple (data: Data, response: URLResponse)لمزيد من المعالجة  data، والشكل UIImage،
4. إذا حدث خطأ عودة الخطوات السابقة nil،
5. نقدم النتيجة إلى mainالتدفق ، حيث نفترض المزيد من الاستخدام في التصميم UI،
6. "مسح" نوع "الناشر" وإرجاع النسخة AnyPublisher.

• @Published url: URL? هي URLصور
• @Published var image: UIImage? هي الصورة نفسها من NewsAPI.org :

عرض الأخطاء عند جلب بيانات JSON وفك تشفيرها من خادم  NewsAPI.org .

func fetchArticlesErr(from endpoint: Endpoint) ->
                            AnyPublisher<[Article], NewsError> {

. . . . . . . .
}

• 0. endpoint  URL endpoint.absoluteURL , url nil: nil, .urlError, — url ,
• 1. «» dataTaskPublisher(for:), — url, Output (data: Data, response: URLResponse)  URLError,
• 2. tryMap { }  (data: Data, response: URLResponse): response.statusCode 200...299,  data. «» .responseError,   data, String, ,
• 3. JSON ,  NewsResponse,
• 4. main , UI
• «» «» sink receiveCompletion receiveValue,
  
  • 5.    receiveCompletion  error, promise (.failure(...))),
  • 6.   receiveValue promise (.success($0.articles)),
   
• 7.  «»  var subscriptions, « » NewsAPI,
• 8. «» «» AnyPublisher.

1. @Published var indexEndpoint: Int — Endpoint ( «», View), 
2. @Published var searchString: String — ,  Endpoint: «» , ( «», View), 
3.  @Published var articles: [Article] - ( «»,  NewsAPI.org )
4.   @Published var articlesError: NewsError? - ,    NewsAPI.org .

struct APIConstants {
    // News  API key url: https://newsapi.org
    static let apiKey: String = "API_KEY" 
    
   .  .  .  .  .  .  .  .  .  .  .  .  .
}

استنتاج

المراجع: