Moderner Code zum Erstellen von HTTP-Anforderungen in Swift 5 mithilfe von Combine und deren Verwendung in SwiftUI. Teil 1

NewsAPI.org Service Data Model und API

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>  - Auswahl der Artikel  [Article]anhand des Parameters endpoint,
• fetchSources (for country: String) -> AnyPublisher<[Source], Never>- Eine Auswahl von Informationsquellen [Source]für ein bestimmtes Land 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"
        }
    }
}

• die neuesten Nachrichten  .topHeadLines,
• Nachrichten einer bestimmten Kategorie (Sport, Gesundheit, Wissenschaft, Wirtschaft, Technologie)  .articlesFromCategory(_ category: String),
• Nachrichten aus einer bestimmten Informationsquelle (CNN, ABC News, Fox News usw.)  .articlesFromSource(_ source: String),
• Nachrichten  .search (searchFilter: String), die eine bestimmte Bedingung erfüllen searchFilter,
• Informationsquellen .sources (country:String)für ein bestimmtes Land 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
    }

• Wenn dies auf der Grundlage des endpoint Formulars URLfür die Anforderung der gewünschten Artikelliste endpoint.absoluteURLnicht möglich ist, geben Sie ein leeres Array von Artikeln zurück[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
    }

"Verlage" Publisherwie View Model in SwiftUI. Liste der Artikel.

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

Liste der Informationsquellen

• Textfeld  SearchViewfür die Suchleiste  searchString,
•  Picker für das Land country,
• Liste  SourcesList der Informationsquellen

• Index  indexEndpoint = 3, dh eine Option  .articlesFromSource (_source:String), die der Auswahl von Artikeln für eine feste Quelle entspricht source,
• Zeichenfolge  searchString als Quelle selbst (oder vielmehr als Kennung) source.id :

Bild UIImagefür Artikel herunterladen Article.

1. wenn urlgleich nil, kehre zurück Just(nil),
2. basierend auf der urlForm des "Herausgebers" dataTaskPublisher(for:), dessen Ausgabewert Outputein Tupel (data: Data, response: URLResponse)und ein Fehler ist  Failure-  URLError,
3. Wir nehmen nur Daten map {}aus dem Tupel (data: Data, response: URLResponse)zur weiteren Verarbeitung  dataund Form UIImage,
4. Wenn bei den vorherigen Schritten ein Rückgabefehler auftritt nil,
5. Wir liefern das Ergebnis an den mainStream, da wir davon ausgehen, dass es im Design weiter verwendet UIwird.
6. "Löschen" Sie den TYP des "Herausgebers" und geben Sie die Kopie zurück AnyPublisher.

• @Published url: URL? sind URLBilder
• @Published var image: UIImage? ist das Bild selbst von NewsAPI.org :

Zeigen Sie Fehler beim Abrufen und Dekodieren von JSON-Daten vom NewsAPI.org- Server an  .

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" 
    
   .  .  .  .  .  .  .  .  .  .  .  .  .
}

Fazit

Verweise: