This PR contains the work done to implement some bugfixes to the existing source code related to the `Communications` library of this package. To provide further details about the work done: - [x] removed an unnecessary function from the `Client` public protocol; - [x] moved the `MakeURLRequestError` public error to its own file; - [x] added the `parameters` property to the `Endpoint` public protocol; - [x] added support for the parameters handling in the `MakeURLRequestUseCase` use case. Co-authored-by: Javier Cicchelli <javier@rock-n-code.com> Reviewed-on: #7
50 lines
1.4 KiB
Swift
50 lines
1.4 KiB
Swift
//===----------------------------------------------------------------------===//
|
|
//
|
|
// This source file is part of the SwiftLibs open source project
|
|
//
|
|
// Copyright (c) 2023 Röck+Cöde VoF. and the SwiftLibs project authors
|
|
// Licensed under the EUPL 1.2 or later.
|
|
//
|
|
// See LICENSE.txt for license information
|
|
// See CONTRIBUTORS.txt for the list of SwiftLibs project authors
|
|
//
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
import Foundation
|
|
|
|
/// This protocol defines an endpoint to be used in a remote call.
|
|
public protocol Endpoint {
|
|
|
|
// MARK: Type aliases
|
|
|
|
typealias Parameters = [String : String?]
|
|
typealias Headers = [String : String]
|
|
|
|
// MARK: Properties
|
|
|
|
/// The scheme subcomponent for the endpoint.
|
|
var scheme: String { get }
|
|
|
|
/// The host subcomponent for the endpoint.
|
|
var host: String { get }
|
|
|
|
/// The port subcomponent for the component.
|
|
var port: Int? { get }
|
|
|
|
/// The path subcomponent for the endpoint.
|
|
var path: String { get }
|
|
|
|
/// The query parameter subcomponents for the endpoint.
|
|
var parameters: Parameters { get }
|
|
|
|
/// The HTTP request method for the endpoint.
|
|
var method: HTTPRequestMethod { get }
|
|
|
|
/// The HTTP header fields as a dictionary for the endpoint.
|
|
var headers: Headers { get }
|
|
|
|
/// The message body as data for a request.
|
|
var body: Data? { get }
|
|
|
|
}
|