Camada de rede

Introdução

O Beagle realiza todas requisições web a partir da dependência networkClient presente no BeagleDependencies do tipo NetworkClientProtocol, sendo assim é possível criar a sua própria implementação de camada de rede para ser utilizada no framework.

Com isso você pode:

• Unificar a camada de networking do sistema em um módulo;
• Modificar propriedades como, por exemplo, cabeçalhos de requisições, métodos request, body response, data response, executar criptografia, etc.

public protocol NetworkClientProtocol {
    typealias Error = NetworkError
    typealias NetworkResult = Result<NetworkResponse, NetworkError>
    typealias RequestCompletion = (NetworkResult) -> Void
 
    @discardableResult
    func executeRequest(
        _ request: Request,
        completion: @escaping RequestCompletion
    ) -> RequestToken?
}

Além disso a função pode retornar o RequestToken, para que a requisição possa ser cancelada internamente pelo Beagle.

Request

HttpAdditionalData

Criando uma camada de Networking

Para substituir a classe responsável por realizar as requisições Http para o Beagle, siga os passos a seguir:

Passo 1: Criar uma implementação para NetworkClientProtocol

Implemente o protocolo NetworkClient na classe que deseja utilizar para realizar as requisições, neste caso o NetworkClientDefault será usado como exemplo:

class NetworkClient: NetworkClientProtocol {
    func executeRequest(
        _ request: Request, 
        completion: @escaping RequestCompletion
    ) -> RequestToken? {
        let url: URL = request.url
        let headers = request.additionalData?.headers
        let method = request.additionalData?.method
        var body: Data?
        if let additionalDataBody = request.additionalData?.body {
            body = try? JSONEncoder().encode(additionalDataBody)
        }
        //Implementacao de Requisicoes
    }
    
    //Implementacao Network Client...
}

Passo 2: Atribuir as dependências

No AppDelegate ou na classe de configurações do ambiente do Beagle, atribua a instância de NetworkClientDefault ao atributo networkClient presente no Beagle Dependencies:

let dependencies = BeagleDependencies()
let client = NetworkClient()
dependencies.networkClient = client
BeagleConfigurator.setup(dependencies: dependencies)

Pronto! Agora o Beagle utilizará a sua classe com todas as modificações e definições necessárias para realizar as requisições Http.

Exemplo de implementação

Caso queira entrar mais a fundo na implementação da camada de rede temos um exemplo aqui

Feedback

Was this page helpful?

Glad to hear it! Please tell us how we can improve.

Sorry to hear that. Please tell us how we can improve.