[REQ] [Swift5] POP proposal
See original GitHub issueHi guys,
I’ve been using the OpenAPI Generator for Swift 4/5 for a while now, quite happy with your work, thanks!
But after a while I struggled a bit whenever I needed to add some customisation on the generated code.
Mainly the issues I found were related to the fact that the methods are defined as class func
.
That makes it hard to:
- override: you would need to define a class
SomethingSubclassAPI
that inherits from the generatedSomethingAPI
class and override the method. Then you would need to use the subclass around. Easy to do if that happens at the beginning of the project, much more complicated if you already used a lot the generated class around - it forces you to pass through the same classes for all the calls, hence the problem above
I then modified the templates to achieve something different.
From this:
open class AlertAPI {
/**
Returns the alert
- parameter ifNoneMatch: (header) The value of the Etag header returned in the previous response (optional)
- parameter completion: completion handler to receive the data and the error objects
*/
open class func getAlert(ifNoneMatch: String? = nil, completion: @escaping ((_ data: [Alert]?,_ error: Error?) -> Void)) {
getAlertWithRequestBuilder(ifNoneMatch: ifNoneMatch).execute { (response, error) -> Void in
completion(response?.body, error)
}
}
}
To this:
public protocol AlertAPIProtocol {
/**
Returns the alert
- parameter ifNoneMatch: (header) The value of the Etag header returned in the previous response (optional)
- parameter completion: completion handler to receive the data and the error objects
*/
static func getAlert(ifNoneMatch: String?, completion: @escaping ((_ data: [Alert]?, _ headers:[String:String]?, _ error: Error?) -> Void))
}
public extension AlertAPIProtocol {
static func getAlert(ifNoneMatch: String? = nil, completion: @escaping ((_ data: [Alert]?, _ headers:[String:String]?, _ error: Error?) -> Void)) {
getAlertWithRequestBuilder(ifNoneMatch: ifNoneMatch).execute { (response, error) -> Void in
completion(response?.body, response?.header, error)
}
}
}
This approach works quite well for me and it allows me to:
- conform to the protocol in each class/struct/enum where I need to perform such API request
- override the methods whenever and wherever I need to. I can override in a single case, if needed, or in a subprotocol, or even make conditional override based on conditions through the
where
operator - plug different protocols to the same class/struct/enum, composing different APIs by needs
Additionally I have an autogenerated Mock version of the same protocols, that inherits from the original ones, that load content from a json in the bundle. This approach opens to the possibility of conforming to AlertAPIPrototocol
in a target and to AlertAPIMockPrototocol
in another and being one a subprotocol to the other you can easily use polymorphism.
This is just an example of what this approach can lead to. 😃
I’d love to see this approach implemented in the official OpenAPI Generator for swift, I think it could be useful for a lot of people. Are you interested on discussing this further?
Thanks, Alessandro
Issue Analytics
- State:
- Created 3 years ago
- Reactions:5
- Comments:12 (11 by maintainers)
Top GitHub Comments
Now that https://github.com/OpenAPITools/openapi-generator/pull/9625 is merged, I think it’s safe to start working on POP implementation 🙂
Follow. it could help me too!