Code moderne pour effectuer des requêtes HTTP dans Swift 5 à l'aide de Combine et les utiliser dans SwiftUI. Partie 1

API et modèle de données de service 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>  - sélection d'articles en  [Article]fonction du paramètre endpoint,
• fetchSources (for country: String) -> AnyPublisher<[Source], Never>- Une sélection de sources d'informations [Source]pour un pays particulier 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"
        }
    }
}

• les dernières nouvelles  .topHeadLines,
• l'actualité d'une certaine catégorie (sport, santé, science, business, technologie)  .articlesFromCategory(_ category: String),
• l'actualité d'une source d'information spécifique (CNN, ABC News, Fox News, etc.)  .articlesFromSource(_ source: String),
• toute nouvelle  .search (searchFilter: String)qui remplit une certaine condition searchFilter,
• sources d'information .sources (country:String)pour un pays particulier 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
    }

• sur la base du endpoint formulaire URLde demande la liste d'articles souhaitée endpoint.absoluteURL, en cas d'échec, puis renvoyer un tableau vide d'articles[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
    }

"Éditeurs" Publishercomme View Model dans SwiftUI. Liste d'articles.

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

Liste des sources d'information

• zone de texte  SearchViewpour la barre de recherche  searchString,
•  Picker pour le pays country,
• liste des  SourcesList sources d'information

• index  indexEndpoint = 3, c'est-à-dire une option  .articlesFromSource (_source:String)correspondant à la sélection d'articles pour une source fixe source,
• chaîne  searchString comme source elle-même (ou plutôt son identifiant) source.id :

Téléchargez l'image UIImagepour l'article Article.

1. si urlégal nil, retournez Just(nil),
2. basé sur la urlforme de "l'éditeur" dataTaskPublisher(for:), dont la valeur de sortie Outputest un tuple (data: Data, response: URLResponse)et une erreur  Failure-  URLError,
3. nous ne prenons que les données map {}du tuple (data: Data, response: URLResponse)pour un traitement ultérieur  dataet la forme UIImage,
4. si l'erreur de retour des étapes précédentes se produit nil,
5. nous fournissons le résultat au mainflux, car nous supposons une utilisation ultérieure dans la conception UI,
6. «Effacez» le TYPE de «l'éditeur» et renvoyez la copie AnyPublisher.

• @Published url: URL? sont des URLimages
• @Published var image: UIImage? est l'image elle-même de NewsAPI.org :

Afficher les erreurs lors de la récupération et du décodage des données JSON à partir du serveur  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" 
    
   .  .  .  .  .  .  .  .  .  .  .  .  .
}

Conclusion

Références: