openapi_dart_common

Description:

openapi dart common

OpenAPI Common Library for Dart Client Code Generator #
This library forms the core reusable library for the Maven plugin.
It is intended to allow you to generate a single client library from an OpenAPI file, and allow you to reuse it across
multiple clients - Flutter for Web (browser), Flutter and Dart CLI (such as when using
Ogurets for e2e testing).
How to use #
This library contains all of the necessary parts required to wire up your generated code from the Maven plugin.
Add these to your pubspec.yaml and then combine them together.
dependencies:
openapi_dart_common: ^3.2.1
your_generated_lib:
path:
../your_generated_lib
copied to clipboard
(for example)
In your application, each of the generated Services will require an ApiClient.
As of version 2.0 we have swapped to Dio, which takes care of browser vs CLI, so you
only need to specify DioClientDelegate() if you wish to override the Dio instance (providing extra options, etc).
It also needs to know how to deserialize specific models and enums - those from your generated code, so a typical
creation could look like this:
_apiClient = ApiClient(
basePath: "http://localhost:8903",
apiClientDelegate: DioClientDelegate());
copied to clipboard
and then you can use your _apiClient instance in your models, consistently across all platforms:
_personService = PersonServiceApi(_apiClient);
copied to clipboard
You can also override the BaseClient that is passed into the ApiClient if you need to customise it, but be
careful not to mix those requiring dart:html (which only exists in the browser) with dart:io (everywhere else).
Maven
If you don't have Maven installed, you can install it fairly easily on Linux and Mac (its in brew), it will require
a JDK implementation so if you don't have done get one from https://adoptopenjdk.net/. Alternatively you can use it from
Docker.